Subscriptions

In addition to being used to obtain updates regarding business entity or business service changes, subscription functionality allows clients with third-party registries (subscribers) to monitor a subset of data within the Policy Manager Registry.

Table of Contents

About Subscriptions

Policy Manager provides UDDI 3.0-compliant Subscription functionality that allows clients with third-party registries (subscribers) to monitor a subset of data within the Policy Manager Registry. Subscriptions can be used to obtain updates regarding any type of business entity or business service change that would be of interest to your organization.

The relationship between a subscriber and the Policy Manager Registry is established through the following steps:

  1. In the Configure > Registry > Subscriptions section of the Policy Manager Management Console, define a subscription request.
  2. Configure one-way replication between the third-party registry (secondary registry) and Policy Manager registry (primary registry).

To view the Subscriptions Summary page, go to Configure > Registry and then click the Subscriptions tab.

Define Subscription

In this example we create a Systinet Registry subscription. Steps:

  • Create any provider to place virtual services.
  • Assign the following category to the provider created above: Replicated Businesses of digev.com:metadata category scheme.

    Note: Use this provider when creating physical or virtual services.

to define a subscription

  1. Go to Configure > Registry.
  2. Click the Subscriptions tab.

    The Subscription Summary page is displayed, showing a list of registry subscriptions current defined in Policy Manager.

  3. Click Add Subscription. The Add Subscription page is displayed.
  4. Enter the following:
    • Subscription Key—The system-generated subscription key that you will configure in the registry you are subscribing to.
    • Subscription Filter—Find_business by category Replicated Businesses from digev.com:metadata category scheme.

      Filter Example:

      <find_business xmlns="urn:uddi-org:api_v3">
<categoryBag>
<keyedReference tModelKey="uddi:digev.com:metadata" keyName="Replicated Businesses" keyValue="repl_business"/>
</categoryBag>
</find_business>
    • Max Entries—10
    • Expires After—Select an entry date from the Calendar pop-up. For example, one month from today.
  5. (Optional) If you would like a summary of data to be retrieved versus complete data, check the Retrieve Data in Brief Format box.
  6. Click Apply.

Configure a Third-Party Registry

After you have defined a subscription in Policy Manager, configure replication information in the third-party registry.

The following example illustrates replicating to the Systinet Registry.

  1. Log on to Systinet Registry with an administrator account.
  2. Create Replication:
    • Primary tab

      Enter the Policy Manager administrator account.

      Enter the Registry Manager URL for Inquiry/Subscription/Security URLs. For example, http://akofmnn-gx270.digev.com:9901/rmengine.

      Enter the subscription key as defined in the subscription definition.

    • Secondary tab

      Enter Systinet Registry administrator account.

      Enter Replication period; for example, 5 minutes.

  3. Save replication.

    Note: Replication starts as soon as you save.

Modify Subscription

You can update a third-party registry subscription configuration.

  1. Go to Configure > Registry.
  2. Click the Subscriptions tab.

    The Subscription Summary page is displayed, showing a list of registry subscriptions current defined in Policy Manager.

  3. Select the line item for the subscription you want to update.
  4. Click View Filter. The Modify Subscription page is displayed.
  5. Update the following items as needed:
    • Subscription Key—The system-generated subscription key that you will configure in the registry you are subscribing to. You can use the current subscription key or remove it. If you remove the subscription key, a new one is generated when you save changes.
    • Subscription Filter

      Simple Filter Example:

      find_business by category "Replicated Businesses" from digev.com:metadata category scheme

      Advanced Filter Example:

      <find_business xmlns="urn:uddi-org:api_v3">
<categoryBag>
<keyedReference tModelKey="uddi:digev.com:metadata" keyName="Replicated Businesses" keyValue="repl_business"/>
</categoryBag>
</find_business>
    • Max Entries—10
    • Expires After—Select an entry date from the Calendar Pop-up. For example, one month from today.
  6. (Optional) If you would like a summary of data to be retrieved, rather than complete data, check the Retrieve Data in Brief Format box.
  7. Click Apply.

View Filter

Use your mouse to hover over the View Filter link included in a Subscription line item as displayed on the Subscription Summary.

  1. Go to Configure > Registry.
  2. Click the Subscriptions tab.

    The Subscription Summary page is displayed, showing a list of registry subscriptions current defined in Policy Manager.

  3. On the line item for the subscription you want to see filter information for, hover your mouse pointer over the View For link.

    The contents of the Subscription filter for the selected entry is displayed in a pop-up window.

Delete Subscription

You can delete subscription definitions.

  1. Go to Configure > Registry.
  2. Click the Subscriptions tab.

    The Subscription Summary page is displayed, showing a list of registry subscriptions current defined in Policy Manager.

  3. Select the line item for the subscription you want to delete.
  4. Click Delete Subscription.
  5. At the confirmation message, click OK to delete the subscription from the system.