Overwriting the values in distributed fields

The information in this topic is applicable only for on-premises deployments.

The data in many distributed fields are system-generated (DSO 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
Warning

The ardist program simply edits field values in a specified request. It does not distribute data between forms and should not be considered a command-line version of DSO.

Related topic

Setting-up-DSO-to-synchronize-data-across-multiple-AR-System-servers

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.


Important

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 Apex Global 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

Apex Global West Bug Tracking

Master Flag

NULL

From Mapping

Apex Global ProdInfoArch W to E

From Server

sanfrancisco

To overwrite distributed fields in a specified request

  1. Perform one of these actions:
    • In Windows, open a DOS session.
    • In UNIX, go to step 3.
  2. Change to the ARSystemServerInstallDir directory that contains ardist.

  3. 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


 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*