| Panel | |
|---|---|
|
...
| Attribute | Type | Description | Version Information |
|---|---|---|---|
| mft_transfer | object | The details of the main transfer record (the single transfer or the parent transfer in case of Wildcard Transfer). | Introduced in 1.0.0 |
| mft_transfer.transfer_id | string | The identifier of the transfer on UDMG. | Introduced in 1.0.0 |
| mft_transfer.status | string | The current status of the transfer One of PLANNED, RUNNING, PAUSED, INTERRUPTED, DONE, CANCELED or ERROR. | Introduced in 1.0.0 |
| mft_transfer.start | string | The date and time the transfer has started (UDMG Server time) | Introduced in 1.0.0 |
| mft_transfer.stop | string | The date and time the transfer has ended (UDMG Server time). For a wildcard transfer, this is when the listing of matching files and the registration of the child transfers is completed. | Introduced in 1.0.0 |
| mft_transfer.step | string | The current processing step of the transfer One of NONE, PRE TASKS, DATA, POST TASKS, ERROR TASKS or FINALIZATION. | Introduced in 1.0.0 |
| mft_transfer.transfer_progress | text | The progress of the data transfer in human-readable format
| Introduced in 1.0.0 |
| mft_transfer.error_code | string | The error code of the transfer (if an error occurred). | Introduced in 1.0.0 |
| mft_transfer.error_msg | string | The error message (if an error occurred). | Introduced in 1.0.0 |
| mft_transfer.task_number | string | The task number in the processing step. Only for the steps 'PRE TASKS', 'POST TASKS', and 'ERROR TASKS'. | Introduced in 1.0.0 |
| mft_transfer.local_file | string | Local file path. | Introduced in 1.0.0 |
| mft_transfer.remote_file | string | Remote file path. | Introduced in 1.0.0 |
mft_transfer.transfer_uuid | string | The UUID of the transfer on UDMG. | Introduced in 1.1.0 |
mft_transfer.transfer_info | object | The transfer information fields. Set of metadata associated with the transfer on the UDMG Server. Fields with the udmg_ prefix are set internally by the UDMG server. Fields with the udmg_ue prefix are set by the UDMG File Transfer task. | Introduced in 1.1.0 |
mft_transfer.transfer_info.udmg_ue_task_uuid | string | The UUID of the UDMG File Transfer task. It can be used to easily correlate the UC task executions and the corresponding UDMG file transfers. | Introduced in 1.2.0 |
mft_transfer.transfer_info.udmg_xfer_wildcard | boolean | Indicator that this is a wildcard transfer. Only for MPUT and MGET. | Introduced in 1.2.0 |
mft_transfer.transfer_info.udmg_xfer_cmd | string | ' Only for LIST. | Introduced in 1.3.0 |
mft_transfer.transfer_info.udmg_xfer_childIDs | array | A list of UDMG transfer IDs that are created in the context of this file file transfer. For each file matching the filename input, one file transfer process is created in UDMG. Only for MPUT and MGET. | Introduced in 1.2.0 |
mft_transfer.transfer_info.udmg_xfer_files | array | The list of files that matched the user input. Each of these files is transferred with a separate file transfer execution, which transfer IDs can be found in “udmg_xfer_childIDs“ list. Only for MPUT and MGET. | Introduced in 1.2.0 |
mft_transfer_files_summary | object | Summary counters | Introduced in 1.2.0 |
| mft_transfer_files_summary.done | number | Number of file transfers with success. | Introduced in 1.0.0 |
| mft_transfer_files_summary.error | number | The number of file transfers in error state. | Introduced in 1.0.0 |
| mft_transfer_files_summary.cancelled | number | The number of file transfers that are canceled. | Introduced in 1.0.0 |
errors | array | List of errors for the child transfers. | Introduced in 1.2.0 |
...
| Field | Type | Description | Version Information |
|---|---|---|---|
| Transfer ID | Text | The identifier of the transfer on UDMG. | Introduced in 1.0.0 |
| Transfer Status | Text | The current status of the transfer. Used for Task instance Extension Status. | Introduced in 1.0.0 |
| Transfer Start Time | Text | The date and time the transfer has started (UDMG Server time). | Introduced in 1.0.0 |
| Transfer End Time | Text | The date and time the transfer has ended (UDMG Server time). For a wildcard transfer, this is when the listing of matching files and the registration of the child transfers is completed. | Introduced in 1.0.0 |
| Transfer Step | Text | The current processing step of the transfer. One of NONE, PRE TASKS, DATA, POST TASKS, ERROR TASKS or FINALIZATION. | Introduced in 1.0.0 |
Transfer Progress | Text | The progress of the data transfer in human-readable format.
| Introduced in 1.0.0 Modified in 1.2.0 |
| Error Code | Text | The UDMG transfer error code. See the table below. | Introduced in 1.0.0 |
| Error Message | Text | The error message (if an error occurred). | Introduced in 1.0.0 |
| Transfer Task Number | Text | The task number in the processing step. Only for the Transfer Steps 'PRE TASKS', 'POST TASKS', and 'ERROR TASKS'. | Introduced in 1.0.0 |
| Local File | Text | Local file path. | Introduced in 1.0.0 |
| Remote File | Text | Remote file path. | Introduced in 1.0.0 |
Transfer UUID | Text | The UUID of the transfer on UDMG. | Introduced in 1.1.0 |
...
| Field | Description |
|---|---|
| id | The identifier of the transfer on UDMG |
| status | The current status of the transfer |
| localFilepath | The path of the file on the local disk |
| start | The date and time the transfer has started (UDMG Server time) |
| stop | The date and time the transfer has ended (UDMG Server time) |
| filesize | The size of the file in bytes (or -1 when unknown) |
| progress | The progress of the data transfer in bytes |
| remoteID | The UUID of the transfer on UDMG |
| errorCode | The UDMG transfer error code. |
| errorMessage | The error message (if an error occurred) |
step | The current processing step of the transfer One of NONE, PRE TASKS, DATA, POST TASKS, ERROR TASKS or FINALIZATION |
| taskNumber | The task number in the processing step. Only for the Transfer Steps 'PRE TASKS', 'POST TASKS', and 'ERROR TASKS' |
| remoteFilepath | The path to the file on the remote partner |
| rule | The name of the transfer rule |
| isSend | Indicates whether the transfer is a send (true) or a receive (false) |
| requested | The name of the server/partner that requested the transfer |
| requester | The name of the account that requested the transfer |
...
Deprecation: Integration is now compatible with Universal Controller and Universal Agent of version 7.3 and up.
Enhancements
...
Breaking Change: Transfer Progress output only field is changed to text value (#32195)
Enhancements
Add: Support Wildcard Transfer (#32198, #32195, #32201)- New actions "MPUT" and "MGET" for wildcard transfers:
- support for wildcard in source file parameter,
- creation of wildcard transfer on UDMG,
- monitoring of child transfers on UDMG,
- tabular report on STDOUT with final child transfer status,
- short summary report in EXTENSION output,
- PAUSE, RESUME, and CANCEL commands are propagated to child transfers
- "Transfer Progress" output field is redefined to show human readable value
- size in KB, MB, or GB for single transfer,
- "x out of y files" for wildcard transfer
- "Max files to monitor" parameter: limit the number of child transfers that are monitored by the task instances, 100 by default.
- "Wait for transfer completion" parameter: task instance only returns when the transfer is completed (with DONE or CANCELLED status) on UDMG.
For wildcard transfers, only returns when all child transfers are completed. Activated by default.
- New actions "MPUT" and "MGET" for wildcard transfers:
Add: Refresh task instance output with re-run (#32463)Add: Keep UC task instance ID in UDMG file transfer metadata field udmg_ue_task_uuid (#30931)
ue-mft-transfer-1.1.0 (2023-01-31)
...