Actividad de carga de Salesforce Einstein Analytics

Introducción

Una actividad Cargar de Salesforce Einstein Analytics, que utiliza su conexión de Salesforce Einstein Analytics, coloca un objeto en Salesforce CRM Analytics y está destinado a usarse como destino para consumir datos en una operación.

Nota

Salesforce Einstein Analytics es el nombre anterior de Salesforce CRM Analytics.

Crear una actividad de carga de Salesforce Einstein Analytics

Se crea una instancia de una actividad Cargar de Salesforce Einstein Analytics desde una conexión de Salesforce Einstein Analytics utilizando su tipo de actividad Cargar.

Para crear una instancia de una actividad, arrastre el tipo de actividad al tela de diseño o copie el tipo de actividad y péguelo en el tela de diseño. Para obtener más información, consulte Crear una instancia de actividad o herramienta en Reutilización de componentes.

Se puede editar una actividad Cargar de Salesforce Einstein Analytics existente desde estas ubicaciones:

• El tela de diseño (vea menú de acciones del componente en Lienzo de diseño).
• La pestaña Componentes del panel del proyecto (vea menú de acciones de componentes en la pestañaComponentes del panel Proyecto).

Configurar una actividad de carga de Salesforce Einstein Analytics

Siga estos pasos para configurar una actividad Cargar de Salesforce Einstein Analytics:

• Paso 1: Ingrese un nombre y especifique la configuración de la aplicación
  Proporcione un nombre para la actividad y especifique la aplicación (carpeta) existente o nueva para cargar los datos.

• Paso 2: Especifique la configuración del conjunto de datos
  Especifique el conjunto de datos existente o nuevo para cargar los datos.

• Paso 3: Seleccione el método de carga
  Seleccione el método de carga entre un archivo sin procesar o un mapeo directo desde una transformación.

• Paso 4: Revise los esquemas de datos
  Se muestran todos los esquemas de solicitud o respuesta generados desde el extremo.

Paso 1: Ingrese un nombre y especifique la configuración de la aplicación

En este paso, proporcione un nombre para la actividad y especifique la aplicación (carpeta) existente o nueva para cargar los datos. A continuación, se describe cada elemento de la interfaz de usuario de este paso.

La interfaz utilizada en este paso de la configuración de una actividad Cargar de Salesforce Einstein Analytics depende de la opción Aplicación existente o nueva seleccionada:

• Usar aplicación existente: Para esta opción, seleccionará de una lista de aplicaciones completadas desde la instancia de Salesforce.
• Crear aplicación si no existe: Para esta opción, ingresará el nombre de una nueva aplicación que se creará en la instancia de Salesforce.

Usar aplicación existente

Si se selecciona Usar aplicación existente para Aplicación existente o nueva, se presenta esta interfaz:

• Nombre: Ingrese un nombre para identificar la actividad. El nombre debe ser único para cada actividad de Carga de Salesforce Einstein Analytics y no debe contener barras diagonales. /o dos puntos :.

• Aplicación existente o nueva: Especifique la aplicación existente o nueva que se utilizará, una de las opciones Usar aplicación existente o Crear aplicación si no existe.

  • Usar aplicación existente: Para esta opción, seleccionará de una lista de aplicaciones completadas desde la instancia de Salesforce.
  • Crear aplicación si no existe: Para esta opción, ingresará el nombre de una nueva aplicación que se creará en la instancia de Salesforce.

• Seleccionar una carpeta: Seleccione una aplicación existente. Si no existe ninguna, deberá cambiar a Crear aplicación si no existe: O crear una nueva aplicación manualmente en Salesforce CRM Analytics.

• Guardar y salir: Si está habilitado, haga clic para guardar la configuración de este paso y cerrar la configuración de la actividad.

• Siguiente: Haga clic para guardar temporalmente la configuración de este paso y continuar con el siguiente. La configuración no se guardará hasta que haga clic en el botón Finalizado en el último paso.

• Descartar cambios: Después de realizar los cambios, haga clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje le solicitará que confirme que desea descartar los cambios.

Crear aplicación si no existe

Si se selecciona Crear aplicación si no existe para Aplicación existente o nueva, se presenta esta interfaz:

• Nombre: Ingrese un nombre para identificar la actividad. El nombre debe ser único para cada actividad de Carga de Salesforce Einstein Analytics y no debe contener barras diagonales. /o dos puntos :.

