A propriedade “modelo” relaciona os Estados e Campos AFLS Adicionais, o arquivo de configuração possui o seguinte JSON para modelo:
{
"model": [
{
"reference": "",
"services": [
0
],
"state": {
"key": "",
"mapping": [
{
"value": "",
"id": 0
}
]
},
"additionalFields": [
{
"id": 0,
"field": {
"key": "",
"searchBy": ""
},
"mapping": [
{
"id": 0,
"value": ""
}
],
"value": {
"id": 0,
"value": ""
}
}
]
}
],
"workOrder": [],
"client": [],
"company": [],
"priority": [],
"service": []
}
Em seções anteriores, foram criadas relações entre a AFLS e as propriedades da ServiceNow
| Propriedade da AFLS | Propriedade na ServiceNow |
|---|---|
| Assunto | short_description |
| Descrição | Descrição |
| serviço | N/A |
| prioridade | prioridade |
| cliente | Chamador |
| Companhia | Companhia |
| estado | estado |
| Localização | Localização |
| Nota | work_notes |
1. Com a ajuda de um Serviço de Campo de Aranda (AFLS) fazer com que os IDs dos serviços sejam integrados, Os serviços devem estar relacionados ao mesmo modelo.
**Servicio:** 15 - Mantenimiento preventivo
2. Digite os valores no “modelo.serviços” No arquivo de configuração:
{
"model": [
{
"reference": "",
"services": [15],
"state": {},
"additionalFields": []
}
]
}
3. Obtenha o nome do imóvel do Estado no ServiceNow e digite o nome dele no imóvel “model.state.key” No arquivo de configuração: “Estado”
{
"model": [
{
"state": {
"key": "state",
"mapping": [
]
},
"services": [
15
],
"additionalFields": []
}
]
}
4. Em Serviço de Campo de Aranda (AFLS) É gerenciado em 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. Con ayuda de un administrador de **AFLS** obtenga los IDs de los ***Sub-Estados***.
| Sub-Estado da AFLS | ID |
|---|---|
| Novo | 187 |
| Em andamento | 188 |
| Em espera | 189 |
| Resolvido | 190 |
| Fechado | 191 |
5. Obter os valores da propriedade Estado pela ServiceNow.
| Serviço Estadual Agora | VALUE SERVICENOW |
|---|---|
| Novo | 1 |
| Em andamento | 2 |
| Em espera | 3 |
| Resolvido | 5 |
| Fechado | 6 |
6. O Subestados da AFLS relaciona-se à propriedade Estado por ServiceNow. Estabeleça uma equivalência entre os valores dos Estados da seguinte forma:
| Serviço Estadual Agora | Tipo de Recorde AFLS | Tipo de Recorde da ID AFLS | CANAL DE VALOR SERVICENOW |
|---|---|---|---|
| Novo | Novo | 187 | 1 |
| Em andamento | Em andamento | 188 | 2 |
| Em espera | Em espera | 189 | 3 |
| Resolvido | Resolvido | 190 | 5 |
| Fechado | Fechado | 191 | 6 |
7. Digite os valores no “modelo.estado” No arquivo de configuração:
{
"model": [
{
"state": {
"key": "state",
"mapping": [
{
"value": "1",
"id": 187
},
{
"value": "2",
"id": 188
},
{
"value": "3",
"id": 189
},
{
"value": "5",
"id": 190
},
{
"value": "6",
"id": 191
}
]
},
"services": [
15
],
"additionalFields": []
}
]
}
A criação de campos adicionais é permitida no AFLS e no ServiceNow; se quiser incluir alguns deles na integração, siga as instruções abaixo.
1. Recomendamos que você crie uma tabela com os campos que deseja adicionar na integração da seguinte maneira:
| no ServiceNow | campo na AFLS | Campo de identificação SERVICENOW | ID de campo AFLS |
|---|---|---|---|
| Campo numérico | Campo numérico | u_campo_num | 286 |
| Texto curto | Texto curto | u_texto_corto | 287 |
| Cidades | Cidades | u_glide_list | 288 |
| Item de configuração | Item de configuração | u_reference_12 | 298 |
13. Digite a relação no arquivo de configuração
{
"model": [
{
"state": {
"key": "state",
"mapping": [
{
"value": "1",
"id": 187
},
{
"value": "2",
"id": 188
},
{
"value": "3",
"id": 189
},
{
"value": "5",
"id": 190
},
{
"value": "6",
"id": 191
}
]
},
"services": [
15
],
"additionalFields": [
{
"id": 286,
"value": "un valor que quiero que sea constante",
"field": {
"key": "u_campo_num"
}
},
{
"id": 287,
"field": {
"key": "u_texto_corto"
}
},
{
"id": 288,
"field": {
"key": "u_glide_list"
}
},
{
"id": 298,
"field": {
"key": "u_reference_12"
}
}
]
}
]
}
Note que para os campos tipo Referência Propriedade é necessária searchBy que indica a propriedade pela qual a tabela ServiceNow será pesquisada.
- O campo u_reference_12 é um campo de referência de tipo à tabela item_configuration, portanto, deve ser indicado que a busca será realizada pelo u_name que é o campo que contém o nome do item de configuração.
- O campo u_glide_list é um campo de escolha, você não precisa inserir a propriedade searchBy, a API ServiceNow para campos de escolha recebe o valor de valor da entidade “sys_choice_“, por isso, os valores na AFLS e no ServiceNow estarão relacionados.
Valores a serem relacionados a partir do campo u_glide_list e o Cidades da AFLS:
| Campo “u_glide_list” da ServiceNow | VALUE SERVICENOW |
|---|---|
| Bogotá | 1 |
| Bucaramanga | 2 |
| Santa Marta | 3 |
| Cidades na AFLS | ID |
|---|---|
| Bogotá | 16 |
| Bucaramanga | 17 |
| Santa Marta | 18 |
14. Para concluir a configuração nos tipos Choice e Reference, você precisa adicionar a propriedade mapping para ambos os casos e a propriedade searchBy para o tipo Reference.
{
"model": [
{
"state": {
"key": "state",
"mapping": [
{
"value": "1",
"id": 187
},
{
"value": "2",
"id": 188
},
{
"value": "3",
"id": 189
},
{
"value": "5",
"id": 190
},
{
"value": "6",
"id": 191
}
]
},
"services": [
15
],
"additionalFields": [
{
"id": 286,
"field": {
"key": "u_campo_num"
}
},
{
"id": 287,
"field": {
"key": "u_texto_corto"
}
},
{
"id": 288,
"field": {
"key": "u_glide_list"
},
"mapping": [
{
"id": 16,
"value": "1"
},
{
"id": 17,
"value": "2"
},
{
"id": 18,
"value": "3"
}
]
},
{
"id": 298,
"field": {
"key": "u_reference_12",
"SearchBy": "u_name"
}
}
]
}
]
}