Actividad de Actualización Masiva o Inserción Masiva de Salesforce¶

Introducción¶

Una actividad de inserción masiva de Salesforce inserta una gran cantidad de registros nuevos en un extremo de Salesforce, mientras que una actividad de actualización masiva de Salesforce actualiza una gran cantidad de registros existentes en un extremo de Salesforce. Ambos están destinados a ser utilizados 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.

Las actividades de inserción y actualización masivas son más rápidas y escalan mejor que las [actividades de inserción y actualización de Salesforce no masivas]](/es/cloud-studio/cloud-studio-reference/connectors/salesforce/salesforce-connector-configuration/salesforce-insert-or-update-activity), pero debe usarse solo si no necesita usar una transformación para cambiar los datos antes de alcanzar su destino. (Las actividades masivas de Salesforce no se pueden utilizar con transformaciones).

La actividad Inserción masiva se usa para crear nuevos registros, mientras que la actividad Actualización masiva se usa para actualizar registros que ya existen en función del Id. del objeto en Salesforce. Si, en cambio, desea utilizar un campo de ID externo para (1) insertar registros de forma masiva si aún no existen, así como (2) actualizar registros de forma masiva si ya existen, utilice una actividad de actualización masiva de Salesforce.

El conector de Salesforce es compatible con Salesforce Bulk API 2.0. Para obtener más información, consulte Requisitos previos y versiones de API admitidas.

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

Una actividad existente se puede editar desde estas ubicaciones:

• El tela de diseño (vea Menú de acciones de componentes en Tela de Diseño).
• La pestaña Componentes del panel del proyecto (vea Menú de acciones de componentes en Ficha Componentes del panel Proyecto).

Configurar una Actividad de Actualización o Inserción Masiva de Salesforce¶

Los pasos para configurar una actividad de inserción masiva o actualización masiva de Salesforce son los mismos. Siga estos pasos para configurar cualquiera de estas actividades:

• Paso 1: Introduzca un nombre y seleccione un objeto Proporcione un nombre para la actividad y seleccione el objeto que se usará al insertar o actualizar datos de forma masiva.
• Paso 2: proporcionar el esquema de respuesta Cargue o seleccione un archivo CSV. Esto proporcionará el esquema que se utilizará en el paso final.
• Paso 3: Encabezados del mapa Asigne los encabezados del archivo de origen proporcionados desde el archivo CSV con los campos de Salesforce para los registros que se van a insertar o actualizar de forma masiva.

Paso 1: Ingrese un Nombre y Seleccione un Objeto¶

En este paso, proporciona un nombre para la actividad y selecciona el objeto que se usará al insertar o actualizar datos de forma masiva.

• Nombre: Ingrese un nombre para identificar la actividad de inserción masiva o actualización masiva de Salesforce. El nombre debe ser único para cada actividad de inserción masiva o actualización masiva de Salesforce y no debe contener barras inclinadas (/) o dos puntos (:).

• Seleccione la referencia del objeto: Use el menú desplegable para seleccionar un objeto estándar o personalizado de Salesforce para insertar o actualizar datos de forma masiva. Introduzca cualquier parte del nombre del objeto 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 el menú desplegable no se completa con los objetos disponibles, la Conexión de Salesforce puede no tener éxito. Asegúrese de estar conectado volviendo a abrir la conexión y volviendo a probar las credenciales.

• Actualizar: Haz clic en el ícono de actualización para volver a cargar objetos desde el extremo de Salesforce. Esto puede ser útil si recientemente agregó objetos 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 almacenar temporalmente la configuración para este paso y continuar con el próximo 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 los 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: 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 3: Encabezados del mapa.

• Proporcionar esquema de respuesta: El esquema de respuesta define el esquema que utiliza el archivo CSV proporcionado. Este esquema se usa como parte de la actividad masiva de Salesforce para crear asignaciones en el siguiente paso. Seleccione una de las dos opciones a continuación.

  Nota

  Los esquemas para las actividades masivas de Salesforce siempre forman 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: Use el menú desplegable para seleccionar un esquema existente para reutilizarlo.

    • 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 flat, 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 manualmente uno 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 forma predeterminada. Si está cargando un archivo, puede dejarlo 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 Examinar a la derecha para buscar un archivo sin formato con un encabezado que aún no se haya usado 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 usa 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é usando, 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 de esquemas.

      • 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 cargar un esquema desde un archivo.

    • Validación: A medida que edita un esquema, la información de validación se proporcionará debajo del área de texto, y cualquier error se informará una línea a la vez. Es decir, después de resolver un error en una línea, se pueden informar errores de sintaxis adicionales para resolver en las líneas subsiguientes. 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 volver al paso anterior.

