API de registro - ServiceNow Fluent

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 2 min. de leitura
  • A API de registro define registros em qualquer tabela. Use a API de registro para definir metadados da aplicação que não têm um dedicado ServiceNow FluentAPI.

    Objeto de registro

    Adicione dados a qualquer tabela com um registro.

    Tabela 1. Propriedades
    Nome Tipo Descrição
    id Cadeia de caracteres ou número Necessário. Um ID exclusivo para o objeto de metadados. Quando você cria a aplicação, este ID é hash em um sys_id exclusivo. Para obter mais informações, consulte ServiceNow Fluent construções de linguagem.

    Formato: Now.ID['Cadeia de caracteres' ou número]

    tabela Cadeia de caracteres Necessário. O nome da tabela à qual o registro pertence.
    dados Objeto E seus valores na tabela. Por exemplo:
    data: {
       state: 'Ready',
       task: 'Add demo data'
    }
    Para usar conteúdo de texto de outro arquivo, consulte um arquivo na aplicação usando o. Now.include sintaxe. Para obter mais informações, consulte ServiceNow Fluent construções de linguagem.
    data: {
       script: Now.include('./script-file.js'),
       html: Now.include('./html-file.html'),
       css: Now.include('./css-file.css')
     }
    meta Objeto Metadados dos metadados da aplicação.
    Com o. Método de instalação , você pode mapear os metadados da aplicação para um diretório de saída que carrega somente em circunstâncias específicas.
    $meta: {
          installMethod: 'String'
    }
    Valores válidos para Método de instalação :
    • Demonstração: Gera os metadados da aplicação para o. metadados/unload.demo diretório a ser instalado com a aplicação quando Carregar dados de demonstração a opção está selecionada.
    • Primeira instalação: Gera os metadados da aplicação para o. metadados/descarregamento diretório a ser instalado somente na primeira vez que uma aplicação for instalada em uma instância.
    Neste exemplo, um registro que define uma categoria de menu é adicionado à tabela Categoria de menu [sys_app_category]. O estilo de categoria de menu é definido no css-file.css arquivo.
    import { Record } from "@servicenow/sdk/core";
    
    export const appCategory = Record({
       table: 'sys_app_category',
       $id: Now.ID[9],
       data: {
          name: 'example',
          style: Now.include('./css-file.css'),
       },
    })
    Neste exemplo, um registro que define um incidente é adicionado à tabela Incidente [incidente].
    import { Record } from '@servicenow/sdk/core';
    
    export const incident1 = Record({
      $id: Now.ID['incident-1'],
      table: 'incident',
      data: {
        active: 'true',
        approval: 'not requested',
        description: 'Unable to send or receive emails.',
        incidentState: '1',
        shortDescription: 'Email server is down.',
        subcategory: 'email',
        callerId: '77ad8176731313005754660c4cf6a7de',
      }
    })
    Neste exemplo, um registro que define um servidor é adicionado à tabela Servidor [cmdb_ci_server].
    import { Record } from '@servicenow/sdk/core';
    
    export const ciserver1 = Record({
      $id: Now.ID['cmdb-ci-server-1'],
      table: 'cmdb_ci_server',
      data: {
        assetTag: 'P1000199',
        attested: 'false',
        canPrint: 'false',
        company: 'e7c1f3d53790200044e0bfc8bcbe5deb',
        cost: '2160',
        costCc: 'USD',
        cpuSpeed: '633',
        cpuType: 'GenuineIntel',
        diskSpace: '100',
        manufacturer: 'b7e7d7d8c0a8016900a5d7f291acce5c',
        name: 'DatabaseServer1',
        os: 'Linux Red Hat',
        shortDescription: 'DB Server',
        subcategory: 'Computer',
      }
    })