Fonctionnalités Amazon Comprehend

Les activités Amazon Comprehend utilisent le service AWS Identity and Access Management (IAM) pour établir une connexion authentifiée entre UiPath et vos ressources AWS. Cette connexion permet à un Robot d'appeler les API Amazon Comprehend pour lire et écrire des ressources en votre nom.

Pour établir une connexion authentifiée, vous créez ou utilisez un utilisateur IAM existant et générez des clés d'accès (ID de clé d'accès (Access Key Id) et Clé d'accès secrète (Secret Access Key)). Lorsque vous créez votre utilisateur IAM, vous attribuez les stratégies et les autorisations qui spécifient les ressources auxquelles votre robot peut accéder (par ex. AmazonComprehendFullAccess).

Après avoir créé votre utilisateur IAM et attribué vos stratégies, saisissez l'ID de clé d'accès (Access Key Id) et la clé d'accès secrète (Secret Access Key) dans l'activité Amazon Comprehend Scope . Lorsque vous exécutez votre projet d'automatisation, les clés sont utilisées pour signer les requêtes API effectuées par chacune des activités.

Mode de fonctionnement

Les étapes et le diagramme de séquence de messages suivants illustrent le fonctionnement de l'activité, depuis la conception (c'est-à-dire les dépendances d'activité et les propriétés d'entrée/sortie) jusqu'à l'exécution.

Terminez les étapes de configuration .
Ajoutez l’activité Amazon Comprehend Scope à votre projet.
Entrez les valeurs des propriétés situées dans le corps de l'activité.
Si vous souhaitez réutiliser la connexion dans les activités d'étendue en aval, entrez une variable dans la propriété Sortie.

Dans le corps de l’activité

Type d'authentification (Authentication Type ) : le type d'authentification que vous souhaitez utiliser. Vous pouvez choisir AmazonComprehend ou Connexion existante. Votre choix d'authentification détermine les autres propriétés d'authentification que vous voyez.
Clé d’accès – l’ ID de la clé d’accès de l’ utilisateur IAM que vous souhaitez authentifier. Ce champ ne prend en charge que les chaînes ou les variables String . Pour récupérer l' ID de clé d'accès, consultez l'une des sections suivantes dans la documentation AWS :
Région (Region) - Point de terminaison du service AWS que vous souhaitez utiliser pour votre connexion. Saisissez une variable RegionEndpoint ou RegionEndpoint .

Remarque :
Selon les activités que vous utilisez, sélectionnez une région où le ou les services sont disponibles.

La liste des régions peut être trouvée en tapant « RegionEndpoint » - qui est un type d'objet - puis un point (.) qui affichera la liste des régions (voir l'image ci-dessous).

Les futures versions d'Amazon Comprehend fourniront une liste déroulante pour faciliter cette sélection.
Clé secrète ( Secret) - La clé d’accès secrète de l’ utilisateur IAM que vous souhaitez connecter au service Amazon Rekognition. Ce champ ne prend en charge que les chaînes ou les variables String . Pour récupérer la clé d'accès secrète, consultez l'une des sections suivantes dans la documentation AWS :
- Gestion des clés d'accès (console)
- Gestion des clés d'accès (AWS CLI)
- Gestion des clés d'accès (API AWS)
  
  Important :
  Si vous utilisez un utilisateur IAM existant et que vous n’avez plus la clé d’accès secrète, vous pouvez en créer un nouveau en cliquant sur le bouton Créer une clé d’accès ( Create access key ) dans votre résumé d’utilisateur IAM – cette Actions crée également un nouvel ID de clé d’accès
  
  Après avoir cliqué sur le bouton Créer une clé d'accès (Create access key ), une boîte de dialogue s'ouvre. Selon les instructions AWS : « Choisissez Télécharger .csv pour enregistrer l'ID de la clé d'accès et la clé d'accès secrète dans un fichier CSV sur votre ordinateur. Stockez le fichier dans un emplacement sécurisé. Vous n'aurez plus accès à la clé d'accès secrète une fois cette boîte de dialogue fermée. Après avoir téléchargé le fichier CSV, choisissez Fermer (Close). »
  
  Amazon recommande une rotation fréquente des clés, afin que vous puissiez créer de nouvelles clés à tout moment si vous ne trouvez pas la clé d'accès secrète associée à votre ID de clé d'accès. Si vous créez de nouvelles clés, veillez à mettre à jour toutes les activités Amazon Scope dans vos projets existants.
  
  Pour en savoir plus, consultez la page <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html?icmpid=docs_iam_console" target="_blank">Managing Access Keys for IAM Users </a> dans la documentation AWS.
Connexion existante : un objet de connexion AmazonComprehend précédemment authentifié. Saisissez une variable AmazonComprehendConnection .

Propriétés

Commun

DisplayName : le nom complet de l'activité. Ce champ prend uniquement en charge les variables Strings ou String .

Divers

Privé (Private) - si cette option est sélectionnée, les valeurs des variables et des arguments ne sont plus enregistrées au niveau Détaillé (Verbose).

Options

ReportApiErrorAsException : lorsque cette option est sélectionnée, les réponses d'erreur d'API sont signalées dans BusinessActivityExecutionException par toutes les activités enfants qui utilisent cette étendue d'application. Lorsqu'elle est décochée, l'activité enfant renseigne le message d'erreur d'API dans la propriété de sortie ResponseStatus et l'exécution du workflow se poursuit. Vérifiez la propriété ResponseStatus pour confirmer la réussite de l'exécution.

Sortie

Connexion - La connexion qui peut être transmise à une étendue d'application enfant. Ce champ ne prend en charge que les variables AmazonComprehendConnection .

À cette page