Saltar al contenido

Actividad de Carga de Salesforce Einstein Analytics

Introducción

Una actividad de Carga de Salesforce Einstein Analytics, utilizando su conexión de Salesforce Einstein Analytics, coloca un objeto en Salesforce CRM Analytics y está destinada a ser utilizada como un objetivo para consumir datos en una operación.

Nota

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

Crear una actividad de Carga de Salesforce Einstein Analytics

Una instancia de una actividad de Carga de Salesforce Einstein Analytics se crea a partir de una conexión de Salesforce Einstein Analytics utilizando su tipo de actividad Carga.

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

Una actividad de Carga de Salesforce Einstein Analytics existente se puede editar desde estas ubicaciones:

Configurar una actividad de Carga de Salesforce Einstein Analytics

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

Paso 1: Ingresa un nombre y especifica la configuración de la aplicación

En este paso, proporciona un nombre para la actividad y especifica la aplicación (carpeta) existente o nueva para cargar datos. Cada elemento de la interfaz de usuario de este paso se describe a continuación.

La interfaz utilizada en este paso de la configuración de una actividad de Carga de Salesforce Einstein Analytics depende de la opción Aplicación Existente o Nueva seleccionada:

Usar aplicación existente

Si se selecciona Usar Aplicación Existente para Aplicación Existente o Nueva, se presenta la interfaz descrita a continuación.

  • Nombre: Ingresa 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: Especifica la aplicación existente o nueva que se utilizará, una de Usar Aplicación Existente o Crear Aplicación si No Existe.

    • Usar Aplicación Existente: Para esta opción, seleccionarás de una lista de aplicaciones pobladas desde la instancia de Salesforce.
    • Crear Aplicación si No Existe: Para esta opción, ingresarás el nombre de una nueva aplicación que se creará en la instancia de Salesforce.

  • Seleccionar una Carpeta: Selecciona una aplicación existente. Si no existen, necesitarás 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, haz clic para guardar la configuración de este paso y cerrar la configuración de la actividad.

  • Siguiente: Haga clic para almacenar temporalmente la configuración de este paso y continuar al siguiente paso. 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 cambios, haga clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje le pide que confirme que desea descartar los cambios.

Crear app si no existe

Si se selecciona Crear App si no existe para App Existente o Nueva, se presenta la interfaz descrita a continuación.

  • 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 inclinadas / o dos puntos :.

  • App Existente o Nueva: Especifique la app existente o nueva que se utilizará, una de Usar App Existente o Crear App si no existe.

    • Usar App Existente: Para esta opción, seleccionará de una lista de apps poblada desde la instancia de Salesforce.
    • Crear App si no existe: Para esta opción, ingresará el nombre de una nueva app que se creará en la instancia de Salesforce.

  • Nombre de la App: El nombre de la nueva app.

  • 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 almacenar temporalmente la configuración de este paso y continuar al siguiente paso. 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 cambios, haga clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje le pide que confirme que desea descartar los cambios.

Paso 2: Especificar configuraciones del conjunto de datos

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

La interfaz utilizada en este paso de la configuración de una actividad de Carga de Salesforce Einstein Analytics depende de la opción Usar Conjunto de Datos Existente o Nuevo seleccionada:

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

Usar 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 la interfaz descrita a continuación.

  • Usar Conjunto de Datos Existente o Nuevo: Especifica el uso de un conjunto de datos existente o nuevo que se utilizará, uno de Usar un Conjunto de Datos Existente o Crear Conjunto de Datos si No Existe.

    • Usar un Conjunto de Datos Existente: Para esta opción, seleccionarás de una lista de conjuntos de datos poblados desde la instancia de Salesforce. Los conjuntos de datos mostrados están asociados con la aplicación seleccionada en el paso anterior.
    • Crear Conjunto de Datos si No Existe: Para esta opción, ingresarás el nombre de un nuevo conjunto de datos que se creará en la instancia de Salesforce.

  • Seleccionar un Conjunto de Datos: Selecciona un conjunto de datos existente basado en la aplicación elegida en el paso anterior. Si no existen, necesitarás cambiar a Crear Conjunto de Datos si No Existe: o crear un nuevo conjunto de datos manualmente en Salesforce CRM Analytics.

  • Operación: Especifica la operación de datos que se utilizará en el conjunto de datos existente, una de Sobrescribir, o Agregar, o Upsert, o Eliminar. Sobrescribir está seleccionado por defecto.

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

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

  • Descartar Cambios: Después de realizar cambios, haz clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje te pedirá que confirmes que deseas 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 la interfaz descrita a continuación.

Consejo

