[Beta]{class="badge informative"}

Crea una connessione sorgente SAP Commerce nell'interfaccia utente

NOTE
L'origine SAP Commerce è in versione beta. Per ulteriori informazioni sull'utilizzo di origini con etichetta beta, vedere la panoramica origini.

Il seguente tutorial illustra i passaggi necessari per creare una connessione di origine SAP Commerce per portare i contatti di SAP Subscription Billing e i dati dei clienti tramite l'interfaccia utente di Adobe Experience Platform.

Introduzione getting-started

Questo tutorial richiede una buona conoscenza dei seguenti componenti di Experience Platform:

Se disponi già di un account SAP Commerce valido, puoi saltare il resto di questo documento e passare all'esercitazione configurazione di un flusso di dati.

Raccogli le credenziali richieste gather-credentials

Per connettere SAP Commerce a Experience Platform, è necessario fornire i valori per le seguenti proprietà di connessione:

Credenziali
Descrizione
ID client
Il valore di clientId dalla chiave del servizio.
Segreto client
Il valore di clientSecret dalla chiave del servizio.
Endpoint token
Il valore di url dalla chiave del servizio sarà simile a https://subscriptionbilling.authentication.eu10.hana.ondemand.com.
Area geografica
La posizione del centro dati. L'area è presente in url e ha un valore simile a eu10 o us10. Ad esempio, se url è https://eu10.revenue.cloud.sap/api, sarà necessario eu10.

Per ulteriori informazioni, consulta la SAP Commerce documentazione.

Creare uno schema di Platform create-platform-schema

Prima di creare una connessione di origine SAP Commerce, è inoltre necessario assicurarsi di creare uno schema di Experience Platform da utilizzare per l'origine. Consulta il tutorial su creazione di uno schema di Platform per i passaggi completi sulla creazione di uno schema.

Espandi la sezione seguente per visualizzare un esempio di schema.

Visualizza esempio di schema
code language-none
{
  "_extconndev": {
    "addresses": [
      {
        "addressUUID": "{ADDRESS_UUID}",
        "city": "Burnaby",
        "country": "Canada",
        "email": "chandni@acme.com",
        "houseNumber": "27",
        "isDefault": false,
        "phone": "123-456-7890",
        "postalCode": "V3J 1X9",
        "state": "British Columbia",
        "street": "Beresford"
      }
    ],
    "changedAt": "1687204041",
    "changedBy": "vero@acme.com",
    "contactNumber": "123-456-7980",
    "corporateInfo": {
      "company": "acme"
    },
    "createAt": "1687204041",
    "createdBy": "vero@acme.com",
    "customReferences": [
      {
        "id": "Sample value",
        "typeCode": "Sample value"
      }
    ],
    "customerNumber": "Sample value",
    "customerType": "Sample value",
    "defaultAddress": {
      "addressUUID": "Sample value",
      "city": "North Vancouver",
      "country": "Canada",
      "email": "chandni@acme.come",
      "houseNumber": "34",
      "isDefault": false,
      "phone": "123-456-7890",
      "postalCode": "V7H 2P1",
      "state": "British Columbia",
      "street": "Maple"
    },
    "externalObjectReferences": [
      {
        "externalId": "{EXTERNAL_ID}",
        "externalIdTypeCode": "{EXTERNAL_ID_TYPE_CODE}",
        "externalSystemId": "{EXTERNAL_SYSTEM_ID}"
      }
    ],
    "markets": [
      {
        "active": false,
        "country": "USA",
        "currency": "USD",
        "marketId": "Sample value",
        "priceinfo": {
          "incoterms": "{INCO_TERMS}",
          "incotermsLocation": "{INCO_TERMS_LOCATION}",
          "priceGroup": "{PRICE_GROUP}",
          "priceListType": "{PRICE_LIST_TYPE}"
        },
        "salesArea": {
          "distributionChannel": "{DISTRIBUTION_CHANNEL}",
          "division": "{DIVISION}",
          "salesOrganization": "{SALES_ORGANIZATION}"
        }
      }
    ],
    "personalInfo": {
      "firstName": "Chandni",
      "lastName": "Kaur"
    }
  },
  "_id": "/uri-reference",
  "_repo": {
    "createDate": "2004-10-23T12:00:00-06:00",
    "modifyDate": "2004-10-23T12:00:00-06:00"
  },
  "createdByBatchID": "/uri-reference",
  "modifiedByBatchID": "/uri-reference",
  "personID": "{PERSON_ID}",
  "repositoryCreatedBy": "kevin@acme.com",
  "repositoryLastModifiedBy": "kevin@acme.com"
}

Connetti il tuo account SAP Commerce connect-account

Nell'interfaccia utente di Platform, seleziona Origini dalla barra di navigazione a sinistra per accedere all'area di lavoro Origini. Nella schermata Catalogo sono visualizzate diverse origini con cui è possibile creare un account.

Puoi selezionare la categoria appropriata dal catalogo sul lato sinistro dello schermo. In alternativa, è possibile trovare l’origine specifica che si desidera utilizzare utilizzando l’opzione di ricerca.

Nella categoria eCommerce, selezionare SAP Commerce, quindi Add data.

