Créer une définition de script pour une table distante

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 3 minutes de lecture

    • Définissez un script et associez-le à une table distante afin de pouvoir récupérer des données à partir d’une source externe. Le Now Platform récupère et met en cache les données pour la table distante en exécutant le script par rapport à une source de données externe afin que vous puissiez l’afficher ou la modifier. Vous pouvez également indiquer la manière dont ces données externes sont mises en cache et la durée de mise en cache des données dans la mémoire jusqu’à ce que le script doive s’exécuter à nouveau.

    Avant de commencer

    Rôle requis : admin

    Pourquoi et quand exécuter cette tâche

    Vous créez des définitions de script pour les tables distantes comme vous le faites pour d’autres scripts. Pour en savoir plus sur la saisie, la modification et le débogage des scripts, consultez Éditeur de syntaxe JavaScript.

    Procédure

    1. Accédez à la Tous > Définition du système > Tables distantes > Définition.
    2. Cliquez sur Nouveau.
    3. Renseignez les champs du formulaire.
      Contrôle Description
      Nom

      Nom du script que vous créez pour l’associer à la table distante sélectionnée.
      Table
      Nom de la table distante à laquelle vous souhaitez associer le script que vous créez.
      • Pour une table distante dans une application incluse dans le périmètre, le nom est précédé d’un identificateur d’espace de noms et la chaîne st_ pour indiquer qu’elle est distante et qu’elle fait partie d’une application.
      • Pour une table distante de l’application globale, le nom est précédé de la chaîne u_st_.
      Application Application associée à cette table distante. Si vous travaillez sur une application ou créez une table distante à partir d’un enregistrement d’application, le champ est défini par défaut sur cette application. Sinon, le champ est défini par défaut sur Global. Tous les enregistrements créés à partir de l’enregistrement de table, tels que les modules et les règles de sécurité, sont affectés à cette application par défaut.
      Actifs Option d’activation du script que vous associez à la table distante. Vous pouvez avoir plusieurs définitions de script inactives pour une table distante, mais vous ne pouvez avoir qu’une seule définition de script active.
      Avancé Option permettant d’accéder à la section Mise en cache pour désigner le mode de fonctionnement de la mise en cache de la mémoire dans la Now Platform table distante.
      Remarque :
      Seuls les utilisateurs avancés doivent définir les paramètres de mise en cache pour une table distante.
    4. Dans la section Script, ajoutez votre syntaxe JavaScript au modèle squelette :
      Remarque :
      La section Script s’affiche uniquement lorsque le champ Flux est vide.
      Modèle d’éditeur de script de table distante
      Remarque :
      Pour en savoir plus sur la saisie, la modification et le débogage des scripts, consultez Éditeur de syntaxe JavaScript.
    5. Dans la section Mise en cache, indiquez comment ces données sont mises en cache et combien de temps elles sont mises en cache dans la mémoire du Now Platform:
      Champ Description
      Cache TTL La durée de vie du cache, exprimée en secondes, pendant laquelle les données externes sont mises en cache dans la mémoire pour cette définition de script de table distante. Par exemple, entrez 300 pour mettre en cache les données dans la mémoire pendant 5 minutes.

      La valeur maximale que vous pouvez entrer est de 60 minutes (3 600 secondes).
      Capacité accrue Option permettant de sélectionner la capacité améliorée afin de prendre en charge plus de 1 000 lignes dans une table distante.
      Remarque :
      Si la taille des données récupérées à partir de la source externe est petite, utilisez la limite par défaut de 1 000 lignes dans une table distante pour réduire les temps de requête. Vous pouvez utiliser la fonctionnalité Capacité étendue si la taille des données récupérées est importante et peut être moins performante.
      Remarque :
      Par défaut, les données externes sont mises en cache dans la mémoire par l’utilisateur.
    6. Cliquez sur Envoyer.

    Résultats

    Lorsque vous activez une définition de script, vous l’associez à la table distante afin de pouvoir récupérer et mettre en cache les données externes.