Updating a rights group
To update existing rights groups:
- Use the PutProvisioningData operation.
To update existing rights groups and return an identifier set for each rights group and user
- Use the PutProvisioningDataAndGetIdentifierSets operation.
Note: Use PutProvisioningDataAndGetIdentiferSets if the returned identifier sets are used within the client. The operation is significantly slower than PutProvisioningData.
Usage—for both operations:
- Specify one or more MedML <RIGHTSGROUP> elements for existing right groups.
- If the GROUPNAME you specify exists, the rights group is automatically updated.
- GROUPNAME values are case-sensitive. If the name you specify does not exactly match an existing name, a new rights group is created.
- Values for the fields are identical to those used when creating a rights group. For more information, see Creating a rights group.
- When calling PutProvisioningData or PutProvisioningDataAndGetIdentifierSets to update a Rights Group, if you want the Rights Group to be changed to contain only the rights you include as RightsRef in the MedML, you can add the attribute OVERWRITERIGHTS=TRUE to the RightsGroup MedML element (for example, <RIGHTSGROUP GROUPNAME="PI" OVERWRITERIGHTS="TRUE">).
If this new attribute is not specified or is false, InForm continues to behave as it did in previous versions. Any right specified in the MedML that was not already selected for the Rights Group in InForm is added. No existing rights are removed.