Actividad de inserción masiva de Salesforce

Introducción

Una actividad Bulk Upsert de Salesforce actualiza una gran cantidad de registros existentes e inserta una gran cantidad de registros nuevos en un extremo de Salesforce y está destinada a utilizarse como destino para consumir datos en una operación. Después de configurar una conexión de Salesforce, puede configurar tantas actividades de Salesforce como desee para cada conexión de Salesforce.

La actividad Bulk Upsert es más rápida y se escala mejor que una actividad Salesforce Upsert que no sea masiva, pero debe usarse solo si no necesita usar una transformación para cambiar los datos antes de alcanzar su objetivo. (Las actividades masivas de Salesforce no se pueden usar con transformaciones).

La actividad Bulk Upsert requiere el uso de un campo de ID externo para (1) insertar registros si aún no existen y (2) actualizar registros si ya existen. Para obtener información sobre cómo crear un campo de ID externo en Salesforce, consulte Crear un ID externo de Salesforce para Jitterbit. Si, en cambio, desea insertar nuevos registros en masa únicamente, o si desea actualizar en masa los registros existentes en función del ID del objeto en Salesforce, utilice una actividad de inserción o actualización en masa de Salesforce.

El conector de Salesforce admite Salesforce Bulk API. Para obtener más información, consulte Requisitos previos y versiones de API compatibles.

Crear una actividad de Salesforce

Una instancia de una actividad se crea a partir de una conexión utilizando un tipo de actividad.

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 detalles, consulte Creación de una instancia de actividad en Reutilización de componentes.

Se puede editar una actividad 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 inserción masiva de Salesforce

Siga estos pasos para configurar una actividad Bulk Upsert de Salesforce:

• Paso 1: Ingrese un nombre y seleccione un objeto Proporcione un nombre para la actividad y seleccione un objeto que se utilizará al insertar datos en masa.
• Paso 2: especifique una ID externa Seleccione un campo existente de Salesforce que desea que Harmony use como ID externo para asociar registros.
• Paso 3: Proporcionar el esquema de respuesta Sube o selecciona un archivo CSV. Esto proporcionará el esquema que se utilizará en el paso final.
• Paso 4: Encabezados del mapa Asigne los encabezados de los archivos de origen proporcionados desde el archivo CSV a los campos de Salesforce deseados de los registros que se insertarán en masa.

Paso 1: Ingrese un nombre y seleccione un objeto

En este paso, proporciona un nombre para la actividad y selecciona un objeto que se utilizará al insertar datos en masa.

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

• Seleccione la referencia del objeto: Use el menú desplegable para seleccionar un objeto estándar o personalizado de Salesforce para insertar datos en forma masiva. Ingrese el valor de cualquier columna en el cuadro de búsqueda para filtrar la lista de objetos. La búsqueda no distingue entre mayúsculas y minúsculas.

  Nota

  Si la lista no se completa con los objetos disponibles, tenga en cuenta los siguientes consejos para la solución de problemas:

  • La conexión de Salesforce puede que no se realice correctamente. Asegúrese de estar conectado volviendo a abrir la conexión y probando nuevamente las credenciales.

  • Una contraseña de Salesforce que utiliza caracteres ASCII extendidos, como £, puede provocar el siguiente error al obtener datos durante la configuración de la actividad:

    Invalid username, password, security token; or user locked out. [INVALID_LOGIN]
    

    En este caso, la prueba de conexión puede ser exitosa. Si recibe este error durante la configuración de la actividad y está usando caracteres especiales en la contraseña, intente cambiar la contraseña.

• Actualizar: Haga clic en el ícono de actualización para volver a cargar objetos desde el extremo de Salesforce. Esto puede resultar útil si ha agregado objetos recientemente a Salesforce.

• 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: Especifique una identificación externa

En este paso, selecciona un campo existente de Salesforce que deseas que Harmony utilice como ID externo para asociar registros.

• ID externa: Use el menú desplegable para seleccionar el campo existente de Salesforce que desea que Harmony use como ID externa para asociar registros. Para obtener información sobre cómo crear un campo de ID externa en Salesforce, consulte Crear una ID externa de Salesforce para Jitterbit.

  Advertencia

  El campo utilizado como ID externo debe tener un valor único para cada registro. Si tiene varios registros con el mismo valor de ID externo, se devolverá una respuesta de error de Salesforce y la inserción masiva fallará para los registros con ID duplicados.

• 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 3: Proporcionar el esquema de respuesta

En este paso, cargue o seleccione un archivo CSV. El archivo CSV proporcionará el esquema que se utilizará en el Paso 4: Encabezados del mapa.

