Fonctionnalités Amazon Comprehend

Les activités Amazon Comprehend utilisent le service AWS Identity and Access Management afin d'é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 et Clé d'accès secrète). Lorsque vous créez votre utilisateur IAM, vous attribuez les politiques et les autorisations qui indiquent les ressources auxquelles votre Robot peut accéder (par exemple, AmazonComprehendFullAccess).

Après avoir créé votre utilisateur IAM et attribué vos stratégies, vous saisissez l’ID de clé d’accès et la clé d’accès secrète 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 d'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.

1. Terminez les étapes de Configuration .
2. Ajoutez l'activité Amazon Comprehend Scope à votre projet.
3. Entrez les valeurs des propriétés situées dans le corps de l'activité.
4. 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é

• TypeAuthentification : le type d'authentification que vous souhaitez utiliser. Vous pouvez choisir AmazonComprehend ou Connexion existante. Le choix de votre authentification détermine les autres propriétés d’authentification affichées.
• Clé d'accès : l' ID de 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:
  • 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)
• Région : le point de terminaison de service AWS que vous souhaitez utiliser pour votre connexion. Saisissez une variable RegionEndpoint ou RegionEndpoint .
  Remarque :

  En fonction des activités que vous utilisez, sélectionnez une région où le(s) service(s) est/sont disponible(s). La liste des régions peut être trouvée en saisissant 'RegionEndpoint' (PointTerminaisonRégion) - qui est un type d'objet, puis un point (.) qui affichera la liste des régions. Les versions futures d'Amazon Comprehend fourniront une liste déroulante pour faciliter cette sélection.

• Clé secrète : 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 ne disposez plus de la clé d’accès secrète, vous pouvez en créer une nouvelle en cliquant sur le bouton Créer une clé d’accès dans votre résumé d’utilisateur IAM. Cette action crée également un nouvel ID de clé d’accès après avoir cliqué sur Bouton Créer la clé d'accès une boîte de dialogue s'ouvre. Selon les instructions AWS: « Choisissez Télécharger le fichier.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 endroit sécurisé. Vous n’aurez plus accès à la clé d’accès secrète après la fermeture de cette boîte de dialogue. Après avoir téléchargé le fichier CSV, choisissez Fermer.» Amazon recommande une rotation fréquente des clés, vous pouvez donc 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 Gestion des clés d'accès pour les utilisateurs IAM dans la documentation AWS.

• Connexion existante : un objet de connexion AmazonComprehend précédemment authentifié. Saisissez une AmazonComprehendConnection variable.

Propriétés

Commun

• NomAffichage : nom affiché de l'activité. Ce champ ne prend en charge que les chaînes ou les variables String .

Divers

• Private - If this checkbox is selected, the values of variables and arguments are no longer logged at Verbose level.

Options

• ReportApiErrorAsException - When selected, API error responses are reported in BusinessActivityExecutionException by all child activities that use this application scope. When cleared, the child activity populates the API error message in the ResponseStatus output property and workflow execution continues. Check the ResponseStatus property to confirm successful execution.

Sortie

• Connexion : la connexion pouvant être transmise à une étendue d'application enfant. Ce champ prend uniquement en charge les variables AmazonComprehendConnection .