Créer ou planifier une tâche de collecte de données

Planifiez une tâche de collecte de données pour collecter régulièrement des Analyse des performances scores d’indicateurs et des instantanés.

Avant de commencer

Avant de définir des tâches de collecte de données, assurez-vous que les sources d’indicateurs, les sources de répartition et les indicateurs ont été définis. Sinon, les tâches ne peuvent renvoyer aucun résultat.

Rôles requis : pa_data_collector ou admin

Pourquoi et quand exécuter cette tâche

Les éléments importants à connaître lors de la configuration d’une tâche de collecte de données sont les suivants :

• Période de collecte
• Fuseau horaire de collecte
• Domaine des scores collectés, si des domaines sont utilisés.
• La tâche de collecte s’exécute sans aucune restriction. Il n’utilise pas les autorisations de l’utilisateur qui l’exécute.

Les travaux de collecte de données exécutent différentes étapes pour collecter des scores et pour collecter des données d’analyse de texte. Par défaut, les tâches collectent les deux types de données. Pour améliorer les performances, vous pouvez plutôt planifier des travaux distincts pour les scores et pour les données d’analyse de texte.

Procédure

1. Accédez à la Tout > Analyse des performances > Collecteur de données > Tâches et cliquez sur Nouveau.
   Vous pouvez modifier une tâche de collecte de données existante, par exemple pour modifier la planification de l’exécution de la tâche. Dans ce cas, accédez à Analyse des performances > Collecteur de données > Tâches et cliquez sur le nom de la tâche.
2. Dans le champ Nom , donnez un nom significatif à la tâche.
   Suivez un format standard pour nommer les tâches du collecteur de données, tel que [Indicateur PA] Collecte de données quotidienne, [Indicateur PA] Collecte de données historiques...
3. Dans le champ Opérateur , indiquez si les données doivent être collectées pour une période absolue ou relative.

   Valeur de l’opérateur	Description
   Fixe	Collecte les données pour une période de temps absolue.
   Relatif	Collecter les données pendant une période relative au moment où la tâche est exécutée.

4. Si vous avez choisi Fixe comme opérateur, sélectionnez Date de début fixe et Date de fin fixe .
5. Si vous avez choisi Relative comme opérateur, spécifiez les intervalles précédant l’heure d’exécution à partir desquels collecter des données.
   1. Dans les champs Début relatif et Intervalle de début relatif, définissez respectivement le nombre et la longueur des périodes passées à partir desquelles commencer à collecter des données.
   2. Dans les champs Fin relative et Intervalle de fin relative, définissez respectivement le nombre et la longueur de la dernière période passée à partir de laquelle collecter des données.
      Conseil :

      • La plupart des indicateurs, et donc la plupart des travaux de collecte de données, s’exécutent quotidiennement. Les travaux planifiés quotidiens doivent normalement être collectés pour le dernier jour terminé. Par conséquent, ils doivent avoir à la fois un début relatif et une fin relative d’il y a un jour. N’exécutez qu’une seule fois les travaux de collecte de données historiques, qui ont des périodes de collecte plus longues.
      • Si vous envisagez d’utiliser cette tâche avec des indicateurs qui utilisent des calendriers professionnels, tenez compte de l’intervalle périodes auparavant . Cet intervalle est basé sur les périodes définies pour un calendrier professionnel.
      Par exemple, vous souhaitez collecter les scores d’un ensemble de plusieurs nouveaux indicateurs avec une fréquence quotidienne, tous utilisant la même source d’indicateur. Commencez par créer une tâche de collecte de données historiques qui collecte les données d’il y a deux mois jusqu’à avant-hier. Pour cette tâche, entrez 60 dans Début relatif et jours plus tôt dans Intervalle de début relatif. Entrez 2 dans Fin relative et jours plus tôt dans Intervalle de fin relative. Définissez le champ Exécuter sur Sur demande. Cliquez sur Exécuter maintenant et exécuter cette tâche une fois pour collecter les scores initiaux.

      Créez une deuxième tâche avec le début et la fin relatifs d’il y a 1 jour et définissez le champ Exécuter sur Quotidien. Activez cette tâche pour collecter les scores d’hier et tous les scores futurs pour la veille de l’exécution de la tâche.

