Read File/Directory

Operation name

Read File/Directory

Function overview

Writes the specified file or directory which exists in Microsoft Azure BLOB Storage to another specified directory in HULFT Square Storage.

Data model

The data model of this component is XML type.

Properties

= Remarks =

For details on use of variables, refer to Variables.

Basic settings

Item name	Required/Optional	Use of variables	Description	Remarks
Name	Required	Not available	Enter a name that is used on the script canvas.

Required settings

Item name	Required/Optional	Use of variables	Description	Remarks
Destination	Required	Not available	Select a connection resource. Add A new connection resource can be added. Edit list Connection resource settings can be edited in > HULFT INTEGRATE > Connections.
Container name	Required	Available	Specify the container.	For details on naming conventions of container name in Microsoft Azure, refer to Limitations of AZUREBLOB category. When specifying root container, create a new container named $root and select it.
Virtual directory	Optional	Available	Select or enter a virtual directory.	When omitted, it will be root directory "/".
File/Directory name	Required	Available	Select or enter a file/directory name.	Wildcards ("*" and "?") can be used. Case-sensitive.
Set directory as target as well	Optional	Not available	Select whether or not to set the directory of File/Directory name as target as well. Selected Files and directories of File/Directory name will be targets. Not selected (Default) Files of File/Directory name will be targets.
Get only file information	Optional	Not available	Select whether or not to get only file information without downloading the file locally. Selected Get only file information, without downloading the file locally. Not selected (Default) Download the file locally.
Local directory	Required	Available	Enter a directory path of HULFT Square Storage. The Browse button launches a directory chooser that allows you to select a directory.	Note Specify an absolute path of HULFT Square Storage for the directory path. With the exception of the path separator "/", the Restricted characters of HULFT Square Storage can't be used. Disabled when Get only file information is selected. Case-insensitive.
Overwrite when file exists	Optional	Not available	Select whether to overwrite when a file with the same name exists in the specified local directory. Selected (Default) Overwrite when a file with the same name exists in the specified local directory. Not selected Output an error without overwriting if a file with the same name exists in the specified local directory.	Disabled when Get only file information is selected.

Property actions

Item name	Description	Remarks
Update container name list	Get container names from the specified destination and set them in Container name.	When Destination is changed or the container in Microsoft Azure BLOB Storage is modified, those changes can be reflected with this property action. Disabled when Destination isn't specified.
Update virtual directory list	Get virtual directories in the specified container and set them in Virtual directory.	When Container name is changed or the virtual directory in Microsoft Azure BLOB Storage is modified, those changes can be reflected by this property action. Disabled when Destination or Container name isn't specified.
Update file/directory name list	Get file/directory names in the specified virtual directory and set them in File/Directory name.	When Virtual directory is changed or the file in Microsoft Azure BLOB Storage is modified, those changes can be reflected with this property action. When Set directory as target as well is selected, directory names will be gotten as well. Disabled when Destination, Container name, or Virtual directory isn't specified.

Data processing method

Item name	Required/Optional	Use of variables	Description	Remarks
Data processing method	Required	Not available	Select a data processing method. Apply script settings (Default) The setting for mass data processing in the script properties is applied to the connector. Do not perform mass data processing Mass data processing isn't performed. Perform mass data processing Mass data processing is performed.

Item name

Required/Optional

Use of variables

Description

Remarks

Data processing method

Required

Not available

Select a data processing method.

Apply script settings

(Default)

The setting for mass data processing in the script properties is applied to the connector.

Do not perform mass data processing

Mass data processing isn't performed.

Perform mass data processing

Mass data processing is performed.

Comment

Item name	Required/Optional	Use of variables	Description	Remarks
Comment	Optional	Not available	You can write a short description of this connector.

Schemas

Input schema

None.

Output schema

<?xml version="1.0"?>
<server>
  <container name="" status="" >
    <file etag="" localpath="" name="" size="" status="" type="" updated="" uri="" />
  </container>
</server>

Element name	Attribute name	Description	Remarks
server	-
container	-
	name	Outputs the container name of the gotten file.
	status	Outputs the container status of the file. Exist The container exists. ErrorContainerNotFound The container doesn't exist. The specified container name might be incorrect. Error The existence of container couldn't be confirmed due to an error.
file	-	Appears once for each gotten file.
	etag	Outputs the ETag of the file.	Outputs when the specified container and file are gotten successfully.
	localpath	Outputs the local path of the file.	Doesn't output when Get only file information is selected.
	name	Outputs the file name in Azure BLOB Storage.
	size	Outputs the file size of the obtained file. The unit is byte.	Outputs when the specified container and file are gotten successfully.
	status	Outputs the status of the file. Exist The file exists. ErrorRemoteFileNotFound The file doesn't exist in Microsoft Azure BLOB Storage. ErrorLocalFileNotFound The specified Local directory doesn't exist, or a file is specified. ErrorLocalFileExist Overwrite when file exists isn't selected and a file with the same name exists in the specified Local directory. Error The file couldn't be read due to an error.
	type	Outputs the type of the file.	Outputs when the specified container and file are gotten successfully.
	updated	Outputs the last updated date and time of the file.	Output in yyyyMMddHHmmss format. Example: "20071016131522" shows October 16, 2007 13:15:22. Time zone is the time zone of HULFT Square. Output when the specified file is updated successfully.
	uri	Outputs the URI of the file.	Outputs when the specified container and file are gotten successfully.

Loading schema in Mapper

The schema is loaded automatically.

= Remarks =

For details, refer to Edit Schema.

Mass data processing

Mass data processing is supported.

Parallel Stream Processing

PSP isn't supported.

Available component variables

Component variable name	Description	Remarks
count	The number of gotten files is stored.	The default value is null.
message_category	When an error occurs, the category of the message code corresponding to the error is stored.	The default value is null.
message_code	When an error occurs, the code of the message code corresponding to the error is stored.	The default value is null.
message_level	When an error occurs, the severity of the message code corresponding to the error is stored.	The default value is null.
error_type	When an error occurs, the error type is stored.	The default value is null. The format of the error type is as follows. Example: java.io.FileNotFoundException
error_message	When an error occurs, the error message is stored.	The default value is null.
error_trace	When an error occurs, the trace information for the error is stored.	The default value is null.

Message codes, exception messages, and limitations

Connector	Message code	Exception message	Limitations
Messages and limitations of the Azure BLOB Storage connector