• Aplicación existente o nueva: Especifique la aplicación existente o nueva que se utilizará, una de las opciones Usar aplicación existente o Crear aplicación si no existe.

  • Usar aplicación existente: Para esta opción, seleccionará de una lista de aplicaciones completadas desde la instancia de Salesforce.
  • Crear aplicación si no existe: Para esta opción, ingresará el nombre de una nueva aplicación que se creará en la instancia de Salesforce.

• Nombre de la aplicación: El nombre de la nueva aplicación.

• Guardar y salir: Si está habilitado, haga clic para guardar la configuración de este paso y cerrar la configuración de la actividad.

• Siguiente: Haga clic para guardar temporalmente la configuración de este paso y continuar con el siguiente. La configuración no se guardará hasta que haga clic en el botón Finalizado en el último paso.

• Descartar cambios: Después de realizar los cambios, haga clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje le solicitará que confirme que desea descartar los cambios.

Paso 2: Especificar la configuración del conjunto de datos

En este paso, especifique el conjunto de datos existente o nuevo para cargar datos. A continuación, se describe cada elemento de la interfaz de usuario de este paso.

La interfaz utilizada en este paso de la configuración de una actividad Cargar de Salesforce Einstein Analytics depende de la opción Usar conjunto de datos existente o nuevo seleccionada:

• Utilizar un conjunto de datos existente: Para esta opción, deberá seleccionar de una lista de conjuntos de datos generados a partir de la instancia de Salesforce. Los conjuntos de datos que se muestran están asociados con la aplicación seleccionada en el paso anterior.
• Crear conjunto de datos si no existe: Para esta opción, ingresará el nombre de un nuevo conjunto de datos que se creará en la instancia de Salesforce.

Utilice un conjunto de datos existente

Si se selecciona Usar conjunto de datos existente o nuevo para Usar conjunto de datos existente o nuevo, se presenta esta interfaz:

• Usar conjunto de datos existente o nuevo: Especifique el conjunto de datos existente o nuevo que se utilizará, uno de los siguientes: Usar un conjunto de datos existente o Crear conjunto de datos si no existe.

  • Usar un conjunto de datos existente: Para esta opción, deberá seleccionar de una lista de conjuntos de datos generados a partir de la instancia de Salesforce. Los conjuntos de datos que se muestran están asociados con la aplicación seleccionada en el paso anterior.
  • Crear conjunto de datos si no existe: Para esta opción, ingresará el nombre de un nuevo conjunto de datos que se creará en la instancia de Salesforce.

• Seleccionar un conjunto de datos: Seleccione un conjunto de datos existente en función de la aplicación elegida en el paso anterior. Si no existe ninguno, deberá cambiar a Crear conjunto de datos si no existe: O crear un nuevo conjunto de datos manualmente en Salesforce CRM Analytics.

• Operación: Especifique la operación de datos que se utilizará en el conjunto de datos existente, una de las siguientes: Sobrescribir, Anexar, Insertar o Eliminar. Sobrescribir está seleccionado de manera predeterminada.

• Atrás: Haga clic para almacenar temporalmente la configuración de este paso y regresar al paso anterior.

• Siguiente: Haga clic para guardar temporalmente la configuración de este paso y continuar con el siguiente. La configuración no se guardará hasta que haga clic en el botón Finalizado en el último paso.

• Descartar cambios: Después de realizar los cambios, haga clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje le solicitará que confirme que desea descartar los cambios.

Crear conjunto de datos si no existe

Si se selecciona Crear conjunto de datos si no existe para Usar conjunto de datos existente o nuevo, se presenta esta interfaz:

Consejo

