Ámbito de Amazon Comprehend

Las actividades de Amazon Comprehend utilizan el servicio AWS Identity and Access Management (IAM) para establecer una conexión autenticada entre UiPath y tus recursos de AWS. Esta conexión permite a un Robot llamar a las API de Amazon Comprehend para leer y escribir recursos en tu nombre.

Para establecer una conexión autenticada, crea o utiliza un usuario de IAM existente y genera claves de acceso (ID de clave de acceso y clave de acceso secreta). Al crear tu usuario de IAM, asignas las políticas y los permisos que especifican los recursos a los que puede acceder tu Robot (por ejemplo, AmazonComprehendFullAccess).

Después de crear tu usuario de IAM y asignar tus políticas, introduces el ID de clave de acceso y la clave de acceso secreta en la actividad Ámbito de Amazon Comprehend . Cuando ejecutas tu proyecto de automatización, las claves se utilizan para firmar las solicitudes de API realizadas por cada una de las actividades.

Cómo funciona

Los siguientes pasos y diagrama de secuencia de mensajes son un ejemplo de cómo funciona la actividad desde el momento de diseño (es decir, las dependencias de la actividad y las propiedades de entrada / salida) hasta el tiempo de ejecución.

1. Completa los pasos de configuración .
2. Añade la actividad Ámbito de Amazon Comprehend a tu proyecto.
3. Introduce valores para las propiedades ubicadas en el cuerpo de la actividad.
4. Si deseas reutilizar la conexión en actividades de ámbito posteriores, introduce una variable en la propiedad Salida.

En el cuerpo de la actividad

• Tipo de autenticación : el tipo de autenticación que quieres utilizar. Puedes elegir AmazonComprehend o Conexión existente. Tu elección de autenticación determina qué otras propiedades de autenticación ves.
• Clave de acceso : el ID de la clave de acceso del usuario de IAM que deseas autenticar. Este campo solo admite cadenas o variables String . Para recuperar el ID de la clave de acceso, consulta una de las siguientes secciones en la documentación de AWS:
  • Gestión de claves de acceso (consola)
  • Administración de claves de acceso (AWS CLI)
  • Administración de claves de acceso (API de AWS)
• Región : el punto final de servicio de AWS que quieres utilizar para tu conexión. Introduce una variable RegionEndpoint o RegionEndpoint .
  Nota:

  Dependiendo de las actividades que estés utilizando, selecciona una región donde estén disponibles los servicios. La lista de regiones se puede encontrar escribiendo 'RegionEndpoint', que es un tipo de objeto, y luego un punto (.) que mostrará la lista de regiones. Las versiones futuras de Amazon Comprehend proporcionarán una lista desplegable para facilitar esta selección.

• Secreto : la clave de acceso secreta del usuario de IAM que quieres conectar al servicio de Amazon Rekognition. Este campo solo admite cadenas o variables String . Para recuperar la clave de acceso secreta, consulta una de las siguientes secciones en la documentación de AWS:
  • Gestión de claves de acceso (consola)
  • Administración de claves de acceso (AWS CLI)
  • Administración de claves de acceso (API de AWS)
    Importante:

    Si está utilizando un usuario de IAM existente y ya no tiene la clave de acceso secreta, cree una nueva haciendo clic en el botón Crear clave de acceso en su resumen de usuario de IAM; esta acción también crea un nuevo ID de clave de acceso. Después de hacer clic en el botón Crear clave de acceso se abre un cuadro de diálogo. Según las instrucciones de AWS: "Elegir Descargar.csv para guardar el ID de la clave de acceso y la clave de acceso secreta en un archivo CSV en tu ordenador. Guarda el archivo en una ubicación segura. No volverás a tener acceso a la clave de acceso secreta después de que se cierre este cuadro de diálogo. Una vez descargado el archivo CSV, selecciona Cerrar". Amazon recomienda la rotación frecuente de claves, para que puedas crear nuevas claves en cualquier momento si no puedes encontrar la clave de acceso secreta asociada a tu ID de clave de acceso. Si creas nuevas claves, asegúrate de actualizar cualquier actividad de Amazon Scope en tus proyectos existentes. Para obtener más información, consulta Gestionar claves de acceso para usuarios de IAM en la documentación de AWS.

• Conexión existente : un objeto de conexión de AmazonComprehend previamente autenticado. Introduce una variable AmazonComprehendConnection .

Propiedades

Común

• NombreParaMostrar : el nombre para mostrar de la actividad. Este campo solo admite cadenas o variables String .

Otros

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

Opciones

• 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.

Salida

• Conexión : la conexión que se puede pasar a un ámbito de aplicación secundario. Este campo solo admite variables AmazonComprehendConnection .