ES
Español
English
Português
    Model

    Relación de estados y campos adicionales con las propiedades de las clases de ServiceNow

    Este apartado relaciona los estados entre las plataformas y los campos adicionales con los campos de las clases de ServiceNow, para esto se utiliza la propiedad model del json de configuración, que tiene la siguiente estructura:

    {
  "model": [
    {
      "reference": "",
      "services": [ 0 ],
      "state": {
        "key": "",
        "mapping": [
          {
            "value": "",
            "id": 0
          }
        ]
      },
      "additionalFields": [
        {
          "id": 0,
          "field": {
            "key": "",
            "searchBy": ""
          },
          "mapping": [
            {
              "id": 0,
              "value": ""
            }
          ],
          "value":{
              "id": 0,
              "value": ""
          }
        }
      ]
    }
  ]
}

    Propiedades

    A continuación se da una descripción de las propiedades del anterior json

    Propiedades Descripción  
    services Identificador de los servicios en AFLS  
    reference Identificador único para crear una relación entre los conceptos workOrder > model, client, company, priority, service ver
    state Relación de los valores del estado de AFLS y ServiceNow Ver
    additionalFields Relación de los campos adicionales de AFLS con los campos de las clases de ServiceNow Ver

    Relación de los estados

    En Aranda Field Service (AFLS) se maneja 5 estados:

    • Open
    • Process
    • StandBy
    • Executed
    • Cancel

    A cada uno de los estados se asocian Sub-Estados, que permiten una transición entre los estados, para la integración es necesario relacionar los sub-estados con los estados de ServiceNow.

    Para relacionar los estados la integración proporciona el siguiente esquema json:

    {
    "state": {
        "key": "",
        "mapping": [
            {
                "value": "",
                "id": 0
            }
        ]
    }
}

    A continuación se da una descripción de las propiedades internas del objecto state

    Propiedades Descripción  
    key Nombre o identificador del campo en ServiceNow donde se buscará y actualizará el valor. Propiedades ServiceNow
    mapping Relación entre los valores del estado en AFLS y ServiceNow  
    value Identificador del estado en ServiceNow (sys_id si es un campo tipo “Reference” o value si es un campo tipo “Choice”) Propiedades ServiceNow
    id Identificador del estado en AFLS  

    EJEMPLO: Relación de estados AFLS / ServiceNow

    Para crear la relación de los estados siga las siguientes instrucciones:

    1. Obtenga los IDs de los estados de AFLS.
    2. Obtenga los sys_id o value de los estados de ServiceNow.
    3. Asigne la siguiente equivalencia de estados:
    4. En la propiedad key escriba el nombre del campo relacionado al estado en ServiceNow.
    Estado en ServiceNow Estado en Aranda ID STATE ARANDA VALUE STATE SERVICENOW
    New NUEVO 1 value_new
    Closed CERRADO 13 value_closed
    • Escriba el ID STATE ARANDA en la propiedad “id” y el VALUE STATE SERVICENOW de su equivalente tomado de ServiceNow en la propiedad value:
    {
    "state": {
        "key": "state",
        "mapping": [
            {
                "value": "value_new",
                "id": 1,
                "subState": 10
            },
            {
                "value": "value_closed",
                "id": 2,
                "subState": 13
            }
        ]
    }
}

    Relación entre los campos adicionales y los campos de las clases de ServiceNow

    Propiedades internas additionalFields

    {
    "id": 0,
    "field": {
        "key": "",
        "searchBy": ""
    },
    "mapping": [
        {
            "id": 0,
            "value": ""
        }
    ],
    "value": {
        "id": 0,
        "value": ""
    }
}

    A continuación se da una descripción de las propiedades internas del objecto additionalFields

    Propiedades Descripción  
    id Identificador del campo adicional en AFLS  
    field Información del campo en ServiceNow, más información ver
    mapping Relación entre valores del campo de AFLS y ServiceNow, donde “id” es el identificador en AFLS y “value” el identificador en ServiceNow (sys_id si es un campo tipo “Reference” o value si es un campo tipo “Choice”)  
    value Agrega un valor por defecto al campo  

    Listado de los tipos de campo adicionales soportados

    Listado de relación entre los tipos de campos de las plataformas:

    AFLS Identificador del campo campo en ServiceNow Nombre/Etiqueta del campo en ServiceNow
    Short Text string String
    Paragraph string String
    Date and Time glide_date_time, calendar_date_time Date/Time, Calendar Date/Time
    Numeric integer, longint Integer, Long
    List choice, glide_list, reference Choice, List, Reference

    ⚐ Nota:

    • Asociar 2 campos diferentes a los relacionados en la anterior tabla genera un error en tiempo de ejecución***
    • Asociar un campo de ServiceNow a varios campos adicionales de AFLS Reemplazara el valor anterior***

    ↩ Volver a Configuración