Create configuration revisions
As a provider, you can edit and create revisions of entitlements that contain updated functionality that can be developed and deployed to consumers.
When the new revision is deployed, consumers can either activate and use the new revision, or continue to use the old revision. The new revision can be activated only if the consumer is using a Service Exchange application version that is compatible with the Service Exchange application version compatibility set on the revision. If the consumers want to use the new revision, they must upgrade their Service Exchange application to the minimum compatibility that is set on the configuration.
Configuration revision life cycle
- Remote task definition
- Remote record producer
Create a configuration revision
- Navigate to the .
- Select the remote task definition for which you want to create a configuration revision.주:The remote task definition that you select must be in the Published state.
Note the Compatibility field. This field shows the Service Exchange version that is being used by the provider. If the consumer is using a compatible Service Exchange version, data can be synced between the provider and consumer instances. But if the consumer isn’t using a compatible version, any new entitlements can’t be activated until the corresponding Service Exchange version is upgraded. See Mismatched version support for additional information.
- Select Checkout.
- A new revision of the configuration is created and the State is set to In Draft.
You can view the older revision by navigating to the Revisions tab under the Related List section. As you can see in the preceding image, the older revision is still in the Published state.
- Make the necessary changes and select Save to save the changes. Select Publish to activate the newly created configuration revision. The newly activated revision is synced to the
consumer instance. The State of the older revision is set to Inactive.주:The inactive configuration is still available to the consumers and data synchronization will continue until this configuration is either archived or retired.
- On the consumer instance, navigate to . You can see the newly published configuration revision under the Entitlements tab in the Related Links section.
- Select the newly published configuration reference and select the Entity reference link to navigate to the Remote task definition page.
- Select Activate to activate the new configuration revision. When the new revision is activated, the earlier revision moves to an Inactive state. Consumers can continue to use the earlier revision until it’s archived or retired.
- You can create multiple configuration revisions for a single configuration but only the latest published revision is active and can be used by the consumers.주:
- If you create a configuration revision and select Save, the revision is set to the Draft state. If you open the Published revision of this configuration, you’ll notice that the Checkout and Retire options are unavailable. In this case, you must open the draft version to make any changes.
- If the newly created draft revision isn’t required, select Cancel to delete that draft revision. The already published revision is available to Checkout or Retire.
Archive a configuration revision
You can archive an inactive configuration revision. When a revision is archived by the provider, it’s deactivated and the State is set to Archived on the consumer instance. The following steps describe how to archive a remote task definition configuration revision. The same process is applicable to the remote record producers and foundation data sync offerings.- Navigate to the .
- Select a remote task definition in the list.
- Navigate to the Revisions tab in the Related List.
- Select the inactive revision that you want to the archive.
- Click Archive to deactivate the remote task definition. Once archived, this revision is no longer available to consumers.주:You can’t Publish, Update, or Checkout an archived configuration revision. You can use the Copy option to make a copy of the configuration.
Retire a configuration
You can retire a published configuration. When you retire a configuration, the entire set of revisions associated with the configuration are retired. To retire a configuration, follow these steps:
- Navigate to the .
- Select a remote task definition configuration on the list.
- Select Retire and then select OK. Once retired, this configuration is no longer available to consumers.주:This option retires published and inactive configuration revisions. But configuration revisions in the Archived state aren’t retired.
- If you want to use the remote task definition again, you can:
- Select Checkout to create a new configuration revision.
- Select Copy to make a duplicate copy of the new configuration.
Copy a configuration revision
- Published
- Inactive
- Archived
- Retired
- Navigate to the .
- Select a remote task definition configuration revision that is in any of the preceding states.
- Select Copy to make a copy of the configuration revision.
Delete a configuration
You can delete a configuration that has been retired. There may be many retired revisions present but the Delete option is available only for the latest retired configuration revision. When a revision is deleted, the entire configuration set is deleted.
- Navigate to the .
- Select a remote task definition that is in the Retired state.
- Select Delete to delete the configuration if it’s no longer required. Once deleted, all records associated with this identity are deleted and can’t be undone.