Schermata dellinterfaccia utente di Platform per il catalogo con scheda SAP Commerce

Viene visualizzata la pagina Connetti account SAP Commerce. In questa pagina è possibile utilizzare nuove credenziali o credenziali esistenti.

Account esistente existing-account

Per utilizzare un account esistente, seleziona l'account SAP Commerce con cui vuoi creare un nuovo flusso di dati, quindi seleziona Successivo per continuare.

Schermata dellinterfaccia utente di Platform per collegare laccount SAP Commerce a un account esistente

Nuovo account new-account

Se stai creando un nuovo account, seleziona Nuovo account, quindi fornisci un nome, una descrizione facoltativa e le tue credenziali. Al termine, selezionare Connetti all'origine e quindi attendere un po' di tempo per stabilire la nuova connessione.

Schermata dellinterfaccia utente di Platform per collegare laccount SAP Commerce con un nuovo account

Selezionare i dati select-data

Infine, seleziona il tipo di oggetto da acquisire in Platform.

Tipo di oggetto
Descrizione
Customers
Le entità che dispongono di sottoscrizioni.
Contacts
I dettagli di contatto per i clienti.
Clienti

Per acquisire i dati del cliente, seleziona Clienti come tipo di oggetto, quindi seleziona Successivo.

Schermata dellinterfaccia utente di Platform per SAP Commerce che mostra la configurazione con lopzione Clienti selezionata

Contatti

Per acquisire i dati di contatto, seleziona Contatti come tipo di oggetto, quindi seleziona Successivo.

Schermata dellinterfaccia utente di Platform per SAP Commerce con lopzione di configurazione con contatti selezionata

Passaggi successivi next-steps

Seguendo questa esercitazione, hai stabilito una connessione al tuo account SAP Commerce. Ora puoi continuare con l'esercitazione successiva e configurare un flusso di dati per inserire dati in Platform.

Risorse aggiuntive additional-resources

Le sezioni seguenti forniscono ulteriori risorse a cui fare riferimento quando si utilizza l'origine SAP Commerce.

Mappatura mapping

Platform fornisce consigli intelligenti per campi mappati automaticamente in base allo schema o al set di dati di destinazione selezionato. Puoi regolare manualmente le regole di mappatura in base ai tuoi casi d’uso. In base alle tue esigenze, puoi scegliere di mappare i campi direttamente o utilizzare le funzioni di preparazione dati per trasformare i dati sorgente in modo da derivare valori calcolati o calcolati. Per i passaggi completi sull'utilizzo dell'interfaccia mapper e dei campi calcolati, consulta la guida dell'interfaccia utente della preparazione dati.

Le configurazioni di mappatura per il flusso di dati variano a seconda dello schema e del tipo di oggetto selezionato per l’acquisizione.

Clienti

Per i dati del cliente, SAP Commerce utilizza gli endpoint clienti e relazioni cliente-contatti dell'API SAP Business Partners per recuperare i dati

Di seguito è riportato un esempio di configurazioni di mappatura per il flusso di dati SAP Commerce per i dati dei clienti:

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 10-row-2 11-row-2 12-row-2 13-row-2
Campo di destinazione Descrizione
customerNumber Il numero del cliente.
corporateInfo Il numero del cliente.
customerType Il tipo di cliente.
createdAt Un timestamp che indica quando è stato creato il cliente.
changedAt Un timestamp che indica quando il cliente è stato aggiornato l’ultima volta.
markets[*].country I mercati dei clienti, recuperati come oggetto array.
addresses[*].email Le e-mail associate ai diversi indirizzi del cliente, recuperate come oggetto array.
addresses[*].city Città associate ai diversi indirizzi del cliente, recuperate come oggetto array.
addresses[*].addressUUID L’ID è associato ai diversi indirizzi del cliente, recuperati come oggetto array.
externalObjectReferences[*].externalSystemId Dati aggiuntivi, recuperati come oggetto array.
externalObjectReferences[*].externalId Dati aggiuntivi, recuperati come oggetto array.
customReferences[*].id Dati aggiuntivi, recuperati come oggetto array.
customReferences[*].typeCode Dati aggiuntivi, recuperati come oggetto array.

Passaggio di mappatura del flusso di lavoro di origine.

Contatti

Per i dati di contatto, SAP Commerce utilizza l'endpoint contacts dell'API SAP Business Partners per recuperare i dati.

Di seguito è riportato un esempio di configurazioni di mappatura per il flusso di dati SAP Commerce per i dati di contatto:

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2
Campo di destinazione Descrizione
contactNumber Il numero del contatto.
createdAt Timestamp che indica quando è stato creato il contatto.
changedAt Timestamp che indica quando è stato eseguito l’ultimo aggiornamento del contatto.
personalInfo.lastName Cognome del contatto.
personalInfo.firstName Nome del contatto.
externalObjectReferences[*].externalSystemId Dati aggiuntivi, recuperati come oggetto array.
externalObjectReferences[*].externalId Dati aggiuntivi, recuperati come oggetto array.
externalObjectReferences[*].externalIdTypeCode Dati aggiuntivi, recuperati come oggetto array.

Passaggio di mappatura del flusso di lavoro di origine.

recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089