This project has moved. For the latest updates, please go here.

<global-operations> element

The SSH MA allows commands to be executed at the beginning and end of each type of operation (Import, Export, Password). The <global-operations> element contains the definition of these options. Global operations are optional, and are not required for normal operation of the MA. The <global-operations> element supports one or more <global-operation> elements

<global-operation> elements must have a type attribute declared as one of the following values
xsi:type Description
sshma:global-operation-ImportFullStart Called at the beginning of a full import operation
sshma:global-operation-ImportFullEnd Called at the end of a full import operation
sshma:global-operation-ImportDeltaStart Called at the start of a delta import operation
sshma:global-operation-ImportDeltaEnd Called at the end of a delta import operation
sshma:global-operation-ExportStart Called at the start of an export operation
sshma:global-operation-ExportEnd Called at the end of an export operation
sshma:global-operation-PasswordStart Called at the start of a password set or change operation
sshma:global-operation-PasswordEnd Called at the end of a password set or change operation

A <global-operation> element must have a single child commands element. Commands can be defined in each of these operations to allow actions to be performed before any object operations take place. For example, an ImportDeltaStart operation might be used to generate files containing the delta changes to the objects within the MA. An ImportDeltaEnd operation might be used to save the state of a set of objects, so a subsequent ImportDeltaStart operation can determine what changed since the last import.

The <global-operations> element can have only one <global-operation> element for each of the global operation types.

Note: As global operations are performed before the MA recieves any objects from FIM, value declarations cannot be within any commands in the global operation.

Example

<global-operations>
    <global-operation xsi:type="sshma:global-operation-ExportStart">
        <commands>
            <command success-codes="0,2">rm /usr/tmp/groups.txt</command>
        </commands>
    </global-operation>
    <global-operation xsi:type="sshma:global-operation-ImportFullStart">
        <commands>
            <command success-codes="0,2">rm /usr/tmp/users.txt</command>
        </commands>
    </global-operation>
</global-operations>
In the example above, an ExportStart and ImportFullStart operation both run a command to delete a file.

Last edited Sep 21, 2013 at 1:06 AM by ryannewington, version 2