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

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 3 minutes de lecture

    • Définissez et associez un script à une table distante afin de pouvoir récupérer des données à partir d’une source externe. L’récupère Now Platform et met en cache les données de la table distante en exécutant le script par rapport à une source de données externe afin que vous puissiez les afficher ou les modifier. Vous pouvez également indiquer comment ces données externes sont mises en cache et combien de temps elles sont mises en cache 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 de scripts, reportez-vous à la rubrique Éditeur de syntaxe JavaScript.

    Procédure

    1. Accédez à la Tout > 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 de la chaîne st_ pour indiquer qu’elle est distante et qu’elle fait partie d’une application.
      • Pour une table distante dans l’application globale, le nom est précédé d’une 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. Dans le cas contraire, 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 permettant d’activer le 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 cette 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 de scripts, reportez-vous à la rubrique É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 Temps de vie du cache, exprimé en secondes, pendant lequel les données externes sont mises en cache dans la mémoire pour cette définition de script de table distante. Par exemple, saisissez 300 pour mettre en cache les données dans la mémoire pendant 5 minutes.

      La valeur maximale que vous pouvez saisir est de 60 minutes (3600 secondes).
      Capacité accrue Option permettant de sélectionner la capacité améliorée pour 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 de 1 000 lignes par défaut 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.