---
sourceDocument: Brasil Crie ou modifique aplicações
sourceDocumentLink: https://www.servicenow.com/docs/r/pt-BR/application-development

 Release :

    - brazil

ft:locale :

    - pt-BR

ft:publication_title :

    - Brasil Crie ou modifique aplicações

ft:clusterId :

    - cadev

bundleId :

    - cadev

workflow :

    - Development, Data, and Analytics


---

# ANS API

# API do acordo de nível de serviço - ServiceNow Fluent {#fluent-sla-api__fluent-api-title}

Versão de lançamento: Brazil  
Atualizado 10 de set. de 2026  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 8 min. de leitura  
A API do Acordo de nível de serviço define acordos de nível de serviço \[contract_sla\] que definem a quantidade de tempo para que uma tarefa atinja uma condição especificada, garantindo que as tarefas sejam resolvidas de acordo com os níveis de serviço acordados entre um provedor de serviços e um cliente.
Nota:  
Para obter a ServiceNow Fluent documentação e exemplos mais recentes da API, consulte [ServiceNow Fluent Referência de API](https://servicenow.github.io/sdk/category/api-reference) E [repositório de exemplos do ServiceNow SDK](https://github.com/ServiceNow/sdk-examples) em GitHub.

Para obter informações gerais sobre ANS, consulte [Service Level Management](https://www.servicenow.com/docs/access?context=service-level-mgmt-landing-page&version=brazil&pubname=brazil-it-service-management&ft:locale=en-US).{#fluent-sla-api__fluent-api-general-info}
**Conceitos relacionados**   

* [ServiceNow Fluent](https://www.servicenow.com/docs/DwwB~tvJ53lVH_VYcC9ghw "Defina metadados da aplicação no código-fonte usando a ServiceNow Fluent linguagem de programação específica do domínio.")

## Objeto do ANS {#fluent-sla-object__fluent-object-title}

Crie uma definição de ANS \[contract_sla\] que controle o tempo, as condições, os fluxos de trabalho e outras informações necessárias para criar e avançar ANS de tarefas.
{#fluent-sla-object__table_sla_object__entry__3}{#fluent-sla-object__now-id-desc2}

| Nome | Tipo | Descrição |
|-|-|-|
| id | Número ou cadeia de caracteres | Necessário. Um ID exclusivo para o objeto de metadados. Quando você cria a aplicação, este ID é hash em um sys_id exclusivo. Para obter mais informações, consulte [ServiceNow Fluent construções de linguagem](https://www.servicenow.com/docs/9_bZMGlWdnudgHwUQ9uB_g "ServiceNow Fluent As construções de linguagem fornecem funcionalidade adicional para desenvolvimento no código-fonte com ServiceNow Fluent APIs."). Formato: `Now.ID['Cadeia de caracteres' ou número]` |
| nome | Cadeia de caracteres | Necessário. Um nome para a definição de ANS. |
| tabela | Cadeia de caracteres | O nome da tabela à qual o ANS se aplica. Padrão: Incidente |
| tipo | Cadeia de caracteres | O tipo de contrato de nível de serviço. O tipo é usado somente para fins de emissão de relatórios. Valores válidos: * ANS: Um acordo de nível de serviço entre um provedor de serviços e um cliente externo. * OLA: Um acordo de nível operacional entre equipes internas na mesma organização. * Contrato de sustentação: Um contrato com um fornecedor externo que sustenta o serviço entregue ao cliente. {#fluent-sla-object__ul_knc_x4c_l3c} Padrão: ANS |
| ativo | Booliano | Sinalizador que indica se a definição de ANS está ativa e pode ser correspondida com registros de tarefa. Valores válidos: * Verdadeiro: A definição de ANS está ativa. * Falso: A definição de ANS está inativa e não corresponde aos registros de tarefa. {#fluent-sla-object__ul_cny_x4c_l3c} Padrão: Verdadeiro |
| target | Cadeia de caracteres | A fase da tarefa que o ANS mede. A meta é usada somente para fins de filtragem, pesquisa e emissão de relatórios. Valores válidos: * Resposta: O ANS mede o tempo para responder pela primeira vez a uma tarefa. * Resolução: O ANS mede o tempo de resolução de uma tarefa. {#fluent-sla-object__ul_sy3_y4c_l3c} |
| duração | Object | A duração de tempo em que a tarefa deve atingir a condição de destino. Use a função duration() para especificar a duração. Esta propriedade será necessária se o valor da propriedade durationType estiver vazio. Formato: duration: Duration({ days: Number, hours: Number, minutes: Number, seconds: Number }) |
| DurationType | Cadeia de caracteres ou referência | O sys_id de uma duração relativa \[cmn_relatative_duration\], como Violação na data de vencimento ou término do próximo dia útil, a ser usado em vez de uma duração especificada pelo usuário. Para definir uma duração relativa, use [API de registro - ServiceNow Fluent](https://www.servicenow.com/docs/M~PfDr5_5Xr9R0J_w_9zwA#record-api-now-ts "A API de registro define registros em qualquer tabela. Use a API de registro para definir metadados da aplicação que não têm uma ServiceNow Fluent API dedicada."). |
| WorksduraçãoRelativaAtivado | Cadeia de caracteres | O tipo de registro a partir do qual a duração relativa é calculada. Esta propriedade só se aplica se o valor da propriedade durationType estiver definido. Valores válidos: * Registro de tarefa: A duração relativa é calculada a partir do registro da tarefa. * Registro de ANS: A duração relativa é calculada a partir do registro de ANS. {#fluent-sla-object__ul_nh3_wrc_l3c} Padrão: Registro de tarefa |
| programação | Cadeia de caracteres ou referência | O sys_id de uma programação \[cmn_schedule\] para os períodos de tempo durante os quais os ANS acumulam tempo de negócio. Para definir uma programação, use [API de registro - ServiceNow Fluent](https://www.servicenow.com/docs/M~PfDr5_5Xr9R0J_w_9zwA#record-api-now-ts "A API de registro define registros em qualquer tabela. Use a API de registro para definir metadados da aplicação que não têm uma ServiceNow Fluent API dedicada."). Esta propriedade será necessária se o valor da propriedade scheduleSource for `sla_definition`. |
| ScheduleSource | Cadeia de caracteres | A origem da qual a programação é obtida. Valores válidos: * ans_definition: O cronograma é especificado na definição de ANS usando a propriedade de cronograma. * Task_field: O cronograma é obtido de um campo no registro de tarefa especificado com a propriedade scheduleSourceField. * no_schedule: Nenhum cronograma é usadoe o ANS é executado continuamente (24x7). {#fluent-sla-object__ul_alc_xxc_l3c} Padrão: ans_definition |
| ScheduleSourceField | Cadeia de caracteres | O campoda tarefa que fornece a programação. Esta propriedade será necessária se o valor da propriedade scheduleSource for `task_field`. |
| condições | Object | Condições de consulta codificada que controlam o tempo de um ANS. Por exemplo, `"Prioridade 1 6"` corresponde a tarefas com prioridade 1 que não estão em um estado fechado. Para obter mais informações sobre condições de ANS, consulte [Create an SLA definition](https://www.servicenow.com/docs/access?context=t_CreateAnSLADefinition&version=brazil&pubname=brazil-it-service-management&ft:locale=en-US). Para obter informações sobre consultas de filtro, consulte [Operators available for filters and queries](https://www.servicenow.com/docs/access?context=r_OpAvailableFiltersQueries&version=brazil&pubname=brazil-platform-user-interface&ft:locale=en-US). Formato: conditions: { start: 'String', stop: 'String', pause: 'String', resume: 'String', reset: 'String', cancel: 'String', } |
| AdvancedConditionType | Cadeia de caracteres | O tipo de lógica de condição avançada a ser aplicada. Valores válidos: * Nenhum: Nenhuma lógica de condição avançada é aplicada. * Avançado: Um script de condição avançada personalizado é usado. * Advanced_journal: Lógica de condição avançada baseada em entradas de diário é usada. * Advanced_system: Lógica de condição avançada baseada em eventos do sistema é usada. * Advanced_journal_and_system: Lógica de condição avançada baseada em entradas de diário e eventos do sistema é usada. {#fluent-sla-object__ul_lmp_wxc_l3c} Padrão: Nenhum |
| ConditionType | Cadeia de caracteres | O sys_id de umacondição de ANS \[sla_condition_class\] que determina quando as transições entre diferentes fases de cada ANS de tarefa. |
| ResetAction | Cadeia de caracteres | A ação a ser realizada no registro de ANS da tarefa atual quando a condição de redefinição é atendida. Valores válidos: * Cancelar: O registro de ANS da tarefa atual é cancelado e um novo é criado. * Concluído: O registro de ANS da tarefa atual é marcado como concluído e um novo é criado. {#fluent-sla-object__ul_tgz_dzc_l3c} Padrão: Cancelar |
| Quando | Object | Configuraçõesque controlam quando um ANS pausado é retomado e quando um ANS é cancelado. * Retomar: O comportamento que controla quando um ANS pausado retoma o tempo. Valores válidos: * On_condition: O ANS é retomado quando o registro da tarefa corresponde à condição definida com a propriedade de retomada do objeto de condições. * no_match: O ANS é retomado quando o registro da tarefa não corresponde mais à condição de pausa definida com a propriedade de pausa do objeto de condições. {#fluent-sla-object__ul_qhb_g3d_l3c} Padrão: On_condition * Cancelamento: O comportamento que controla quando um ANS ativo é cancelado. Valores válidos: * On_condition: O ANS é cancelado quando o registro da tarefa corresponde à condição definida com a propriedade cancelar do objeto de condições. * no_match: O ANS é cancelado quando o registro da tarefa não corresponde mais à condição de início definida com a propriedade de início do objeto de condições. * Nunca: O ANS nunca é cancelado, independentemente do estado do registro da tarefa. {#fluent-sla-object__ul_urx_c3d_l3c} Padrão: On_condition {#fluent-sla-object__ul_d1m_shd_l3c} Formato: whenTo: { resume: 'String', cancel: 'String', } |
| retroativo | Object | Configuraçõesque controlam se a hora de início do ANS está definida como um ponto no passado com base em um valor de campo especificado. * Sinalizador que indica se o início retroativo está habilitado. Quando habilitada, a hora de início do ANS é definida com o valor do campo especificado em setStartTo em vez da hora em que a condição de início foi atendida pela primeira vez. Padrão: falso * SetStartTo: O campo no registro da tarefa cujo valor é usado como a hora de início do ANS quando o início retroativo está habilitado. Esta propriedade será necessária se o valor da propriedade inicial for verdadeiro. * Pausa: Sinalizador que indica se a pausa retroativa está habilitada quando o início retroativo está ativo. Quando habilitado, qualquer momento em que a tarefa estava em um estado pausado antes que o ANS fosse anexado é subtraído do tempo decorrido. Padrão: verdadeiro {#fluent-sla-object__ul_uzx_r3d_l3c} Formato: retroactive: { start: Boolean, setStartTo: 'String', pause: Boolean, } |
| TimezoneSource | Cadeia de caracteres | A origem da qual o fuso horário para cálculos de ANS é obtido. Valores válidos: * task.caller_id.time_zone:O fuso horário do solicitante no registro da tarefa. * task.caller_id.location.time_zone:O fuso horário do local do solicitante no registro da tarefa. * cmdb_ci.location.time_zone: O fuso horário do local do item de configuração no registro da tarefa. * Task.location.time_zone: O fuso horário do local no registro da tarefa. * TimeZone: O fuso horário especificado com a propriedade de fuso horário. {#fluent-sla-object__ul_pvw_11d_l3c} Padrão: task.caller_id.time_zone |
| fuso horário | Cadeia de caracteres | O fuso horário a ser usado para cálculos de ANS, como `EUA/Pacífico`. Esta propriedade será necessária se o valor da propriedade timezoneSource for `sla.timezone`. |
| substituições | Cadeia de caracteres ou referência | O identificador de variável ou sys_id de outra definição de ANS \[contract_sla\] que esta definição de ANS substitui. |
| fluxo de trabalho | Cadeia de caracteres ou referência | O identificador de variável ou sys_id de um fluxo de trabalho \[wf_workflow\] a ser executado quando o ANS atingir um marco ou violar. Para definir um fluxo de trabalho, use [API de registro - ServiceNow Fluent](https://www.servicenow.com/docs/M~PfDr5_5Xr9R0J_w_9zwA#record-api-now-ts "A API de registro define registros em qualquer tabela. Use a API de registro para definir metadados da aplicação que não têm uma ServiceNow Fluent API dedicada."). |
| Fluxo | Cadeia de caracteres ou referência | O identificador de variável ou sys_id de um fluxo \[sys_hub_flow\] a ser executado quando o ANS atingir um marco ou violar. Para definir um fluxo, use [Flow API - ServiceNow Fluent](https://www.servicenow.com/docs/CbLbx~f07B~wfp77kuQu_Q#fluent-flow-api "A API de fluxo define fluxos e subfluxos [sys_hub_flow], que automatizam os processos de negócios com componentes reutilizáveis de várias etapas."). Padrão: Fluxo de ANS padrão (828f267973333300e289235f04f6a7a3) |
| fornecedor | Cadeia de caracteres ou referência | O identificador de variável ou sys_id de uma empresa \[core_company\] que é o fornecedor de um ANS de contrato subjacente. Para definir uma empresa, use [API de registro - ServiceNow Fluent](https://www.servicenow.com/docs/M~PfDr5_5Xr9R0J_w_9zwA#record-api-now-ts "A API de registro define registros em qualquer tabela. Use a API de registro para definir metadados da aplicação que não têm uma ServiceNow Fluent API dedicada."). |
| DomainPath | Cadeia de caracteres | O caminho do domínio que determina qual domínio possui o ANS em um ambiente de vários domínios. Padrão: O domínio global (/) |
| EnableLogging | Booliano | Sinalizador que indica se o registro em log de depuração está habilitado para a definição de ANS. Valores válidos: * Verdadeiro: O registro em log de depuração está habilitado. * Falso: O registro em log de depuração está desativado. {#fluent-sla-object__ul_bs5_kcd_l3c} Padrão: Falso |
| meta | Object | Metadados para os metadados da aplicação. Com a propriedade installMethod, você pode mapear os metadados da aplicação para um diretório de saída que carrega somente em circunstâncias específicas. $meta: { installMethod: 'String' } Valores válidos para installMethod: * Demonstração: Gera os metadados da aplicação para o diretório metadata/unload.demo a ser instalado com a aplicação quando a opção Carregar dados de demonstração é selecionada. * Primeira instalação: Envia os metadados da aplicação para o diretório metadata/unload para serem instalados somente na primeira vez que uma aplicação é instalada em uma instância. {#fluent-sla-object__ul_n3q_y3s_42c} |
[Tabela 1. Propriedades]

{#fluent-sla-object__table_sla_object}  

    import { Sla, Duration } from '@servicenow/sdk/core'

    Sla({
        $id: Now.ID['incident-p1-resolution'],
        name: 'P1 Incident Resolution',
        table: 'incident',
        target: 'resolution',
        duration: Duration({ hours: 4 }),
        schedule: 'b1992362eb601100fcfb858ad106fe16',
        conditions: {
            start: 'priority=1',
            stop: 'state=6',
            pause: 'state=3',
            resume: 'state!=3',
        },
        whenTo: {
            resume: 'on_condition',
        },
        resetAction: 'cancel',
    })