• Siguiente: Haga clic para almacenar temporalmente la configuración para este paso y continuar con el próximo 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 los 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 3: Encabezados de Mapa¶

En este paso, asigna los encabezados del archivo de origen del archivo CSV proporcionado en Paso 2: Proporcione el esquema de respuesta a los campos de Salesforce deseados para los registros que se van a insertar o actualizar de forma masiva.

• Asignar encabezados: Este paso se utiliza para asignar campos por columna en el archivo de origen a los de la actividad de destino masivo de Salesforce. Para completar una asignación, arrastre un campo de origen de la izquierda a un campo de destino de la derecha. Cuando se asignan 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 de origen: El lado izquierdo muestra los encabezados de las columnas en el archivo plano proporcionado en el paso anterior.

    • Buscar: Ingrese cualquier parte del nombre del encabezado 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, a continuación, proporcione información en el cuadro de diálogo:

      

      • Tipo de archivo: Use 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 Design Studio hasta Save Mappings to File descrito en Mapeo de Transformación en Asistente de proceso masivo de Salesforce para Upsert Action).
        • JSON: Seleccione JSON para usar un archivo que se haya exportado desde Cloud Studio mediante el enlace Exportar asignación que se describe a continuación.

      • Archivo: Haga clic en el botón Examinar 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 la asignación.

        Advertencia

        El mapeo cargado sobrescribe cualquier mapeo existente, si está presente.

      • Cancelar: Haga clic en Cancelar para cerrar el cuadro de 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 actividad masiva exportadas no se pueden importar como asignaciones de transformación y solo se puede importar mediante el enlace Importar mapeo descrito anteriormente.

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

    • Buscar: Ingrese cualquier parte del nombre de la columna en el cuadro de búsqueda para filtrar la lista de encabezados. La búsqueda no distingue entre mayúsculas y minúsculas.
    • Automapa: Haga clic en el enlace Automapa para asignar nombres de campo de origen y destino que coincidan exactamente (independientemente de las mayúsculas y minúsculas) y tengan tipos de datos idénticos. Los campos que se asignan automáticamente se suman a las asignaciones existentes, que se dejan en su lugar.
    • Volver a empezar: Haga clic en el enlace Volver a empezar para borrar todas las asignaciones.
  • Atrás: Haga clic para almacenar temporalmente la configuración de este paso y volver 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 pide que confirme que desea descartar los cambios.

Próximos Pasos¶

Después de configurar una actividad de inserción masiva o actualización masiva de Salesforce, complete la configuración de la operación agregando y configurando otras actividades o secuencias de comandos como pasos de 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 los mismos o diferentes flujos de trabajo.

Una vez que se ha creado una actividad de inserción masiva o actualización masiva de Salesforce, se puede acceder a las acciones de 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 actividad para detalles.

Las actividades de actualización o inserción masiva de Salesforce se pueden utilizar como destino con este patrón de operación:

• Patrón de objetivo masivo de Salesforce

Una actividad de Salesforce se puede utilizar como un etapa de operación en una sola operación. Es decir, no puede hacer referencia a la misma actividad varias veces dentro de otras operaciones. En su lugar, 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 con las actividades de actualización o inserción masiva de Salesforce. Consulte los patrones de validación en la Validez de la operación página.

Un caso de uso típico es usar una actividad de inserción masiva de Salesforce en el Patrón de destino masivo de Salesforce. En este ejemplo, la actividad de lectura de FTP (Read Bulk Insert Request) proporciona datos dentro de la operación. La actividad de inserción masiva de Salesforce (Inserción masiva) se utiliza como destino, recibiendo datos dentro de la operación. Luego, el secuencia de comandos Escribir en el registro de operaciones registra un mensaje:

Además, la fuente basada en archivos utilizada en la operación debe usar 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 usan actividades de Salesforce también pueden tener acciones de operación configuradas para activarse en una falla 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 ocurra una falla de SOAP. Para obtener instrucciones sobre cómo activar una acción en caso de falla de SOAP, consulte Acciones de operación.

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

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