Planifier une exportation

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

    • Vous pouvez planifier une exportation pour transférer régulièrement les données d’un jeu d’exportation vers une destination distante. En configurant une exportation récurrente et planifiée, vous êtes en mesure d’envoyer régulièrement des données vers un emplacement externe, par exemple pour la création de rapports ou 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 d’exportation planifiés pour exporter uniquement des enregistrements nouveaux ou modifiés à l’aide des exportations delta.

    Procédure

    1. Accédez à la Tous > Ensembles d'exportation 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 jeu 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écution Sélectionnez la fréquence d’exportation planifiée.
      Jour Sélectionnez le jour de la semaine ou du mois où vous souhaitez exécuter cette exportation planifiée. Ce champ apparaît 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 apparaît lorsque le champ Exécuter est défini sur Périodique.
      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 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 de sauvegarder l’enregistrement de l’exportation de données planifiée. Dans cet événement, une erreur apparaît en haut du formulaire.
      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 différentiel d’exportation, en fonction de la valeur delta le ou après .
      Scripts
      Conditionnel Case à cocher 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 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 planifiées de jeux de données

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

    Vous pouvez utiliser l’exportation delta uniquement 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 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 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.

    Options de scripting de jeux d’exportation planifiée

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

    Utilisez ces objets dans les scripts de jeu d’exportation planifiés, tels que les champs Pre-script et Post-script .
    annuler
    Définissez cet objet sur true pour arrêter l’action d’exportation. Tous les ensembles d’exportation 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 Script préalable 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
    Obtenir l’objet GlideRecord pour le nouveau jeu de données d’exportation. Cette variable vous permet d’interroger les colonnes suivantes depuis 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 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;