ServiceNow

Saiba mais sobre o conector ServiceNow e como usá-lo na Digibee Integration Platform.

O conteúdo desta documentação está em revisão e pode ser alterado. Agradecemos sua compreensão enquanto trabalhamos para melhorá-la.

ServiceNow interage com o ServiceNow por meio de sua API REST.

Parâmetros

Dê uma olhada nos parâmetros de configuração do conector. Parâmetros suportados por expressões Double Braces estão marcados com (DB).

Aba General

ParâmetroDescriçãoValor padrãoTipo de dado

Dynamic Account

Quando ativo, o conector usará a conta dinamicamente. Caso contrário, usará a conta de forma estática.

False

Booleano

Account Name (DB)

O nome da conta dinâmica usada pelo conector. Esta conta deve ter sido previamente configurada em um conector Store Account no pipeline para que este processo tenha efeito. Este parâmetro fica disponível apenas se o parâmetro Dynamic Account estiver ativo.

N/A

String

Account

A conta usada pelo conector. Este parâmetro fica disponível apenas se o parâmetro Dynamic Account estiver inativo.

N/A

Account

Instance Name (DB)

O nome da instância do ServiceNow.

N/A

String

Fail On Error

Se a opção for ativada, a execução do pipeline com erro será interrompida. Caso contrário, a execução do pipeline continua, mas o resultado mostrará um valor falso para a propriedade "success".

False

Booleano

Aba Opcional

ParâmetroDescriçãoValor padrãoTipo de dado

Display

Defina este parâmetro como true para retornar apenas scorecards onde o campo Display do indicador está selecionado. Defina como all para retornar scorecards com qualquer valor no campo Display. O valor padrão é true.

True

String

Display Value

Retorna o valor de exibição (true), valor real (false) ou ambos (all) para campos de referência (padrão: false).

False

String

Exclude Reference Link

Defina como true para excluir links da API Table para campos de referência (padrão: false).

False

Booleano

Favorites

Defina este parâmetro como true para retornar apenas scorecards que são favoritos do usuário da consulta.

False

Booleano

Include Aggregates

Defina este parâmetro como true para retornar todos os agregados disponíveis para um indicador, mesmo que já tenha sido aplicado um agregado. Se não for especificado, o padrão será false e não retornará agregados.

False

Booleano

Include Available Aggregates

Defina este parâmetro como true para retornar todos os agregados disponíveis para um indicador quando nenhum agregado tiver sido aplicado. Se não for especificado, o padrão será false e não retornará agregados.

False

Booleano

Include Available Breakdowns

Defina este parâmetro como true para retornar todas as divisões disponíveis para um indicador. Se não for especificado, o padrão será false e não retornará divisões.

False

Booleano

Include Score Notes

Defina este parâmetro como true para retornar todas as notas associadas à pontuação. O elemento de nota inclui o texto da nota, autor e timestamp de quando a nota foi adicionada.

False

Booleano

Include Scores

Defina este parâmetro como true para retornar todas as pontuações de um scorecard. Se não for especificado, o padrão será false e retornará apenas o valor mais recente da pontuação.

False

Booleano

Input Display Value

Defina como true para usar o valor bruto dos campos de entrada (padrão: false).

False

Booleano

Key

Defina este parâmetro como true para retornar apenas scorecards de indicadores-chave.

False

Booleano

Models (DB)

Define tanto os modelos de solicitação quanto de resposta.

N/A

JSON

Per Page

Insira o número máximo de scorecards que cada consulta pode retornar. O valor padrão é 10, com um máximo de 100.

10

Number

Release

A versão do ServiceNow a ser alvo, o padrão é Helsinki. Consulte https://docs.servicenow.com.

HELSINKI

String

Request Models (DB)

Define o modelo de solicitação.

N/A

JSON

Resource (DB)

O recurso padrão, pode ser substituído pelo cabeçalho CamelServiceNowResource.

N/A

String

Response Models (DB)

