Saltar al contenido

Conector ServiceMax

Resumen

El conector ServiceMax proporciona una interfaz para ingresar información proporcionada por el usuario, como credenciales, para crear una conexión ServiceMax autenticada. Esa conexión proporciona la base para configurar las actividades asociadas del conector ServiceMax que interactúan con la conexión. En conjunto, una conexión ServiceMax específica y sus actividades se denominan extremo de ServiceMax.

Nota

Como ServiceMax es una aplicación de Salesforce y este conector se basa en Cloud Studio conector de Salesforce, las funciones, variables y asistentes de Jitterbit Salesforce se aplican y se pueden utilizar. Esta documentación hace referencia a la documentación relacionada de Salesforce según corresponda.

Requisitos Previos y Versiones de API Compatibles

El conector ServiceMax admite el uso de agentes privados o en la nube de Harmony que tengan la versión 9.4.2 o superior.

Se requiere una cuenta de Salesforce que no tenga habilitada la autenticación multifactor (MFA). Para configurar una cuenta de Salesforce sin MFA, asegúrese de que el Conjunto de permisos asignado al inicio de sesión de integración del sistema Salesforce no tenga la selección Autenticación multifactor para inicios de sesión de API. Los tipos de inicio de sesión de integración del sistema están exentos del requisito MFA de Salesforce, como lo describe Salesforce en ¿Se requiere MFA para mis usuarios de integración? en su documentación preguntas frecuentes sobre autenticación multifactor de Salesforce.

Como ServiceMax usa la plataforma Salesforce, el conector de ServiceMax usa la API de Salesforce.

La versión de API que utiliza el conector para actividades no masivas depende de la versión del agente Harmony:

Versión del Agente Harmony Versión de la API SOAP de Salesforce Lanzamiento de Salesforce
11.30 o posterior 61.0 Verano '24
11,23 a 11,29
10,85 a 10,87
60,0 Primavera '24
11,18 a 11,22
10,80 a 10,84
59,0 Invierno '24
11.11 a 11.17
10.73 a 10.79
58.0 Verano '23
11,7 a 11,10
10,69 a 10,72
57,0 Primavera '23
11,0 a 11,6
10,55 a 10,68
54,0 Primavera '22
10,44 a 10,54 52,0 Verano '21
10,42 a 10,43 51,0 Otoño '21
10,28 a 10,41 50,0 Invierno '21
10,23 a 10,27 49,0 Verano '20
10,17 a 10,22 48,0 Primavera '20
10.11 a 10.16 47.0 Invierno '20
10,3 a 10,10 45,0 Primavera '19
9,8 a 10,2 44,0 Invierno '19
9.4.2 a 9.7 41.0 Invierno '18

La API masiva de Salesforce basada en SOAP se utiliza para actividades masivas.

La API masiva de Salesforce utiliza un X-SFDC-Session encabezado completado con un ID de sesión obtenido mediante una API SOAP de Salesforce login() Llame para solicitudes válidas.

Las actualizaciones de Agente que omiten las versiones de API SOAP de Salesforce incluyen implícitamente compatibilidad con versiones de API intermedias.

Consulte la documentación proporcionada en los enlaces anteriores para obtener información sobre los campos del esquema.

Descripción General del Conector

Este conector se utiliza primero para configurar una conexión ServiceMax, estableciendo acceso a ServiceMax y luego utilizado para configurar una o más actividades de ServiceMax asociadas con esa conexión como origen o destino dentro de una operación.

Actividades Estándar de ServiceMax

  • Consulta: Consulta datos desde un extremo de ServiceMax y está diseñado para usarse como fuente en una operación.
  • Insertar: Inserta datos nuevos en un extremo de ServiceMax y está diseñado para usarse como destino en una operación.
  • Actualizar: Actualiza los datos existentes en un extremo de ServiceMax y está diseñado para usarse como destino en una operación.
  • Actualizar: Actualiza los datos existentes e inserta datos nuevos en un extremo de ServiceMax y está diseñado para usarse como destino en una operación.
  • Borrar: Elimina datos en un extremo de ServiceMax y está diseñado para usarse como destino en una operación.

Actividades Masivas de ServiceMax

