---
sourceDocument: Yokohama Platform Analytics
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/yokohama/now-intelligence

 Release :

    - yokohama

ft:locale :

    - fr-FR

ft:publication_title :

    - Yokohama Platform Analytics

ft:clusterId :

    - par

bundleId :

    - par

workflow :

    - Platform


---

# Indicateurs avec données externes

# Utilisation de Performance Analytics avec des données externes {#ariaid-title1}

* Rversion finale: Yokohama
* 
* Mis à jour 30 janv. 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 12 minutes de lecture

Analyse des performances sur les sources de données externes vous permet de réaliser une analyse détaillée sur des données qui ne se trouvent pas dans votre ServiceNow instance.

Lorsque vous collectez des scores sur des données externes, Analyse des performances stocke les scores et les éléments de répartition à partir des données externes sur votre instance. Les données brutes analysées restent sur la source de données externe et ne sont pas copiées sur votre instance. Cette fonctionnalité vous permet d'analyser et de partager des mesures sans dupliquer les données sous-jacentes.  
La collecte de données externes d'Analyse des performances utilise trois types d'enregistrements de configuration :

* Indicateur externe qui spécifie la source de données JDBC et l'instruction SQL utilisées pour collecter les scores.
* Une répartition externe qui spécifie la source de données JDBC et l'instruction SQL utilisée pour spécifier les éléments de répartition.
* Répartition d'indicateur externe qui définit la relation entre un indicateur externe et une répartition, ainsi que l'instruction SQL utilisée pour collecter les scores de chaque élément de répartition de cet indicateur.
{#pa-external-data__ul_dzz_dyt_2bb}

## Formats de base de données pris en charge pour les données externes {#ariaid-title2}

Analyse des performances prend uniquement en charge les formats de base de données pris ServiceNow en charge par défaut. Si un client ajoute un pilote JDBC pour un format de base de données non pris en charge, Analyse des performances il ne prend pas en charge ce format de base de données en tant que source de données externe.
{#supported-database-formats__table_ov4_ctn_lgb__entry__2}

| Type de serveur SQL | Port |
|-|-|
| MySQL | 3306 |
| Serveur Microsoft SQL | 1433 |
| Oracle | 1521 |
[Tableau 1. Formats de base de données pris en charge]

{#supported-database-formats__table_ov4_ctn_lgb}
**Information associée**   

* [Source de données de type JDBC](https://www.servicenow.com/docs/access?context=r_JDBCTypeDataSource&version=yokohama&pubname=yokohama-integrate-applications&ft:locale=en-US)

## Créer un indicateur pour les données externes {#ariaid-title3}

Créez un indicateur externe pour définir les données à évaluer et l'instruction SQL utilisée pour déterminer le score de l'indicateur.{#create-ind-ext-data__ph_create-external-indicator}

### Avant de commencer

Rôle requis : pa_admin, pa_power_user ou admin

### Procédure

1. Accédez à TousAnalyse des performancesIndicateurs externes et cliquez sur Nouveau.
2. Donnez un nom descriptif à l'indicateur.
3. Dans le champ Fréquence , spécifiez la fréquence des points de données de l'indicateur, par exemple Quotidienne, Hebdomadaire ou Mensuelle. {#create-ind-ext-data__step_ext-indicator-freq}
{#create-ind-ext-data__step_ext-indicator-freq}
4. Dans l'onglet Source , sélectionnez une source de données à partir de laquelle collecter des scores.  
   Seules les sources de données de type JDBC sont prises en charge par Analyse des performances. Consultez la documentation sur les sources de données pour plus d'informations sur la configuration des sources de données.  
   Remarque :  
   L'instruction SQL et la table des ensembles de données à importer définies dans la source de données ne sont pas utilisées par Analyse des performances.
5. Spécifiez l'instruction SQL à utiliser pour calculer la valeur du score.  
   L'instruction SQL doit renvoyer une valeur d'agrégat avec l'alias valueet doit filtrer les données en fonction d'un champ de date.  
   Important :  
   L'alias d'agrégat doit être une valeur.  
   Pour un indicateur simple, l'instruction SQL sera quelque chose comme `SELECT count(*) AS value FROM... OÙ DATE(date_field) >= DATE(${start_at}).`

   Pour les indicateurs plus complexes, vous pouvez également avoir besoin d'une condition indiquant que DATE est antérieur à la date renvoyée par DATEADD. Ici, un indicateur mensuel avec des données complexes a l'instruction `SQL SELECT count(*) AS value FROM... OÙ DATE(date_field) >= DATE(${start_at}) ET DATE(date_field) < DATEADD(month, 1, ${start_at})`.
   {#create-ind-ext-data__step_ext-indicator-sql}
{#create-ind-ext-data__step_ext-indicator-sql}
6. Si vous préférez que le score de cet indicateur augmente ou diminue avec le temps, sélectionnez Agrandir ou Réduire dans le champ Direction .  
   Les outils d'analyse et les affichages graphiques utilisent cette direction avec cet indicateur.  
   Conseil :  
   Définissez une direction chaque fois que vous le pouvez. Tous les indicateurs clés doivent être définis sur Maximiser ou Minimiser.

   | Valeur | Cas d'utilisation |
   | Agrandir | Sélectionnez si une augmentation de ce score d'indicateur est souhaitée. Par exemple, envisagez de sélectionner Maximiser pour un indicateur qui indique le chiffre d'affaires. Les outils d'analyse et les éléments graphiques montrent qu'une augmentation de ce score d'indicateur est bonne et qu'une diminution est mauvaise. |
   | Réduire | Sélectionnez si une diminution de ce score d'indicateur est souhaitée. Par exemple, envisagez de sélectionner Minimiser pour un indicateur qui affiche les coûts. Les outils d'analyse et les éléments graphiques montrent qu'une diminution de ce score d'indicateur est bonne et qu'une augmentation est mauvaise. |
   | Aucune | Sélectionnez si le sens du changement de ce score n'a pas d'importance pour votre entreprise. |
   |-|-|

   {#create-ind-ext-data__choicetable_myb_r3v_vcb}
7. **Facultatif :** Sous Propriétés de l'indicateur, spécifiez l'une des propriétés suivantes :  
   {#create-ind-ext-data__table_uh3_vsv_q2b__entry__2}{#create-ind-ext-data__row_key}{#create-ind-ext-data__row_unit}{#create-ind-ext-data__row_precision}

   | Champ | Description |
   |-|-|
   | Clé | Identifie l'indicateur comme un indicateur clé. Utilisé uniquement pour filtrer la liste des indicateurs dans Analyse des performancesCentre d'analyse. Non utilisé dans l'expérience Platform Analytics . |
   | Unité | Unité de mesure du score, telle que le nombre, les jours ou les pourcentages. Pour collecter les scores dans la devise de référence du système sur un champ Prix, Devise ou Devise FX, sélectionnez Utiliser la devise de référence. Pour plus d'informations, consultez [Scores des indicateurs dans la devise de référence](https://servicenow-prod.fluidtopics.net/md~lz89XazhoCIYhG95mmQ "Vous pouvez suivre les tendances des champs monétaires des types Prix, Devise ou Devise FX. Les scores d’un indicateur basé sur l’un de ces champs sont collectés dans les valeurs de la devise de référence."). Si vous sélectionnez % ou une période comme unité, envisagez d'exclure certains types de séries chronologiques de l'application à l'indicateur. Pour plus d'informations, consultez [Exclure les séries chronologiques d'un indicateur](https://servicenow-prod.fluidtopics.net/0MKu5cFWu943uPhrRCillA "Certaines agrégations de séries chronologiques ne peuvent pas être appliquées à certains indicateurs. Vous pouvez exclure les séries chronologiques sur les indicateurs automatisés, de formule et manuels. Les séries chronologiques exclues ne peuvent pas être sélectionnées dans les Centre d'analyse widgets , Détails des KPI ou . D’autres séries chronologiques restent sélectionnables."). Si vous sélectionnez l'heure comme unité, les heures sont exprimées sous forme de jours, d'heures et de minutes. Si la propriété glide.ui.duration.seconds.enabled système existe et est vraie, les secondes s'affichent également. Dans ce cas, les secondes sont également affichées pour les champs de tous les temps sur l'instance et sont incluses dans les exportations vers Microsoft Excel. |
   | Précision | Le nombre de chiffres après le séparateur décimal. Pour plus d'informations, consultez [Arrondi et précision des indicateurs](https://servicenow-prod.fluidtopics.net/TXmMPzF9OPUEITsceQ8TwQ "Les indicateurs arrondissent les résultats fractionnaires à l’aide de l’arrondi du banquier ou de l’arrondi mathématique en fonction de la précision de l’indicateur."). Ce champ n'est pas disponible lorsque l'unité est Utiliser la devise de référence. Dans ce cas, la précision est héritée de la devise de référence. |
   | Format de nombre | Abréviations utilisées pour les grands nombres, des milliers aux trillions. Pour plus d'informations, consultez [Arrondi et précision des indicateurs](https://servicenow-prod.fluidtopics.net/TXmMPzF9OPUEITsceQ8TwQ "Les indicateurs arrondissent les résultats fractionnaires à l’aide de l’arrondi du banquier ou de l’arrondi mathématique en fonction de la précision de l’indicateur."). |
   [ ]

   {#create-ind-ext-data__table_uh3_vsv_q2b}
8. Dans l'onglet Contrôle d'accès , indiquez s'il faut enregistrer cet indicateur dans la bibliothèque et s'il faut limiter la visibilité de l'indicateur par utilisateur, groupe ou rôle.  
   L'activation de l'option Afficher dans la bibliothèque signifie que l'indicateur sera disponible aux emplacements suivants :
   * Bibliothèque d'indicateurs Platform Analytics
   * Détails des KPI
   * Centre d'analyse, mais uniquement sur les instances mises à niveau qui n'ont pas encore été entièrement migrées vers Platform Analytics
   {#create-ind-ext-data__ul_hd3_lrn_1bc} {#create-ind-ext-data__cmd_access-control-fields}
9. **Facultatif :** Dans l'onglet Other (Autre ), définissez diverses propriétés diverses.  
   {#create-ind-ext-data__table_hft_ltv_q2b__entry__2}{#create-ind-ext-data__row_default-time-series}{#create-ind-ext-data__row_live-group-profile}{#create-ind-ext-data__row_order}{#create-ind-ext-data__row_render-cont-lines}

   | Champ | Description |
   |-|-|
   | Séries chronologiques par défaut | Fonction analytique prédéfinie, telle qu'une moyenne glissante sur 7 jours, à appliquer à l'indicateur au lieu d'afficher les scores bruts de l'indicateur.{#create-ind-ext-data__ph_time-series-desc} Pour plus d'informations, consultez [Application d'agrégations de séries chronologiques](https://servicenow-prod.fluidtopics.net/wnwaBEcEX7NNSGXKV696Uw#applying-time-series-aggregations "Vous pouvez agréger les changements des indicateurs en intervalles de temps distincts. Ces agrégations peuvent rendre les tendances plus facilement visibles ou aider à suivre les progrès par rapport à une cible."). Remarque : Vous ne pouvez pas définir les séries chronologiques par défaut pour un indicateur qui utilise un calendrier commercial ou fiscal. Ces calendriers ne prennent pas en charge les agrégations de séries chronologiques. |
   | Profil de groupe actif | Enregistrement de profil de groupe actif \[live_group_profile\] pour un groupe Flux en direct. Spécifiez un profil de groupe pour que ce groupe reçoive des notifications sur cet indicateur. Pour en savoir plus sur cette application sociale, consultez la Now Platform rubrique [Flux en direct](https://www.servicenow.com/docs/access?context=c_GetStartedWithLiveFeed&version=yokohama&pubname=yokohama-servicenow-platform&ft:locale=en-US). |
   | Ordre | Nombre indiquant l'ordre dans lequel les indicateurs sont affichés dans le Centre d'analyse. Les indicateurs avec la valeur la plus faible sont affichés en haut de la liste. Si aucune valeur n'est fournie dans le champ Commande , les indicateurs s'affichent de a à z dans le champ Nom . Pour utiliser le champ Commande, vous devez saisir des numéros de commande pour tous les indicateurs. Si vous entrez des chiffres pour seulement quelques indicateurs, l'ordre dans lequel les indicateurs sont affichés revient de a à z. Non utilisé dans l'expérience Platform Analytics . |
   | Type de graphique par défaut | Définissez un type de graphique par défaut (ligne, colonne, spline ou aire) pour cet indicateur. Lorsque vous ouvrez ou Centre d'analyseDétails des KPI pour cet indicateur pour la première fois, le type de graphique par défaut est utilisé. Si le type de graphique est modifié dans le Centre d'analyse ou Détails des KPI, cette préférence est mémorisée. |
   | Afficher des lignes continues | Lorsque cette option est sélectionnée, le Centre d'analyse et Détails des KPI affiche des lignes de données ininterrompues pour cet indicateur, même en l'absence de données pour une date spécifique. Ce comportement peut être utile lors de l'affichage d'ensembles de données avec des dates de début variables ou pour des données qui ne sont pas régulièrement mises à jour, telles que des informations de stock. Les lignes continues ne sont pas rendues lorsqu'une série chronologique est définie sur l'indicateur ou sur le Centre d'analyse ou Détails des KPI. |
   | Afficher le score en temps réel | Lorsque cette option est sélectionnée, le Centre d'analyse et Détails des KPI peut afficher le score de cet indicateur en temps réel, ainsi que l'état actuel des enregistrements associés. Décochez cette case lorsque les données de l'indicateur ne sont pas disponibles en temps réel, comme dans une intégration qui utilise des données provenant d'une source tierce. Pour plus d'informations, consultez [Scores en temps réel](https://servicenow-prod.fluidtopics.net/8EOxuV6jsT9j2JldxpNkyA "Vous pouvez afficher certains Analyse des performances scores en temps réel plutôt qu’à partir de la tâche de collecte de données la plus récente. Si les scores en temps réel sont activés, vous pouvez les afficher dans Détails des KPI et dans certaines visualisations de données."). Remarque : Une condition doit être définie sur l'indicateur ou la source d'indicateur associée pour que les scores en temps réel soient affichés. |
   [Tableau 2. Champs de l'onglet \<\< Autre \>\>]

   {#create-ind-ext-data__table_hft_ltv_q2b}  
   Par exemple, dans l'onglet Autre, vous pouvez configurer un indicateur comme suit :
   * Par défaut, il affiche une somme cumulée des scores sur 30 jours dans les widgets. Vous pouvez remplacer cette valeur par défaut dans les , , les widgets du tableau de bord ou la visualisation des données de l'espace Centre d'analyseDétails des KPI de travail.
   * Le groupe IT Live est informé des changements apportés à l'indicateur.
   * L'indicateur est répertorié en troisième position dans la Centre d'analyse liste des indicateurs. La position de tous les autres indicateurs est également spécifiée. Ce paramètre n'affecte pas l'ordre des indicateurs sur Détails des KPI.
   * Le type de graphique par défaut est Spline sur Détails des KPI.
   * Les lignes de données de l'indicateur sont affichées ininterrompues, même lorsque des données sont manquantes.
   * Détails des KPI peut afficher le score de cet indicateur en temps réel.

   {#create-ind-ext-data__ul_x5k_rzc_lwb}

10. **Facultatif :** Dans l'onglet Prévision , définissez la méthode de prévision, le nombre de périodes de collecte de données à prévoir, la quantité de données historiques sur laquelle baser la prévision et les limites supérieure et inférieure des valeurs de prévision.  
    Pour plus d'informations, consultez [Prévisions des scores d'Analyse des performances](https://servicenow-prod.fluidtopics.net/wnCezAM2YndmbLdVGfGbxw#c_ForecastingData "Analyse des performances vous permet de prévoir les scores futurs en fonction du comportement passé. Vous pouvez prévoir les scores sur les widgets de séries chronologiques, Détails des KPI les visualisations de données de séries chronologiques et le .Centre d'analyse Les scores de prévision s’affichent sous la forme d’une ligne pointillée."). {#create-ind-ext-data__cmd_forecasting-fields}
11. Enregistrez l'indicateur.
12. Press Test Collection.  
    Cette action teste la requête principale de l'indicateur.

### Que faire ensuite

Si vous souhaitez collecter les scores de répartition pour l'indicateur, définissez une répartition externe et associez-la à l'indicateur.

## Créer une répartition à l'aide de données externes {#ariaid-title4}

Créez une répartition externe pour définir les éléments disponibles pour répartir les scores des indicateurs externes.{#create-bd-ext-data__ph_ext-bkdwn-short-desc}

### Avant de commencer

Rôle requis : pa_admin, pa_power_user ou admin

### Pourquoi et quand exécuter cette tâche

Par défaut, une répartition externe peut contenir un maximum de 5 000 éléments. Cette limite est contrôlée par la propriété com.snc.pa.dc.max_external_elements.

Les éléments de répartition externes sont stockés dans les tables pa_ext_elements.

### Procédure

1. Accédez à TousAnalyse des performancesRépartitions externes.
2. Cliquez sur Nouveau.
3. Sélectionnez une source de données qui contient les enregistrements que vous souhaitez utiliser comme [éléments de répartition](https://servicenow-prod.fluidtopics.net/ovhhdNydRSr_rf~a~ytTKw#gloss-breakdown-element "Valeurs d’une répartition. Par exemple, la répartition Priorité peut comporter les éléments Critique, Élevée et Faible.").  
   Seules les sources de données de type JDBC sont prises en charge par Analyse des performances. Consultez la documentation sur les sources de données pour plus d'informations sur la configuration des sources de données.  
   Remarque :  
   L'instruction SQL et la table des ensembles de données à importer définies dans la source de données ne sont pas utilisées par Analyse des performances. {#create-bd-ext-data__step_ext-bkdwn-data-source}
{#create-bd-ext-data__step_ext-bkdwn-data-source}
4. Spécifiez une instruction SQL pour sélectionner les éléments de répartition.  
   L'instruction SQL doit renvoyer la clé unique de chaque élément de répartition avec l'alias id et le nom d'affichage de l'élément avec l'alias name, tel que `SELECT GUID AS id, user_name AS name FROM...`.  
   Important :  
   L'alias de clé unique doit être ID et l'alias du nom d'affichage doit être nom. {#create-bd-ext-data__step_ext-bkdwn-sql}
{#create-bd-ext-data__step_ext-bkdwn-sql}
5. Enregistrez la répartition.
6. Press Test Collection.  
   Cette action teste la requête qui sélectionne les éléments de répartition.
{#create-bd-ext-data__steps_opj_t3b_t1b}

### Que faire ensuite

Après avoir défini comment collecter les éléments de répartition, associez la répartition externe à un ou plusieurs indicateurs externes.

## Configurer un indicateur externe pour utiliser une répartition externe {#ariaid-title5}

Associez un indicateur externe et une répartition externe pour définir la façon de collecter les scores de répartition pour l'indicateur.

### Avant de commencer

Rôle requis : pa_admin, pa_power_user ou admin

### Procédure

1. Accédez à TousAnalyse des performancesIndicateurs externes.
2. Sélectionnez un indicateur.
3. Dans la liste connexe Répartitions , cliquez sur Nouveau.
4. Sélectionnez la répartition externe à appliquer à cet indicateur.
5. Dans le champ Instruction SQL , entrez une instruction SQL qui calcule la valeur de score pour chaque élément de répartition.  
   L'instruction SQL doit utiliser la même fonction d'agrégat que l'instruction SQL d'indicateur, telle que COUNT. L'instruction SQL doit renvoyer la valeur d'agrégat avec l'alias value et la clé unique de l'élément de répartition avec l'ID d'alias. L'instruction SQL doit également regrouper les données par la colonne qui contient les valeurs des éléments de répartition.  
   Par exemple, `SELECT count(*) AS value, guid as id FROM... WHERE DATE(date_field) >= DATE({$start_at}) GROUP BY GUID`  
   Important :  
   L'alias d'agrégat doit être une valeur et l'alias de clé unique de répartition doit être id.
6. Enregistrez vos changements.
7. Press Test Collection.  
   Cette action teste l'instruction SQL qui calcule la valeur de score de l'élément de répartition.

### Que faire ensuite

Répétez les étapes précédentes pour ajouter des répartitions supplémentaires à l'indicateur. Testez l'instruction SQL après l'avoir ajoutée.

## Tester les indicateurs externes et les répartitions {#ariaid-title6}

Testez vos indicateurs externes et répartitions pour vous assurer que vous pouvez vous connecter à la source de données externe et collecter les données attendues.

### Avant de commencer

Rôle requis : pa_admin, pa_power_user ou admin

### Pourquoi et quand exécuter cette tâche

Testez un indicateur pour tester la requête de cet indicateur et les requêtes pour tous les éléments de répartition. Testez une répartition pour tester la requête utilisée pour déterminer les éléments de répartition disponibles.

Aucun score ou élément de répartition n'est enregistré lorsque vous testez un indicateur ou une répartition.

### Procédure

1. Accédez à TousAnalyse des performancesIndicateurs externes ou Analyse des performancesRépartitions externes.
2. Sélectionnez l'indicateur ou la répartition que vous souhaitez tester.
3. Cliquez sur le bouton Test .  
   Si la requête s'exécute avec succès, le nombre de scores ou d'éléments de répartition qui seraient collectés s'affiche. Si une erreur se produit pendant le test, le message d'erreur s'affiche.

### Que faire ensuite

Après avoir confirmé que toutes les requêtes s'exécutent correctement et renvoient les données attendues, ajoutez l'indicateur externe à une tâche de collecte de données pour commencer à collecter des scores.

## Filtrer les données externes par date {#ariaid-title7}

Lorsque vous utilisez Analyse des performances avec des données externes, vous devez filtrer les instructions SQL qui collectent les scores par date.

Dans les instructions SQL d'indicateur et de répartition d'indicateur, filtrez la requête par date, par exemple `WHERE DATE(my_date_field) >= DATE(${start_at}).` Il n'est pas nécessaire de filtrer les instructions SQL de répartition par date, car les instructions SQL de répartition collectent uniquement des éléments et non des scores.

La variable ${start_at} contient la date de la période collectée au format AAAAMMJJ. Pour les indicateurs quotidiens, cette valeur correspond toujours à la date de collecte. Pour les indicateurs avec des fréquences de collecte plus longues, telles que hebdomadaire ou mensuelle, la date est le premier jour de la période de collecte. La date à laquelle la tâche de collecte de données s'exécute n'affecte pas cette variable.

Lorsque vous testez un indicateur ou une répartition, la variable ${start_at} est toujours définie sur la date actuelle.

## Limitations lors de l'utilisation d'Analyse des performances avec des données externes {#ariaid-title8}

Certaines fonctionnalités d'Analyse des performances ne sont pas disponibles lorsque vous mesurez des données externes.
* Vous ne pouvez pas collecter d'instantanés
* Vous ne pouvez pas afficher les scores en temps réel
* Vous ne pouvez pas appliquer de répartitions de niveau 2
* Vous ne pouvez pas utiliser de visualisations de widgets qui dépendent de répartitions de niveau 2 avec des données externes. Cela inclut les visualisations de tableaux croisés dynamiques et de cartes thermiques.
* Étant donné que les instantanés ne sont pas disponibles, vous ne pouvez pas afficher les changements dans les enregistrements collectés
{#pa-ext-data-limitations__ul_gh2_gbb_t1b}