• Proporcionar esquema de solicitud: Un archivo CSV cargado o existente define el esquema que se utiliza en la solicitud. Este esquema se utiliza como parte de la actividad masiva de Salesforce para crear asignaciones en el siguiente paso. Seleccione una de las dos opciones siguientes.

  Nota

  Los esquemas para actividades masivas de Salesforce siempre son parte de la actividad y nunca se pueden definir en una transformación, ya que las transformaciones no se pueden usar en una operación que tenga una actividad masiva de Salesforce.

  • Usar esquema guardado: Elija esta opción para seleccionar un esquema existente que se haya definido previamente en el proyecto actual.

    • Esquemas guardados: Utilice el menú desplegable para seleccionar un esquema existente para reutilizar.

    • Ver esquema: Después de seleccionar un esquema cargado existente, puede esquema directamente dentro del área de texto debajo del menú desplegable. Aunque un esquema guardado no se puede editar, esta área de texto se puede copiar usando Control+C (Windows o Linux) o Command+C (macOS). Esta área de texto es solo para mostrar los esquemas cargados existentes y no para plano, jerárquico, o reflejado esquemas personalizados.

    • Validación: La información de validación se proporciona debajo del área de texto y se basa en la extensión de archivo del esquema guardado.

      • Proporcionar nuevo esquema: Elija esta opción para definir un nuevo esquema cargando un archivo o ingresando uno manualmente en el área de texto.

    • Nombre del esquema: Ingrese un nombre para el esquema en el cuadro de texto superior, incluida la extensión del archivo. Si no se proporciona una extensión de archivo, el archivo se trata como CSV de manera predeterminada. Si está cargando un archivo, puede dejar este espacio en blanco, ya que el nombre se completa una vez que se carga el archivo.

    • Cargar archivo: Haga clic en este botón para abrir un cuadro de diálogo donde puede cargar un esquema desde un archivo al que se puede acceder desde la máquina actual:

      

      • Archivo: Use el botón Explorar para buscar un archivo plano con un encabezado que aún no se haya utilizado en el proyecto actual. Se pueden cargar archivos de hasta 5 MB de tamaño.

        Advertencia

        Si intenta cargar un archivo con el mismo nombre que un archivo existente ya definido en el proyecto, un cuadro de diálogo le preguntará si desea sobrescribir el archivo existente. Si hace clic en Continuar, el archivo se reemplazará con el nuevo archivo con el mismo nombre en todos los lugares donde se use en el proyecto. Si no desea sobrescribir el archivo, haga clic en Cancelar y luego modifique manualmente el archivo para que tenga un nombre que no se esté utilizando ya, luego intente cargarlo nuevamente.

        

      • Cargar: Haga clic en este botón para cargar el esquema desde el archivo. Tenga en cuenta que algunos datos pueden convertirse durante el procesamiento como se describe en Procesamiento del esquema.

      • Cancelar: Haga clic en Cancelar para cerrar el cuadro de diálogo Cargar archivo de esquema sin guardar.

    • Ver/editar esquema: Después de cargar un esquema, puede verlo o editarlo directamente dentro del área de texto debajo del botón Cargar archivo. Otra opción es ingresar o pegar manualmente un esquema en esta área sin cargarlo desde un esquema.

    • Validación: A medida que edita un esquema, se proporcionará información de validación debajo del área de texto y se informarán los errores línea por línea. Es decir, después de resolver un error en una línea, es posible que se informen errores de sintaxis adicionales para resolver en las líneas posteriores. La validación se basa en la extensión de archivo del esquema proporcionado.

• 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: Encabezados del mapa

En este paso, asigna los encabezados del archivo de origen del archivo CSV proporcionado en Paso 3: Proporcionar el esquema de respuesta a los campos de Salesforce deseados de los registros que se insertarán en forma masiva.

