API d’enregistrement : ServiceNow Fluent

  • Rversion finale: Zurich
  • Mis à jour 31 juil. 2025
  • 2 minutes de lecture

    • L’API d’enregistrement définit les enregistrements dans n’importe quelle table. Utilisez l’API Record pour définir les métadonnées d’application qui n’ont pas d’API dédiée ServiceNow Fluent .

    Objet d’enregistrement

    Ajouter des données à n’importe quelle table contenant un enregistrement.

    Tableau 1. Propriétés
    Nom Type Description
    $id Chaîne ou numéro Requis. ID unique pour l’objet de métadonnées. Lorsque vous créez l’application, cet ID est haché en une sys_id unique. Pour en savoir plus, consultez ServiceNow Fluent Constructions linguistiques.

    Format : Now.ID['chaîne' ou numéro]
    Table Chaîne Requis. Nom de la table à laquelle l’enregistrement appartient.
    données Objet Champs et leurs valeurs dans la table. Par exemple :
    data: {
   state: 'Ready',
   task: 'Add demo data'
}
    Pour utiliser le contenu textuel d’un autre fichier, reportez-vous à un fichier de l’application à l’aide de la syntaxe Now.include . Pour en savoir plus, consultez ServiceNow Fluent Constructions linguistiques.
    data: {
   script: Now.include('./script-file.js'),
   html: Now.include('./html-file.html'),
   css: Now.include('./css-file.css')
 }
    $meta Objet Métadonnées pour les métadonnées de l’application.
    Avec la propriété installMethod , vous pouvez mapper les métadonnées d’application à un répertoire de sortie qui ne se charge que dans des circonstances spécifiques.
    $meta: {
      installMethod: 'String'
}
    Valeurs valides pour installMethod :
    • demo : génère les métadonnées de l’application dans le répertoire metadata/unload.demo à installer avec l’application lorsque l’option Charger les données de démonstration est sélectionnée.
    • première installation : génère les métadonnées de l’application dans le répertoire metadata/unload à installer uniquement la première fois qu’une application est installée sur une instance.
    Dans cet exemple, un enregistrement définissant une catégorie de menu est ajouté à la table Catégorie de menu [sys_app_category]. Le style de catégorie de menu est défini dans le fichier css-file.css .
    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'),
   },
})
    Dans cet exemple, un enregistrement définissant un incident est ajouté à la table Incident [incident].
    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',
  }
})
    Dans cet exemple, un enregistrement définissant un serveur est ajouté à la table Server (Serveur) [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',
  }
})