Créer ou planifier un travail de collecte de données

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

Avant de commencer

Avant de définir les 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 pas renvoyer de résultats.

Rôles requis : pa_data_collector ou admin

Pourquoi et quand exécuter cette tâche

Les éléments importants à savoir lorsque vous configurez un travail de collecte de données sont les suivants :

• Période de collecte
• Fuseau horaire de collecte
• Scores collectés dans le domaine, 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 tâches de collecte de données exécutent différentes étapes pour collecter les scores et pour collecter les 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 à la place planifier des tâches distinctes 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 à la place une tâche de collecte de données existante, par exemple pour modifier le calendrier d’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 vous souhaitez collecter des données pour une période de temps absolue ou relative.

   Valeur de l’opérateur	Description
   Fixe	Collecte les données pour une période de temps absolue.
   Relatif	Collecter des données pour une période de temps relative à l’heure d’exécution de la tâche.

4. Si vous avez sélectionné Fixe comme opérateur, sélectionnez la date de début fixe et la date de fin fixe .
5. Si vous avez sélectionné Relatif comme opérateur, spécifiez les intervalles avant l’heure d’exécution à partir de laquelle collecter les données.
   1. Dans les champs Début relatif et Intervalle de début relatif, définissez respectivement le nombre et la durée, respectivement, de périodes dans le passé à 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 durée de la dernière période antérieure à 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. Exécuter une seule fois les tâches 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 de périodes précédentes . 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. Tout d’abord, vous créez 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, saisissez 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écutez cette tâche une fois pour collecter les scores initiaux.

      Créez une deuxième tâche avec un démarrage relatif et une fin 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 de la veille de l’exécution de la tâche.

6. Renseignez les paramètres de la tâche comme il convient.

   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 des tables de faits et Analyse des performances des enregistrements qui ont soit le domaine global, soit qui sont dans le domaine de cet utilisateur. Le travail de collecte de données suit uniquement 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 l’option Exécuter en tant qu’utilisateur . Reportez-vous à la section Étape 9 dans cette rubrique.
   Exécuter en tant que tz	Sélectionnez le fuseau horaire utilisé par les requêtes 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][sur][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 la planification pour la 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 les entrées du 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 la tâche pour qu’elle s’exécute sur demande.
   Jour	Si 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 le jour 1 et l’heure peu après minuit. Ce paramètre collecte les données d’un mois terminé, quelle que soit la durée du mois.
   Intervalle de répétition	Si Exécuter est Périodiquement, 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	Heure d’exécution de la tâche, sur une horloge de 24 heures. Le champ s’affiche une fois que Actif est sélectionné. 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 réglé sur 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 comportent des étapes distinctes pour la collecte des scores et pour la collecte des analyses 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 s'exécuter. 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 Conditions d’utilisation. Avertissement : Les scripts conditionnels pour Analyse des performances les travaux 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é du 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é. Faites preuve de prudence lorsque vous éteignez cette propriété. Si elle 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 :

   • Incluez au moins un indicateur pour la tâche. Sinon, la tâche ne peut pas renvoyer de résultats.
   • Pour garantir la maintenance des tâches, essayez de ne pas associer un indicateur à plusieurs tâches de collecte actives, à moins que vous n’ayez 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.
   • Le travail de collecte de données génère une requête de base de données pour chaque source d’indicateur des 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 regroupent des domaines en fonction de leur visibilité pour un utilisateur, un groupe 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 Analyse des performances des configurations de domaine.
10. Cliquez sur Envoyer.

Que faire ensuite

• Par défaut, pour chaque indicateur de tâche, les données sont collectées pour toutes les répartitions et l’indicateur lui-même. Pour modifier cette 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 de 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 nouvelle configuration de domaine. Pour plus d'informations, consultez Créer une configuration de domaine.