Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# ServiceNow
ServiceNow fournit un système de gestion des services basé sur le cloud pour créer et gérer des flux de travail au niveau de l'organisation, tels que les services informatiques, les systèmes de billetterie et le support. Vous pouvez l'utiliser Amazon Kendra pour indexer vos ServiceNow catalogues, articles de connaissances, incidents et leurs pièces jointes.
Vous pouvez vous connecter Amazon Kendra à votre source de ServiceNow données à l'aide de la [Amazon Kendraconsole](https://console.aws.amazon.com/kendra/), de l'[TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)API ou de l'[ServiceNowConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_ServiceNowConfiguration.html)API.
Amazon Kendrapossède deux versions du ServiceNow connecteur. Les fonctionnalités prises en charge par chaque version incluent :
**ServiceNow connecteur V1.0/API [ServiceNowConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_ServiceNowConfiguration.html)**
+ Mappages de champs
+ ServiceNow versions d'instance : Londres, Autres
+ Filtres d’inclusion et d’exclusion
**ServiceNow connecteur V2.0/API [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)**
+ Mappages de champs
+ Contrôle d'accès utilisateur
+ Filtres d’inclusion et d’exclusion
+ Synchronisation complète et incrémentielle du contenu
+ ServiceNow versions d'instance : Rome, Sandiego, Tokyo, autres
+ Cloud privé virtuel (VPC)
**Note**
ServiceNow le connecteur V1.0/ ServiceNowConfiguration API a pris fin en 2023. Nous vous recommandons de migrer vers ou d'utiliser le ServiceNow connecteur TemplateConfiguration V2.0/API.
Pour résoudre les problèmes liés à votre connecteur de source de Amazon Kendra ServiceNow données, consultez[Dépannage des sources de données](troubleshooting-data-sources.md).
**Topics**
+ [ServiceNow connecteur V1.0](data-source-v1-servicenow.md)
+ [ServiceNow connecteur V2.0](data-source-v2-servicenow.md)
+ [Spécification des documents à indexer à l'aide d'une requête](servicenow-query.md)
# ServiceNow connecteur V1.0
ServiceNow fournit un système de gestion des services basé sur le cloud pour créer et gérer des flux de travail au niveau de l'organisation, tels que les services informatiques, les systèmes de billetterie et le support. Vous pouvez l'utiliser Amazon Kendra pour indexer vos ServiceNow catalogues, vos articles de connaissances et leurs pièces jointes.
**Note**
ServiceNow le connecteur V1.0/ ServiceNowConfiguration API a pris fin en 2023. Nous vous recommandons de migrer vers ou d'utiliser le ServiceNow connecteur TemplateConfiguration V2.0/API.
Pour résoudre les problèmes liés à votre connecteur de source de Amazon Kendra ServiceNow données, consultez[Dépannage des sources de données](troubleshooting-data-sources.md).
**Topics**
+ [Fonctionnalités prises en charge](#supported-features-v1-servicenow)
+ [Conditions préalables](#prerequisites-v1-servicenow)
+ [Instructions de connexion](#data-source-procedure-v1-servicenow)
+ [En savoir plus](#servicenow-v1-learn-more)
## Fonctionnalités prises en charge
Amazon KendraServiceNow le connecteur de source de données prend en charge les fonctionnalités suivantes :
+ ServiceNow versions d'instance : Londres, Autres
+ Modèles d'inclusion/exclusion : catalogues de services, articles de connaissances et leurs pièces jointes
## Conditions préalables
Avant de pouvoir Amazon Kendra indexer votre source de ServiceNow données, apportez ces modifications à vos AWS comptes ServiceNow and.
**Dans ServiceNow, assurez-vous d'avoir :**
+ J'ai créé un compte ServiceNow administrateur et j'ai créé une ServiceNow instance.
+ Vous avez copié l'URL de l'hôte de votre ServiceNow instance. Par exemple, si l'URL de l'instance est*https://your-domain.service-now.com*, le format de l'URL hôte que vous entrez est le suivant*your-domain.service-now.com*.
+ Vous avez noté vos informations d'authentification de base contenant un nom d'utilisateur et un mot de passe pour vous Amazon Kendra permettre de vous connecter à votre ServiceNow instance.
**Note**
Nous vous recommandons d’actualiser ou de modifier régulièrement vos informations d’identification et votre secret. Pour votre propre sécurité, fournissez uniquement le niveau d’accès nécessaire. Nous vous **déconseillons** de réutiliser les informations d'identification et les secrets entre les sources de données et les versions 1.0 et 2.0 du connecteur (le cas échéant).
+ **Facultatif :** configuration d'un jeton d'identification OAuth 2.0 capable d'identifier Amazon Kendra et de générer un nom d'utilisateur, un mot de passe, un identifiant client et un secret client. Le nom d'utilisateur et le mot de passe doivent permettre d'accéder à la base de ServiceNow connaissances et au catalogue de services. Consultez [ServiceNow la documentation sur l'authentification OAuth 2.0](https://www.servicenow.com/docs/bundle/utah-platform-security/page/integrate/single-sign-on/concept/c_Authentication.html) pour plus d'informations.
+ Les autorisations suivantes ont été ajoutées :
+ kb\$1category
+ kb\$1knowledge
+ kb\$1knowledge\$1base
+ kb\$1uc\$1ne peut pas lire le mtom
+ kb\$1uc\$1can\$1read\$1mtom
+ sc\$1catalog
+ sc\$1category
+ sc\$1cat\$1item
+ sys\$1attachment
+ sys\$1attachment\$1doc
+ rôle\$1utilisateur système
+ Il est vérifié que chaque document est unique dans ServiceNow et entre les autres sources de données que vous prévoyez d'utiliser pour le même index. Chaque source de données que vous souhaitez utiliser pour un index ne doit pas contenir le même document dans toutes les sources de données. IDs Les documents sont globaux par rapport à un index et doivent être uniques par index.
**Dans votreCompte AWS, assurez-vous d'avoir :**
+ [Création d'un Amazon Kendra index](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) et, si vous utilisez l'API, notez l'ID de l'index.
+ Vous avez [créé un IAM rôle](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) pour votre source de données et, si vous utilisez l'API, notez l'ARN du IAM rôle.
**Note**
Si vous modifiez votre type d'authentification et vos informations d'identification, vous devez mettre à jour votre IAM rôle pour accéder au bon identifiant AWS Secrets Manager secret.
+ Stockez vos informations d' ServiceNow authentification dans un AWS Secrets Manager secret et, si vous utilisez l'API, notez l'ARN du secret.
**Note**
Nous vous recommandons d’actualiser ou de modifier régulièrement vos informations d’identification et votre secret. Pour votre propre sécurité, fournissez uniquement le niveau d’accès nécessaire. Nous vous **déconseillons** de réutiliser les informations d'identification et les secrets entre les sources de données et les versions 1.0 et 2.0 du connecteur (le cas échéant).
Si vous n'avez pas de IAM rôle ou de secret existant, vous pouvez utiliser la console pour créer un nouveau IAM rôle et un nouveau Secrets Manager secret lorsque vous connectez votre source de ServiceNow données àAmazon Kendra. Si vous utilisez l'API, vous devez fournir l'ARN d'un IAM rôle et d'un Secrets Manager secret existants, ainsi qu'un identifiant d'index.
## Instructions de connexion
Pour vous connecter Amazon Kendra à votre source de ServiceNow données, vous devez fournir les informations nécessaires sur votre source de ServiceNow données afin de Amazon Kendra pouvoir accéder à vos données. Si vous n'avez pas encore configuré ServiceNow pour Amazon Kendra voir[Conditions préalables](#prerequisites-v1-servicenow).
------
#### [ Console ]
**Pour vous connecter Amazon Kendra à ServiceNow**
1. Connectez-vous à la console AWS de gestion et [Amazon Kendraouvrez-la](https://console.aws.amazon.com/kendra/).
1. Dans le volet de navigation de gauche, choisissez **Index**, puis choisissez l'index que vous souhaitez utiliser dans la liste des index.
**Note**
Vous pouvez choisir de configurer ou de modifier vos paramètres de **contrôle d'accès utilisateur** dans les paramètres de **l'index**.
1. Sur la page de **démarrage**, choisissez **Ajouter une source de données**.
1. Sur la page **Ajouter une source de données**, choisissez le **ServiceNowconnecteur V1.0**, puis sélectionnez **Ajouter une source de données**.
1. Sur la page **Spécifier les détails de la source de données**, entrez les informations suivantes :
1. Dans **Nom et description**, pour Nom de la **source de données** : entrez le nom de votre source de données. Vous pouvez inclure des tirets, mais pas des espaces.
1. (Facultatif) **Description** : entrez une description facultative pour votre source de données.
1. Dans la **langue par défaut** : choisissez une langue pour filtrer vos documents pour l'index. Sauf indication contraire, la langue par défaut est l'anglais. La langue spécifiée dans les métadonnées du document remplace la langue sélectionnée.
1. Dans **Balises**, pour **Ajouter une nouvelle balise** : incluez des balises facultatives pour rechercher et filtrer vos ressources ou suivre vos AWS coûts.
1. Choisissez **Suivant**.
1. Sur la page **Définir l'accès et la sécurité**, entrez les informations suivantes :
1. **ServiceNow host** —Entrez l'URL de l' ServiceNowhôte.
1. **ServiceNow version** —Sélectionnez votre ServiceNow version.
1. Choisissez entre **l'authentification de base et l'authentification** **Oauth 2.0 en fonction de votre cas d'**utilisation.
1. **AWS Secrets Managersecret** —Choisissez un secret existant ou créez-en un nouveau Secrets Manager pour stocker vos informations ServiceNow d'authentification. Si vous choisissez de créer un nouveau secret, une fenêtre AWS Secrets Manager secrète s'ouvre.
1. **Nom du secret** : nom de votre secret. Le préfixe « AmazonKendra - ServiceNow - » est automatiquement ajouté à votre nom secret.
1. Si vous utilisez l'authentification de base, entrez le **nom secret, le nom** **d'utilisateur** et le mot de **passe de votre compte**. ServiceNow
Si vous utilisez l' OAuth2 authentification, entrez le **nom secret, le nom** **d'utilisateur**, le **mot de passe**, l'**identifiant client** et le **secret client** que vous avez créés dans votre compte. ServiceNow
1. Choisissez **Enregistrer et ajouter un secret**.
1. **IAMrôle** —Choisissez un IAM rôle existant ou créez-en un nouveau IAM pour accéder aux informations d'identification de votre référentiel et indexer le contenu.
**Note**
IAMles rôles utilisés pour les index ne peuvent pas être utilisés pour les sources de données. Si vous ne savez pas si un rôle existant est utilisé pour un index ou une FAQ, choisissez **Créer un nouveau rôle** pour éviter les erreurs.
1. Choisissez **Suivant**.
1. Sur la page **Configurer les paramètres de synchronisation**, entrez les informations suivantes :
1. **Inclure les articles de connaissances** : choisissez d'indexer les articles de connaissances.
1. **Type d'articles de connaissances** : choisissez entre **Inclure uniquement les articles publics** et **Inclure les articles en fonction d'une requête de ServiceNow filtrage** basée sur votre cas d'utilisation. Si vous sélectionnez **Inclure les articles en fonction d'une requête de ServiceNow filtre**, vous devez saisir une **requête de filtre** copiée depuis votre ServiceNow compte.
1. **Inclure les pièces jointes aux articles de connaissances** : choisissez d'indexer les pièces jointes aux articles de connaissances. Vous pouvez également sélectionner des types de fichiers spécifiques à indexer.
1. **Inclure les éléments du catalogue** : choisissez d'indexer les éléments du catalogue.
1. **Inclure les pièces jointes aux éléments du catalogue** : choisissez d'indexer les pièces jointes aux éléments du catalogue. Vous pouvez également sélectionner des types de fichiers spécifiques à indexer.
1. **Fréquence : fréquence** Amazon Kendra de synchronisation avec votre source de données.
1. Choisissez **Suivant**.
1. Sur la page **Définir les mappages de champs**, entrez les informations suivantes :
1. **Articles de connaissances** et **catalogue de services** : sélectionnez parmi les champs de source de données par défaut Amazon Kendra générés et les mappages de champs suggérés supplémentaires que vous souhaitez mapper à votre index.
1. **Ajouter un champ** —Pour ajouter des champs de source de données personnalisés afin de créer un nom de champ d'index à mapper et le type de données du champ.
1. Choisissez **Suivant**.
1. Sur la page **Réviser et créer**, vérifiez que les informations saisies sont correctes, puis sélectionnez **Ajouter une source de données**. Vous pouvez également choisir de modifier vos informations depuis cette page. Votre source de données apparaîtra sur la page **Sources de données** une fois que la source de données aura été ajoutée avec succès.
------
#### [ API ]
**Pour vous connecter Amazon Kendra à ServiceNow**
Vous devez spécifier les éléments suivants à l'aide de l'[ServiceNowConfiguration API](https://docs.aws.amazon.com/kendra/latest/APIReference/API_ServiceNowConfiguration.html) :
+ **URL de la source de données** : spécifiez l' ServiceNow URL. Le point de terminaison de l'hôte doit ressembler à ce qui suit :*your-domain.service-now.com*.
+ **Instance hôte de source de données** : spécifiez la version de l'instance ServiceNow hôte sous la forme `LONDON` ou`OTHERS`.
+ **Nom de ressource Amazon (ARN) secret** : indiquez le nom de ressource Amazon (ARN) d'un Secrets Manager secret contenant les informations d'authentification que vous avez créées dans votre ServiceNow compte.
Si vous utilisez l'authentification de base, le secret est stocké dans une structure JSON avec les clés suivantes :
```
{
"username": "user name",
"password": "password"
}
```
Si vous utilisez l' OAuth2 authentification, le secret est stocké dans une structure JSON avec les clés suivantes :
```
{
"username": "user name",
"password": "password",
"clientId": "client id",
"clientSecret": "client secret"
}
```
+ **IAMrole** —Spécifiez le `RoleArn` moment où vous appelez `CreateDataSource` pour fournir à un IAM rôle les autorisations d'accéder à votre Secrets Manager secret et d'appeler le public requis APIs pour le ServiceNow connecteur etAmazon Kendra. Pour plus d'informations, consultez la section [IAMRôles des sources de ServiceNow données](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds).
Vous pouvez également ajouter les fonctionnalités optionnelles suivantes :
+ **Mappages de champs : choisissez de mapper** les champs de votre source de ServiceNow données à vos champs d'Amazon Kendraindex. Pour plus d’informations, consultez [Mappage des champs de source de données](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html).
**Note**
Le champ du corps du document ou l'équivalent du corps du document pour vos documents est requis pour Amazon Kendra effectuer une recherche dans vos documents. Vous devez associer le nom du champ du corps du document dans votre source de données au nom du champ d'index`_document_body`. Tous les autres champs sont facultatifs.
+ **Filtres d'inclusion et d'exclusion** : indiquez si vous souhaitez inclure ou exclure certaines pièces jointes de catalogues et d'articles de connaissances.
**Note**
La plupart des sources de données utilisent des modèles d’expressions régulières, qui sont des modèles d’inclusion ou d’exclusion appelés filtres. Si vous spécifiez un filtre d’inclusion, seul le contenu correspondant au filtre d’inclusion est indexé. Tout document qui ne correspond pas au filtre d'inclusion n'est pas indexé. Si vous spécifiez un filtre d'inclusion et d'exclusion, les documents correspondant au filtre d'exclusion ne sont pas indexés, même s'ils correspondent au filtre d'inclusion.
+ **Paramètres d'indexation** : vous pouvez également choisir de spécifier si vous souhaitez :
+ Indexez les articles de connaissances et les catalogues de services, ou les deux. Si vous choisissez d'indexer des articles de connaissances et des éléments du catalogue de services, vous devez fournir le nom du ServiceNow champ mappé au champ de contenu du document d'index dans l'Amazon Kendraindex.
+ Indexez les pièces jointes aux articles de connaissances et aux éléments du catalogue.
+ Utilisez une ServiceNow requête qui sélectionne des documents dans une ou plusieurs bases de connaissances. Les bases de connaissances peuvent être publiques ou privées. Pour plus d'informations, veuillez consulter la rubrique [Spécification des documents à indexer avec une requête](https://docs.aws.amazon.com/kendra/latest/dg/servicenow-query.html).
------
## En savoir plus
Pour en savoir plus sur l'intégration Amazon Kendra à votre source de ServiceNow données, consultez :
+ [Commencer à utiliser le connecteur Amazon Kendra ServiceNow en ligne](https://aws.amazon.com/blogs/machine-learning/getting-started-with-amazon-kendra-servicenow-online-connector/)
# ServiceNow connecteur V2.0
ServiceNow fournit un système de gestion des services basé sur le cloud pour créer et gérer des flux de travail au niveau de l'organisation, tels que les services informatiques, les systèmes de billetterie et le support. Vous pouvez l'utiliser Amazon Kendra pour indexer vos ServiceNow catalogues, articles de connaissances, incidents et leurs pièces jointes.
Pour résoudre les problèmes liés à votre connecteur de source de Amazon Kendra ServiceNow données, consultez[Dépannage des sources de données](troubleshooting-data-sources.md).
**Topics**
+ [Fonctionnalités prises en charge](#supported-features-v2-servicenow)
+ [Conditions préalables](#prerequisites-v2-servicenow)
+ [Instructions de connexion](#data-source-procedure-v2-servicenow)
+ [En savoir plus](#servicenow-learn-more)
## Fonctionnalités prises en charge
Amazon KendraServiceNow le connecteur de source de données prend en charge les fonctionnalités suivantes :
+ Mappages de champs
+ Contrôle d'accès utilisateur
+ Filtres d’inclusion et d’exclusion
+ Synchronisation complète et incrémentielle du contenu
+ ServiceNow versions d'instance : Rome, Sandiego, Tokyo, autres
+ Cloud privé virtuel (VPC)
## Conditions préalables
Avant de pouvoir Amazon Kendra indexer votre source de ServiceNow données, apportez ces modifications à vos AWS comptes ServiceNow and.
**Dans ServiceNow, assurez-vous d'avoir :**
+ créé une instance de développeur personnelle ou d’entreprise et disposer d’une instance ServiceNow dotée d’un rôle administratif ;
+ Vous avez copié l'URL de l'hôte de votre ServiceNow instance. Le format de l'URL d'hôte que vous entrez est*your-domain.service-now.com*. Vous avez besoin de l’URL de votre instance ServiceNow pour vous connecter à Amazon Kendra ;
+ Vous avez pris note de vos informations d'authentification de base, à savoir un nom d'utilisateur et un mot de passe Amazon Kendra pour autoriser la connexion à votre ServiceNow instance.
**Note**
Nous vous recommandons d’actualiser ou de modifier régulièrement vos informations d’identification et votre secret. Pour votre propre sécurité, fournissez uniquement le niveau d’accès nécessaire. Nous vous **déconseillons** de réutiliser les informations d'identification et les secrets entre les sources de données et les versions 1.0 et 2.0 du connecteur (le cas échéant).
+ **Facultatif :** informations d'identification client OAuth 2.0 configurées qui peuvent être identifiées à l'Amazon Kendraaide d'un nom d'utilisateur, d'un mot de passe, d'un identifiant client généré et d'un secret client. Consultez [ServiceNow la documentation sur l'authentification OAuth 2.0](https://www.servicenow.com/docs/bundle/utah-platform-security/page/integrate/single-sign-on/concept/c_Authentication.html) pour plus d'informations.
+ Les autorisations suivantes ont été ajoutées :
+ kb\$1category
+ kb\$1knowledge
+ kb\$1knowledge\$1base
+ kb\$1uc\$1ne peut pas lire le mtom
+ kb\$1uc\$1can\$1read\$1mtom
+ sc\$1catalog
+ sc\$1category
+ sc\$1cat\$1item
+ sys\$1attachment
+ sys\$1attachment\$1doc
+ rôle\$1utilisateur système
+ Il est vérifié que chaque document est unique dans ServiceNow et entre les autres sources de données que vous prévoyez d'utiliser pour le même index. Chaque source de données que vous souhaitez utiliser pour un index ne doit pas contenir le même document dans toutes les sources de données. IDs Les documents sont globaux par rapport à un index et doivent être uniques par index.
**Dans votreCompte AWS, assurez-vous d'avoir :**
+ [Création d'un Amazon Kendra index](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) et, si vous utilisez l'API, notez l'ID de l'index.
+ Vous avez [créé un IAM rôle](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) pour votre source de données et, si vous utilisez l'API, notez l'ARN du IAM rôle.
**Note**
Si vous modifiez votre type d'authentification et vos informations d'identification, vous devez mettre à jour votre IAM rôle pour accéder au bon identifiant AWS Secrets Manager secret.
+ Stockez vos informations d' ServiceNow authentification dans un AWS Secrets Manager secret et, si vous utilisez l'API, notez l'ARN du secret.
**Note**
Nous vous recommandons d’actualiser ou de modifier régulièrement vos informations d’identification et votre secret. Pour votre propre sécurité, fournissez uniquement le niveau d’accès nécessaire. Nous vous **déconseillons** de réutiliser les informations d'identification et les secrets entre les sources de données et les versions 1.0 et 2.0 du connecteur (le cas échéant).
Si vous n'avez pas de IAM rôle ou de secret existant, vous pouvez utiliser la console pour créer un nouveau IAM rôle et un nouveau Secrets Manager secret lorsque vous connectez votre source de ServiceNow données àAmazon Kendra. Si vous utilisez l'API, vous devez fournir l'ARN d'un IAM rôle et d'un Secrets Manager secret existants, ainsi qu'un identifiant d'index.
## Instructions de connexion
Pour vous connecter Amazon Kendra à votre source de ServiceNow données, vous devez fournir les informations nécessaires sur votre source de ServiceNow données afin de Amazon Kendra pouvoir accéder à vos données. Si vous n'avez pas encore configuré ServiceNow pour Amazon Kendra voir[Conditions préalables](#prerequisites-v2-servicenow).
------
#### [ Console ]
**Pour vous connecter Amazon Kendra à ServiceNow**
1. Connectez-vous à la [Amazon Kendraconsole AWS Management Console et ouvrez-la](https://console.aws.amazon.com/kendra/).
1. Dans le volet de navigation de gauche, choisissez **Index**, puis choisissez l'index que vous souhaitez utiliser dans la liste des index.
**Note**
Vous pouvez choisir de configurer ou de modifier vos paramètres de **contrôle d'accès utilisateur** dans les paramètres de **l'index**.
1. Sur la page de **démarrage**, choisissez **Ajouter une source de données**.
1. Sur la page **Ajouter une source de données**, choisissez **ServiceNow connecteur**, puis sélectionnez **Ajouter un connecteur**. Si vous utilisez la version 2 (le cas échéant), choisissez le **ServiceNow connecteur** avec la balise « V2.0 ».
1. Sur la page **Spécifier les détails de la source de données**, entrez les informations suivantes :
1. Dans **Nom et description**, pour Nom de la **source de données** : entrez le nom de votre source de données. Vous pouvez inclure des tirets, mais pas des espaces.
1. (Facultatif) **Description** : entrez une description facultative pour votre source de données.
1. Dans la **langue par défaut** : choisissez une langue pour filtrer vos documents pour l'index. Sauf indication contraire, la langue par défaut est l'anglais. La langue spécifiée dans les métadonnées du document remplace la langue sélectionnée.
1. Dans **Balises**, pour **Ajouter une nouvelle balise** : incluez des balises facultatives pour rechercher et filtrer vos ressources ou suivre vos AWS coûts.
1. Choisissez **Suivant**.
1. Sur la page **Définir l'accès et la sécurité**, entrez les informations suivantes :
1. **ServiceNow host** —Entrez l'URL de l' ServiceNowhôte. Le format de l'URL d'hôte que vous entrez est*your-domain.service-now.com*.
1. **ServiceNow version** —Sélectionnez la version de votre ServiceNow instance. Vous pouvez choisir entre Rome, Sandiego, Tokyo ou autres.
1. **Autorisation** : activez ou désactivez les informations de la liste de contrôle d'accès (ACL) pour vos documents, si vous disposez d'une ACL et que vous souhaitez l'utiliser pour le contrôle d'accès. L'ACL indique les documents auxquels les utilisateurs et les groupes peuvent accéder. Les informations ACL sont utilisées pour filtrer les résultats de recherche en fonction de l'accès de l'utilisateur ou de son groupe aux documents. Pour plus d'informations, consultez la section [Filtrage du contexte utilisateur](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources).
1. **Authentification** : choisissez entre **l'authentification de base et l'authentification** **Oauth 2.0.**
1. **AWSSecrets Managersecret** —Choisissez un secret existant ou créez-en un nouveau Secrets Manager pour stocker vos informations ServiceNow d'authentification. Si vous choisissez de créer un nouveau secret, une fenêtre AWS Secrets Manager secrète s'ouvre. Saisissez les informations suivantes dans la fenêtre :
1. **Nom du secret** : nom de votre secret. Le préfixe « AmazonKendra - ServiceNow - » est automatiquement ajouté à votre nom secret.
1. Si vous utilisez l'authentification de base, entrez le **nom secret, le nom** **d'utilisateur** et le mot de **passe de votre compte**. ServiceNow
Si vous utilisez l'authentification OAuth2 .0, entrez le **nom secret, le nom** **d'utilisateur**, le mot de **passe**, l'**identifiant client** et le **secret client** que vous avez créés dans votre compte. ServiceNow
1. Enregistrez et ajoutez votre secret.
1. **Virtual Private Cloud (VPC)** —Vous pouvez choisir d'utiliser un VPC. Dans ce cas, vous devez ajouter des **sous-réseaux et des** groupes de **sécurité VPC.**
1. **Identity Crawler** : spécifiez s'il faut activer l'explorateur Amazon Kendra d'identité. Le robot d'exploration d'identité utilise les informations de la liste de contrôle d'accès (ACL) de vos documents pour filtrer les résultats de recherche en fonction de l'accès de l'utilisateur ou de son groupe aux documents. Si vous disposez d'une ACL pour vos documents et que vous choisissez de l'utiliser, vous pouvez également choisir d'activer le robot d'exploration Amazon Kendra d'identité pour configurer [le filtrage des résultats de recherche par contexte utilisateur](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources). Sinon, si le robot d’identité est désactivé, tous les documents peuvent faire l’objet d’une recherche publique. Si vous souhaitez utiliser le contrôle d'accès pour vos documents et que le robot d'exploration d'identité est désactivé, vous pouvez également utiliser l'[PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API pour télécharger les informations d'accès des utilisateurs et des groupes afin de filtrer le contexte utilisateur.
1. **IAMrôle** —Choisissez un IAM rôle existant ou créez-en un nouveau IAM pour accéder aux informations d'identification de votre référentiel et indexer le contenu.
**Note**
IAMles rôles utilisés pour les index ne peuvent pas être utilisés pour les sources de données. Si vous ne savez pas si un rôle existant est utilisé pour un index ou une FAQ, choisissez **Créer un nouveau rôle** pour éviter les erreurs.
1. Choisissez **Suivant**.
1. Sur la page **Configurer les paramètres de synchronisation**, entrez les informations suivantes :
1. Pour les **Articles de connaissances**, choisissez l’une des options suivantes :
+ **Articles de connaissances** : choisissez d'indexer les articles de connaissances.
+ **Pièces jointes aux articles de connaissances** : choisissez d'indexer les pièces jointes aux articles de connaissances.
+ **Type d'articles de connaissances** : choisissez entre **uniquement les articles publics et les articles** de **connaissances en fonction d'une requête de ServiceNow filtrage** basée sur votre cas d'utilisation. Si vous sélectionnez **Inclure les articles en fonction d'une requête de ServiceNow filtre**, vous devez saisir une **requête de filtre** copiée depuis votre ServiceNow compte. Les exemples de requêtes de filtrage incluent :*workflow\$1state=draft^EQ*,*kb\$1knowledge\$1base=dfc19531bf2021003f07e2c1ac0739ab^text ISNOTEMPTY^EQ*,*article\$1type=text^active=true^EQ*.
**Important**
Si vous choisissez d'explorer **uniquement les articles publics, n'Amazon Kendraexplore que les articles** de connaissances auxquels un rôle d'accès public a été attribué dans. ServiceNow
+ **Inclure des articles en fonction d'un filtre de brève description** : spécifiez des modèles d'expressions régulières pour inclure ou exclure des articles spécifiques.
1. Pour les **Éléments du catalogue de services** :
+ **Articles du catalogue de services** : choisissez d'indexer les articles du catalogue de services.
+ **Pièces jointes des articles du catalogue de services** : choisissez d'indexer les pièces jointes des articles du catalogue de services.
+ **Éléments du catalogue de services actifs** : choisissez d'indexer les éléments du catalogue de services actifs.
+ **Éléments du catalogue de services inactifs** : choisissez d'indexer les éléments du catalogue de services inactifs.
+ **Requête de filtre** : choisissez d'inclure les éléments du catalogue de services en fonction d'un filtre défini dans votre ServiceNow instance. Les exemples de requêtes de filtrage incluent :*short\$1descriptionLIKEAccess^category=2809952237b1300054b6a3549dbe5dd4^EQ*,*nameSTARTSWITHService^active=true^EQ*.
+ **Inclure les éléments du catalogue de services en fonction d'un filtre de brève description** : spécifiez un modèle d'expression régulière pour inclure des articles de catalogue spécifiques.
1. Pour les **Incidents** :
+ **Incidents** : choisissez d'indexer les incidents de service.
+ **Pièces jointes aux incidents** : choisissez d'indexer les pièces jointes aux incidents.
+ **Incidents actifs** : choisissez d'indexer les incidents actifs.
+ **Incidents inactifs** : choisissez d'indexer les incidents inactifs.
+ **Type d'incident actif** : choisissez entre **Tous les incidents, Incidents** **ouverts, Incidents** **non assignés et Incidents** **résolus en fonction de votre cas** d'utilisation.
+ **Requête de filtre** : choisissez d'inclure les incidents en fonction d'un filtre défini dans votre ServiceNow instance. Les exemples de requêtes de filtrage incluent :*short\$1descriptionLIKETest^urgency=3^state=1^EQ*,*priority=2^category=software^EQ *.
+ **Inclure les incidents en fonction d'un filtre de brève description** : spécifiez un modèle d'expression régulière pour inclure des incidents spécifiques.
1. Pour une **configuration supplémentaire** :
+ **Informations ACL** : les listes de contrôle d'accès pour les entités que vous avez sélectionnées sont incluses par défaut. La désélection d'une liste de contrôle d'accès rendra publics tous les fichiers de cette catégorie. Les options ACL sont automatiquement désactivées pour les entités non sélectionnées. Pour les articles publics, l'ACL n'est pas appliquée.
+ Pour la **taille de fichier maximale** : spécifiez la taille limite de fichier MBs qu'Amazon Kendra explorera. Amazon Kendra explorera uniquement les fichiers dans la limite de taille que vous avez définie. La taille de fichier par défaut est de 50 Mo. La taille de fichier maximale doit être supérieure à 0 Mo et inférieure ou égale à 50 Mo.
+ **Modèles d'expressions régulières pour pièces jointes** : ajoutez des modèles d'expressions régulières pour inclure ou exclure certains fichiers joints de catalogues, d'articles de connaissances et d'incidents. Vous pouvez ajouter jusqu’à 100 modèles.
1. **Mode de synchronisation** : choisissez la manière dont vous souhaitez mettre à jour votre index lorsque le contenu de votre source de données change. Lorsque vous synchronisez votre source de données Amazon Kendra pour la première fois, tout le contenu est analysé et indexé par défaut. Vous devez exécuter une synchronisation complète de vos données en cas d'échec de la synchronisation initiale, même si vous ne choisissez pas l'option de synchronisation complète comme mode de synchronisation.
+ Synchronisation complète : Indexez tout le contenu fraîchement, en remplaçant le contenu existant chaque fois que votre source de données se synchronise avec votre index.
+ Synchronisation nouvelle, modifiée ou supprimée : Indexez uniquement le contenu nouveau, modifié et supprimé chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
1. Dans **Calendrier d'exécution de la synchronisation**, pour **Fréquence : choisissez la fréquence** à laquelle vous souhaitez synchroniser le contenu de votre source de données et mettre à jour votre index.
1. Choisissez **Suivant**.
1. Sur la page **Définir les mappages de champs**, entrez les informations suivantes :
1. **Mappages de champs par défaut** : sélectionnez parmi les champs de source de données par défaut Amazon Kendra générés que vous souhaitez mapper à votre index.
1. **Ajouter un champ** —Pour ajouter des champs de source de données personnalisés afin de créer un nom de champ d'index à mapper et le type de données du champ.
1. Choisissez **Suivant**.
1. Sur la page **Réviser et créer**, vérifiez que les informations saisies sont correctes, puis sélectionnez **Ajouter une source de données**. Vous pouvez également choisir de modifier vos informations depuis cette page. Votre source de données apparaîtra sur la page **Sources de données** une fois que la source de données aura été ajoutée avec succès.
------
#### [ API ]
**Pour vous connecter Amazon Kendra à ServiceNow**
Vous devez spécifier un JSON du [schéma de source de données](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html) à l'aide de l'[TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)API. Vous devez fournir les informations suivantes :
+ **Source de données** —Spécifiez le type de source de données tel que `SERVICENOWV2` lorsque vous utilisez le schéma [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON. Spécifiez également la source de données `TEMPLATE` lorsque vous appelez l'[https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API.
+ **URL de l'hôte** : spécifiez la version de l'instance ServiceNow hôte. Par exemple, *your-domain.service-now.com*.
+ **Type d'authentification** : spécifiez le type d'authentification que vous utilisez, que ce soit `basicAuth` ou `OAuth2` pour votre ServiceNow instance.
+ **ServiceNow version de l'instance** —Spécifiez l' ServiceNow instance que vous utilisez`Tokyo`, si`Sandiego`,`Rome`, ou`Others`.
+ **Mode de synchronisation** : spécifiez comment Amazon Kendra mettre à jour votre index lorsque le contenu de votre source de données change. Lorsque vous synchronisez votre source de données Amazon Kendra pour la première fois, tout le contenu est analysé et indexé par défaut. Vous devez exécuter une synchronisation complète de vos données en cas d'échec de la synchronisation initiale, même si vous ne choisissez pas l'option de synchronisation complète comme mode de synchronisation. Vous pouvez choisir entre :
+ `FORCED_FULL_CRAWL`pour indexer à nouveau tout le contenu, en remplaçant le contenu existant chaque fois que votre source de données se synchronise avec votre index.
+ `FULL_CRAWL`pour indexer uniquement le contenu nouveau, modifié et supprimé chaque fois que votre source de données se synchronise avec votre index. Amazon Kendrapeut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.
+ **Nom de ressource Amazon (ARN) secret** : indiquez le nom de ressource Amazon (ARN) d'un Secrets Manager secret contenant les informations d'authentification que vous avez créées dans votre ServiceNow compte.
Si vous utilisez l'authentification de base, le secret est stocké dans une structure JSON avec les clés suivantes :
```
{
"username": "user name",
"password": "password"
}
```
+ Si vous utilisez les informations d'identification du OAuth2 client, le secret est stocké dans une structure JSON avec les clés suivantes :
```
{
"username": "user name",
"password": "password",
"clientId": "client id",
"clientSecret": "client secret"
}
```
+ **IAMrole** —Spécifiez le `RoleArn` moment où vous appelez `CreateDataSource` pour fournir à un IAM rôle les autorisations d'accéder à votre Secrets Manager secret et d'appeler le public requis APIs pour le ServiceNow connecteur etAmazon Kendra. Pour plus d'informations, consultez la section [IAMRôles des sources de ServiceNow données](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds).
Vous pouvez également ajouter les fonctionnalités optionnelles suivantes :
+ **Virtual Private Cloud (VPC) `VpcConfiguration` —Spécifiez** le moment de votre appel. `CreateDataSource` Pour de plus amples informations, veuillez consulter [Configuration Amazon Kendra pour utiliser un Amazon VPC](vpc-configuration.md).
+ **Filtres d'inclusion et d'exclusion** : vous pouvez spécifier si vous souhaitez inclure ou exclure certains fichiers joints en utilisant les noms de fichiers et les types de fichiers des articles de connaissances, des catalogues de services et des incidents.
**Note**
La plupart des sources de données utilisent des modèles d’expressions régulières, qui sont des modèles d’inclusion ou d’exclusion appelés filtres. Si vous spécifiez un filtre d’inclusion, seul le contenu correspondant au filtre d’inclusion est indexé. Tout document qui ne correspond pas au filtre d'inclusion n'est pas indexé. Si vous spécifiez un filtre d'inclusion et d'exclusion, les documents correspondant au filtre d'exclusion ne sont pas indexés, même s'ils correspondent au filtre d'inclusion.
+ **Documents spécifiques à indexer** : vous pouvez utiliser une ServiceNow requête pour spécifier les documents que vous souhaitez obtenir à partir d'une ou de plusieurs bases de connaissances, y compris les bases de connaissances privées. L'accès aux bases de connaissances est déterminé par l'utilisateur que vous utilisez pour vous connecter à l' ServiceNow instance. Pour plus d'informations, veuillez consulter la rubrique [Spécification des documents à indexer avec une requête](https://docs.aws.amazon.com//kendra/latest/dg/servicenow-query.html).
+ **Paramètres d'indexation** : vous pouvez également choisir de spécifier si vous souhaitez :
+ Indexez les articles de connaissances, les catalogues de services et les incidents, ou tous ces éléments. Si vous choisissez d'indexer des articles de connaissances, des éléments du catalogue de services et des incidents, vous devez fournir le nom du ServiceNow champ mappé au champ de contenu du document d'index dans l'Amazon Kendraindex.
+ Indexez les pièces jointes aux articles de connaissances, aux éléments du catalogue de services et aux incidents.
+ Incluez des articles de connaissances, des éléments du catalogue de services et des incidents en fonction du modèle de `short description` filtre.
+ Choisissez de filtrer les articles et incidents du catalogue de services actifs et inactifs.
+ Choisissez de filtrer les incidents en fonction du type d'incident.
+ Choisissez les entités dont l'ACL doit être analysée.
+ Vous pouvez utiliser une ServiceNow requête pour spécifier les documents que vous souhaitez obtenir à partir d'une ou de plusieurs bases de connaissances, y compris des bases de connaissances privées. L'accès aux bases de connaissances est déterminé par l'utilisateur que vous utilisez pour vous connecter à l' ServiceNowinstance. Pour plus d'informations, veuillez consulter la rubrique [Spécification des documents à indexer avec une requête](https://docs.aws.amazon.com//kendra/latest/dg/servicenow-query.html).
+ **Identity Crawler** : spécifiez s'il faut activer l'explorateur Amazon Kendra d'identité. Le robot d'exploration d'identité utilise les informations de la liste de contrôle d'accès (ACL) de vos documents pour filtrer les résultats de recherche en fonction de l'accès de l'utilisateur ou de son groupe aux documents. Si vous disposez d'une ACL pour vos documents et que vous choisissez de l'utiliser, vous pouvez également choisir d'activer le robot d'exploration Amazon Kendra d'identité pour configurer [le filtrage des résultats de recherche par contexte utilisateur](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources). Sinon, si le robot d’identité est désactivé, tous les documents peuvent faire l’objet d’une recherche publique. Si vous souhaitez utiliser le contrôle d'accès pour vos documents et que le robot d'exploration d'identité est désactivé, vous pouvez également utiliser l'[PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API pour télécharger les informations d'accès des utilisateurs et des groupes afin de filtrer le contexte utilisateur.
+ **Mappages de champs : choisissez de mapper** les champs de votre source de ServiceNow données à vos champs d'Amazon Kendraindex. Pour plus d’informations, consultez [Mappage des champs de source de données](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html).
**Note**
Le champ du corps du document ou l'équivalent du corps du document pour vos documents est requis pour Amazon Kendra effectuer une recherche dans vos documents. Vous devez associer le nom du champ du corps du document dans votre source de données au nom du champ d'index`_document_body`. Tous les autres champs sont facultatifs.
Pour obtenir la liste des autres clés JSON importantes à configurer, consultez le [schéma du ServiceNow modèle](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-servicenow-schema).
------
## En savoir plus
Pour en savoir plus sur l'intégration Amazon Kendra à votre source de ServiceNow données, consultez :
+ [Commencer à Amazon Kendra annoncer le ServiceNow connecteur mis à jour (V2) pour Amazon Kendra](https://aws.amazon.com/blogs/machine-learning/announcing-the-updated-servicenow-connector-v2-for-amazon-kendra/)
# Spécification des documents à indexer à l'aide d'une requête
Vous pouvez utiliser une ServiceNow requête pour spécifier les documents que vous souhaitez inclure dans un Amazon Kendra index. Lorsque vous utilisez une requête, vous pouvez spécifier plusieurs bases de connaissances, y compris des bases de connaissances privées. L'accès aux bases de connaissances est déterminé par l'utilisateur que vous utilisez pour vous connecter à l' ServiceNow instance.
Pour créer une requête, vous devez utiliser le générateur de ServiceNow requêtes. Vous pouvez utiliser le générateur pour créer la requête et vérifier qu'elle renvoie la bonne liste de documents.
**Pour créer une requête à l'aide de la ServiceNow console**
1. Connectez-vous à la ServiceNow console.
1. Dans le menu de gauche, choisissez **Connaissances**, puis **Articles**, puis choisissez **Tout**.
1. En haut de la page, choisissez l'icône du filtre.
1. Utilisez le générateur de requêtes pour créer la requête.
1. Lorsque la requête est terminée, cliquez avec le bouton droit sur la requête et choisissez **Copier la requête** pour copier la requête depuis le générateur de requêtes. Enregistrez cette requête pour l'utiliser dansAmazon Kendra.
![\[Query builder interface showing Knowledge base filters with options to run, save, and copy query.\]](http://docs.aws.amazon.com/fr_fr/kendra/latest/dg/images/ServiceNowQuery.png)
Assurez-vous de ne modifier aucun paramètre de requête lorsque vous copiez la requête. Si l'un des paramètres de requête n'est pas reconnu, ServiceNow traite le paramètre comme vide et ne l'utilise pas pour filtrer les résultats.