Registrar la propiedad "case"

    La propiedad “case” es una lista que permite relacionar los campos de ASMS con los campos de ServiceNow:

    Ejemplo de un caso en ASMS


    Ejemplo de un caso en ServiceNow


    Los campos de casos en ASMS y ServiceNow se presenta mediante el siguiente JSON (Archivo de configuración):

    {
      
        "case": [
            {
                "table": "",
                "externalIdField": "",
                "definition": {
                    "itemType": "",
                    "typeRegister": {
                        "type": "",
                        "searchBy": "",
                        "key": ""
                    },
                    "service": {
                        "type": "",
                        "searchBy": "",
                        "key": ""
                    },
                    "project": {
                        "type": "",
                        "searchBy": "",
                        "key": ""
                    },
                    "category": {
                        "type": "",
                        "searchBy": "",
                        "key": ""
                    },
                    "applicant": {
                        "type": "",
                        "searchBy": "",
                        "key": ""
                    },
                    "responsibleGroup": {
                        "type": "",
                        "searchBy": "",
                        "key": ""
                    },
                    "responsible": {
                        "type": "",
                        "searchBy": "",
                        "key": ""
                    }
                }
            }
        ],
        "urgency": [
        ],
        "impact": [
        ], 
        "model": [
        ],
        "typeRegister": [
        ],
        "service": [
        ],
        "project": [
        ],
        "category": [
        ],
        "applicant": [
        ],
        "responsibleGroup": [
        ],
        "responsible": [
        ]   
    }
    

    1. Cree una relación entre las tablas de ServiceNow (incident, problem, change_request) con los tipos de casos en ASMS:

    Tipos de casos en ASMS
    
    Incidents,
    Problem,
    Change,
    ServiceCall,
    Release,
    
         Table ServiceNow    Tipo de Caso ASMS    
    
            incident             Incidents         
            problem              Problem              
            change_request       Change               
    
    

    2. En la propiedad “table” del archivo de configuración escriba el nombre de la tabla incident:

    {
        "case": [
        {
            "table": "incident",
            "externalIdField": "",
            "definition": {
                "itemType": "",
                "typeRegister": {
                },
                "service": {
                },
                "project": {
                },
                "category": {
                },
                "applicant": {
                },
                "responsibleGroup": {
                },
                "responsible": {
                }
            }
        }
      ]    
    }
    

    3. En la propiedad “definition.itemType” del archivo de configuración escriba el nombre del tipo de caso Incidents:

    {
        "case": [
        {
            "table": "incident",
            "externalIdField": "",
            "definition": {
                "itemType": "Incidents",
                "typeRegister": {
                },
                "service": {
                },
                "project": {
                },
                "category": {
                },
                "applicant": {
                },
                "responsibleGroup": {
                },
                "responsible": {
                }
            }
        }
      ]    
    }
    

    4. Obtenga el nombre de las propiedades de ServiceNow que relacionará con las propiedades de ASMS, dando clic derecho sobre el nombre del campo y seleccionando la opción show:

         Propiedad en ServiceNow    
            Label                         Name
    _________________________________________________________        
            InquilinoChoice               u_inquilinochoice                           
            external id field             u_external_id_field
            Category                      category
            Short description             short_description
            Description                   description
            Channel                       contact_type
            State                         state
            Impact                        impact
            Urgency                       urgency
            Assignment group              assignment_group
            Assigned to                   assigned_to
    
    

    5. Cree una relación entre las propiedades de ASMS y ServiceNow:

         Propiedad en ASMS               Propiedad en ServiceNow     
    
            project                       u_inquilinochoice                           
            idByProject                   u_external_id_field *   
            category                      category
            subject                       short_description   *
            description                   description         *
            typeRegister                  contact_type
            state                         state   
            impact                        impact
            urgency                       urgency
            responsibleGroup              assignment_group
            responsible                   assigned_to
            service                       N/A
    


    Nota: Los campos asignados con asterisco ( * ) se asignan de forma interna y no se pueden modificar.


    6. Asigne el tipo de mapeo que realizaran las propiedades :

    FieldValue: Toma el valor directamente de ServiceNow; si el campo en ServiceNow es de tipo Reference debe agregar el valor “searchBy” en el archivo de configuración, este campo corresponde al campo por el que se buscará el valor
    Value: Toma el valor del archivo de configuración para el campo seleccionado
    Mapper: Asigne este valor de mapeo si necesita comparar o relacionar valores de ASMS y ServiceNow
         Propiedad en ASMS               Propiedad en ServiceNow      Tipo de Mapeo
    
            project                       u_inquilinochoice              Mapper                   
            category                      category                       Mapper
            typeRegister                  contact_type                   Mapper
            state                         state                            --
            impact                        impact                           -- 
            urgency                       urgency                          --
            responsibleGroup              assignment_group               FieldValue
            responsible                   assigned_to                    FieldValue
            service                       N/A                            Value
    


    Nota: Las propiedades sin ningún tipo de mapeo se tratarán en otra sección.


    7. Las propiedades asignadas con el “mapping type” “FieldValue”, requieren la propiedad “searchBy” en el archivo de configuración, esta propiedad permite realizar la búsqueda en ServiceNow:

    Asigne el nombre de búsqueda para las propiedades tipo FieldValue:

         Propiedad en ASMS               Propiedad en ServiceNow      Tipo de Mapeo    Campo de búsqueda
    
            project                       u_inquilinochoice              Mapper             --                   
            category                      category                       Mapper             --
            typeRegister                  contact_type                   Mapper             --
            state                         state                            --                --
            impact                        impact                           --                --
            urgency                       urgency                          --                --   
            responsibleGroup              assignment_group               FieldValue          name
            responsible                   assigned_to                    FieldValue          name
            service                       N/A                            Value                --
    

    8. Escriba en el archivo de configuración la relación realizada en los pasos anteriores:

    {
        "case": [
        {
            "table": "incident",
            "externalIdField": "",
            "definition": {
                "itemType": "Incidents",
                "service": {
                    "type": "Value"
                },
                "typeRegister": {
                    "type": "Mapper",
                    "key": "contact_type"
                },          
                "project": {
                    "type": "Mapper",
                    "key": "u_inquilinochoice"
                },
                "category": {
                    "type": "Mapper",
                    "key": "category"
                },
                "responsibleGroup": {
                    "type": "FieldValue",
                    "searchBy": "name",
                    "key": "assignment_group"            
                },
                "responsible": {
                    "type": "FieldValue",
                    "searchBy": "name",
                    "key": "assigned_to"
                }
            }
        }
      ]    
    }
    

    9. La propiedad “externalIdField” está relacionada directamente con la propiedad “idByProject”, para el ejemplo esta propiedad tomará el valor del campo “external id field”: [u_external_id_field].

    10. Escriba en el archivo de configuración el nombre del campo con el que relacionará la propiedad “idByProject”:

    {
        "case": [
        {
            "table": "incident",
            "externalIdField": "u_external_id_field",
            "definition": {
                "itemType": "Incidents",
                "service": {
                    "type": "Value"
                },
                "typeRegister": {
                    "type": "Mapper",
                    "key": "contact_type"
                },          
                "project": {
                    "type": "Mapper",
                    "key": "u_inquilinochoice"
                },
                "category": {
                    "type": "Mapper",
                    "key": "category"
                },
                "responsibleGroup": {
                    "type": "FieldValue",
                    "searchBy": "name",
                    "key": "assignment_group"            
                },
                "responsible": {
                    "type": "FieldValue",
                    "searchBy": "name",
                    "key": "assigned_to"
                }
            }
        }
      ]    
    }
    


    ↩ Volver


    Continuar: Registrar las propiedades Mapping (paso 4) ↪