RiskMinder Web Services Developer's Guide › Managing Organizations › Updating Organizations

Updating Organizations

The updateOrg operation enables you to update the following organization information:

• Display name
• Description
• Custom attributes

Note: In addition to the elements that are required to perform these tasks, updateOrgRequest contains other elements for repository (directory service or RiskMinder database) configuration and user attribute mapping. After you create an organization, you cannot change the repository type and the related settings. Therefore, these elements are not applicable when you update an organization. Even if you set these elements, they will not be considered.

This section walks you through the following steps for updating organizations:

• Preparing the Request Message
• Invoking the Web Service
• Interpreting the Response Message

Note: After you update an organization, you must refresh the system cache for the changes to take effect. See "Refreshing the Organization Cache" for more information on how to refresh the system cache.

Preparing the Request Message

The updateOrgRequest message is used to update organizations in the RiskMinder database. The following table lists the elements of this request message.

Note: The following table lists only the elements that you can use to update the organization information. You can ignore other additional updateOrgRequest elements, such as repository type (repositoryDetails) configuration, user attribute mapping (mappingDetails) configuration, and status.

Invoking the Web Service

To update an organization:

1. (Optional) Include the authentication and authorization details in the header of the updateOrg operation. See "Managing Web Services Security" for more information on the header elements.
2. Use the upateOrgRequest elements to update the organization information, as listed in the table.
3. Use the upateOrgRequest message and construct the input message by using the details specified in the preceding step.
4. Invoke the updateOrg operation of the ArcorUserRegistryMgmtSvc service to update the organization.

   This operation returns the updateOrgResponse message that includes the transaction identifier and the authentication token. See the following section for more information on the response message.

Interpreting the Response Message

The response message, updateOrgResponse, returns the transaction identifier and the authentication token in the SOAP envelope header. These elements are explained in the following table. The SOAP body returns a success message if the operation was performed successfully. If there are any errors, then the Fault response is returned. See appendix, "Exceptions and Error Codes" for more information on the SOAP error messages.