Export Format

Copyright © Cloud Software Group, Inc. All Rights Reserved

Chapter 10 Users and Groups : Export Format

Export Format

The output of the swutil USERINFO EXPORT command is in a format that can be re-imported. It starts with an R command to reset the user information, followed by sections for each type of data, for example:

R

; START OF ATTRIBUTES --------------------

A+DESCRIPTION,T,24,,

A+LANGUAGE,T,24,,

A+MENUNAME,T,24,,

A+QSUPERVISORS,T,48,,

A+SORTMAIL,T,24,,

A+SW_DOMAIN,T,24,,

A+USERFLAGS,T,24,,

; END OF ATTRIBUTES ----------------------

; START OF GROUPS ------------------------

G+clerks

V+clerks,DESCRIPTION,Clerical Workers

V+clerks,MENUNAME,sw_group

; END OF GROUPS --------------------------

; START OF USERS -------------------------

U+fred@EMEA

V+fred,DESCRIPTION,System Administrator

V+fred,LANGUAGE,english

V+fred,MENUNAME,ADMIN

V+fred,QSUPERVISORS,

V+fred,SORTMAIL,PROCEDURE

V+fred,SW_DOMAIN,EMEA

V+fred,USERFLAGS,

; END OF USERS ---------------------------

; START OF GROUP MEMBERSHIP --------------

M+fred,clerks

; END OF GROUP MEMBERSHIP ----------------

The export format for a single user export command starts with a U- instruction to delete the user, followed by instructions to add it back again together with its other data, enabling a single user's data to be updated. For example, swutil USERINFO EXPORT fred could give the following:

U-fred

U+fred@EMEA

V+fred,DESCRIPTION,System Administrator

V+fred,LANGUAGE,english

V+fred,MENUNAME,ADMIN

V+fred,QSUPERVISORS,

V+fred,SORTMAIL,PROCEDURE

V+fred,SW_DOMAIN,EMEA

V+fred,USERFLAGS,

V+fred,WISCACHE,

By default, the value of a user’s SW_DOMAIN attribute is included in an "add user" U+ instruction. For example:

   U+fred@EMEA

This value will be used to validate the user as a Windows operating system user if the instruction is used to re-import the user to iProcess Engine. See Validating New Users on a Windows iProcess Engine.

However, if the EXPORT command included the nolocation option, the SW_DOMAIN attribute value is not included. For example:

   U+fred

The SW_DOMAIN attribute value is always included in the "change attribute value" V+ instruction, even if the EXPORT command included the nolocation option. For example:

   V+fred,SW_DOMAIN,EMEA

For more information about the SW_DOMAIN user attribute, see "Defining Where a User’s Password Should be Validated" in TIBCO iProcess Workspace (Windows) Manager’s Guide.