Actividad de Eliminación Masiva o Eliminación Total Masiva de Salesforce¶

Introducción¶

Una actividad de Eliminación masiva o Eliminación total de Salesforce elimina una gran cantidad de registros existentes 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 diferencia entre una eliminación y una eliminación permanente es que, con una eliminación, los registros eliminados se almacenan en la papelera de reciclaje de Salesforce. Con una eliminación permanente, los registros se vuelven inmediatamente elegibles para su eliminación. La papelera de reciclaje de Salesforce le permite ver y restaurar registros eliminados recientemente durante 15 días antes de que se eliminen de forma permanente. Existe un límite en el tamaño de la papelera de reciclaje de Salesforce; una vez superado, los registros pueden volverse automáticamente elegibles para su eliminación. Consulte la documentación de Salesforce para más detalles.

Las actividades Eliminación masiva y Eliminación total masiva son más rápidas y se escalan mejor que las actividades de eliminación no masivas de Salesforce, 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).

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 Eliminación Masiva o Eliminación Total Masiva de Salesforce¶

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

• Paso 1: Ingrese un nombre y seleccione un objeto Proporcione un nombre para la actividad y seleccione el objeto que se utilizará al eliminar datos de forma masiva o permanente.
• Paso 2: Proporcionar el esquema de respuesta Sube o selecciona un archivo CSV. Esto proporcionará el esquema que se utilizará en el paso final.
• Paso 3: 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 eliminarán en forma masiva o se eliminarán definitivamente en forma masiva.

Paso 1: Ingrese un Nombre y Seleccione un Objeto¶

En este paso, debe proporcionar un nombre para la actividad y seleccionar el objeto que se utilizará al eliminar datos de forma masiva o permanente.

• Nombre: Ingrese un nombre para identificar la actividad de Salesforce. El nombre debe ser único para cada actividad de Eliminación masiva o Eliminación total masiva 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 eliminar datos de forma masiva o permanente. 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 el menú desplegable no se completa con los objetos disponibles, la conexión de Salesforce puede que no se realice correctamente. Asegúrese de estar conectado volviendo a abrir la conexión y volviendo a probar las credenciales.

• 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: 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 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 a continuación.

  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 CSV 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 campo 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: Usa el botón Explorar para buscar localmente un archivo plano 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 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 cargar un esquema desde un archivo.

    • 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 una línea a la vez. 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 3: Encabezados del Mapa¶

En este paso, asigna los encabezados del archivo de origen del archivo CSV proporcionado en Paso 2: Proporcionar el esquema de respuesta a los campos de Salesforce deseados de los registros que se eliminarán en forma masiva o se eliminarán definitivamente 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 de los archivos 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 Cloud Studio usando 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, ya que 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 los nombres de los 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 de Eliminación masiva o Eliminación total 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 Eliminación masiva o Eliminación total 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 de Eliminación masiva o Eliminación total 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 Eliminación masiva o Eliminación definitiva de Salesforce se pueden usar 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 las actividades Eliminación masiva o Eliminación definitiva 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:

• Descargar 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.