Registros de consulta

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 1 min. de leitura
  • Recupera vários registros de uma tabela especificada.

    Antes de Iniciar

    Função necessária: sn_cli_metadata.cli_admin, sn_cli_metadata.cli_user ou admin

    Procedimento

    Abra a ferramenta de linha de comando do sistema e execute este comando.
    $ snc record query [--displayvalue displayValue --fields fields --limit limit --offset offset --query query --table table]

    Passe valores para estes argumentos.

    Parâmetro Descrição
    displayValue Incluir --displayvalue para recuperar o valor de exibição do banco de dados para campos de referência e de escolha. Não inclua este parâmetro para recuperar os valores reais.
    campos Lista separada por vírgulas de nomes de campo para retornar do banco de dados.
    limite Número máximo de registros a serem retornados.
    deslocamento Índice de registro inicial para o qual iniciar a recuperação de registros. Use este valor para paginar a recuperação de registro.
    consulta Necessário. Consulta codificada usada para filtrar o conjunto de resultados no seguinte formato: --query '<column_name> <operator> <value>' .
    tabela Necessário. Nome da tabela na qual consultar os registros.

    Exemplo

    $ snc record query --displayvalue --fields short_description,state --query '123TEXTQUERY321=email' --table incident

    A CLI retorna todos os registros que correspondem à consulta.

    {
       "result": [
          {
             "short_description": "Unable to connect to email",
             "state": "Closed"
          }
       ]
    }