Amazon Comprehend Scope

Die Amazon Comprehend-Aktivitäten verwenden den AWS Identity and Access Management (IAM) -Dienst, um eine authentifizierte Verbindung zwischen UiPath und Ihren AWS-Ressourcen herzustellen. Diese Verbindung ermöglicht es einem Roboter, die Amazon Comprehend-APIs aufzurufen, um Ressourcen in Ihrem Namen zu lesen und zu schreiben.

Um eine authentifizierte Verbindung herzustellen, erstellen oder verwenden Sie einen vorhandenen IAM-Benutzer und generieren Zugriffsschlüssel (Zugriffsschlüssel-ID und geheimer Zugriffsschlüssel). Wenn Sie Ihren IAM-Benutzer erstellen, weisen Sie die Richtlinien und Berechtigungen zu, die die Ressourcen angeben, auf die Ihr Roboter zugreifen kann (z. B. AmazonComprehendFullAccess).

Nachdem Sie Ihren IAM-Benutzer erstellt und Ihre Richtlinien zugewiesen haben, geben Sie die Zugriffsschlüssel-ID und den geheimen Zugriffsschlüssel in der Aktivität Amazon Comprehend Scope ein. Wenn Sie Ihr Automatisierungsprojekt ausführen, werden die Schlüssel verwendet, um die API-Anforderungen zu signieren, die von den einzelnen Aktivitäten gestellt werden.

Wie es funktioniert

Die folgenden Schritte und das folgende Nachrichtensequenzdiagramm sind ein Beispiel dafür, wie die Aktivität von der Entwurfszeit (d. h. den Aktivitätsabhängigkeiten und Eingabe-/Ausgabeeigenschaften) bis zur Laufzeit funktioniert.

1. Schließen Sie die Einrichtungsschritte ab.
2. Fügen Sie Ihrem Projekt die Aktivität Amazon Comprehend Scope hinzu.
3. Geben Sie Werte für die Eigenschaften ein, die sich im Textkörper der Aktivität befinden.
4. Wenn Sie die Verbindung in nachgelagerten Scope-Aktivitäten wiederverwenden möchten, geben Sie eine Variable in die Eigenschaft Ausgabe ein.

Im Textkörper der Aktivität

• Authentifizierungstyp – Der Authentifizierungstyp, den Sie verwenden möchten. Sie können entweder AmazonComprehend oder Existing Connection auswählen. Ihre Wahl der Authentifizierung bestimmt, welche anderen Authentifizierungseigenschaften Sie sehen.
• Zugriffsschlüssel – Die Zugriffsschlüssel-ID des IAM-Benutzers , den Sie authentifizieren möchten. Dieses Feld unterstützt nur Strings oder String -Variablen. Informationen zum Abrufen der Zugriffsschlüssel-ID finden Sie in einem der folgenden Abschnitte in der AWS-Dokumentation:
  • Verwalten von Zugriffsschlüsseln (Konsole)
  • Verwalten von Zugriffsschlüsseln (AWS CLI)
  • Verwalten von Zugriffsschlüsseln (AWS API)
• Region – Der AWS-Service-Endpunkt , den Sie für Ihre Verbindung verwenden möchten. Geben Sie eine RegionEndpoint - oder RegionEndpoint -Variable ein.
  Hinweis:

  Wählen Sie je nach den von Ihnen verwendeten Aktivitäten eine Region aus, in der der/die Dienst(e) verfügbar ist/sind.

  Die Liste der Regionen finden Sie, indem Sie „RegionEndpoint“ – einen Objekttyp – und dann einen Punkt (.) eingeben, der die Liste der Regionen anzeigt (siehe Abbildung unten).

  Zukünftige Versionen von Amazon Comprehend werden eine Dropdownliste zur Verfügung stellen, um diese Auswahl zu erleichtern.

• Secret (Secret) – Der geheime Zugriffsschlüssel des IAM-Benutzers , den Sie mit dem Amazon Rekognition-Dienst verbinden möchten. Dieses Feld unterstützt nur Strings oder String -Variablen. Informationen zum Abrufen des geheimen Zugriffsschlüssels finden Sie in einem der folgenden Abschnitte in der AWS-Dokumentation:
  • Verwalten von Zugriffsschlüsseln (Konsole)
  • Verwalten von Zugriffsschlüsseln (AWS CLI)

  • Verwalten von Zugriffsschlüsseln (AWS API)

    Wichtig:

    Wenn Sie einen vorhandenen IAM-Benutzer verwenden und nicht mehr über den geheimen Zugriffsschlüsselverfügen, erstellen Sie einen neuen, indem Sie in Ihrer IAM-Benutzerzusammenfassung auf die Schaltfläche Zugriffsschlüssel erstellen klicken – diese Actions erstellt auch eine neue Zugriffsschlüssel-ID

    Nachdem Sie auf die Schaltfläche Zugriffsschlüssel erstellen geklickt haben, wird ein Dialogfeld geöffnet. Gemäß den AWS-Anweisungen: „Choose .csv um die Zugriffsschlüssel-ID und den geheimen Zugriffsschlüssel in einer CSV-Datei auf Ihrem Computer zu speichern. Speichern Sie die Datei an einem sicheren Speicherort. Sie haben keinen Zugriff mehr auf den geheimen Zugriffsschlüssel, nachdem dieses Dialogfeld geschlossen wurde. Nachdem Sie die CSV-Datei heruntergeladen haben, wählen Sie „Schließen“ aus.“

    Amazon empfiehlt eine häufige Schlüsselrotation, sodass Sie jederzeit neue Schlüssel erstellen können, wenn Sie den geheimen Zugriffsschlüssel , der Ihrer Zugriffsschlüssel-IDzugeordnet ist, nicht finden können. Wenn Sie neue Schlüssel erstellen, müssen Sie alle Amazon Scope- Aktivitäten in Ihren vorhandenen Projekten aktualisieren.

    Weitere Informationen finden Sie unter <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html?icmpid=docs_iam_console" target="_blank">Verwalten von Zugriffsschlüsseln für IAM-Benutzer </a> in der AWS-Dokumentation.

• Vorhandene Verbindung – Ein zuvor authentifiziertes AmazonComprehend-Verbindungsobjekt. Geben Sie eine AmazonComprehendConnection -Variable ein.

Eigenschaften

Allgemein

• DisplayName - Der Anzeigename der Aktivität. Dieses Feld unterstützt nur Strings oder String -Variablen.

Sonstiges

• Privat (Private) - Bei Aktivierung dieses Kontrollkästchens werden die Werte von Variablen und Argumenten nicht mehr auf der Stufe Verbose protokolliert.

Optionen

• ReportApiErrorAsException – Wenn diese Option ausgewählt ist, werden API-Fehlerantworten in BusinessActivityExecutionException von allen untergeordneten Aktivitäten gemeldet, die diesen Anwendungsbereich verwenden. Wenn diese Option deaktiviert ist, füllt die untergeordnete Aktivität die API-Fehlermeldung in der Ausgabeeigenschaft ResponseStatus aus und die Workflowausführung wird fortgesetzt. Überprüfen Sie die Eigenschaft ResponseStatus, um die erfolgreiche Ausführung zu bestätigen.

Ausgabe

• Verbindung – Die Verbindung, die an einen untergeordneten Anwendungsbereich übergeben werden kann. Dieses Feld unterstützt nur AmazonComprehendConnection -Variablen.