[Beta]{class="badge informative"}

Crear una conexión de origen SAP Commerce en la interfaz de usuario

NOTE
El origen SAP Commerce está en la versión beta. Consulte la descripción general de orígenes para obtener más información sobre el uso de orígenes etiquetados como beta.

El siguiente tutorial lo acompañará durante los pasos para crear una conexión de origen de SAP Commerce con el fin de obtener contactos y datos de clientes de SAP Facturación de suscripción mediante la interfaz de usuario de Adobe Experience Platform.

Introducción getting-started

Este tutorial requiere una comprensión práctica de los siguientes componentes de Experience Platform:

Si ya tiene una cuenta de SAP Commerce válida, puede omitir el resto de este documento y continuar con el tutorial sobre configuración de un flujo de datos.

Recopilar credenciales necesarias gather-credentials

Para conectar SAP Commerce al Experience Platform, debe proporcionar valores para las siguientes propiedades de conexión:

Credencial
Descripción
ID de cliente
El valor de clientId de la clave de servicio.
Secreto del cliente
El valor de clientSecret de la clave de servicio.
Extremo de token
El valor de url de la clave de servicio será similar a https://subscriptionbilling.authentication.eu10.hana.ondemand.com.
Región
Su ubicación del centro de datos. La región está presente en url y tiene un valor similar a eu10 o us10. Por ejemplo, si url es https://eu10.revenue.cloud.sap/api, necesitará eu10.

Para obtener más información, consulte la SAP Commerce documentación.

Creación de un esquema de Platform create-platform-schema

Antes de crear una conexión de origen de SAP Commerce, también debe asegurarse de crear primero un esquema de Experience Platform para utilizarlo en el origen. Consulte el tutorial de creación de un esquema de Platform para ver los pasos detallados sobre cómo crear un esquema.

Expanda la siguiente sección para ver un esquema de ejemplo.

Ver ejemplo de esquema
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"
}

Conectar su cuenta de SAP Commerce connect-account

En la interfaz de usuario de Platform, seleccione Sources en la barra de navegación izquierda para acceder al área de trabajo Sources. La pantalla Catálogo muestra una variedad de orígenes con los que puede crear una cuenta.

Puede seleccionar la categoría adecuada del catálogo en la parte izquierda de la pantalla. También puede encontrar la fuente específica con la que desea trabajar utilizando la opción de búsqueda.

En la categoría eCommerce, seleccione SAP Commerce y, a continuación, seleccione Agregar datos.

Captura de pantalla de IU de Platform para el catálogo con la tarjeta SAP Commerce

Aparecerá la página Conectar cuenta de SAP Commerce. En esta página, puede usar credenciales nuevas o existentes.

Cuenta existente existing-account

Para usar una cuenta existente, seleccione la cuenta de SAP Commerce con la que desee crear un nuevo flujo de datos y, a continuación, seleccione Siguiente para continuar.

Captura de pantalla de la IU de Platform para conectar la cuenta de SAP Commerce con una cuenta existente

Nueva cuenta new-account

Si va a crear una cuenta nueva, seleccione Cuenta nueva y, a continuación, proporcione un nombre, una descripción opcional y sus credenciales. Cuando termine, seleccione Conectarse al origen y deje pasar un tiempo para que se establezca la nueva conexión.

Captura de pantalla de la IU de Platform para conectar la cuenta de SAP Commerce con una nueva cuenta

Seleccionar datos select-data

Finalmente, debe seleccionar el tipo de objeto que desea introducir en Platform.

Tipo de objeto
Descripción
Customers
Las entidades que tienen suscripciones.
Contacts
Los datos de contacto de los clientes.
Clientes

Para introducir datos de clientes, selecciona Clientes como tipo de objeto y, a continuación, selecciona Siguiente.

Captura de pantalla de IU de Platform para SAP Commerce que muestra la configuración con la opción Customers seleccionada

Contactos

Para introducir datos de contacto, selecciona Contactos como tipo de objeto y, a continuación, selecciona Siguiente.

Captura de pantalla de IU de Platform para SAP Commerce que muestra la configuración con la opción Contactos seleccionada

Pasos siguientes next-steps

Al seguir este tutorial, ha establecido una conexión con su cuenta de SAP Commerce. Ahora puede continuar con el siguiente tutorial y configurar un flujo de datos para introducir datos en la plataforma.

Recursos adicionales additional-resources

Las secciones siguientes proporcionan recursos adicionales a los que puede hacer referencia al usar el origen SAP Commerce.

Asignación mapping

Platform proporciona recomendaciones inteligentes para campos asignados automáticamente en función del esquema o el conjunto de datos de destino seleccionado. Puede ajustar manualmente las reglas de asignación para adaptarlas a sus casos de uso. En función de sus necesidades, puede elegir asignar campos directamente o utilizar funciones de preparación de datos para transformar los datos de origen y derivar valores calculados o calculados. Para ver los pasos detallados sobre el uso de la interfaz de asignador y los campos calculados, consulte la guía de la interfaz de usuario de la preparación de datos.

Las configuraciones de asignación para el flujo de datos variarán según el esquema y el tipo de objeto que seleccione para la ingesta.

Clientes

Para los datos del cliente, SAP Commerce usa los extremos de clientes y relaciones cliente-contactos de la API SAP Business Partners para recuperar los datos

A continuación se muestra un ejemplo de asignación de configuraciones para el flujo de datos SAP Commerce para los datos del cliente:

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 de destino Descripción
customerNumber El número del cliente.
corporateInfo El número del cliente.
customerType El tipo de cliente.
createdAt Una marca de tiempo que indica cuándo se creó el cliente.
changedAt Una marca de tiempo que indica cuándo se actualizó el cliente por última vez.
markets[*].country Los mercados de clientes, recuperados como un objeto de matriz.
addresses[*].email Correos electrónicos asociados a las múltiples direcciones del cliente, recuperados como objeto de matriz.
addresses[*].city Ciudades asociadas con las varias direcciones del cliente, recuperadas como un objeto de matriz.
addresses[*].addressUUID ID asociados con las varias direcciones del cliente, recuperados como un objeto de matriz.
externalObjectReferences[*].externalSystemId Datos adicionales, recuperados como un objeto de matriz.
externalObjectReferences[*].externalId Datos adicionales, recuperados como un objeto de matriz.
customReferences[*].id Datos adicionales, recuperados como un objeto de matriz.
customReferences[*].typeCode Datos adicionales, recuperados como un objeto de matriz.

Paso de asignación del flujo de trabajo de orígenes.

Contactos

Para los datos de contacto, SAP Commerce usa el extremo contacts de la API SAP Business Partners para recuperar los datos.

A continuación se muestra un ejemplo de asignación de configuraciones para el flujo de datos SAP Commerce para los datos de contacto:

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 de destino Descripción
contactNumber El número del contacto.
createdAt Una marca de tiempo que indica cuándo se creó el contacto.
changedAt Una marca de tiempo que indica cuándo se actualizó el contacto por última vez.
personalInfo.lastName Apellido del contacto. - ¿Qué?
personalInfo.firstName El nombre del contacto.
externalObjectReferences[*].externalSystemId Datos adicionales, recuperados como un objeto de matriz.
externalObjectReferences[*].externalId Datos adicionales, recuperados como un objeto de matriz.
externalObjectReferences[*].externalIdTypeCode Datos adicionales, recuperados como un objeto de matriz.

Paso de asignación del flujo de trabajo de orígenes.

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