Relação de estados e campos adicionais com propriedades de classe do ServiceNow
Esta seção relaciona os estados entre as plataformas e os campos adicionais aos campos das classes ServiceNow, para isso o modelo da configuração JSON, que possui a seguinte estrutura:
{
"model": [
{
"reference": "",
"services": [ 0 ],
"state": {
"key": "",
"mapping": [
{
"value": "",
"id": 0
}
]
},
"additionalFields": [
{
"id": 0,
"field": {
"key": "",
"searchBy": ""
},
"mapping": [
{
"id": 0,
"value": ""
}
],
"value":{
"id": 0,
"value": ""
}
}
]
}
]
}
Propriedades
A seguir está uma descrição das propriedades do json acima
| Propriedades | Descrição | |
|---|---|---|
| Serviços | Identificador para serviços na AFLS | |
| Referência | Identificador único para criar uma relação entre os conceitos de Ordem de trabalho > modelo, cliente, empresa, prioridade, serviço | ver |
| estado | Relação entre AFLS e Valores de Status do ServiceNow | Ver |
| Campos adicionais | Relação dos campos adicionais da AFLS com os campos de classe ServiceNow | Ver |
Lista de estados
Em Serviço de Campo de Aranda (AFLS) É gerenciado em 5 estados:
- Aberto
- Processo
- StandBy
- Executado
- Cancelar
Cada um dos estados está associado Subestados, que permitem uma transição entre estados, para a integração é necessário relacionar os subestados aos estados do ServiceNow.
Para relacionar os estados, a integração fornece o seguinte esquema json:
{
"state": {
"key": "",
"mapping": [
{
"value": "",
"id": 0
}
]
}
}
Veja a seguir uma descrição das propriedades internas do objeto de estado
| Propriedades | Descrição | |
|---|---|---|
| Chave | Nome ou ID do campo no ServiceNow em que o valor será encontrado e atualizado. | Propriedades do ServiceNow |
| Mapeamento | Relação entre os valores estaduais na AFLS e ServiceNow | |
| valor | Identificador de status do ServiceNow (sys_id se for um campo do tipo “Referência” ou valor se for um campo do tipo “Escolha”) | Propriedades do ServiceNow |
| Id | Identificador de status na AFLS |
EXEMPLO: Relação de Status AFLS/ServiceNow
Para criar a lista de estados, siga as instruções abaixo:
- Obtenha os documentos dos estados da AFLS.
- Obtenha sys_id ou valor dos status do ServiceNow.
- Atribuir a seguinte equivalência de status:
- Na propriedade Chave digite o nome do campo relacionado ao estado no ServiceNow.
| Status no ServiceNow | Estado em Aranda | ID ESTADO ARANDA | ESTADO DE VALOR SERVICENOW |
|---|---|---|---|
| Novo | NOVO | 1 | value_new |
| Fechado | FECHADO | 13 | value_closed |
- Digite o ID ESTADO ARANDA Na propriedade “identificação” e o ESTADO DE VALOR SERVICENOW do seu equivalente retirado de ServiceNow Na propriedade valor:
{
"state": {
"key": "state",
"mapping": [
{
"value": "value_new",
"id": 1,
"subState": 10
},
{
"value": "value_closed",
"id": 2,
"subState": 13
}
]
}
}
Relação entre campos adicionais e campos em classes do ServiceNow
propriedades internas de additionalFields
{
"id": 0,
"field": {
"key": "",
"searchBy": ""
},
"mapping": [
{
"id": 0,
"value": ""
}
],
"value": {
"id": 0,
"value": ""
}
}
Veja a seguir uma descrição das propriedades internas do objeto additionalFields
| Propriedades | Descrição | |
|---|---|---|
| Id | Identificador de campo adicional na AFLS | |
| campo | Informações de campo do ServiceNow, saiba mais | ver |
| Mapeamento | A relação entre os valores de campo AFLS e ServiceNow, onde “id” é o identificador no AFLS e “value” é o identificador no ServiceNow (sys_id se for um campo do tipo “Referência” ou valor se for um campo do tipo “Escolha”) | |
| valor | Adicionar um valor padrão ao campo |
Lista de tipos de campos adicionais com suporte
Lista de relacionamento entre os tipos de campos das plataformas:
| AFLS | ID do campo no ServiceNow | Nome/rótulo do campo no ServiceNow |
|---|---|---|
| Texto curto | Corda | Corda |
| Parágrafo | Corda | Corda |
| Data e hora | glide_date_time, calendar_date_time | Data/Hora, Data/Hora do Calendário |
| Numérico | Inteiro, Inteiro Longo | Inteiro, Longo |
| Lista | escolha, glide_list, referência | Escolha, Lista, Referência |
⚐ Nota:
- Associar 2 campos diferentes aos listados na tabela anterior resulta em um erro de tempo de execução***
- Associar um campo ServiceNow a múltiplos campos adicionais do AFLS substituirá o valor anterior***