Campos con un icono variable Admite el uso de variables globales, variables del proyecto y variables Jitterbit. Comience escribiendo un corchete abierto [ en el campo o haciendo clic en el ícono de variable para mostrar una lista de las variables existentes para elegir.

• Usar conjunto de datos existente o nuevo: Especifique el conjunto de datos existente o nuevo que se utilizará, uno de los siguientes: Usar un conjunto de datos existente o Crear conjunto de datos si no existe.

  • Usar un conjunto de datos existente: Para esta opción, deberá seleccionar de una lista de conjuntos de datos generados a partir de la instancia de Salesforce. Los conjuntos de datos que se muestran están asociados con la aplicación seleccionada en el paso anterior.
  • Crear conjunto de datos si no existe: Para esta opción, ingresará la información para que se cree un nuevo conjunto de datos en la instancia de Salesforce.

• Nombre del conjunto de datos que se creará: El nombre del nuevo conjunto de datos.

• Descripción: La descripción del nuevo conjunto de datos.

• Valor numérico predeterminado: El valor predeterminado para los campos numéricos en el nuevo conjunto de datos. Este valor se establece en 0 De forma predeterminada. Para obtener más información, consulte Referencia de formato de metadatos de datos externos en la documentación de Salesforce.

• Precisión numérica: La cantidad máxima de dígitos permitidos para los campos numéricos en el nuevo conjunto de datos. Este valor debe estar entre 1 y 18 de manera inclusiva y se establece en 2 De forma predeterminada. Para obtener más información, consulte Referencia de formato de metadatos de datos externos en la documentación de Salesforce.

• Escala numérica: La cantidad de dígitos a la derecha del punto decimal en los campos numéricos del nuevo conjunto de datos. Este valor debe ser menor que el valor establecido en Precisión numérica y se establece en 2 De forma predeterminada. Para obtener más información, consulte Referencia de formato de metadatos de datos externos en la documentación de Salesforce.

• Formato de fecha: Especifique el formato de fecha que se utilizará en el nuevo conjunto de datos. El formato se establece en yyyy-MM-dd de forma predeterminada, pero se pueden agregar nuevas opciones según Pautas para formatear fechas en la documentación de Salesforce.

• Campos de metadatos del conjunto de datos: Especifique los campos de metadatos que se incluirán en la carga asociada con el nuevo conjunto de datos.

  Importante

  Los campos de la tabla Campos de metadatos del conjunto de datos muestran el ícono de variable Solo en modo de edición. Para que los valores de las variables de estos campos se completen en tiempo de ejecución, la versión del agente debe ser al menos 10.75 / 11.13.

• Atrás: Haga clic para almacenar temporalmente la configuración de este paso y volver al paso anterior.

• Siguiente: Haga clic para almacenar temporalmente la configuración de este paso y continuar con el siguiente paso. La configuración no se guardará hasta que haga clic en el botón Terminado en el último paso.

• Descartar cambios: Después de realizar cambios, haga clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje le solicitará que confirme que desea descartar los cambios.

Paso 3: Seleccione el método de carga

En este paso, seleccione el método de carga entre un archivo sin procesar o la asignación directa desde una transformación. A continuación, se describe cada elemento de la interfaz de usuario de este paso.

• Enfoque: Seleccione el enfoque de carga que se utilizará, uno de Archivo o Asignación directa. Esta configuración afecta el esquema de datos resultante.

• Atrás: Haga clic para almacenar temporalmente la configuración de este paso y regresar al paso anterior.

• Siguiente: Haga clic para guardar temporalmente la configuración de este paso y continuar con el siguiente. La configuración no se guardará hasta que haga clic en el botón Finalizado en el último paso.

• Descartar cambios: Después de realizar los cambios, haga clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje le solicitará que confirme que desea descartar los cambios.

Paso 4: Revisar los esquemas de datos

Se muestran todos los esquemas de solicitud o respuesta generados desde el extremo. A continuación, se describe cada elemento de la interfaz de usuario de este paso.

Estas subsecciones describen las estructuras de solicitud y respuesta para cada combinación de enfoque y tipo de etapa:

• Aproximación del archivo
• Enfoque de mapeo directo

Estas acciones están disponibles con cada enfoque:

• Esquemas de datos: Estos esquemas de datos son heredados por transformaciones adyacentes y se muestran nuevamente durante el mapeo de transformación.

  Nota

  Los datos suministrados en una transformación tienen prioridad sobre la configuración de la actividad.

  El conector de Salesforce Einstein Analytics utiliza la API SOAP de Salesforce. Consulte la documentación de la API para obtener información sobre los nodos y campos del esquema.

• Actualizar: Haga clic en el icono de actualización o la palabra Actualizar para regenerar esquemas desde el extremo de Salesforce Einstein Analytics. Esta acción también regenera un esquema en otras ubicaciones en todo el proyecto donde se hace referencia al mismo esquema, como en una transformación adyacente.

• Atrás: Haga clic para almacenar temporalmente la configuración de este paso y regresar al paso anterior.

• Terminado: Haga clic para guardar la configuración de todos los pasos y cerrar la configuración de la actividad.

• Descartar cambios: Después de realizar los cambios, haga clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje le solicitará que confirme que desea descartar los cambios.

Enfoque de archivo

Si el enfoque es Archivo, los esquemas de datos de solicitud y respuesta constan de estos nodos y campos:

• Solicitud

  Campo/nodo del esquema de solicitud	Notas
  loadRequest	Nodo que representa la solicitud de carga.
  data	Datos asociados a la solicitud de carga.
  metadata	Metadatos obligatorios asociados con la solicitud de carga. Para obtener más información, consulte Formato de metadatos de Salesforce.

• Respuesta

  Campo/nodo del esquema de respuesta	Notas
  loadResponse	Nodo que representa la respuesta de carga.
  id	ID asociado a la respuesta de carga.
  errors	Nodo que representa errores en la respuesta de carga.
  item	Nodo que representa un único error.
  errorCode	Código asociado a un error.
  errorMessage	Mensaje asociado a un error.

Enfoque de mapeo directo

Si el enfoque es Mapeo directo, los esquemas de datos de solicitud y respuesta constan de estos nodos y campos:

• Solicitud

  Campo/nodo del esquema de solicitud	Notas
  loadRequest	Nodo que representa la solicitud de carga.
  dataset	Nodo que representa el conjunto de datos en la solicitud de carga.
  item	Nodo que representa un elemento del conjunto de datos.
  field	Un campo con nombre asociado con el conjunto de datos.
  metadata	Metadatos obligatorios asociados con la solicitud de carga. Para obtener más información, consulte Formato de metadatos de Salesforce.

• Respuesta

  Campo/nodo del esquema de respuesta	Notas
  loadResponse	Nodo que representa la respuesta de carga.
  id	ID asociado a la respuesta de carga.
  errors	Nodo que representa errores en la respuesta de carga.
  item	Nodo que representa un único error.
  errorCode	Código asociado a un error.
  errorMessage	Mensaje asociado a un error.

Formato de metadatos de Salesforce

La actividad Cargar requiere metadatos (en el esquema de solicitud) metadata campo) para cargar datos en Salesforce CRM Analytics.

