Planifier un export

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

    • Vous pouvez planifier une exportation pour transmettre régulièrement les données d’un jeu d’exportation vers une destination distante. En configurant une exportation périodique et planifiée, vous êtes en mesure de transmettre régulièrement les données vers un emplacement externe, par exemple pour le reporting ou pour la conservation d’un instantané des données.

    Avant de commencer

    Rôle requis : export_set_scheduler ou export_set_admin

    Pourquoi et quand exécuter cette tâche

    Vous pouvez configurer des ensembles de données à exportations planifiées pour exporter uniquement des enregistrements nouveaux ou modifiés à l’aide d’exportations delta.

    Procédure

    1. Accédez à la Tout > Ensembles de données à exportations système > Administration > Exportations planifiées.
    2. Cliquez sur Nouveau.
    3. Renseignez les champs suivants.
      Tableau 1. Champs d’exportation de données de calendrier
      Champ Description
      Nom Entrez un nom descriptif pour cette exportation planifiée.
      Exporter un ensemble de données Sélectionnez l’exportation d’un jeu de données à planifier.
      Exécuter en tant que Sélectionnez l’utilisateur avec lequel exécuter l’exportation planifiée. Assurez-vous que l’utilisateur dispose de tous les rôles nécessaires pour afficher les données à exporter.
      Exécuter Sélectionnez la fréquence d’exportation planifiée.
      Jour Sélectionnez le jour de la semaine ou du mois où exécuter cette exportation planifiée. Ce champ s’affiche lorsque le champ Exécuter est défini sur Hebdomadaire ou Mensuel
      Intervalle de répétition Entrez le nombre de jours et d’heures à attendre avant de répéter cette exportation planifiée. Ce champ s’affiche lorsque le champ Exécuter est défini sur Périodique.
      Heure Entrez l’heure du jour à laquelle exécuter l’exportation planifiée.
      Exportations de différentiels
      Activer les exportations de différentiels Cochez cette case pour activer la fonctionnalité delta pour cette exportation planifiée. Lorsque cette option est sélectionnée, seuls les enregistrements nouveaux ou modifiés sont exportés.
      Différentiel le ou après le Sélectionnez Mis à jour pour exporter tous les enregistrements qui ont changé depuis la dernière exportation, y compris les nouveaux enregistrements. Sélectionnez Créé pour exporter uniquement les nouveaux enregistrements créés après la dernière exportation.
      Remarque :
      Si la définition de l’exportation inclut déjà une condition de filtre sur les champs sys_updated_on ou sys_created_on, l’activation des exportations de différentiels vous empêchera d’enregistrer l’enregistrement de l’exportation de données planifiée. Une erreur apparaît en haut du formulaire dans cet événement.
      Exécution planifiée de la dernière exportation Laissez ce champ vide pour exporter tous les enregistrements à partir de la définition d’exportation. Lors de l’utilisation des exportations delta, ce champ est défini automatiquement chaque fois que l’exportation planifiée s’exécute. Les enregistrements mis à jour ou créés après ces date et heure sont inclus dans le delta d’exportation, en fonction de la valeur de delta égal ou postérieur .
      Scripts
      Conditionnel Cochez cette case pour exécuter le calendrier uniquement lorsqu’une condition est remplie.
      Condition Écrivez le script à utiliser pour évaluer si l’exportation doit s’exécuter. Ce champ est visible si vous cochez la case Conditionnel .
      Exécuter le script avant exportation Cochez cette case pour exécuter un script avant le début de l’exportation.
      Script pré-traitement Écrivez le script que vous souhaitez exécuter avant que les données ne soient exportées. Ce champ est visible si vous avez coché la case Exécuter le script avant exportation .
      Exécuter le script après exportation Cochez cette case pour exécuter un script une fois l’exportation terminée.
      Script post-traitement Écrivez le script que vous voulez exécuter une fois l’exportation terminée. Ce champ est visible si vous avez coché la case Exécuter le script après exportation .
    4. Cliquez sur Envoyer.

    Que faire ensuite

    Vous pouvez cliquer sur le bouton Exécuter maintenant pour exécuter l’exportation immédiatement et confirmer que les données sont exportées comme prévu.

    Exportations planifiées des ensembles de données à exporter

    Les exportations de différentiels incluent uniquement les enregistrements qui ont changé depuis la dernière exportation planifiée.

    Vous pouvez utiliser l’exportation delta uniquement pour les tables standard, telles que les tables de tâches et de problèmes.
    Important :
    Vous ne pouvez pas utiliser l’exportation de différentiel pour une table de vue de base de données, qui est une table virtuelle qui joint des tables physiques.

    Une vue de base de données n’inclut pas les champs système tels que sys_created activé, sys_created par et sys_updated activé. Étant donné que les champs de date système ne sont pas inclus dans la vue de base de données, vous ne pouvez pas utiliser les exportations de différentiels avec les vues de base de données, car il n’existe aucun moyen de savoir quand la table a été mise à jour pour la dernière fois.

    Options de scripting des ensembles de données à exportations planifiées

    Lors de la planification d’une exportation d’un jeu de données, vous pouvez accéder à certains objets JavaScript.

    Utilisez ces objets dans des scripts de jeu d’exportation planifiés, tels que les champs Pré-script et Post-script .
    annuler
    Définissez cet objet sur vrai pour arrêter l’action d’exportation. Tous les ensembles de données à exporter enfants sont également annulés si le parent est annulé. Cet objet n’est disponible que dans le champ Pre-script .
    Exemple : utilisez le champ Pre-script pour évaluer les conditions de l’exportation et déterminer s’il convient d’annuler le processus d’exportation. Pour annuler le processus d’exportation, utilisez l’appel suivant :
    cancel = true;
    export_set
    Obtenez l’objet GlideRecord pour le nouveau jeu de données à exporter. Cette variable vous permet d’interroger les colonnes suivantes à partir de la table sys_export_set :
    • nom
    • sys_id
    • État
    • table_name

    Cet objet est disponible dans les champs Pre-script et Post-script .

    Exemple : si vous souhaitez utiliser des informations de l’exportation d’un jeu de données, vous pouvez spécifier l’une des propriétés de la variable export_set.

    var x = export_set.sys_id;