Define o modelo de resposta.

N/A

JSON

Sort By

Especifique o campo a ser usado ao ordenar resultados. Por padrão, as consultas ordenam registros por valor.

N/A

String

Sort Dir

Especifique a direção da ordenação, crescente ou decrescente. Por padrão, as consultas ordenam registros em ordem decrescente. Use sysparm_sortdir=asc para ordenar em ordem crescente.

N/A

String

Suppress Auto Sys Field

Defina como true para suprimir a geração automática de campos de sistema (padrão: false).

False

Booleano

Suppress Pagination Header

Defina como true para remover o cabeçalho Link da resposta. O cabeçalho Link permite solicitar páginas adicionais de dados quando o número de registros excede o limite de consulta.

False

Booleano

Table (DB)

A tabela padrão, pode ser substituída pelo cabeçalho CamelServiceNowTable.

N/A

String

Target

Defina este parâmetro como true para retornar apenas scorecards que possuem uma meta.

False

Booleano

Top Level Only

Retorna apenas categorias cujo pai é um catálogo.

False

Booleano

Api Version (DB)

A versão da REST API do ServiceNow, o padrão é a mais recente.

N/A

String

Date Format (DB)

O formato de data usado para serialização/deserialização JSON.

yyyy-MM-dd

String

Date Time Format (DB)

O formato de data/hora usado para serialização/deserialização JSON.

yyyy-MM-dd HH:mm:ss

String

Retrieve Target Record On Import

Defina este parâmetro como true para recuperar o registro alvo ao usar a API de conjunto de importação. O resultado do conjunto de importação é substituído pelo registro alvo.

False

Booleano

Time Format (DB)

O formato de tempo usado para serialização/deserialização JSON.

HH:mm:ss

String

Body

O corpo, se aplicável.

{}

JSON

Aba Headers

ParâmetroDescriçãoValor padrãoTipo de dado

Resource (DB)

O recurso a ser acessado.

N/A

String

Action (DB)

A ação a ser executada.

N/A

String

Action Subject (DB)

O assunto da ação.

N/A

String

Model (DB)

Define o modelo de dados.

N/A

String

Request Model (DB)

Define o modelo de dados da solicitação.

N/A

String

Response Model (DB)

Define o modelo de dados da resposta.

N/A

String

Content Type (DB)

O tipo de conteúdo.

N/A

String

Content Meta (DB)

Metadados associados ao conteúdo.

N/A

JSON

Response Meta (DB)

Metadados associados à resposta.

N/A

JSON

Api Version (DB)

A versão da API REST.

N/A

String

Response Type (DB)

O tipo de resposta.

N/A

String

Retrieve Target Record

Defina este parâmetro como true para recuperar o registro alvo.

False

Boolean

Table (DB)

A tabela padrão a ser acessada.

N/A

String

Sys Id (DB)

O ID do sistema (sys_id) do registro alvo.

N/A

String

User SysId (DB)

O ID do sistema (sys_id) do usuário.

N/A

String

User Id (DB)

O ID do usuário.

N/A

String

Cart Item Id (DB)

O ID do item do carrinho.

N/A

String

File Name (DB)

O nome do arquivo.

N/A

String

Table Sys Id (DB)

O ID do sistema (sys_id) da tabela.

N/A

String

Encryption Context (DB)

O contexto para criptografia.

N/A

String

Category (DB)

A sys_param categoria.

N/A

String

Type (DB)

O sys_param tipo.

N/A

String

Catalog (DB)

O sys_param catálogo.

N/A

String

Query (DB)

O sys_param consulta.

N/A

String

Display Value (DB)

Retorna o valor de exibição (true), valor real (false) ou ambos (all) para campos de referência.

False

String

Input Display Value

Defina este parâmetro como true para usar o valor bruto dos campos de entrada.

False

Boolean

Exclude Reference Link

Defina como true para excluir links da API da Tabela para campos de referência.

False

Boolean

