Monitoring Guide

The Monitoring feature provides the ability to receive notifications when changes occur to content contained in specific data products and D-U-N-S Numbers®.

D&B Direct+ data API provides access to numerous products, each with a set of attributes. Monitoring allows you to receive notifications when any of those attribute values change for the D-U-N-S Number in the registration.

For more information on the products, please see the Data Product APIs.

Monitoring

Registration

D&B Direct+ Monitoring Registrations represent a request to monitor a set of D-U-N-S Numbers against one of the D&B Direct+ Data Products. It also includes details on how notifications are to be delivered and other information necessary for monitoring.
Note: Subjects can be identified using the D-U-N-S Number (or) other subject ID type.

The D-U-N-S Numbers can be specified as:

  • List of D-U-N-S Numbers (LOD): A specific list of D-U-N-S Numbers included with the registration.
  • Using a Dun & Bradstreet Managed Universe
    • Dynamic Universe: In a dynamic Universe, D-U-N-S Numbers are identified by specified criteria defined by Dun & Bradstreet. For a list of available Universes, see the Appendix under Dun & Bradstreet Managed Universes.
      IMPORTANT: cmpbol product cannot be registered for a Dynamic Universe, can only be registered for Full Universe.
    • Full Universe: The full Dun & Bradstreet Universe.

The Subject IDs can be specified as:

  • List of Subject IDs: A specific list of Subject IDs included with the registration.
  • IMPORTANT: SBFE subjectID based Data Blocks cannot be registered for a universe.

The Monitoring Registration also allows for an optional request for a seed (or baseline) of the data to be delivered per the delivery channel configuration in the Registration.

Note: For China, due to recent regulatory changes limited data is available for online & monitoring.

Seed

A seed file provides a baseline of data for the Monitoring Registration. When you create a registration, if Seed File = True:

  • Seed generated and delivered per the Monitoring Registration settings within 7 days.
  • Seed File data is delivered in a text file with JSON formatted records conforming to that of the D&B Direct+ Platform.
  • Change notifications are initially suppressed allowing time for the seed file to be generated and processed. An unsuppress request must be issued in order to start receiving change notifications. (See the Monitoring, Suppress or Unsuppress API page.) IMPORTANT: Exception for API Pull Notifications which are not initially suppressed.

Note: Maximum file (compressed) size for Seed and Notification is 3GB. Multiple files will be delivered when output data size is more than 3GB.

Update Notifications

Change notifications provide details about changes that occur to D-U-N-S Numbers within the Monitoring Registration.

Once a registration is created and processed, regular notifications are delivered to the destination and at the frequency specified in the registration.

For STP, S3 and GCS, multiple files may be received depending on the number of notifications. The individual notifications are grouped by D-U-N-S Numbers and in date/time ascending order. A single D-U-N-S Number will never be split between multiple files. Best practice to update a single D-U-N-S Number, is to process the notifications in a file in order.

While it is unlikely, it is possible that the same D-U-N-S Number will have more than one UPDATE notification in a single package.

Cloud Platform

To create a registration to send notifications to a cloud platform, please refer to (See Create a Registration).

Please note the following is not supported for cloud platform notifications:

  • Standard Products (eg cmpelk)
  • Full Universe Registrations
  • Full Product Notification Type (update only)
  • UBO (eg cmpbol)
  • Full Family Tree

On successful creation of the registration, the following tables will automatically be created within the Cloud platform:

Naming conventions for tables will depend on the cloud platform.

Cloud platforms currently supported are:

Getting Started with Monitoring

  1. Create a Monitoring Registration for the data blocks with list of specific D-U-N-S Numbers or Universe to receive change notifications. See Create a Registration.
  2. If a seed file was requested, Customer will receive seed file (For information on its contents, see Process a Seed File). After processing seed file, unsuppress notifications to start receiving change notifications. (See the Monitoring, Suppress or Unsuppress API page.)
  3. Process change notifications. For information on the content of change notifications, see Process Change Notifications.

Monitoring Registration Process

Create Registration Flow


Monitoring Types

Direct+ offers 3 different monitoring types based on the registered product.
  • Data Blocks/Data Products have the standard functionality which includes the setting of Threshold. For the guide on Thresholds please refer here for additional details.
  • For Full Family Tree product, please refer here for additional details.
  • For UBO (cmpbol) product, please refer here for additional details.

Appendix

Below additional details are available in the appendix page:

DNB Full Logo Direct+ Product Documentation