Using Dun and Bradstreet Connector in Digital Journeys

The Dun and Bradstreet Connector consists of a digital journey, client side scripts, and three endpoints. Below are the steps used when calling the connector.

1. Before calling the connector, the parameters must be set. The environment settings required for the API search are set through the below variables.

  • DUNS Lookup:

Copy 
let baseUrl = getAppSetting("FTOS_EXTD_DUNS_BaseUrl")

  • DUNS Company Profile:

Copy
let baseUrl = getAppSetting("FTOS_EXTD_DUNS_BaseUrl")
 

  • DUNS Corporate Linkage:

Copy
let baseUrl = getAppSetting("FTOS_EXTD_DUNS_CorpLinkage_BaseUrl")
    let path = getAppSetting("FTOS_EXTD_DUNS_CorpLinkage_Path")
 

2. Use the ebs.callActionByNameAsync function with FTOS_EXTD_DUNS_LOOKUP_Endpoint, FTOS_EXTD_DUNS_CorpLinkage_Endpoint, and the FTOS_EXTD_DUNS_CompProfile_Endpoint parameter when searching for certain information in the digital journey.

3. Based on the search options, the endpoint is called and the search data is returned.

  • FTOS_EXTD_DUNS_LOOKUP_Endpoint:

Copy
const connectorName = formData.formScope.connectorName
const searchLookupId = ebs.getFormData().id
let searchObject = {}

let transactionTimestamp = $('#transactionTimestamp').dxDateBox('instance').option('value')
let submittingOfficeId = $('#submittingOfficeId').dxTextBox('instance').option('value')
let dunsNumber = $('#dunsNumber').dxTextBox('instance').option('value')
let subjectName = $('#subjectName').dxTextBox('instance').option('value')
let streetAddressLine = $('#streetAddressLine').dxTextBox('instance').option('value')
let countryISOAlpha2Code = $('#countryISOAlpha2Code').dxTextBox('instance').option('value')
let territoryName = $('#territoryName').dxTextBox('instance').option('value')
let applicationTransactionId = $('#applicationTransactionId').dxTextBox('instance').option('value')
let primaryTownName = $('#primaryTownName').dxTextBox('instance').option('value')
let fullPostalCode = $('#fullPostalCode').dxTextBox('instance').option('value')
let telephoneNumber = $('#telephoneNumber').dxTextBox('instance').option('value')
let internationalDialingCode = $('#internationalDialingCode').dxTextBox('instance').option('value')
let organizationIdentificationNumber = $('#organizationIdentificationNumber').dxTextBox('instance').option('value')
let urlText = $('#urlText').dxTextBox('instance').option('value')
let emailAddress = $('#emailAddress').dxTextBox('instance').option('value')
let candidateMaximumQuantity = $('#candidateMaximumQuantity').dxTextBox('instance').option('value')
let confidenceLowerLevelThresholdValue = $('#confidenceLowerLevelThresholdValue').dxNumberBox('instance').option('value')
let exclusionCriteria = $('#exclusionCriteria').dxTextBox('instance').option('value')
let matchTypeText = $('#matchTypeText').dxTextBox('instance').option('value')
let customerReferenceText = $('#customerReferenceText').dxTextBox('instance').option('value')
let customerBillingEndorsement = $('#customerBillingEndorsement').dxTextBox('instance').option('value')
let match = $('#match').dxCheckBox('instance').option('value')

ebs.showLoadingPanel()

searchObject = {
    'searchLookupId': searchLookupId,
    'match': match,
    'transactionTimestamp': transactionTimestamp,
    'submittingOfficeID': submittingOfficeId,
    'dunsNumber': dunsNumber,
    'subjectName': subjectName,
    'streetAddressLine': streetAddressLine,
    'countryISOAlpha2Code': countryISOAlpha2Code,
    'territoryName': territoryName,
    'applicationTransactionID': applicationTransactionId,
    'primaryTownName': primaryTownName,
    'fullPostalCode': fullPostalCode,
    'telephoneNumber': telephoneNumber,
    'internationalDialingCode': internationalDialingCode,
    'organizationIdentificationNumber': organizationIdentificationNumber,
    'urlText': urlText,
    'emailAddress': emailAddress,
    'candidateMaximumQuantity': candidateMaximumQuantity,
    'confidenceLowerLevelThresholdValue': confidenceLowerLevelThresholdValue,
    'exclusionCriteria': exclusionCriteria,
    'matchTypeText': matchTypeText,
    'customerReferenceText': customerReferenceText,
    'customerBillingEndorsement': customerBillingEndorsement,
}



ebs.callActionByNameAsync('FTOS_EXTD_DUNS_LOOKUP_Endpoint', searchObject)

  • FTOS_EXTD_DUNS_CorpLinkage_Endpoint:

Copy
const connectorName = formData.formScope.connectorName
const searchLookupId = ebs.getFormData().id
let searchObject = {}

