Overwriting the values in distributed fields
The information in this topic is applicable only for on-premises deployments.
The data in many distributed fields is system-generated ( sets their values). You cannot manually change the values of such fields in a request. The ardist program, however, enables you to overwrite the values in these distributed fields:
- From Form
- From Mapping
- From Pool
- From Server
- Master Flag
The following table lists the ardist command-line arguments.
Argument | Description |
|---|---|
-C | Sets the From Form field to NULL. This is a flag; do not assign it a value. |
-c | Sets the From Form field value. Use this to change the source form name. |
-d | Runs the program in Debug mode, printing debug information to the terminal. This is a flag; do not assign a value to it. |
-e | Specifies the ID of the request to modify. |
-i | Specifies the directory in which the AR System server is installed. |
-L | Sets the From Pool field to NULL. This is a flag; do not assign it a value. |
-l | Sets the From Pool field value. Use this to change the source pool name. |
-M | Sets the Master Flag field to NULL. This is a flag; do not assign it a value. |
-m | Sets the Master Flag field to the specified value (1 = Yes, 0 = No). Use this if your transfer gives you zero or multiple requests with ownership. |
-P | Sets the From Mapping field to NULL. This is a flag; do not assign it a value. |
-p | Sets the From Mapping field value. Use this to change the mapping name. |
-R | Sets the From Server field to NULL. This is a flag; do not assign it a value. |
-r | Sets the From Server field value. Use this to change the source server name. |
-s | Specifies the name of the form containing the request to modify. |
-x | Specifies the name of the server on which the form (-s ) containing the request to modify resides. |
If you use corresponding uppercase and lowercase arguments in the same command line, such as -m 1 -M, the field value is set to NULL.
Overwriting distributed fields scenario
In the Acme Product Info Archive form on the chicago server, this example procedure sets the following field values in request ID 1234567:
Field | Value set by ardist example command |
|---|---|
From Form | Acme West Bug Tracking |
Master Flag | NULL |
From Mapping | Acme ProdInfoArch W to E |
From Server | sanfrancisco |
To overwrite distributed fields in a specified request
- Perform one of these actions:
- In Windows, open a DOS session.
- In UNIX, go to step 3.
- Change to the ARSystemServerInstallDir directory that contains ardist.
At the prompt, enter this command:
ardist -i <ARSystemServerInstallDir> -c "Acme West Bug Tracking"
-e 1234567 -M -p "Acme ProdInfoArch W to E"
-r sanfrancisco -s "Acme Product Info Archive" -x chicago