...
Each time a file transfer action occurs on the UDMG server a Universal Event can be generated. This event can be used to trigger a Universal Monitor Task for the processing of the file or for further actions in relation to this transfer.
...
The template can also be created with the Universal Event Template Web Services.
Expand |
---|
|
Code Block |
---|
language | bash |
---|
title | Curl Request |
---|
| curl -L -X POST 'http://host_name/uc/resources/universaltemplateuniversaleventtemplate' \
-H 'Content-Type: application/json' -H 'Accept: application/json' \
--data-raw '{
"attributesPolicy": "Include Attributes",
"description": "Event for when a file is transferred by UDMG server",
"label": "UAC User Event: UDMG transfer",
"name": "b2bmft",
"ttl": 60000,
"attributes": [
{
"label": "actual name of the file on the disk",
"name": "truefilename",
"type": "Text"
},
{
"label": "original path of the file before the transfer",
"name": "fullpath",
"type": "Text"
},
{
"label": "actual path of the file on the disk",
"name": "truefullpath",
"type": "Text"
},
{
"label": "date (in format AAAAMMJJ) when the transfer was executed",
"name": "date",
"type": "Text"
},
{
"label": "filesize",
"name": "size",
"type": "Float"
},
{
"label": "identifier of the partner who received the transfer request",
"name": "requestedhost",
"type": "Text"
},
{
"label": "identifier of the partner who requested the transfer",
"name": "requesterhost",
"type": "Text"
},
{
"label": "local partner",
"name": "localhost",
"type": "Text"
},
{
"label": "original name of the file before the transfer",
"name": "filename",
"type": "Text"
},
{
"label": "remote partner",
"name": "remotehost",
"type": "Text"
},
{
"label": "rule used by the transfer",
"name": "rule",
"type": "Text"
},
{
"label": "time (in format HHMMSS) at the time of the execution of the transfer",
"name": "hour",
"type": "Text"
},
{
"label": "transfer ID",
"name": "transferid",
"type": "Text"
}
]
}
' |
|
...
The template can also be created with the Universal Event Template Web Services.
Expand |
---|
|
Code Block |
---|
language | bash |
---|
title | Curl Request |
---|
| curl -L -X POST 'http://host_name/uc/resources/universaltemplateuniversaleventtemplate' \
-H 'Content-Type: application/json' -H 'Accept: application/json' \
--data-raw '{
"attributesPolicy": "Include Attributes",
"description": "Event for error with file transfer by UDMG server",
"label": "UAC User Event: UDMG transfer error",
"name": "b2bmft_error",
"ttl": 6000,
"attributes": [
{
"label": "actual name of the file on the disk",
"name": "truefilename",
"type": "Text"
},
{
"label": "original path of the file before the transfer",
"name": "fullpath",
"type": "Text"
},
{
"label": "actual path of the file on the disk",
"name": "truefullpath",
"type": "Text"
},
{
"label": "date (in format AAAAMMJJ) when the transfer was executed",
"name": "date",
"type": "Text"
},
{
"label": "filesize",
"name": "size",
"type": "Float"
},
{
"label": "identifier of the partner who received the transfer request",
"name": "requestedhost",
"type": "Text"
},
{
"label": "identifier of the partner who requested the transfer",
"name": "requesterhost",
"type": "Text"
},
{
"label": "local partner",
"name": "localhost",
"type": "Text"
},
{
"label": "original name of the file before the transfer",
"name": "filename",
"type": "Text"
},
{
"label": "remote partner",
"name": "remotehost",
"type": "Text"
},
{
"label": "rule used by the transfer",
"name": "rule",
"type": "Text"
},
{
"label": "time (in format HHMMSS) at the time of the execution of the transfer",
"name": "hour",
"type": "Text"
},
{
"label": "transfer ID",
"name": "transferid",
"type": "Text"
},
{
"label": "error message",
"name": "errormsg",
"type": "Text"
},
{
"label": "error code",
"name": "errorcode",
"type": "Text"
}
]
}
' |
|
...
The publishing of Universal Event is enabled with the UDMG processing task PUBLISHEVENT, which is an addition to the standard tasks that are provided by the Waarp GatewayUDMG-Client.
The task is configured for every transfer rule for which it is required to have an event on Universal Controller.
The interface with the Universal Controller is through the Universal Event Publishing Web Service.
The table below show the list of parameters that are accepted by the PUBLISHEVENT task. Except for the path
, they are passed as attributes to the Universal Event.
...
Option Name | Description |
EventUrl
| Specify the URL for the Target Universal Controller. This specifies where the Event will be published. |
EventName | Universal Event Template Name |
EventTTL | Universal Event Template Time To Live in minutes (optional) |
UACEventUsername | Name of the user to access the Universal Controller REST API
|
UACEventPassword | Password to access the Universal Controller REST API |
...
Configuration of Universal Monitor Task for UDMG File Transfer Event
Create a Universal Monitor task and select the Universal Event Template that was created for UDMG File Transfer.
...
Configuration of Universal Monitor Trigger for UDMG File Transfer Event
Create a Universal Monitor Trigger and select the Universal Monitor Task that was created to filter the events to be caught.
...