Los campos con un ícono de variable admiten el uso de variables globales, variables de proyecto y variables de Jitterbit. Comience escribiendo un corchete cuadrado abierto [ en el campo o haciendo clic en el ícono de variable para mostrar un menú con las variables existentes para elegir.

  • Usar Conjunto de Datos Existente o Nuevo: Especifique el uso de un conjunto de datos existente o nuevo, uno de Usar un Conjunto de Datos Existente o Crear Conjunto de Datos si No Existe.

    • Usar un Conjunto de Datos Existente: Para esta opción, seleccionará de una lista de conjuntos de datos poblados desde la instancia de Salesforce. Los conjuntos de datos mostrados 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 un nuevo conjunto de datos que se creará en la instancia de Salesforce.

  • Nombre del Conjunto de Datos a Crear: El nombre del nuevo conjunto de datos.

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

  • Valor Predeterminado Numérico: El valor predeterminado para los campos numéricos en el nuevo conjunto de datos. Este valor se establece en 0 por defecto. Para más información, consulte Referencia del Formato de Metadatos de Datos Externos en la documentación de Salesforce.

  • Precisión Numérica: El número máximo de dígitos permitidos para los campos numéricos en el nuevo conjunto de datos. Este valor debe estar entre 1 y 18 inclusive y se establece en 2 por defecto. Para más información, consulte Referencia del Formato de Metadatos de Datos Externos en la documentación de Salesforce.

  • Escala Numérica: El número de dígitos a la derecha del punto decimal en los campos numéricos en el nuevo conjunto de datos. Este valor debe ser menor que el valor establecido en Precisión Numérica y se establece en 2 por defecto. Para más información, consulta la Referencia de Formato de Metadatos de Datos Externos en la documentación de Salesforce.

  • Formato de Fecha: Especifica el formato de fecha que se utilizará en el nuevo conjunto de datos. El formato se establece en yyyy-MM-dd por defecto, pero se pueden agregar nuevas opciones basadas en las Directrices para Formatear Fechas en la documentación de Salesforce.

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

    Importante

    Los campos en 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 variable de estos campos se completen en tiempo de ejecución, la versión del agente debe ser al menos 10.75 / 11.13.

    Los campos en la tabla Campos de Metadatos del Conjunto de Datos no admiten el uso de variables para pasar JSON sin procesar. Si tu caso de uso no admite definir JSON sin procesar en los campos directamente, escapa el contenido JSON antes de pasarlo con una variable. Por ejemplo, escapar {"success": "true"}; se convierte en {\"success\": \"true\"};.

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

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

  • Descartar Cambios: Después de realizar cambios, haz clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje te pide que confirmes que deseas descartar los cambios.

Paso 3: Seleccionar el enfoque de carga

En este paso, selecciona el enfoque de carga entre un archivo en bruto o un mapeo directo de una transformación. Cada elemento de la interfaz de usuario de este paso se describe a continuación.

  • Enfoque: Selecciona el enfoque de carga a utilizar, uno de Archivo o Mapeo Directo. Esta configuración afecta el esquema de datos resultante.

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

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

  • Descartar Cambios: Después de realizar cambios, haz clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje te pide que confirmes que deseas descartar los cambios.

Paso 4: Revisar los esquemas de datos

Cualquier esquema de solicitud o respuesta generado desde el punto final se muestra. Cada elemento de la interfaz de usuario de este paso se describe a continuación.

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

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 transformaciones.

    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. Consulta la documentación de la API para obtener información sobre los nodos y campos del esquema.

  • Actualizar: Haz clic en el ícono de actualizar o en la palabra Actualizar para regenerar esquemas desde el punto final de Salesforce Einstein Analytics. Esta acción también regenera un esquema en otras ubicaciones a lo largo del proyecto donde se hace referencia al mismo esquema, como en una transformación adyacente.

  • Volver: Haz clic para almacenar temporalmente la configuración de este paso y regresar al paso anterior.

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

  • Descartar Cambios: Después de realizar cambios, haz clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje te pide que confirmes que deseas 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 con la solicitud de carga.
    metadata Metadatos requeridos asociados con la solicitud de carga. Para más información, consulta el formato de metadatos de Salesforce.

  • Respuesta

    Campo/Nodo del Esquema de Respuesta Notas
    loadResponse Nodo que representa la respuesta de carga.
    id ID asociado con la respuesta de carga.
    errors Nodo que representa errores en la respuesta de carga.
    item Nodo que representa un solo error.
    errorCode Código asociado con un error.
    errorMessage Mensaje asociado con 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 nombrado asociado con el conjunto de datos.
    metadata Metadatos requeridos asociados con la solicitud de carga. Para más información, consulta el formato de metadatos de Salesforce.

  • Respuesta

    Campo/Nodo del Esquema de Respuesta Notas
    loadResponse Nodo que representa la respuesta de carga.
    id ID asociado con la respuesta de carga.
    errors Nodo que representa errores en la respuesta de carga.
    item Nodo que representa un solo error.
    errorCode Código asociado con un error.
    errorMessage Mensaje asociado con un error.

Formato de metadatos de Salesforce

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

Un ejemplo de metadatos correctamente formateados:

{
    "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 pueden contener solo una definición de objeto.

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

Próximos pasos

Después de configurar una actividad de Carga de Salesforce Einstein Analytics, complete la configuración de la operación agregando y configurando otras actividades o herramientas como pasos de operación. También puede configurar la configuración de la operación, que incluye la capacidad de encadenar operaciones que están en los mismos o diferentes flujos de trabajo.

Las acciones del menú para una actividad son accesibles desde el panel del proyecto y el lienzo de diseño. Para más detalles, consulte el menú de acciones de actividad en Conceptos básicos de conectores.

Las actividades de Carga de Salesforce Einstein Analytics se pueden utilizar como un objetivo con estos patrones de operación:

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

Cuando esté listo, despliegue y ejecute la operación y valide el comportamiento revisando los registros de operación.