Parâmetros da ação

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 2 min. de leitura
  • 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.
    ObtRegistros 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 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 no URL.
    InsertMultiple Crie vários novos registros para a tabela de destino no 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 seu 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 deleteMultiplesysfarm_action.

    sysparm_view

    Especifique uma exibição de formulário para personalizar os valores de retorno das chamadas de função GET 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 ).

    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 do 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 sys_id são mostrados. Por exemplo, o campo assignedto no registro de incidente é enviado de volta como assigned_to:1234556, dv_assigned_to:Fred Luddy.

    displayvariables

    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.