Please ensure Javascript is enabled for purposes of website accessibility
Powered by Zoomin Software. For more details please contactZoomin

Asset Framework and PI System Explorer (PI Server 2024 R2)

List of AFImport utility parameters

  • Last UpdatedDec 20, 2024
  • 3 minute read

The AFImport utility supports these parameters.

Parameter

Short form

Description

Path

Path to the object into which you want to import. Typically of the form: \\afserver\database. Use '.' to import into the default database.

/File:string

/F

Specify an input file. If not specified, the import operation reads from the standard input.

/AutoCheckIn[-]

/A

Automatically check in changes during an import operation. Default value: True

/Create[-]

/C

Allow import operation to create new objects. Default value: True

/Update[-]

/U

Allow import operation to update existing objects. Default value: True

/CreateCategories[-]

/CC

Create categories that do not exist but are referenced by objects in the input. Default value: True

/CreateUpdatePIPoints[-]

/P

Create or update PI point configuration for newly created elements. This option can significantly affect import performance.

/PreserveUniqueIDs[-]

/Pid

Retain unique IDs that exist in the source XML. This option is only valid when /Create and /AutoCheckIn are also specified. This option can significantly affect import performance.

There is no guarantee that PI AF will preserve unique IDs of attributes derived from templates because unique IDs of such attributes are generated based on the template's unique ID.

Note: Because PI AF servers maintain a cache of rowids to ids, the import with Preserve Unique IDs option affects load-balanced PI AF servers differently from non-load balanced PI AF servers. In a non-load balanced scenario, removed items will cause the cache of rowids to ids to be updated. However, in a load-balanced scenario, the non-connected server will need to be restarted to have the cache updated after items are removed, and before the import with Preserve Unique IDs option is used to restore items to the same system.

/DisableNewAnalysesNotifications[-]

/DN

New analyses and notifications are created in a disabled state. Existing analyses and notifications in the destination database are not affected.

/DisableConfigStringValidation[-]

/D

Disable the validation of configuration string settings for data references and delivery channels, which can improve the speed of the import operation. However, this will bypass looking up PI points, which corrects or adds server IDs and point IDs to configuration strings.

/GenerateUniqueNames[-]

/G

Generate unique names for objects when an object with the same name already exists.

/Paste[-]

/Pa

Paste operation behaves as if this is a copy/paste process. Depending on where the data is imported, this affects whether a new name is generated.

/ContinueOnError

/CE

Specify the behavior of the import process when a recoverable error occurs. The three options available are Yes, No, and Prompt. The default value is Prompt, unless running silently in which case the default will be to cancel the import process.

/Silent[-]

/S

Silent mode. Prevent informational messages from being displayed.

/Summary[-]

/M

Summary mode. Output only minimal information on progress.

/User:string

/user

Use to specify a different Windows user account to connect to the PI AF server.

/Password:string

/pw

If a user name is specified, specify the network credentials password.

/Version

/V

Display version information. All other parameters are ignored.

@file

Read response file for more options. The response file contains one parameter per line. Comment lines start with the # character.

TitleResults for “How to create a CRG?”Also Available in