let dunsNumber = $('#DunsNumber').dxTextBox('instance').option('value')
let applicationTransactionID = $('#ApplicationTransactionID').dxTextBox('instance').option('value')
let submittingOfficeID = $('#SubmittingOfficeID').dxTextBox('instance').option('value')
let countryISOAlpha2Code = $('#CountryISOAlpha2Code').dxTextBox('instance').option('value')
let languagePreferenceCode = $('#LanguagePreferenceCode').dxTextBox('instance').option('value')
let orderReasonCode = $('#OrderReasonCode').dxTextBox('instance').option('value')
let returnTransferredToDUNSIndicator = $('#ReturnTransferredToDUNSIndicator').dxTextBox('instance').option('value')
let customerReferenceTextn = $('#CustomerReferenceTextn').dxTextBox('instance').option('value')
let customerBillingEndorsementText = $('#CustomerBillingEndorsementText').dxTextBox('instance').option('value')
let transactionTimestamp = $('#TransactionTimestamp').dxDateBox('instance').option('value')

let tradeUpIndicator = $('#TradeUpIndicator').dxCheckBox('instance').option('value')
let archiveProductOptOutIndicator = $('#ArchiveProductOptOutIndicator').dxCheckBox('instance').option('value')
let extendArchivePeriodIndicator = $('#ExtendArchivePeriodIndicator').dxCheckBox('instance').option('value')

ebs.showLoadingPanel()

searchObject = {
    'dunsNumber': dunsNumber,
    'applicationTransactionID': applicationTransactionID,
    'submittingOfficeID': submittingOfficeID,
    'countryISOAlpha2Code': countryISOAlpha2Code,
    'languagePreferenceCode': languagePreferenceCode,
    'orderReasonCode': orderReasonCode,
    'returnTransferredToDUNSIndicator': returnTransferredToDUNSIndicator,
    'customerReferenceTextn': customerReferenceTextn,
    'customerBillingEndorsementText': customerBillingEndorsementText,
    'transactionTimestamp': transactionTimestamp,
    'tradeUpIndicator': tradeUpIndicator,
    'archiveProductOptOutIndicator': archiveProductOptOutIndicator,
    'extendArchivePeriodIndicator': extendArchivePeriodIndicator,
    'searchLookupId': ebs.getFormData().id
}

ebs.callActionByNameAsync('FTOS_EXTD_DUNS_CompProfile_Endpoint', searchObject)

 

  • FTOS_EXTD_DUNS_CompProfile_Endpoint

Copy
const connectorName = formData.formScope.connectorName
const searchLookupId = ebs.getFormData().id
let searchObject = {}

let dunsNumber = $('#dunsNumber').dxTextBox('instance').option('value')
let applicationTransactionID = $('#applicationTransactionId').dxTextBox('instance').option('value')
let submittingOfficeID = $('#submittingOfficeId').dxTextBox('instance').option('value')
let countryISOAlpha2Code = $('#countryISOAlpha2Code').dxTextBox('instance').option('value')
let territinclusionDataDescriptionory = $('#inclusionDataDescription').dxTextBox('instance').option('value')
let customerReferenceText = $('#customerReferenceText').dxTextBox('instance').option('value')
let customerBillingEndorsementText = $('#customerBillingEndorsementText').dxTextBox('instance').option('value')

let transactionTimestamp = $('#transactionTimestamp').dxDateBox('instance').option('value')

let languagePreferenceCode = $('#languagePreferenceCode').dxNumberBox('instance').option('value')

let attachCompressedProductIndicator = $('#attachCompressedProductIndicator').dxCheckBox('instance').option('value')
let archiveProductOptOutIndicator = $('#archiveProductOptOutIndicator').dxCheckBox('instance').option('value')
let extendArchivePeriodIndicator = $('#extendArchivePeriodIndicator').dxCheckBox('instance').option('value')

ebs.showLoadingPanel()

searchObject = {
    'searchLookupId': searchLookupId,
    'dunsNumber': dunsNumber,
    'attachCompressedProductIndicator': attachCompressedProductIndicator,
    'applicationTransactionID' : applicationTransactionID,
    'transactionTimestamp' : transactionTimestamp,
    'submittingOfficeID' : submittingOfficeID,
    'countryISOAlpha2Code' : countryISOAlpha2Code,
    'languagePreferenceCode' : languagePreferenceCode,
    'territinclusionDataDescriptionory' : territinclusionDataDescriptionory,
    'archiveProductOptOutIndicator' : archiveProductOptOutIndicator,
    'extendArchivePeriodIndicator' : extendArchivePeriodIndicator,
    'customerReferenceText' : customerReferenceText,
    'customerBillingEndorsementText' : customerBillingEndorsementText,
}

ebs.callActionByNameAsync('FTOS_EXTD_DUNS_CorpLinkage_Endpoint', searchObject)