6. Renseignez les paramètres de la tâche, le cas échéant.

   Paramètre de la tâche	Description
   Exécuter en tant que	Pour les instances séparées par domaine, sélectionnez l’utilisateur qui exécute cette tâche. La tâche collecte les scores à partir de la table de faits et Analyse des performances des enregistrements qui ont le domaine global ou qui sont dans le domaine de cet utilisateur. La tâche de collecte de données ne suit que le domaine, pas les autorisations de cet utilisateur. Les ACL et les règles métier ne s’appliquent pas aux travaux de collecte de données. N’importe quel utilisateur peut exécuter la tâche. Important : Si vous sélectionnez une configuration de domaine pour cette tâche, elle remplace Exécuter en tant qu’utilisateur . Consultez Étape 9 dans cette rubrique.
   Exécuter en tant que tz	Sélectionnez le fuseau horaire que les requêtes utilisent lorsqu’elles sont exécutées à partir de la tâche. Utilisez le fuseau horaire de génération de rapports de votre société, s’il en existe un. Par défaut, le fuseau horaire du système est utilisé. Ce fuseau horaire détermine le jour « aujourd’hui » pour des conditions telles que [[Ouvert][le][Aujourd’hui]].
   Actif	Si cette option est sélectionnée, comme c’est le cas par défaut, la collecte de données a lieu à la date et à l’heure planifiées.
   Exécuter	Sélectionnez le calendrier de collecte des données. Les choix possibles sont les suivants : Quotidien Hebdomadaire Mensuel Périodiquement Une fois Sur demande Si vous utilisez des calendriers professionnels, vous disposez également des options suivantes, pour le début et la fin de la période du calendrier professionnel (voir Définir des entrées de calendrier professionnel) : Calendrier d’entreprise : début de l’entrée Calendrier d’entreprise : fin de l’entrée Si vous créez une tâche de collecte de données historiques, planifiez l’exécution de la tâche Sur demande.
   Jour	Si l’exécution est hebdomadaire, spécifiez le jour de la semaine. Si l’exécution est mensuelle, spécifiez le jour du mois. Pour collecter à la fin du mois, définissez l’heure sur le jour 1 et définissez l’heure peu après minuit. Ce paramètre collecte les données d’un mois complet, quelle que soit la durée du mois.
   Intervalle de répétition	Si l’exécution est périodique, spécifiez la durée entre les collectes de données planifiées, en jours et en heures.
   En cours de démarrage	Si l’exécution est périodique ou unique, spécifiez la date et l’heure de la première collecte de données planifiée.
   Heure	Temps d’exécution de la tâche, sur une horloge de 24 heures. Le champ s’affiche après la sélection de l’option Actif . Heure basée sur le fuseau horaire de votre session utilisateur, et non sur le fuseau horaire Exécuter en tant que tz . Généralement fixé à une heure entre minuit et 6 heures du matin dans votre entreprise, pour collecter la dernière période complète. Par exemple, si vous êtes à New York et que vous souhaitez collecter des données à 5 heures du matin pour votre entreprise qui est à l’heure de Los Angeles, définissez l’heure sur 08:00:00.
   Collecter	Les tâches de collecte de données ont des étapes distinctes pour la collecte des scores et pour la collecte de l’analyse de texte. Sélectionnez l’une des options suivantes : Scores uniquement Index de texte uniquement Scores et index de texte (par défaut) Pour plus d'informations, consultez Configurer l’analyse de texte.
   Conditionnel	Si cette option est activée, la collecte de données n’a lieu que si certaines conditions sont remplies.
   Conditions	Script conditionnel qui détermine si une tâche planifiée doit être exécutée. La dernière expression du script doit être évaluée à une valeur booléenne (vrai/faux). Cette zone de texte s’affiche uniquement si vous sélectionnez Utiliser les conditions. Avertissement : Les scripts conditionnels pour Analyse des performances les tâches de collecte de données sont exécutés dans le bac à sable. Par conséquent, les définitions de fonctions ne sont pas autorisées. Certains appels API et mots clés ne sont pas non plus autorisés. Pour plus d’informations, consultez Propriété de bac à sable de script. Après la mise à niveau, les tâches avec des scripts conditionnels qui contiennent ces composants d’API non autorisés se termineront par « Collecté avec des erreurs ». Ces tâches ne collectent pas de scores. La propriété système com.snc.pa.dc.script.use.sandbox contrôle si les scripts de collecte de données utilisent le bac à sable. Seuls les utilisateurs disposant du rôle security_admin peuvent modifier cette propriété. Soyez prudent lorsque vous désactivez cette propriété. Lorsque la valeur est définie sur faux, les utilisateurs non autorisés peuvent être en mesure d’exécuter des actions malveillantes sur votre instance.

7. Cliquez avec le bouton droit sur l'en-tête du formulaire, puis sélectionnez Enregistrer.
8. Dans la liste connexe Indicateurs , cliquez sur Modifier et sélectionnez les indicateurs pour lesquels cette tâche collecte des données.
   Important :

   • Inclure au moins un indicateur pour la tâche. Sinon, la tâche ne peut renvoyer aucun résultat.
   • Pour que les tâches restent maintenables, essayez de ne pas associer un indicateur à plusieurs tâches de collecte actives, sauf si vous disposez d’un cas d’utilisation clair. Si vous essayez d’obtenir des données en temps réel, envisagez d’utiliser un indicateur en temps réel.
   • La tâche de collecte de données produit une requête de base de données pour chaque source d’indicateur pour les indicateurs associés. Ainsi, les données de tous les indicateurs qui partagent une source d’indicateur représentent le même point dans le temps.
9. Si vous avez activé les configurations de domaine, vous pouvez sélectionner une configuration de domaine à associer à cette tâche dans la liste connexe Configurations de domaine .
   Les configurations de domaine sont des regroupements de domaines en fonction de leur visibilité pour un groupe d’utilisateurs ou une autre condition. Ces regroupements peuvent inclure des relations parent-enfant. Si vous sélectionnez une configuration de domaine pour une tâche, la tâche collecte les scores des enregistrements dans les domaines de la configuration, y compris le domaine global. Les configurations de domaine remplacent l’option Exécuter en tant qu’utilisateur . Pour plus d'informations, consultez Regroupement de domaines dans des Analyse des performances configurations de domaine.
10. Cliquez sur Envoyer.

Que faire ensuite

• Par défaut, pour chaque indicateur de tâche, des données sont collectées pour toutes les répartitions et l’indicateur lui-même. Pour modifier la configuration d’un indicateur, reportez-vous à la section Configurer un indicateur de tâche.
• Si vous avez activé la prise en charge de domaine, vous disposez d’une liste connexe nommée Configuration du domaine. Dans cet onglet, cliquez sur Modifier pour associer une configuration de domaine existante à cette tâche ou cliquez sur Nouveau pour créer une configuration de domaine. Pour plus d'informations, consultez Créer une configuration de domaine.