Write File/Directory

Operation name

Write File/Directory

Function overview

Writes the specified file or a directory which exists in HULFT Square Storage to the specified container in Microsoft Azure BLOB 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.

 

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
  • Case-insensitive.

Local file/directory name

Required

Available

Select or enter the file/directory on the source (HULFT Square Storage side).

  • Wildcards ("*" and "?") can be used.

  • Case-sensitive.

Set directory as target as well

Optional

Not available

Select whether or not to set a directory of Local file/directory name as target as well.

Selected

Files and directories of Local file/directory name will be targets.

Not selected

(Default)

Files of Local file/directory name will be targets.

 

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.

Create container when it doesn't exist

Optional

Not available

Select whether or not to create a container when the specified container doesn't exist.

Selected

(Default)

Container will be created when the specified container doesn't exist.

Not selected

When the specified container doesn't exist, it will be an error without creating it.

  • When selected, the visibility attribute of the created container will be "private".

Virtual directory

Optional

Available

Select or enter a virtual directory.

  • When omitted, it will be root directory "/".

  • When the specified virtual directory doesn't exist, it will be created.

Overwrite when file exists

Optional

Not available

Select whether or not to overwrite when a file with the same name exists in the specified container.

Selected

(Default)

Overwrite when a file with the same name exists in the specified container.

Not selected

When a file with the same name exists in the specified container, it will be an error without overwriting.

 

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.

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.

 

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 written file.

 

status

Outputs the container status of the written file.

Exist

The container exists.

Created

The container has been created newly. Create container when it doesn't exist is selected and the specified container has been created successfully.

ErrorContainerNotCreated

The creation of container has failed. Create container when it doesn't exist is selected, and the creation of the specified container has failed.

ErrorContainerNotFound

The container doesn't exist. Create container when it doesn't exist isn't selected and the specified container doesn't exist.

Error

The existence of container couldn't be confirmed due to an error.

 

file

-

Appears once for each written file.

 

etag

Outputs the ETag of the written file.

  • Output when the specified file is updated successfully.

localpath

Outputs the local path of the written file.

 

name

Outputs the file name in Azure BLOB Storage of the written file.

 

size

Outputs the size of the written file. The unit is byte.

  • Output when the specified file is updated successfully.

status

Outputs the status of the written file.

Updated

The file has been updated successfully.

ErrorLocalFileNotFound

The specified Local directory or the specified File name doesn't exist.

ErrorRemoteFileExist

Overwrite if file exists isn't selected and a file with the same name exists in the specified container.

Error

The file couldn't be read due to an error.

 

type

Outputs the type of the written file.

  • Output when the specified file is updated successfully.

updated

Outputs the last updated date and time of the written 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 written file.

  • Output when the specified file is updated 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.

Transaction

Transaction isn't supported.

Parallel Stream Processing

PSP isn't supported.

Available component variables

Component variable name

Description

Remarks

count

The number of written 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

check

check

check