8.3.2 The list of the data transfer management command
The list of the data transfer management command is as follows. In addition, in the case of Linux, read the extension "bat" of a command name as "sh".
No |
Function |
Command |
Explanation |
Refer to |
---|---|---|---|---|
1 |
Message Box list acquisition |
DWClientUtil.bat |
Acquire the list of delivery of Out-box. |
|
2 |
DWClientUtil.bat |
Acquire the list of delivery of In-box. |
||
3 |
Delivery cancellation |
DWClientUtil.bat |
Cancel the executing transmission and reception. |
|
4 |
Delivery deletion |
DWClientUtil.bat |
Specify specific delivery which transmission completed and delete it. |
|
- Organization of this subsection
(1) Out-box list acquisition
Acquire the list of delivery of Out-box and output it to the execution result file. In the following cases etc, this is used.
-
When you confirm the situation of delivery (transmitting) with status of delivery.
-
When you identify delivery ID to appoint in "delivery cancellation" command or "delivery deletion" command.
(a) Format
DWClientUtil.batGETOUTBOX [
-recieverid
the user ID of the address for delivery | -receivermail
the email address of the user of the address for delivery] [
-detail] [
-inprogress]
-fromdate
the start date to acquire information of deliveries
-todate
the end date to acquire information of deliveries
-result
the path of the execution result file
-property
the path of the Command Property File
(b) Argument
No |
Option |
Explanation |
---|---|---|
1 |
-receiverid |
When you acquire delivery in Out-box, you appoint the user ID of the address for delivery that you want to limit. When you specify an unregistered user, you specify "anonymous". When this option is omitted, all delivery that the execution user (the user who was listed in the property file which you appointed with -property option) of this command delivered becomes a target of the acquisition. This includes the delivery to unregistered address. -receivermail options and this can't be specified at the same time. |
2 |
-receivermail |
When you acquire delivery in Out-box, you appoint the email address of the user of the address for delivery that you want to limit. You can also specify an unregistered user. When this option is omitted, all delivery that the execution user (the user who was listed in the property file which you appointed with -property option) of this command delivered becomes a target of the acquisition. This includes the delivery to unregistered address. -receiverid options and this can't be specified at the same time. |
3 |
-detail |
You acquire detailed information. File information is included in detailed information in addition to the delivery information. When this option is omitted, you acquire the information that does not contain the file information. |
4 |
-inprogress |
Acquire only delivery of "The transfer is proceeding". "The transfer is proceeding" is "being forwarded" and "suspended", and "not approved" does not include it. When this option is omitted, all delivery that the execution user (the user who was listed in the property file which you appointed with -property option) of this command delivered becomes a target of the acquisition. |
5 |
-fromdate |
When you acquire delivery, you appoint the creation date of delivery (create-date) # that you limit. You specify the starting date of the period when you want to acquire delivery, in the form of Data Highway - Server local thyme and YYYY/MM/DD. |
6 |
-todate |
When you acquire delivery, you appoint the creation date of delivery (create-date) # that you limit. You specify the ending date of the period when you want to acquire delivery, in the form of Data Highway - Server local thyme and YYYY/MM/DD. The delivery information outputted contains the specified date. |
7 |
-result |
Specify the path of the execution result file. The file is outputted in XML format. |
8 |
-property |
Refer to 8.3.1(2) Common options. |
- #
-
The creation date of delivery is the day when the user started transmission.
(c) Description
- (i) When you specify -detail option
-
The format of the execution result file which is outputted when you specify -detail option is specified is as follows.
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <data> <deliveries> <delivery id="154" send-status="on-approving" create-date="2014/07/29 11:40" send-date="" shelf-life-time="2014/08/29 23:59" subject="XX development project" message="I send the documents." total-size="2364662"> <sender id="user1@domain1" email="user1@domain1.co.jp"> <files> <file id="130" type="file" name="XX_Report.doc" size="266752"/> <file id="131" type="file" name="set_of_XX_development_documents.zip" size="2097910"/> </files> </sender> <receivers> <receiver id="user2@domain1" to-type="TO" url="https://jp1dhserver.co.jp/receipt.jspx?servlet-action=receipt&id=389&cc=8014d12f457e410b09bffdfbd629dcc821d2896e" email="user2@domain1.co.jp"> <files> <file id="130" download-date=""/> <file id="131" download-date=""/> </files> </receiver> </receivers> <approvers> <approver email="approver01@domain1.co.jp" id="approver01@domain1"/> </approvers> </delivery> </deliveries> </data>
- (ii)When you do not specify -detail option
-
The format of the execution result file which is outputted when you do not specify -detail option is specified is as follows. Unlike the case where -detail option is specified, file Element, approvers Element, and message Attribute are not outputted. In addition, the receiver information outputs only the email address.
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <data> <deliveries> <delivery id="154" send-status="on-approving" create-date="2014/07/29 11:40" send-date="" shelf-life-time="2014/08/29 23:59" subject="XX development project" total-size="2364662"> <sender id="user1@domain1" email="user1@domain1.co.jp"/> <receivers> <receiver email="user2@domain1.co.jp"/> </receivers> </delivery> </deliveries> </data>
- (iii)Details of the execution result file format
-
The meanings of the elements which are outputted to the delivery information file are as follows. In addition, the special symbol in XML is transposed to the entity reference (escape character) and outputted.
Table 8‒3: The meanings of the elements of the execution result file Element/Attribute
Number
Explanation
data/deliveries Element
1
It is always outputted.
delivery Element
n
The delivery information tag.
id Attribute
1
Delivery ID is outputted.
It is used to identify delivery.
send-status Attribute
1
The status of the delivery is outputted.
in-progress : The transfer is proceeding
failed : The transfer is failed
suspended : The transfer is suspended
on-approving : The transfer is not approved
rejected : The transfer is not denied
completed : The transfer is already sent
create-date Attribute
1
The creation date-time of delivery is outputted.
send-date Attribute
1
The sending date-time of delivery is outputted.
In the case of unapproved, it is not output.
subject Attribute
1
The subject of the delivery is outputted.
message Attribute
1
The input message of the sender outputted.
shelf-life-time Attribute
1
The storage expiry date is outputted.
total-size Attribute
1
Total data size is outputted with a number of bytes.
sender Element
1
The sender information tag.
id Attribute
1
The sender's user ID is outputted.
email Attribute
1
The sender's email address is outputted.
files Element
1
The send file/folder information tag.
file Element
n
The send file/folder information tag of the send file/folder unit.
id Attribute
1
ID of the send file/folder is outputted.
type Attribute
1
The type of the file/folder is outputted.
-
File : "file"
-
Folder : "folder"
name Attribute
1
The name of the file/folder is outputted.
size Attribute
1
The size of the file/folder is outputted with a number of bytes.
receivers Element
1
The receiver information tag.
receiver Element
n
The receiver is outputted. When two or more receivers exist in delivery, all the receivers that exist in delivery are outputted. Also when -receiverid option is used, all the receivers are outputted.
id Attribute
1
The receiver's user ID is outputted.
url Attribute
1
"URL for opening delivery" of the recipient outputs it.
to-type Attribute
1
The receiver's address type (TO|CC|BCC) is outputted.
email Attribute
1
The receiver's email address is outputted.
files Element
1
The receive file/folder information tag.
file Element
n
The receive file/folder information tag of the receive file/folder unit.
id Attribute
1
ID of the file/folder is outputted.
download-date Attribute
1
The date which downloaded the file/folder is outputted.
approvers Element
1
The approver information tag (when there is no approver this tag is not outputted).
approver Element
n
The approver information tag of the approver unit.
id Attribute
1
The approver's user ID is outputted.
email Attribute
1
The approver's email address is outputted.
-
|
(d) The example for execution
DWClientUtil.bat GETOUTBOX -fromdate "2014/06/01" -todate "2014/06/30" -result "C:\DWCLient\OUTBOX-result.xml" -property "C:\DWCLient\property.xml"
(2) In-box list acquisition
Acquire the list of delivery of In-box and output it to the execution result file. In the following cases etc, this is used.
-
When you confirm the situation of delivery (reception) with status of delivery.
-
When you identify delivery ID to appoint in "the receiving files".
(a) Format
DWClientUtil.batGETINBOX [
- senderid
the user ID of the sender | - sendermail
the email address of the user of the sender] [
-detail] [
-inprogress]
-fromdate
the start date to acquire information of deliveries
-todate
the end date to acquire information of deliveries
-result
the path of the execution result file
-property
the path of the Command Property File
(b) Argument
No |
Option |
Explanation |
---|---|---|
1 |
-senderid |
When you acquire delivery in In-box, you appoint the user ID of the sender user that you want to limit. When this option is omitted, all send user becomes a target of the acquisition. -sendermail options and this can't be specified at the same time. |
2 |
-sendermail |
When you acquire delivery in In-box, you appoint the email address of the sender user that you want to limit. When this option is omitted, all sender user becomes a target of the acquisition. -senderid options and this can't be specified at the same time. |
3 |
-detail |
You acquire detailed information. File information is included in detailed information in addition to the delivery information. When this option is omitted, you acquire the information that does not contain the file information. |
4 |
-inprogress |
You acquire unreceived delivery. When this option is omitted, you acquire all delivery to the execution user. Unreceived delivery here points out not delivery which is not written in the Received List File, but delivery to which the reception record of the applicable user does not exist in Data Highway - Server side. |
5 |
-fromdate |
When you acquire delivery, you appoint the send date of delivery (send-date) that you limit. You specify the starting date of the period when you want to acquire delivery, in the form of Data Highway - Server local thyme and YYYY/MM/DD. |
6 |
-todate |
When you acquire delivery, you appoint the send date of delivery (send-date) that you limit. You specify the ending date of the period when you want to acquire delivery, in the form of Data Highway - Server local thyme and YYYY/MM/DD. The delivery information outputted contains the specified date. |
7 |
-result |
Specify the path of the execution result file. The file is outputted in XML format. |
8 |
-property |
Refer to 8.3.1(2) Common options. |
(c) Description
- (i)When you specify -detail option
-
The format of the execution result file which is outputted when you specify -detail option is specified is as follows.
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <data> <deliveries> <delivery id="154" download-status="downloaded" send-date="2014/07/29 11:43" shelf-life-time="2014/08/29 23:59" subject="XX development project" total-size="2364662"> <sender id="user1@domain1" email="user1@domain1.co.jp"> <files> <file id="130" type="file" name="XX_Report.doc" size="266752"/> <file id="131" type="file" name="set_of_XX_development_documents.zip" size="2097910"/> </files> </sender> <message>I send the documents.</message> </delivery> </deliveries> </data>
- (ii)When you do not specify -detail option
-
The format of the execution result file which is outputted when you do not specify -detail option is specified is as follows. Unlike the case where -detail option is specified, file Element, message Attribute, and total-size Attribute are not outputted.
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <data> <deliveries> <delivery id="154" download-status="downloaded" send-date="2014/07/29 11:43" shelf-life-time="2014/08/29 23:59" subject="XX development project"> <sender id="user1@domain1" email="user1@domain1.co.jp"/> </delivery> </deliveries> </data>
- (iii)Details of the execution result file format
-
The meanings of the elements which are outputted to the delivery information file are as follows. In addition, the special symbol in XML is transposed to the entity reference (escape character) and outputted.
Table 8‒5: The meanings of the elements of the execution result file Element/Attribute
Number
Explanation
data Element
n
It is always outputted.
delivery Element
n
Delivery information tag of delivery unit.
id Attribute
1
Delivery ID is outputted.
It is used to identify delivery.
download-status Attribute
1
The status of the delivery is outputted.
not-opened : The delivery is not opened
opened : The delivery is opened
downloaded : The delivery is downloaded files
send-date Attribute
1
The sending date-time is outputted.
shelf-life-time Attribute
1
The storage expiry date is outputted.
subject Attribute
1
The subject of the delivery is outputted.
total-size Attribute
1
Total data size is outputted with a number of bytes.
sender Element
1
The sender information tag.
id Attribute
1
The sender's user ID is outputted.
email Attribute
1
The sender's email address is outputted.
files Element
1
The send file/folder information tag.
file Element
n
The send file/folder information tag of the send file/folder unit.
id Attribute
1
ID of the file/folder is outputted.
type Attribute
1
The type of the file/folder is outputted.
-
File : "file"
-
Folder : "folder"
name Attribute
1
The name of the file/folder is outputted.
size Attribute
1
The size of the file/folder is outputted with a number of bytes.
message Attribute
1
The input message of the sender outputted.
-
|
(d) The example for execution
DWClientUtil.bat GETINBOX -fromdate "2014/06/01" -todate "2014/06/30" -result "C:\DWCLient\INBOX-result.xml" -property "C:\DWCLient\property.xml"
(3) Delivery cancellation
Target specific delivery by specifying delivery ID and cancel the executing delivery (sending files/receiving files).
(a) Format
DWClientUtil.batCANCEL [
-deliveryid
delivery ID]
-property
the path of the Command Property File
(b) Argument
No |
Option |
Explanation |
---|---|---|
1 |
-deliveryid |
You appoint delivery ID of the delivery that you want to cancel. The number of delivery ID which can be specified is one. You cannot appoint plural delivery ID. You acquire delivery ID to appoint in this option using Out-box list acquisition (GETOUTBOX) or In-box list acquisition (GETINBOX) of the data transfer management command. When this option is omitted, all the sending/receiving that the execution user (the user who was listed in the property file which you appointed with -property option) of this command delivered becomes a target of the cancellation. |
2 |
-property |
Refer to 8.3.1(2) Common options. |
(c) Description
- (i)Precondition
-
When you cancel the delivery using this function, the execution user of transfer specified by delivery ID needs to be the same user as the execution user (the user who was listed in the property file which you appointed with -property option) of this command. When it is not the same user, it becomes the error.
When the user ID is the same, the execution terminal of the sending/receiving command and the execution terminal of the delivery cancellation command do not need to be the same.
- Note:
-
-
The delivery which carried out delivery cancellation cannot be resumed.
-
If delivery cancellation which omitted delivery ID during execution of the sending/receiving command is performed, an error may occur. In this case, please perform delivery cancellation again.
-
(4) Delivery deletion
Target specific delivery by specifying delivery ID and delete delivery which transmission completed.
For example, when you delete the transmission data which you delivered by mistake, you use this.
(a) Format
DWClientUtil.batDELETEDELIVERY [
-deliveryid
delivery ID]
-property
the path of the Command Property File
(b) Argument
No |
Option |
Explanation |
---|---|---|
1 |
-deliveryid |
You appoint delivery ID of the delivery that you want to delete. The number of delivery ID which can be specified is one. You cannot appoint plural delivery ID. You acquire delivery ID to appoint in this option using Out-box list acquisition (GETOUTBOX) of the data transfer management command. |
2 |
-property |
Refer to 8.3.1(2) Common options. |
(c) Description
- (i)Precondition
-
When you delete the delivery using this function, the delivery specified by delivery ID needs to be the same user as the execution user (the user who was listed in the property file which you appointed with -property option) of this command. When it is not the same user, it becomes the error.
When the user ID is the same, the execution terminal of the sending files command and the execution terminal of the delivery deletion command do not need to be the same.
- Note:
-
-
When Data Highway - Server is the Windows version, in the middle of the downloading, you can't delete the delivery. When Data Highway - Server is the Linux version, in the middle of the downloading, you can delete the delivery, but the downloading is continued.
-
When delivery ID does not exist or when there isn't authority to delete delivery of specified delivery ID, it becomes the error.
-