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,

Note 

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.