Record API - ServiceNow Fluent

  • Versão de lançamento: Australia
  • Atualizado 12 de mar. de 2026
  • 2 min. de leitura

    • The Record API defines records in any table. Use the Record API to define application metadata that doesn't have a dedicated ServiceNow Fluent API.

    Record object

    Add data to any table with a record.

    Tabela 1. Properties
    Name Type Description
    $id String or Number Required. A unique ID for the metadata object. When you build the application, this ID is hashed into a unique sys_id. For more information, see ServiceNow Fluent language constructs.

    Format: Now.ID['String' or Number]
    table String Required. The name of the table to which the record belongs.
    data Object Fields and their values in the table. For example:
    data: {
   state: 'Ready',
   task: 'Add demo data'
}
    To use text content from another file, refer to a file in the application using the Now.include syntax. For more information, see ServiceNow Fluent language constructs.
    data: {
   script: Now.include('./script-file.js'),
   html: Now.include('./html-file.html'),
   css: Now.include('./css-file.css')
 }
    $meta Object Metadata for the application metadata.
    With the installMethod property, you can map the application metadata to an output directory that loads only in specific circumstances.
    $meta: {
      installMethod: 'String'
}
    Valid values for installMethod:
    • demo: Outputs the application metadata to the metadata/unload.demo directory to be installed with the application when the Load demo data option is selected.
    • first install: Outputs the application metadata to the metadata/unload directory to be installed only the first time an application is installed on an instance.
    $override Object Fields and their values provided to configure fields that aren't included in a ServiceNow Fluent API or to override an existing field.
    Aviso:
    Type safety isn't enforced for fields configured with the $override property.
    $override: {
 field: value, 
 ...
}
    In this example, a record defining a menu category is added to the Menu Category [sys_app_category] table. The menu category style is defined in the css-file.css file.
    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'),style: 'border-color: #a7cded; background-color: #e3f3ff;',
   },
})
    In this example, a record defining a script include is added to the Script Include [sys_script_include] table. The script include uses a script from the SampleClass.server.js file. 
    import { Record } from "@servicenow/sdk/core";

export const SampleClass = Record({
  $id: Now.ID["SampleClass"],
  table: "sys_script_include",
  data: {
    name: "SampleClass",
    apiName: "x_sample.SampleClass",
    access: "public",
    callerAccess: "caller_tracking",
    protectionPolicy: "read-only",
    script: Now.include("./SampleClass.server.js"),
  },
})
    In this example, a record defining an incident is added to the Incident [incident] table.
    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',
  }
})
    In this example, a record defining a server is added to the Server [cmdb_ci_server] table.
    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',
  }
})