Identificador de registro exclusivo (sys_id)

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 2 min. de leitura
  • Um GUID exclusivo de 32 caracteres (ID exclusivo globalmente), chamado de ID do sistema (sys_id) identifica cada registro em uma instância. Existem várias maneiras pelas quais um registro é atribuído a um sys_id.

    Quando criados na aplicação, os valores de sys_id são exclusivos. O Now Platform e o banco de dados devem gerenciar todas as operações nos valores de sys_id. O mesmo valor de sys_id nunca é gerado duas vezes, o que garante que cada registro criado em cada tabela em cada instância no mundo tenha um identificador exclusivo. Se dois registros tiverem o mesmo valor de sys_id, isso ocorrerá como resultado das seguintes situações:
    • Se um registro com o sys_id foi copiado para outro no nível de banco de dados fora do Now Platform.
    • Se um registro com o sys_id foi copiado usando um conjunto de atualizações ou via XML, seu sys_id será o mesmo.

    Nota:
    Um novo registro tem um sys_id de -1 e, uma vez inserido, é atribuído a ele um novo sys_id. O sys_id não deve ser exibido como um campo em um formulário ou como uma coluna em uma lista. Para saber mais, consulte o artigo Os usuários não conseguem adicionar o campo sys_id a um formulário ou exibição de lista [KB0690876] no Now Support Base de conhecimento.

    Obter o sys_id da barra de cabeçalho

    Os usuários podem localizar o sys_id de um registro usando a barra de cabeçalho.

    Procedimento

    1. Navegue até o registro.
    2. Clique com o botão direito do mouse na barra de cabeçalho e selecione Copiar URL.

      O sys_id está dentro do URL, após o parâmetro sys_id=. Por exemplo, o seguinte é um URL para um incidente:

      https://<instance name>.service-now.com/nav_to.do?uri=incident.do?sys_id=9d385017c611228701d22104cc95c371

      Portanto, o sys_id é 9d385017c611228701d22104cc95c371.

    Obter o sys_id de um script

    Os usuários podem localizar o sys_id de um registro usando um script.

    Procedimento

    • O valor de sys_id de um registro pode ser encontrado em uma regra de negócios (ou qualquer outro JavaScript do lado do servidor) por referência com pontos do GlideRecord.
      var id = current.sys_id;
    • O sys_id de um registro pode ser encontrado no JavaScript do lado do cliente usando g_form.getUniqueValue() conforme mostrado no exemplo a seguir.
      function onLoad() {
          var incSysid = g_form.getUniqueValue();
          alert(incSysid);
      }

    Obter o sys_id da URL

    Os usuários podem localizar o sys_id de um registro exibindo o URL.

    Por Que e Quando Desempenhar Esta Tarefa

    Como o sys_id de um registro sempre faz parte do URL de um link para esse registro, é possível recuperar o sys_id exibindo o URL.

    Procedimento

    Exiba o sys_id na barra de informações do navegador passando o mouse sobre um link para o registro.
    Por exemplo, um incidente com o seguinte URL: https://<instance name> .service-now.com/nav_to.do?uri=incident.do?sys_id=23dc968f0a0a3c1900534f399927740e , tem este sys_id: 23dc968f0a0a3c1900534f399927740e.
    Exemplo de sys_id