Unica Campaign session utility syntax and options

Use the following syntax and options to run the Unica Campaign session utility. The unica_acsesutil utility operates on the .ses file.


unica_acsesutil -s sesFileName -h partitionName
[-r | -c | -x [-o outputFileName]] [-u] 
[{-e exportFileName [-f {flowchart | campaign | session}]}
| {-i importFileName [-t ]
[-b {abort | replace | skip}]}]
[-p] [-a | -n | -l]
[-S dataSource -U DBUser -P DBPassword]*
[-y userName] [-z password]
[-j owner] [-K policy]
[-J

-J export session file into JSON and include in Flowchart Advanced Search.

The unica_acsesutil utility supports the following options.

unica_acsesutil -s sesFileName -h partitionName
[-r | -c | -x [-o outputFileName]] [-u]
[{-e exportFileName [-f {flowchart | campaign | session}]}
| {-i importFileName [-t ]
[-b {abort | replace | skip}]}]
[-p] [-a | -n | -l]
[-S dataSource -U DBUser -P DBPassword]*
[-y userName] [-z password]
[-j owner] [-K policy]
[-J]
[-Z]

In above command -Z is newly introduced

Table 1. Unica Campaign session utility (`unica_acsesutil`) options
Option	Syntax	Description
-a	`-a`	Recomputes record counts and the list of distinct values for all tables.
-b	`-b {abort \| replace \| skip}`	Applies only for the import option (`-i`). Specifies that the import be done in batch mode. Requires one of the following arguments to specify how to handle duplicate objects (if there is an ID conflict): `abort` - If a duplicate object is detected, the import stops. `replace` - If a duplicate object is detected, replace it with the imported object. `skip` - If a duplicate object is detected, do not replace it and continue the import.
-c	`-c <outputFileName>`	Generates a table catalog in `outputFileName` in `.cat` format (Unica Campaign internal format). This option is ignored with the -`s` option.
-e	`-e <exportFileName>`	Exports the object type specified by the `-f` option to a file named `exportFileName`. If the `-f` option is not used, by default a flowchart is set for export.
-f	`-f {flowchart \| campaign \| session}`	Specifies the type of object to export. If this option is omitted, by default a flowchart is set for export. If `-f` is used, requires one of the following arguments: flowchart, campaign, session.
-h	`-h <partitionName>`	Specifies the name of the partition in which the flowchart file (specified with `-s)` is located. This parameter is required.
-i	`-i <importFileName>`	Specifies the name of the file being imported. This should be a file that was exported using the `-e` option in a previous export operation.
-j	`-j <owner>`	Specifies the owner of the file being imported or exported.
-J	`-s <Flowchart ses file> -h <partition_name> -J -y <user_id> -z <password>`	Creates or updates search indexes for the specified flowchart .ses file. The `-J` option performs JSON serialization and indexes the flowchart so it is searchable. Use this option to index a single flowchart session file or refresh the index after making changes to the flowchart. You must use `-s` to indicate the session file. The options `-y` and `-z` are optional; if you omit them, the tool prompts for user ID and password. Note: Until flowcharts are indexed, they are not searchable. Flowcharts are not automatically indexed, and indexes are not automatically updated. You must index them initially (for example, after upgrading to Campaign v10), then periodically refresh the indexes to keep them up-to-date. To reindex all existing flowchart session files in a partition at one time, use the Campaign session utility (advSrchUtil). . For example `unica_acsesutil -s <Flowchart ses file> -h <partition_name> -J -y <user_id> -z <password>` You must use -s to indicate the session file. The options-y and -z are optional; if you omit them, the tool prompts for user ID and password.
-k	`-k <policy>`	Specifies the security policy of the file being imported.
-l	`-l`	Recomputes only the list of distinct values.
-n	`-n`	Recomputes only record counts.
-o	`-o <outputFileName>`	Specify the catalog with the name `outputFileName`. If unspecified, the default is `catFileName`.`xml` or `catFileName.cat`, depending on whether you use the `-x` or `-c` option. The output file name should specify a destination directory when using wildcards.
-P	`-P <DBPassword>`	Specifies the password for the database user account. Used with the `-U` and `-S` options.
-p	`-p`	Print table mappings to the console.
-r	`-r <outputFileName>`	Generate a flowchart XML report in `outputFileName.` This parameter is ignored when you use the `-t` option (using a table catalog as input).
-S	`-S <dataSource>`	Specifies the name of the data source for the object being operated on. Use with the `-U` <`database_user>` and `-P` <`database_password>` options.
-s	`-s <sesFileName>`	Specifies a Unica Campaign flowchart (`.ses`) file on which to operate. Specifying the `.ses` file is always required for exporting and importing, regardless of the object type (campaign, session, or flowchart). When exporting or importing a campaign or session with multiple associated flowcharts, any of the associated `.ses` files can be used. The file name should include the path below the partition in which this flowchart file is located (defined using the `-h` option). For example, a valid value for `-s` is: `"campaign/Campaign C00001_C00001_Flowchart 1.ses"` The <`sesFileName`> can contain wildcard characters to operate on multiple matching flowcharts.
-t	`-t <catFileName>`	Read a table catalog named `<catFileName>` as the input. The <`catFileName>` can contain wildcard characters.
-U	`-U <DBUserName>`	Specifies the user login for the data source specified by the `-S` option. Use with the `-P` option, which specifies the database password for this database user.
-u	`-u`	Uses existing database authentication information when saving table catalogs.
-v	`-v`	Displays the version number and exits.
-x	`-x <outputFileName>`	Generates a table catalog file in an alternate XML format in `outputFileName`. If the input table catalog is a `.cat` file, it generates a corresponding `.xml` file, and vice versa.
-y	`-y <userName>`	Specifies the Unica user name.
-z	`-z <password>`	Specifies the password for the user specified by the `-y` option.
-z	`-z`	Adding new record in UA_FlowchartSeg system table, After processing .ses file. During campaign upgrade procedure.