Récupérez le contenu et les métadonnées interrogeables à partir de votre système source avec une analyse de contenu. Exécutez l’analyse comme une tâche ponctuelle ou planifiez-la pour qu’elle s’exécute de manière récurrente.
Avant de commencer
Pour exécuter des analyses pour les connecteurs de contenu externe, le support mTLS entrant doit être activé sur votre instance. Pour plus d’informations sur la vérification de l’activation de cette fonctionnalité sur votre instance, reportez-vous à la section Vérifiez si la prise en charge mTLS entrante est activée pour votre instance.
Rôle requis : sn_ext_conn.xcc_admin
Pourquoi et quand exécuter cette tâche
Les administrateurs de Search peuvent récupérer le contenu et les métadonnées interrogeables à partir du système source d’un connecteur de contenu externe en créant une
analyse de contenu pour le connecteur. Les administrateurs de Search peuvent spécifier la portée de l’analyse : une analyse de contenu
complète récupère le contenu et les métadonnées consultables à partir de tous les emplacements disponibles (appelés
points de départ) dans votre système source, tandis qu’une analyse
partielle du contenu récupère uniquement le contenu et les métadonnées d’un seul point de départ spécifié et de ses descendants. Une exploration de contenu peut prendre des heures ou des jours, en fonction de la quantité de contenu disponible dans votre système source et de l’étendue de l’exploration.
Remarque : Les analyses de contenu complètes et partielles respectent les paramètres d’analyse définis pour votre connecteur de contenu externe, y compris les filtres de contenu d’inclusion/exclusion. L’exécution d’une analyse complète du contenu ne contourne pas ces paramètres.
Certains connecteurs de contenu externe incluent une option d’analyse du contenu des autorisations de mise à jour de l’utilisateur. Lorsque vous sélectionnez cette option, l’exécution de l’analyse lance à la fois une analyse du contenu et une analyse des autorisations de de l’utilisateur pour votre système source. Pour plus de détails sur les analyses des autorisations utilisateur, reportez-vous à la section Créer une analyse des autorisations de l’utilisateur pour un connecteur de contenu externe.
Vous pouvez exécuter une analyse de contenu comme une tâche ponctuelle ou la définir pour qu’elle se reproduise de manière planifiée.
Remarque : À partir de Connecteurs de contenu externe 6.0, l’application Connecteurs de contenu externe permet à un maximum de cinq analyses de connecteur de s’exécuter simultanément sur votre
ServiceNow AI Platform® instance. Les analyses de contenu et les analyses d’autorisations utilisateur sont comptabilisées dans cette limite. Vous pouvez planifier et exécuter des analyses du connecteur de contenu externe tout au long de la journée pour éviter les chevauchements, ou créer un
Service et assistance client ticket à
https://support.servicenow.com/now pour demander une augmentation de limite.
Procédure
-
Accédez à la .
-
Dans la liste Connecteurs, sélectionnez l’enregistrement du connecteur pour lequel vous souhaitez créer une analyse de contenu.
-
Dans l’onglet Créer des analyses de l’éditeur de connecteur, sélectionnez Analyser le contenu.
La boîte de dialogue Analyser le contenu s’affiche.
-
Sélectionnez la vignette correspondant au périmètre que vous souhaitez pour votre analyse de contenu.
- Pour récupérer le contenu et les métadonnées interrogeables à partir de tous les points de départ disponibles dans votre système source, sélectionnez Analyse complète du contenu.
- Pour récupérer uniquement le contenu et les métadonnées interrogeables à partir d’un point de départ unique, sélectionnez Analyse partielle du contenu et saisissez ou sélectionnez le point de départ de l’analyse. L’analyse partielle récupère uniquement le contenu de ce point de départ et de ses emplacements descendants.
Remarque : Lors de la configuration d’une analyse de contenu partielle, vous pouvez sélectionner Actualiser les points de départ pour remplir la liste des points de départ disponibles. L’actualisation de cette liste nécessite la récupération des données du système source et peut prendre une minute ou deux.
Remarque : Si la tuile d’analyse du contenu partiel n’est pas affichée, le connecteur de contenu externe ne prend en charge que les analyses de contenu complètes.
- Facultatif :
Pour configurer votre analyse de contenu afin de lancer une analyse des autorisations de utilisateur (récupération des principaux de sécurité de votre système source) lorsqu’elle s’exécute, sélectionnez l’option Mettre à jour les mappages utilisateur.
Remarque : Si l’option Mettre à jour les autorisations l’utilisateur ne s’affiche pas, le connecteur de contenu externe ne prend pas en charge le lancement d’analyses des autorisations de des utilisateurs à partir des analyses de contenu.
- Facultatif :
Pour que l’analyse de votre contenu s’exécute selon un calendrier récurrent, sélectionnez l’option Rendre récurrent , puis spécifiez les options de calendrier.
Remarque : Si l’option Rendre récurrent n’est pas affichée, le connecteur de contenu externe planifie automatiquement ses propres analyses de contenu. Dans ce cas, vous ne pouvez exécuter qu’une seule analyse de contenu.
-
Entrez un nom pour votre analyse planifiée.
-
Sélectionnez Quotidien, Hebdomadaire ou Mensuel comme fréquence de votre analyse planifiée.
Remarque : Tous les connecteurs de contenu externe ne prennent pas en charge toutes ces options de fréquence d’analyse. Sélectionnez une option de fréquence d’analyse qui s’affiche pour votre connecteur de contenu externe.
-
Si vous avez sélectionné Hebdomadaire comme fréquence d’analyse, sélectionnez les options correspondant aux jours de la semaine auxquels vous souhaitez que votre analyse planifiée s’exécute.
-
Si vous avez sélectionné Mensuel comme fréquence d’analyse, sélectionnez une valeur de champ Jour pour spécifier le jour du mois où vous souhaitez que votre analyse planifiée s’exécute.
-
Spécifiez quand vous souhaitez que le système exécute votre analyse planifiée en saisissant son heure de début et en sélectionnant un fuseau horaire.
L’heure de début doit être au
hh:mm a format, où les paramètres de format ont les valeurs suivantes :
- hh: heure à un ou deux chiffres comprise entre 0 et 12 inclus, par exemple 5 ou 11
- mm: minute à deux chiffres comprise entre 00 et 59 inclus, par exemple 15 ou 37
- a: l’un des jours A, a, AM ou am pour le matin ou l’un des P, p, PM ou pm pour l’après-midi (après-midi)
-
Créez votre nouvelle exploration de contenu en sélectionnant l’option appropriée.
- Si vous avez ignoré l’étape 6, sélectionnez Créer une analyse ponctuelle.
- Si vous avez sélectionné l’option Rendre récurrent dans l’étape 6, sélectionnez Créer un calendrier d’analyse.
Résultats
Si vous avez ignoré cette étape 6, votre nouvelle analyse de contenu est ajoutée à la file d’attente d’analyse du système. Le système exécute votre analyse lorsqu’il dispose des ressources nécessaires pour le faire.
Si vous avez sélectionné l’option Rendre récurrent dans l’étape 6, votre nouvelle analyse apparaît dans la liste Calendriers d’analyse de l’onglet Créer des analyses de l’éditeur du connecteur de contenu externe. Pour les analyses partielles, l’entrée de liste inclut un lien avec l’ID du point de départ choisi. Lorsque vous sélectionnez ce lien, l’enregistrement du point de départ s’affiche, avec son étiquette ainsi que son ID.
Que faire ensuite
Vous pouvez surveiller l’état de votre exploration de contenu ou examiner ses résultats à l’aide de l’historique d’exploration et des analyses. Pour en savoir plus sur ces mesures, reportez-vous à la section Examiner l’historique d’analyse pour un connecteur de contenu externe.
Si vous devez annuler l’analyse du contenu en cours, reportez-vous à la section Annuler l’analyse du connecteur de contenu externe en cours d’exécution.