The structure, and permissible elements, are as shown in the following code example:
<?xml version="1.0" ?>
<EXTRACT>
<USERS ACTION="UPDATE">
<USER ACTION="UPDATE" UUSERPROFILE="FRED">
<USEQUENCE TYPE="N" VALUE="1" />
<UCAPTION LANG="ENG" VALUE="USER FRED" />
<UHINT LANG="ENG" VALUE="" />
<UICONNAME VALUE="VF_IC496" />
<UUSEROBJECTTYPE VALUE="FRED_OBJ" />
<UPASSWORD VALUE="FREDSPSWD" />
<UEMAILADDRESS VALUE="FRED@LANSA.COM.AU" />
<UTEMPDIRECTORY VALUE="C:\DOCUME~1\user\LOCALS~1\Fred\" />
<UDISABLED VALUE="FALSE" />
<UADMIN VALUE="FALSE" />
<UGROUPUSER VALUE="FALSE" />
<USIGNOFFTIMEOUT TYPE="N" VALUE="0" />
<USIGNONTIMEOUT TYPE="N" VALUE="0" />
<GROUPS ACTION="REPLACE">
<GROUP VALUE="GROUP_1" />
</GROUPS>
<AUTHORITIES ACTION="REPLACE">
<AUTHORITY TYPE="FRAMEWORK" OBJECT="SHIPPED_FRAMEWORK" VALUE="ALLOW" />
</AUTHORITIES>
</USER>
</USERS>
</EXTRACT>
Other element types will be ignored.
Property elements (e.g. uSequence, uCaption) have a VALUE attribute.
Numeric property elements should also have a TYPE = "N" attribute.
Boolean properties such as <UADMIN>, <UDISABLED>, <UGROUPUSER> are specified using VALUE="TRUE" or VALUE="FALSE"
The ACTION attribute can only be specified for USERS USER GROUPS or AUTHORITIES.
ACTION="UPDATE" means change/add what is specified in the XML, but leave everything else as it is. If it doesn't exist already, it will be created.
ACTION="REPLACE" means change/add what is specified in the XML and remove anything that is not specified in the XML.
ACTION="DELETE" means remove the object/s.
Rules for Specific Elements/Attributes| Element | Attribute | Description | Value/s | Mandatory |
|---|---|---|---|---|
|
<USERS> |
ACTION |
Replace all users or add to/change existing |
REPLACE, UPDATE |
Yes |
|
<USER> |
ACTION |
How to handle properties not specified in the XML, or To delete the user |
REPLACE, UPDATE, DELETE |
Yes |
|
|
UUSERPROFILE |
The User Profile of the User |
|
Yes |
|
<GROUPS> |
ACTION |
|
REPLACE, UPDATE, DELETE |
Yes |
|
<GROUP> |
VALUE |
The User profile of the Group. The Group should exist in the Framework already. If not, the Group should be defined as a <USER> prior to other users, in the XML. |
|
Yes |
|
<AUTHORITIES> |
ACTION |
Replace all authorities, Add to/change existing authorities, or delete the specified authorities |
REPLACE, UPDATE, DELETE |
Yes |
|
<AUTHORITY> |
TYPE |
The type of object that the user will not be authorised to use. |
FRAMEWORK, APPLICATION, BUSINESS_OBJECT, COMMAND_REFERENCE, APPLICATION_VIEW, SERVER |
Yes |
|
|
OBJECT |
The "User Object Name / Type" of the object the user will not be able to use. |
|
Yes (if not command_ reference) |
|
|
VALUE |
Allow the user to use this object (only used with the FRAMEWORK object) or Disallow the user to use this object (all other kinds of objects) |
ALLOW, DISALLOW |
Yes |
|
|
COMMAND |
(This only applies to Authority to COMMAND_REFERENCE objects)
|
|
Yes (if command_ reference) |
|
|
OWNER |
(This only applies to Authority to COMMAND_REFERENCE objects) This is the "User Object Name / Type" of the object (Framework, application or business object) to which the command is applied |
|
Yes (if command_ reference) |
|
|
OWNTYP |
The type of object the command applies to |
FRAMEWORK, APPLICATION, or BUSINESS_OBJECT |
Yes (if command_ reference) |