Parâmetros da ação

Os parâmetros de ação são separados e diferentes dos parâmetros de dados porque especificam a ação a ser realizada quando o parâmetro de objeto JSON faz parte de uma solicitação HTTP GET ou POST.

Os parâmetros também podem ser especificados como um campo no objeto JSON fornecido. Têm o efeito de acionar uma ação no caso de sysparm_action , ou filtrando os resultados de uma atualização ou consulta no caso de sysparm_query .

sysparm_action

Estes são os valores válidos para sysparm_action E a ação correspondente acionada pela API.

Tabela 1. Recuperação de dados

Resumo do método	Descrição
GetKeys	Consulte a tabela de destino usando uma cadeia de caracteres de consulta codificada e retorne uma lista delimitada por vírgulas de sys_id valores.
Obter registros	Consulte a tabela de destino usando uma cadeia de caracteres de consulta codificada e retorne todos os registros correspondentes e seus campos.
obter	Consulte um único registro da tabela de destino especificando o. sys_id em sysparm_sys_id Parâmetro de URL e retornam o registro e seus campos.

Tabela 2. Modificação de dados

Resumo do método	Descrição
inserir	Crie um ou mais novos registros para a tabela de destino na URL.
InsertMultiple	Crie vários novos registros para a tabela de destino na URL.
atualizar	Atualize os registros existentes na tabela de destino no URL, filtrados por uma cadeia de caracteres de consulta codificada.
ExcluteRecord	Exclua um registro da tabela de destino no URL especificando-o. sys_id em sysparm_sys_id Parâmetro de URL.
DeleteMultiple	Exclua vários registros da tabela de destino no URL, filtrados por uma cadeia de caracteres de consulta codificada.

sysparm_query

Especifique uma cadeia de caracteres de consulta codificada a ser usada no valor GET, getRecords, UPDATE ou deleteMultiplesysparm_action.

sysparm_view

Especifique uma exibição de formulário para personalizar os valores de retorno das chamadas de função Obter e getRecords. Ao usar uma exibição, a consulta retorna somente os campos definidos na exibição, incluindo valores referenciados. Se não houver nome de exibição ou se o nome da exibição não for válido, a consulta retornará todos os nomes de campo marcados como ativos no dicionário.

sysparm_sys_id

Especifique um sys_id de destino durante uma chamada de função GET ou DELETE ( sysparm_action valor).

sysparm_record_count

Especifique um valor inteiro para limitar o número de registros recuperados para esta solicitação. Observe que este valor é limitado por glide.processor.json.row_limitpropriedade do sistema.

valor de exibição

Obtenha o valor de exibição de um campo de referência, se houver algum no registro. Por exemplo, o registro de incidente pode ter um assigned_to campo que é uma referência a um registro de usuário. Em vez de enviar o sys_id do registro de usuário, o nome de usuário é enviado.

O parâmetro displayvalue pode ter três valores: verdadeiro , falso , ou todos .

• verdadeiro : Todos os campos de referências mostram o valor de exibição em vez de sys_id .
• falso (Padrão): Todos os campos de referência são exibidos sys_ids .
• todos : O valor de exibição e o. sys_id são mostrados. Por exemplo, o campo assignedto no registro do incidente é enviado de volta como assigned_to:1234556, dv_assigned_to:fred Luddy.

variáveis de exibição

Defina este valor booliano como verdadeiro Durante uma chamada de função GET ou getRecords para recuperar todas as variáveis anexadas a este registro.