pp108 : RepairAssignments

RepairAssignments

This method repairs the link between the user assignment and the organization unit. This method is used whenever a unit is renamed (or moved to another folder) or recreated with the same name, and you want to preserve the user assignments for that unit.

Example:

There are two references from the assignment to the organization unit: (1) based on the unit ID, and (2) based on the unit qualified name. If a unit is renamed or moved, the unit's qualified name changes; and if a unit is recreated, the unit's ID changes. Therefore, in either case, the references must be repaired to maintain the link.

SOAP Request

<SOAP:Envelope xmlns:SOAP="http://schemas.xmlsoap.org/soap/envelope/">
    <SOAP:Body>
        <RepairAssignments xmlns="http://schemas.cordys.com/userassignment/UserAssignmentService/1.0">
            <WorkspaceID>002481F0-8E9F-11E2-EE36-A5EED1105F38</WorkspaceID>
            <AssignmentRoot>[Assignment Root]</AssignmentRoot>
            <UnitID>001CC438-906D-11E2-EECC-49936ED1DF4B</UnitID>
            <UnitQName>teams/college</UnitQName>
        </RepairAssignments>
    </SOAP:Body>
</SOAP:Envelope>
Request Parameters

Parameter

Description

Mandatory

Accepted input values

WorkspaceID

Unique and valid ID of the Collaborative Workspace (CWS).

No

GUID or null

AssignmentRoot

Assignment root ID. GUID retrieved from InitializeAssignmentRoot must be used.

Yes

GUID

UnitID

ID of the organization unit

Yes. Either UnitID or UnitQName.

ID of a unit, usually GUID, which is retrieved using the getUnits API.

UnitQName

Qualified name of the organization unit

Yes. Either UnitID or UnitQName.

QName of a unit, which is retrieved using the getUnits API.

If both UnitID and UnitQName are empty, all existing assignments under the Assignment root are repaired.

SOAP Response

<RepairAssignmentsResponse xmlns="http://schemas.cordys.com/userassignment/UserAssignmentService/1.0">
    <RepairAssignments>
        <ReloadResult>
            <Reload>[Reload result]</Reload>
      ...
    </ReloadResult>
    </RepairAssignments>
</RepairAssignmentsResponse>
Response Parameters

Parameter

Description

Reload

Informative message about the repair operation