Las actividades masivas de ServiceMax son más rápidas y escalan mejor que las actividades de ServiceMax no masivas, pero deben usarse solo si no necesita utilizar una transformación para cambiar los datos antes de alcanzar el objetivo.

  • Consulta masiva: Consulta una gran cantidad de registros desde un extremo de ServiceMax y está diseñado para usarse como fuente en una operación.
  • Inserción masiva: Inserta una gran cantidad de registros nuevos en un extremo de ServiceMax y está diseñado para usarse como destino en una operación.
  • Actualización masiva: Actualiza una gran cantidad de registros existentes en un extremo de ServiceMax y está diseñado para usarse como destino en una operación.
  • Inserción masiva: Ambos actualizan una gran cantidad de registros existentes e insertan una gran cantidad de registros nuevos en un extremo de ServiceMax y están destinados a usarse como destino en una operación.
  • Eliminación masiva: Elimina una gran cantidad de registros de un extremo de ServiceMax y está diseñado para usarse como destino en una operación. Los registros eliminados se almacenan en la Papelera de reciclaje de ServiceMax antes de eliminarse permanentemente.
  • Eliminación completa masiva: Elimina de forma permanente una gran cantidad de registros de un extremo de ServiceMax y está diseñado para usarse como destino en una operación. Los registros eliminados automáticamente se vuelven elegibles para su eliminación.

Nota

Este conector es un conector nativo de Cloud Studio, al que Jitterbit puede hacer referencia cuando comunica cambios realizados en los conectores. El calendario de lanzamiento para conectores nativos de Cloud Studio se basa en la cadencia de las aplicaciones en la nube de Harmony.

Accediendo al Conector

Se accede al conector ServiceMax desde la pestaña Conectores y extremos del proyecto de la paleta de componentes de diseño (consulte paleta de componentes de diseño).

adjunto

Cree un Campo Personalizado de ServiceMax /id Externo para Jitterbit

Se recomienda utilizar un campo personalizado en ServiceMax para asociar registros con una identificación externa para Jitterbit. Estos pasos muestran cómo crear un campo personalizado en ServiceMax en el objeto Cuenta para crear una ID externa llamada "Jitterbit_Account_ID":

  1. Inicie sesión en su instancia de ServiceMax con sus credenciales.

  2. Navegue hasta Configuración > Herramientas de plataforma > Objetos y campos > Administrador de objetos.

  3. En la pestaña Administrador de objetos, seleccione el objeto estándar Cuenta.

  4. Desde la vista de objeto Cuenta, vaya a la sección Campos y relaciones y haga clic en Nuevo en la parte superior derecha.

    1. En Paso 1. Elija el tipo de campo, seleccione Texto como tipo de datos y haga clic en Siguiente.
    2. En Paso 2. Ingrese los detalles, configure su nuevo campo personalizado de la siguiente manera. Luego haga clic en Siguiente.
      • Etiqueta de campo: Jitterbit_Account_ID
      • Longitud: 50
      • Nombre de campo: Jitterbit_Account_ID
  5. ID externo: Marcado (muy importante)**

    1. En el Paso 3. Establecer seguridad a nivel de campo, acepte la configuración predeterminada haciendo clic en **Siguiente.
    2. En Paso 4. Agregar a diseños de página, acepte los valores predeterminados haciendo clic en Guardar.
  6. Debería regresar a la pantalla Campos y relaciones para el objeto Cuenta. Verifique que vea el nuevo campo personalizado con los mismos parámetros que se muestran a continuación.

    adjunto

Para obtener más información, consulte la documentación de Salesforce sobre Crear campos personalizados.

Funciones de Salesforce y Variables Jitterbit

Se pueden utilizar varias funciones de Salesforce dentro de secuencias de comandos para proporcionar información de inicio de sesión y de sesión y búsquedas para instancias de ServiceMax, incluidas estas:

  • GetSalesforceTimestamp- LoginToSalesforceAndGetTimeStamp- SalesforceLogin- SetSalesforceSession- SfCacheLookup- SfLookup- SfLookupAll- SfLookupAllToFile

Además, ciertas variables de Jitterbit se proporcionan específicamente para su uso con extremos de ServiceMax y Salesforce, incluidas estas:

  • jitterbit.sfdc.auto_fieldsToNull- jitterbit.sfdc.dbsource.sfheader- jitterbit.sfdc.failure_record_count- jitterbit.sfdc.query.record_count- jitterbit.sfdc.success_record_count

Para obtener detalles sobre el uso de estas funciones y variables, consulte Funciones de Salesforce y variables de Jitterbit de SFDC, respectivamente.

Solución de Problemas

Si tiene problemas con el conector ServiceMax, se recomiendan estos pasos de solución de problemas:

  1. Asegúrese de que la conexión ServiceMax se realiza correctamente utilizando el botón Probar en la pantalla de configuración. Si la conexión no se realiza correctamente, el error devuelto puede proporcionar una indicación del problema.

  2. Verifique los registros de operación para cualquier información escrita durante la ejecución de la operación.

  3. Habilite el registro de depurar de operación (para agentes en la nube o para agentes privados) para generar archivos de registro y datos adicionales.

  4. Si utiliza agentes privados, puede consultar los registros de agentes para más información.