--- sourceDocument: Yokohama Créer ou modifier des applications sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/yokohama/application-development Release : - yokohama ft:locale : - fr-FR ft:publication_title : - Yokohama Créer ou modifier des applications ft:clusterId : - cadev bundleId : - cadev workflow : - Creator --- ServiceNow Fluent ================= ServiceNow Fluent {#ariaid-title1} ================================== * Rversion finale: Yokohama * * Mis à jour 30 janv. 2025 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 minutes de lecture Définissez les métadonnées d'application dans le code source à l'aide du langage de programmation spécifique au ServiceNow Fluent domaine. Vue d'ensemble de ServiceNow Fluent {#servicenow-fluent__section_jnb_vvg_z1c} ----------------------------------------------------------------------------- ServiceNow Fluent est un langage spécifique à domaine (DSL) basé sur TypeScript pour définir les fichiers de métadonnées \[sys_metadata\] qui composent les applications et inclut des API pour les différents types de métadonnées, tels que les tables, les rôles, les ACL, les règles métier et Framework de tests automatisés les tests. Les développeurs définissent ces métadonnées en quelques lignes de code plutôt que par le biais d'un formulaire ou d'une interface utilisateur d'outil de création. Applications créées ou converties avec le ou ServiceNow SDK la prise en charge en cours de ServiceNow IDE développement dans ServiceNow Fluent. ServiceNow Fluent prend en charge la synchronisation bidirectionnelle, ce qui permet de synchroniser les modifications apportées aux métadonnées à partir d'autres Now Platform interfaces utilisateur dans le code source et de resynchroniser les modifications apportées au code source avec les métadonnées dans l'ensemble de l'instance. Remarque : L'API Framework de tests automatisés de test ne prend en charge que la synchronisation unidirectionnelle. Après la définition d'un test ATF dans le code source, si les métadonnées sont modifiées en dehors du code source, ces modifications ne sont pas synchronisées et reflétées dans le code source. Pour commencer à utiliser le ServiceNow IDE ou ServiceNow SDK, consultez la documentation ou [ServiceNow IDE](https://servicenow-prod.fluidtopics.net/CcoZW4ijTWNhOlxeivX5gA "Créez et développez des applications incluses dans le périmètre en code source dans un environnement de développement intégré (IDE) afin d’améliorer la collaboration entre les équipes de développement et d’accélérer le développement d’applications Now Platform .")[ServiceNow SDK](https://servicenow-prod.fluidtopics.net/~w2E9qd3KFxMqMf8sj15MQ "Créez et développez des applications incluses dans le périmètre du code source localement dans Visual Studio Code Desktop et chargez les modifications sur une instance à l’aide du kit de ServiceNow développement logiciel (SDK).") . API {#servicenow-fluent__section_nyj_y13_zbc} --------------------------------------------- ServiceNow Fluent inclut des API pour les types de métadonnées suivants. Vous pouvez utiliser l'API d'enregistrement pour définir les métadonnées d'application qui n'ont pas d'API dédiée. Pour en savoir plus sur les API et des exemples, consultez [ServiceNow Fluent Référence d'API](https://servicenow-prod.fluidtopics.net/qnUXZ8kuk_FzNidt6XabVg "Utilisez ServiceNow Fluent des API pour définir les métadonnées qui composent les applications incluses dans le périmètre du code source avec le ServiceNow IDE ou ServiceNow SDK.") et le référentiel [d'exemples du SDK ServiceNow](https://github.com/ServiceNow/sdk-examples) GitHub . * Listes de contrôle d'accès (ACL) * Menus d'application * Tests Framework de tests automatisés * Règles métier * Scripts clients * Listes * Propriétés * Enregistrements * Rôles * API REST basées sur un script * Tables {#servicenow-fluent__ul_cx1_db3_zbc} Utilisation {#servicenow-fluent__section_dgj_1b3_zbc} ----------------------------------------------------- Dans les fichiers avec l'extension .now.ts , utilisez des objets dans ServiceNow Fluent les API pour définir les métadonnées dans l'application. Vous devez également inclure les importations requises pour les API à partir de @servicenow/sdk/core. L'exemple suivant inclut les définitions d'une table, d'un script client et d'une règle métier dans l'application. La règle métier utilise une fonction du module JavaScript script.js . import '@servicenow/sdk/global' import { BusinessRule } from '@servicenow/sdk/core' import { ClientScript } from '@servicenow/sdk/core' import { Table, DateColumn, StringColumn } from '@servicenow/sdk/core' import { showStateUpdate } from '../server/script.js' //creates todo table, with three columns (deadline, status and task) export const x_snc_example_to_do = Table({ name: 'x_snc_example_to_do', schema: { deadline: DateColumn({ label: 'deadline' }), state: StringColumn({ label: 'State', choices: { ready: { label: 'Ready' }, completed: { label: 'Completed' }, in_progress: { label: 'In Progress' }, }, }), task: StringColumn({ label: 'Task', maxLength: 120 }), }, }) //creates a client script that pops up 'Table loaded successfully!!' message everytime todo record is loaded ClientScript({ $id: Now.ID['cs0'], name: 'my_client_script', table: 'x_snc_example_to_do', active: true, applies_extended: false, global: true, ui_type: 'all', description: 'Custom client script generated by Now SDK', messages: '', isolate_script: false, type: 'onLoad', script: script`function onLoad() { g_form.addInfoMessage("Table loaded successfully!!") }`, }) //creates a business rule that pops up state change message whenever a todo record is updated BusinessRule({ $id: Now.ID['br0'], action: ['update'], table: 'x_snc_example_to_do', script: showStateUpdate, name: 'LogStateChange', order: 100, when: 'after', active: true, }) Une fois l'application créée, ce code source génère les fichiers de métadonnées d'application suivants sur l'instance. Figure 1. Métadonnées d'application générées à partir du ServiceNow Fluent code Conseil : Vous pouvez utiliser les directives suivantes dans un commentaire de code pour vous aider à gérer votre code : * `@fluent-ignorer` : supprime les avertissements de diagnostic et les ServiceNow Fluent erreurs dans la ligne de code suivante. * `@fluent-disable-sync` : désactive la synchronisation des modifications apportées à un ServiceNow Fluent objet. À utiliser avant une expression d'appel (par exemple, `Record({ ... }))` pour désactiver la synchronisation de cet objet et de ses objets enfants. N'utilisez cette directive que si vous souhaitez ignorer les modifications apportées à l'objet en dehors du code source et ne jamais le mettre à jour lors de la synchronisation. * `@fluent-disable-sync-for-file` : désactive la synchronisation des modifications apportées à un ServiceNow Fluent fichier (.now.ts). Utilisez dans la première ligne du fichier pour désactiver la synchronisation de tout le code du fichier. N'utilisez cette directive que si vous voulez ignorer les modifications apportées au fichier en dehors du code source et ne jamais le mettre à jour lors de la synchronisation. {#servicenow-fluent__ul_dzm_xxw_ldc} **Tâches associées** * [Définir les métadonnées d'application dans le code avec ServiceNow Fluent dans le ServiceNow IDE](https://servicenow-prod.fluidtopics.net/XJBYorPpiaO~smtLGAUD8w "Définir les métadonnées d’application dans le code avec ServiceNow Fluent dans le ServiceNow IDE.") * [Définir les métadonnées d'application dans le code avec ServiceNow Fluent et le ServiceNow SDK](https://servicenow-prod.fluidtopics.net/CYWNhZ1HOqRsD0avQELECw "Définir les métadonnées d’application dans le code avec ServiceNow Fluent et le ServiceNow SDK.")