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.

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:

• El lienzo de diseño (consulte Menú de acciones de componentes en Lienzo de diseño).
• La pestaña Componentes del panel del proyecto (consulte Menú de acciones de componentes en Pestaña de componentes del panel del proyecto).

Configurar una actividad de Carga de Salesforce Einstein Analytics

Siga estos pasos para configurar una actividad de Carga 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 datos.

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

• Paso 3: Seleccionar el enfoque de carga
  Seleccione el enfoque de carga entre un archivo sin procesar o un mapeo directo de una transformación.

• Paso 4: Revisar los esquemas de datos
  Se muestran los esquemas de solicitud o respuesta generados desde el endpoint.

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 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: Para esta opción, seleccionará de una lista de aplicaciones pobladas 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 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 pobladas 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 existen, 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 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 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 :.

• 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 pobladas 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 la configuración del conjunto de datos

En este paso, se especifica 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, se 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, se ingresará 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 esta interfaz:

• Usar conjunto de datos existente o nuevo: Especificar 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, se 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, se ingresará el nombre de un nuevo conjunto de datos que se creará en la instancia de Salesforce.

• Seleccionar un conjunto de datos: Seleccionar un conjunto de datos existente basado en la aplicación elegida en el paso anterior. Si no existen, será necesario cambiar a Crear conjunto de datos si no existe: o crear un nuevo conjunto de datos manualmente en Salesforce CRM Analytics.

• Operación: Especificar la operación de datos que se utilizará en el conjunto de datos existente, una de Sobrescribir, Agregar, 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 esta interfaz:

• Usar Conjunto de Datos Existente o Nuevo: Especifica 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á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 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, consulta 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, consulta 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 Referencia del 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 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 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.

  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 pedirá 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 pedirá que confirmes que deseas descartar los cambios.

Paso 4: Revisar los esquemas de datos

Cualquier esquema de solicitud o respuesta generado desde el endpoint 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:

• Enfoque de 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 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.

• Atrás: 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 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 consisten en 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": ""
                }
            ]
        }
    ]
}

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 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 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:

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

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

Cuando estés listo, despliega y ejecuta la operación y valida el comportamiento revisando los registros de operación.