Planifier une exportation

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 4 minutes de lecture

    • Vous pouvez planifier une exportation pour transmettre régulièrement par push des données d’un jeu de données à exporter vers une destination distante. En configurant une exportation récurrente et planifiée, vous pouvez régulièrement transférer des données vers un emplacement externe, par exemple pour la génération de rapports 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 afin d’exporter uniquement des enregistrements nouveaux ou modifiés à l’aide des exportations de différentiels.

    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. Planifier les champs d’exportation de données
      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 sous 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écution Sélectionnez la fréquence de l’exportation planifiée.
      Jour Sélectionnez le jour de la semaine ou du mois auquel 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ériodiquement.
      Heure Entrez l’heure de la journée à 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 d’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 de sauvegarder l’enregistrement de l’exportation de données planifiée. Une erreur s’affiche en haut du formulaire lors de 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 de différentiels, 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 différentiel d’exportation, en fonction du différentiel le ou après la valeur.
      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 l’exportation des donné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 souhaitez 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 de différentiels d’ensembles de données à exporter planifiées

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

    Vous ne pouvez utiliser l’exportation de différentiels que pour les tables régulières, telles que les tables de tâches et de problèmes.
    Important :
    Vous ne pouvez pas utiliser l’exportation delta 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 de champs système tels que sys_created activé, sys_created par et sys_updated. É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 delta 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.

    Exportation planifiée pour définir les options de scripting

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

    Utilisez ces objets dans les scripts d’exportation planifiée d’un jeu de données, tels que les champs Pré-script et Post-script .
    annuler
    Définissez cet objet sur vrai pour arrêter l’action d’exportation. Toutes les exportations de jeux de données enfants sont également annulées si le parent est annulé. Cet objet est disponible uniquement dans le champ Pré-script .
    Exemple : utilisez le champ Pré-script pour évaluer les conditions de l’exportation et déterminer s’il y a lieu 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 Pré-script et Post-script.

    Exemple : si vous souhaitez utiliser les 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;