• Encabezados de mapa: Este paso se utiliza para asignar campos por columna en el archivo de origen a los de la actividad de destino en bloque de Salesforce. Para completar una asignación, arrastre un campo de origen a la izquierda a un campo de destino a la derecha. Cuando se asignan los campos, el fondo se vuelve naranja y se dibuja una línea entre los campos asignados. Para eliminar una asignación, haga clic en el campo de origen o en el campo de destino.

  • Encabezados del archivo fuente: El lado izquierdo muestra los encabezados de las columnas en el archivo proporcionado en el paso anterior.

    • Buscar: Ingrese el valor de cualquier columna en el cuadro de búsqueda para filtrar la lista de encabezados. La búsqueda no distingue entre mayúsculas y minúsculas.

    • Importar mapeo: Para importar un mapeo que se haya exportado previamente, haga clic en el enlace Importar mapeo y luego proporcione información en el cuadro de diálogo:

      

      • Tipo de archivo: Utilice el menú desplegable para seleccionar el formato del archivo de mapeo:

        • JDL: Seleccione JDL para usar un archivo que se haya exportado desde una operación de proceso masivo de Design Studio (desde la opción de Design Studio para Guardar asignaciones en archivo descrita en Asignación de Transformación en Asistente de proceso masivo de Salesforce para la acción upsert).
        • JSON: Seleccione JSON para usar un archivo que se haya exportado desde Integration Studio utilizando el enlace Exportar mapeo que se describe a continuación.

      • Archivo: Haga clic en el botón Explorar a la derecha para seleccionar un archivo que contenga la asignación.

      • Cargar: Después de seleccionar un archivo, haga clic en Cargar para cargar el mapeo.

        Advertencia

        La asignación cargada sobrescribe cualquier asignación existente, si está presente.

      • Cancelar: Haga clic en Cancelar para cerrar el diálogo de importación sin cargar una asignación.

    • Exportar asignación: Para exportar una asignación existente, haga clic en el enlace Exportar asignación. Esto inicia el proceso de descarga en su navegador. El archivo exportado está en formato JSON. Cada asignación de campo incluye el nombre del campo de origen, el nombre del campo de destino y el índice de origen.

      Nota

      Las asignaciones de actividades masivas exportadas no se pueden importar como asignaciones de transformación y se pueden importar únicamente utilizando el enlace Importar mapeo descrito anteriormente.

  • Campos de Salesforce: El lado derecho muestra los nombres de columnas en Salesforce que están disponibles para ser asignados.

    • Buscar: Ingrese el valor de cualquier columna en el cuadro de búsqueda para filtrar la lista de encabezados. La búsqueda no distingue entre mayúsculas y minúsculas.
    • Automap: Haga clic en el enlace Automap para asignar nombres de campos de origen y destino que coincidan exactamente (sin importar si se usan mayúsculas o minúsculas) y tengan tipos de datos idénticos. Los campos que se asignan automáticamente se suman a cualquier asignación existente, que se deja en su lugar.
    • Comenzar de nuevo: Haga clic en el enlace Comenzar de nuevo para borrar todas las asignaciones.
  • 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.

Próximos pasos

Después de configurar una actividad Bulk Upsert de Salesforce, puede usarla dentro de una operación como se describe a continuación. Después de ejecutar una operación que contenga una actividad de Salesforce en un agente privado, podrás descargar los archivos de éxito y fracaso de la operación.

Completar la operación

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

Una vez que se ha creado una actividad Bulk Upsert de Salesforce, se puede acceder a las acciones del menú para esa actividad desde el panel del proyecto en las pestañas Flujos de trabajo o Componentes, y desde el tela de diseño. Consulte menú de acciones de la actividad para más detalles.

Las actividades de Bulk Upsert de Salesforce se pueden utilizar como destino con este patrón de operación:

• Patrón de destino masivo de Salesforce

Una actividad de Salesforce se puede utilizar como un etapa de operación en una sola operación. Es decir, no se puede hacer referencia a la misma actividad varias veces dentro de otras operaciones. En su lugar, se puede hacer una copia de una actividad de Salesforce para utilizarla en otro lugar (consulte Reutilización de componentes).

Otros patrones no son válidos si se utilizan actividades de Upsert masivo de Salesforce. Consulte los patrones de validación en Validez de la operación página.

Además, la fuente basada en archivo utilizada en la operación debe utilizar un formato de archivo plano con un encabezado y solo estos tipos de datos:

• Base64
• Booleano
• Formatos de fecha
• Doble
• Entero
• Identificación de Salesforce
• Cadena

Las operaciones que utilizan actividades de Salesforce también pueden tener acciones de operación configuradas para activarse en caso de un error de SOAP (un error que resulta de un formato de mensaje incorrecto, procesamiento de encabezado o incompatibilidad). Las acciones de operación se pueden configurar para ejecutar una operación o enviar un correo después de que se produzca un error de SOAP. Para obtener instrucciones sobre cómo activar una acción en caso de un error de SOAP, consulte Acciones de operación.

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 valide el comportamiento verificando los registros de operación.

Ver archivos de éxito y fracaso

Si está ejecutando una operación que contiene una actividad de Salesforce en un agente privado, los archivos de éxito y error están disponibles para descargar en la página Operaciones en tiempo de ejecución de la Management Console. Seleccione la operación correspondiente en la tabla Operaciones en tiempo de ejecución y haga clic en la pestaña Registros de actividad en la sección inferior de la pantalla para mostrar los enlaces de descarga de los archivos, si están disponibles:

• Descarga de archivo exitoso: Si está ejecutando la operación en un agente privado, haga clic en el enlace Descargar para guardar los registros de éxito como un archivo CSV.

• Descargar archivo de error: Si está ejecutando la operación en un agente privado, haga clic en el enlace Descargar para guardar los registros de fallas como un archivo CSV.