Un ejemplo de metadatos formateados correctamente:

{
    "fileFormat": {
        "charsetName": "UTF-8",
        "numberOfLinesToIgnore": 0
    },
    "objects": [
        {
            "connector": "Jitterbit",
            "description": "",
            "fullyQualifiedName": "Record",
            "label": "Record",
            "name": "Record",
            "fields": [
                {
                    "description": "",
                    "fullyQualifiedName": "Record.Name",
                    "label": "Name",
                    "name": "Name",
                    "isSystemField": false,
                    "defaultValue": "",
                    "isUniqueId": false,
                    "isMultiValue": false,
                    "type": "Text",
                    "precision": null,
                    "scale": null,
                    "format": ""
                },
                {
                    "description": "",
                    "fullyQualifiedName": "Record.Id",
                    "label": "Id",
                    "name": "Id",
                    "isSystemField": false,
                    "defaultValue": "",
                    "isUniqueId": false,
                    "isMultiValue": false,
                    "type": "Text",
                    "precision": null,
                    "scale": null,
                    "format": ""
                }
            ]
        }
    ]
}

Importante

Los metadatos solo pueden contener una definición de objeto.

Para obtener información detallada sobre cada campo de metadatos posible, consulte Referencia de formato de metadatos de datos externos en la documentación de Salesforce.

Próximos pasos

Después de configurar una actividad Cargar de Salesforce Einstein Analytics, complete la configuración de la operación agregando y configurando otras actividades o herramientas como pasos de la operación. También puede configurar los ajustes de la operación, que incluyen la capacidad de encadenar operaciones que se encuentran en el mismo flujo de trabajo o en flujos de trabajo diferentes.

Se puede acceder a las acciones del menú de una actividad desde el panel del proyecto y el tela de diseño. Para obtener más información, consulte menú de acciones de la actividad en Conceptos básicos del conector.

Las actividades Carga de Salesforce Einstein Analytics se pueden usar como destino con estos patrones de operación:

• Patrón de Transformación
• Patrón de dos transformaciones (como primer o segundo objetivo)

Para utilizar la actividad con funciones de script, escriba los datos en una ubicación temporal y luego use esa ubicación temporal en la función de script.

Cuando esté listo, desplegar y ejecute la operación y validar el comportamiento comprobando los registros de operación.