Créer ou planifier une tâche 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’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éfinies. Sinon, les tâches ne peuvent pas retourner de résultats.

Rôles requis : pa_data_collector ou admin

Pourquoi et quand exécuter cette tâche

Les éléments importants à connaître lorsque vous configurez 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 tâches de collecte de données exécutent différentes étapes pour collecter les scores et 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 Tous > 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 de collecte 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 absolue.
   Relatif	Collectez les données pour une période relative à l’heure d’exécution de la tâche.

4. Si vous avez sélectionné Fixe comme opérateur, sélectionnez les options Date de début fixe et Date de fin fixe .
5. Si vous avez sélectionné Relative comme opérateur, spécifiez les intervalles avant la durée d’exécution à partir desquels 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 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 le nombre et la durée, respectivement, 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 tâches de collecte de données, s’exécutent quotidiennement. Les tâches planifiées quotidiennes devraient normalement être collectées pour la dernière journée terminée. Par conséquent, ils doivent avoir à la fois un début relatif et une fin relative d’il y a un jour. Exécutez les tâches de collecte de données historiques, qui ont des périodes de collecte plus longues, une seule fois.
      • Si vous envisagez d’utiliser cette tâche avec des indicateurs qui utilisent des calendriers d’entreprise, tenez compte de l’intervalle des périodes . 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’avant-hier mois à la période d’avant-hier. Pour cette tâche, entrez 60 dans Début relatif et Il y a jours 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 seule fois pour collecter les scores initiaux.

      Créez une deuxième tâche avec un démarrage et une 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 de la journée précédente 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 à 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 suit uniquement le domaine, et non 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 de 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 quel jour est « 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 se produit aux date et heure prévues.
   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 les entrées du calendrier d’entreprise) : 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 le champ Exécution est défini sur Hebdomadaire, spécifiez le jour de la semaine. Si le champ Exécution est défini sur Mensuel, 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 pour un mois complet, quelle que soit la durée du mois.
   Intervalle de répétition	Si l’option Exécuter 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 Une fois, 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, au format 24 heures. Le champ s’affiche une fois que l’option Actif est sélectionnée. 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 travaux de collecte de données comportent 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 Les scores et l’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é 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 détermine 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é. Lorsqu’elle est définie sur faux, les utilisateurs non autorisés peuvent 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 retourner de résultats.
   • Pour que les tâches restent maintenables, essayez de ne pas associer un indicateur à plusieurs tâches de collecte actives à moins d’avoir 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 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 regroupent des domaines en fonction de leur visibilité pour un groupe d’utilisateurs ou d’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 Exécuter en tant qu’utilisateur . Pour plus d'informations, consultez Regroupement de domaines dans Analyse des performances des configurations de domaines.
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 pour un indicateur, reportez-vous à la section Configurer un indicateur de tâche.
• Si vous avez activé la prise en charge du domaine, vous avez 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 nouvelle configuration de domaine. Pour plus d'informations, consultez Créer une configuration de domaine.