Fields (DB)

Os campos sys_param a serem recuperados.

N/A

String

Limit

O sys_param limite para resultados de consulta.

N/A

Number

Text (DB)

O sys_param texto.

N/A

String

Offset

O sys_param offset para paginação.

N/A

Number

View (DB)

A sys_param visualização.

N/A

String

Suppress Auto Sys Field

Defina como true para suprimir a geração automática de campos do sistema.

False

Boolean

Suppress Pagination Header

Defina como true para remover o cabeçalho de Link da resposta, o que permite solicitar páginas adicionais de dados.

False

Boolean

Min Fields (DB)

Os campos sys_param mínimos a serem recuperados.

N/A

String

Max Fields (DB)

Os campos sys_param máximos a serem recuperados.

N/A

String

Sum Fields (DB)

Os campos sys_param de soma a serem calculados.

N/A

String

Avg Fields (DB)

Os campos sys_param de média a serem calculados.

N/A

String

Count

Defina como true para retornar uma contagem dos registros.

False

Boolean

Group By (DB)

Os campos sys_param para agrupar por agregação.

N/A

String

Order By (DB)

Os campos sys_param para ordenar resultados.

N/A

String

Having (DB)

A cláusula sys_param having para filtrar resultados agregados.

N/A

String

UUID (DB)

O sys_param UUID.

N/A

String

Breakdown (DB)

O campo sys_param divisão.

N/A

String

Include Scores

Defina este parâmetro como true para retornar todas as pontuações de um scorecard. Se não for especificado, apenas a pontuação mais recente será retornada.

False

Boolean

Include Score Notes

Defina este parâmetro como true para retornar todas as notas associadas a uma pontuação, incluindo texto, autor e timestamp.

False

Boolean

Include Aggregates

Defina este parâmetro como true para retornar todos os agregados disponíveis, mesmo que um agregado já tenha sido aplicado.

False

Boolean

Include Available Breakdowns

Defina este parâmetro como true para retornar todas as divisões disponíveis para um indicador.

False

Boolean

Include Available Aggregates

Defina este parâmetro como true para retornar todos os agregados disponíveis quando nenhum agregado foi aplicado.

False

Boolean

Favorites

Defina este parâmetro como true para retornar apenas scorecards que são favoritos do usuário que consulta.

False

Boolean

Key

Defina este parâmetro como true para retornar apenas scorecards de indicadores-chave.

False

Boolean

Target

Defina este parâmetro como true para retornar apenas scorecards que possuem uma meta.

False

Boolean

Display (DB)

Defina este parâmetro como true para retornar scorecards onde o campo Exibição está selecionado. Use all para retornar scorecards com qualquer valor no campo Exibição.

True

String

Per Page

Especifique o número máximo de scorecards a serem retornados em uma consulta. O padrão é 10, com um máximo de 100.

10

Number

Sort By (DB)

Especifique o campo a ser usado para ordenar resultados. Por padrão, os registros são ordenados por valor.

N/A

String

Sort Dir (DB)

Especifique a direção da ordenação: crescente ou decrescente. Por padrão, os resultados são ordenados em ordem decrescente. Use sysparm_sortdir=asc para crescente.

N/A

String

Contains (DB)

O sys_param contains clause.

N/A

String

Tags (DB)

O sys_param tags para categorizar registros.

N/A

String

Page (DB)

O número da página sys_param para paginação.

N/A

String

Elements Filter (DB)

O sys_param elements filter.

N/A

String

Breakdown Relation (DB)

O sys_param breakdown relation.

N/A

String

Data Source (DB)

O sys_param data source a ser consultado.

N/A

String

Top Level Only

Defina como true para retornar apenas categorias cujo pai seja um catálogo.

False

Boolean

Aba Documentation

ParâmetroDescriçãoValor padrãoTipo de dado

Documentation

Seção para documentar qualquer informação necessária sobre a configuração do conector e regras de negócio.

N/A

String

Atualizado