Saltar al contenido

Actividad de Inserción Masiva de ServiceMax

Introducción

Una actividad Upsert masiva de ServiceMax actualiza una gran cantidad de registros existentes e inserta una gran cantidad de registros nuevos en un extremo de ServiceMax y está diseñada para usarse como destino para consumir datos en una operación. Después de configurar una conexión de ServiceMax, puede configurar tantas actividades de ServiceMax como desee para cada conexión de ServiceMax.

La actividad Bulk Upsert es más rápida y escala mejor que una actividad no masiva ServiceMax Upsert, pero debe usarse solo si no necesita usar una transformación para cambiar los datos antes de alcanzar su destino. (Las actividades masivas de ServiceMax 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 ServiceMax, consulte Creación de un campo personalizado de ServiceMax /ID externo para Jitterbit en ServiceMax.. Si, en cambio, solo desea insertar nuevos registros de forma masiva, o si desea actualizar de forma masiva los registros existentes en función del ID del objeto en ServiceMax, use una actividad de inserción masiva o actualización masiva de ServiceMax.

El conector ServiceMax 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 ServiceMax

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:

Configurar una Actividad de Actualización Masiva de ServiceMax

Siga estos pasos para configurar una actividad Upsert masiva de ServiceMax:

Paso 1: Ingrese un Nombre y Seleccione un Objeto

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

actividad de inserción masiva de servicemax 1

  • Nombre: Ingrese un nombre para usar para identificar la actividad de actualización masiva de ServiceMax. El nombre debe ser único para cada actividad de ServiceMax Bulk Upsert 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 ServiceMax para la inserción masiva de datos. 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 ServiceMax 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 icono de actualización archivo adjunto para volver a cargar objetos y campos desde el extremo de ServiceMax. Esto puede ser útil si recientemente agregó objetos o campos a ServiceMax.

  • 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: Especifique una ID Externa

En este paso, selecciona un campo ServiceMax existente que desea que Jitterbit Harmony use como ID externo para asociar registros.

actividad de inserción masiva de servicemax 2

  • ID externo: Use el menú desplegable para seleccionar el campo ServiceMax existente que desea que Jitterbit Harmony use como ID externo para asociar registros. Para obtener información sobre cómo crear un campo de ID externo en ServiceMax, consulte Creación de un campo personalizado de ServiceMax /ID externo para Jitterbit en ServiceMax..

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

actividad de inserción masiva de servicemax 3

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

    Nota

    Los esquemas para las actividades masivas de ServiceMax 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 ServiceMax.

    • 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/Editar esquema: Después de seleccionar un esquema cargado existente, puede ver el 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 de archivo .csv. 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:

        esquema de carga de servicemax

        • Archivo: Utilice el botón Examinar para buscar un archivo sin formato 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 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.

          archivo de sobrescritura de servicemax

        • 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 4: Encabezados de Mapa

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

actividad de inserción masiva de servicemax 4

  • 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 ServiceMax. 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:

        asignaciones de importación de servicemax

        • 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 Guardar asignaciones en archivo_ descrito en Transformación de asignació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 ServiceMax: El lado derecho muestra los nombres de columna en ServiceMax 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 Upsert masiva de ServiceMax, 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 los mismos o diferentes flujos de trabajo. Además, si se encuentra con los límites de registro impuestos por la API, es posible que desee utilizar la fragmentación de datos.

Una vez que se ha creado una actividad de inserción masiva de ServiceMax, 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 actividad para detalles.

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

Una actividad de ServiceMax se puede utilizar como un etapa de operación en una única 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 ServiceMax para utilizarla en otro lugar (consulte Reutilización de componentes).

Otros patrones no son válidos con las actividades de actualización masiva de ServiceMax. 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 Upsert masiva de ServiceMax en el Patrón de objetivo masivo de Salesforce. En este ejemplo, la actividad de lectura de FTP (Solicitud de lectura) proporciona datos a la operación. La actividad Bulk Upsert de ServiceMax (Bulk Upsert) se utiliza como objetivo, recibiendo datos dentro de la operación. A continuación, el secuencia de comandos Write to Operation Log registra un mensaje:

operación de actividad upsert masiva de servicemax 1

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

Base64 - Booleano - Formatos de fecha - Doble - Entero - Identificación de ServiceMax - Cadena

Las operaciones que usan actividades de ServiceMax 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.