Creación de un flujo de traducción de documentos (versión preliminar)

Importante

El conector de Traductor está disponible actualmente en versión preliminar pública. Antes de la disponibilidad general (GA), las características, los enfoques y los procesos podrían cambiar en función de los comentarios de los usuarios.

Este tutorial le guía por la configuración de un flujo en la nube del conector de Traductor de Microsoft V3 que admite la traducción de documentos. El conector Translator V3 crea una conexión entre la instancia de Translator Service y Microsoft Power Automate, lo que le permite usar una o varias operaciones precompiladas como pasos en las aplicaciones y los flujos de trabajo.

La traducción de documentos es una característica de la API de REST basada en la nube del servicio Traductor de Azure AI. Document Translation API permite traducciones de documentos complejos y diversos, y conserva la estructura del documento original y el formato de datos.

En este tutorial, aprenderá a:

• Crear una cuenta de Blob Storage con contenedores para los archivos de origen y destino.
• Configurar una identidad administrada con control de acceso basado en rol (RBAC).
• Traducir documentos desde la cuenta de Azure Blob Storage.
• Traducir documentos desde el sitio de SharePoint.

Requisitos previos

Esto es lo que necesita para empezar: Recurso de Translator, cuenta de almacenamiento de Azure con al menos dos contenedores y una identidad administrada asignada por el sistema con acceso basado en roles.

Recurso de Translator

• Si no tiene una cuenta de Azure activa, puede crearla gratis.

• Cree un recurso único del servicio Traductor (no un recurso multiservicio de servicios de Azure AI). A medida que complete los campos de detalles del proyecto y la instancia de Traductor, preste especial atención a las entradas siguientes:

  • Región del recurso. Elija una región geográfica como Oeste de EE. UU (no la región Global).

  • Plan de tarifa. Seleccione Estándar S1 para probar el servicio.

• Use la clave y el nombre del recurso de Traductor para conectar la aplicación a Power Automate. Las claves de recursos de Translator se encuentran en la sección Administración de recursos de Azure Portal y el nombre del recurso en la parte superior de la página.

  

• Copie y pegue la clave y el nombre del recurso en una ubicación adecuada, como el Bloc de notas de Microsoft.

Almacenamiento de Azure

• A continuación, necesita una cuenta de Azure Blob Storage y al menos dos contenedores para los archivos de origen y destino:

  • Contenedor de origen. En este contenedor se cargan los archivos para su traducción (obligatorio).
  • Contenedor de destino. En este contenedor se almacenan los archivos traducidos (obligatorio).

• Si la cuenta de almacenamiento está detrás de un firewall, debe habilitar configuraciones adicionales:

  1. Vaya a Azure Portal e inicie sesión con su cuenta de Azure.

  2. Seleccione la cuenta de almacenamiento.

  3. En el grupo Seguridad y redes del panel izquierdo, seleccione Redes.

  4. En la pestaña Firewalls y redes virtuales, seleccione Habilitado desde redes virtuales y direcciones IP seleccionadas.

     

  5. Anule la selección de todas las casillas.

  6. Asegúrese de que esté seleccionada la opción Enrutamiento de red de Microsoft.

  7. En la sección Instancias de recursos, seleccione Microsoft.CognitiveServices/accounts como tipo de recurso y seleccione el recurso de Traductor como nombre de instancia.

  8. Comprobar que la casilla Permitir que los servicios de Azure de la lista de servicios de confianza accedan a esta cuenta de almacenamiento esté seleccionada. Para obtener más información sobre la administración de excepciones, consulte Configuración de firewalls y redes virtuales de Azure Storage.

     

  9. Seleccione Guardar. Los cambios de red pueden tardar hasta 5 minutos en propagarse.

Identidad administrada con control de acceso basado en rol

Por último, para poder usar las operaciones del conector Translator V3 para la traducción de documentos, debe conceder acceso a los recursos de Translator a la cuenta de almacenamiento mediante una identidad administrada con control de identidad basado en roles (RBAC).

Creación de una entidad administrada

En primer lugar, cree una identidad administrada asignada por el sistema para el recurso de Translator y conceda a esa identidad permisos específicos para acceder a la cuenta de Azure Storage:

1. Vaya a Azure Portal e inicie sesión con su cuenta de Azure.

2. Selección del recurso de Traductor.

3. En el grupo Administración de recursos del panel izquierdo, seleccione Identidad.

4. En la pestaña Sistema asignado, active el botón de alternancia Estado.

5. Seleccione Guardar.

   

Asignación de roles

A continuación, asigne un rol Storage Blob Data Contributor a la identidad administrada en el ámbito de almacenamiento del recurso de almacenamiento.

1. Vaya a Azure Portal e inicie sesión con su cuenta de Azure.

2. Selección del recurso de Traductor.

3. En el grupo Administración de recursos del panel izquierdo, seleccione Identidad.

4. En Permisos, seleccione Asignaciones de roles de Azure:

   

5. En la página Asignaciones de roles de Azure que se abre, elija su suscripción en el menú desplegable y, después, seleccione + Agregar asignación de roles.

   

6. Por último, asigne un rol de Colaborador de datos de Storage Blob al recurso del servicio Translator. El rol Colaborador de datos de Storage Blob proporciona al Traductor (representado por la identidad administrada asignada por el sistema) acceso de lectura, escritura y eliminación al contenedor de blobs y a los datos. En la ventana emergente Agregar asignación de roles, complete los campos como se muestra a continuación y seleccione Guardar:

   Campo	Valor
   Ámbito	Storage.
   Suscripción	La suscripción asociada al recurso de almacenamiento.
   Recurso	El nombre del recurso de almacenamiento.
   Rol	Colaborador de datos de Storage Blob.

7. Una vez que aparezca el mensaje de confirmación de asignación de rol agregado, actualice la página para ver la asignación de rol agregada.

   

8. Si no ve la nueva asignación de roles inmediatamente, espere e intente actualizar la página de nuevo. Al asignar o quitar asignaciones de roles, los cambios pueden tardar hasta 30 minutos en aplicarse.

   

Configuración de un flujo de traducción de documentos

Ahora que ha completado los requisitos previos y la configuración inicial, se usará el conector Translator V3 para crear el flujo de traducción de documentos:

1. Inicie sesión en Power Automate.

2. Seleccione Crear en el menú de la barra lateral izquierda.

3. Seleccione Flujo de nube instantáneo en el área de contenido principal.

   

4. En la ventana emergente, asigne un nombre al flujo y, después, elija Desencadenar manualmente un flujo y seleccione Crear.

   

5. En la pantalla aparece el primer paso para el flujo instantáneo; Desencadenar manualmente un flujo. Seleccione Nuevo paso.

   

Traducción de documentos

A continuación, ya se puede seleccionar una acción. Puede traducir documentos ubicados en la cuenta de Azure Blob Storage o Microsoft SharePoint.

Uso de Azure Blob Storage

Azure Blob Storage

Estos son los pasos para traducir un archivo en Azure Blob Storage mediante el conector Translator V3:

• Elija el conector Translator V3.
• Seleccione la traducción de documentos.
• Escriba las credenciales de Azure Blob Storage y las ubicaciones de contenedor.
• Traduzca los documentos y elija los idiomas de origen y destino.
• Obtenga el estado de la operación de traducción.

1. En la ventana emergente Elegir una operación, escriba Translator V3 en la barra de búsqueda Buscar conectores y acciones, y seleccione el icono de Microsoft Translator V3.

   

2. Seleccione la acción Iniciar traducción de documentos.

3. Si es la primera vez que usa el conector de Translator V3, debe escribir las credenciales del recurso:

   • Nombre de la conexión. Escriba un nombre para la conexión.

   • Clave de suscripción. Las claves del recurso de Traductor se encuentran en la sección Administración de recursos de la barra lateral del recurso en Azure Portal. Escriba una de las claves. Asegúrese de que el recurso Traductor está asignado a una región geográfica como Oeste de EE. UU (no global).

   • Nombre del recurso de Traductor. Escriba el nombre del recurso de Traductor que se encuentra en la parte superior de la página del recurso en Azure Portal. Seleccione Crear.

     

     Nota:

     Después de configurar la conexión, no será necesario volver a escribir las credenciales para los flujos posteriores.

4. Ahora aparece la ventana de la acción Iniciar traducción de documentos. Complete los campos como se indica a continuación:

   • En Tipo de almacenamiento de los documentos de entrada. Seleccione Archivo o Carpeta.

   • Seleccione un Idioma de origen en el menú desplegable o mantenga la opción Detección automática predeterminada.

   • Ubicación de los documentos de origen. Escriba la dirección URL de los documentos en el contenedor de documentos de origen de almacenamiento de Azure.

   • Ubicación de los documentos traducidos. Escriba la dirección URL del contenedor de documentos de destino de Azure Storage.

     Para buscar las direcciones URL de origen y destino:

     • Vaya a la cuenta de almacenamiento en Azure Portal.

     • En la barra lateral de la izquierda, en Almacenamiento de datos, seleccione Contenedores:

       Source	Destino
       Active la casilla situada junto al contenedor de origen	Active la casilla situada junto al contenedor de destino.
       En el área principal de la ventana, seleccione un archivo o documento para la traducción.	Seleccione los puntos suspensivos situados a la derecha y, después, elija Propiedades.
       La dirección URL de origen se encuentra en la parte superior de la lista Propiedades. Seleccione el icono Copiar al Portapapeles.	La dirección URL de destino se encuentra en la parte superior de la lista Propiedades. Seleccione el icono Copiar al Portapapeles.
       Vaya al flujo de Power Automate y pegue la dirección URL de origen en el campo Ubicación de los documentos de origen.	Vaya al flujo de Power Automate y pegue la dirección URL de destino en el campo Ubicación de los documentos traducidos.

   • Elija un Idioma de destino en el menú desplegable y seleccione Guardar.

     

Obtención del estado de los documentos

Ahora que ha enviado los documentos para la traducción, se comprobará el estado de la operación.

1. Seleccione Nuevo paso.

2. Escriba Traductor V3 en el cuadro de búsqueda y elija Traductor de Microsoft V3.

3. Seleccione Obtener el estado de los documentos (no la acción singular Obtener estado del documento).

   

4. A continuación, escribirá una expresión para recuperar el valor operation ID.

5. Seleccione el campo Id. de operación. Aparece una ventana desplegable Contenido dinámico / Expresión.

6. Seleccione la pestaña Expresión y escriba la siguiente expresión en el campo de función:

   
      body('Start_document_translation').operationID
   
   

   

7. Seleccione Aceptar. La función aparece en la ventana Id. de operación. Seleccione Guardar.

   

Prueba del flujo del conector

Es el momento de comprobar el flujo y los resultados de la traducción de documentos.

1. Hay una barra verde en la parte superior de la página que indica que el flujo está listo para usarse.

2. Seleccione Probar en la esquina superior derecha de la página.

   

3. Seleccione los botones siguientes: Probar flujo → Manualmente → Probar en la ventana de la derecha.

4. En la ventana siguiente, seleccione el botón Ejecutar flujo.

5. Por último, seleccione el botón Listo.

6. Debe recibir un mensaje El flujo se ha ejecutado correctamente y verá marcas de verificación verdes que se alinean con cada paso correcto.

   

7. Seleccione el paso Obtener el estado de los documentos y después Mostrar salidas sin procesar en la sección Salidas.

8. Aparece una ventana Obtener el estado de los documentos. En la parte superior de la respuesta JSON, verá "statusCode":200, lo que indica que la solicitud se ha realizado correctamente.

   

9. Como comprobación final, vaya al contenedor de origen de destino de Azure Blob Storage. Allí debería ver el documento traducido en la sección Información general. Es posible que el documento esté en una carpeta etiquetada con el código del idioma de traducción.

Uso de Microsoft SharePoint

Microsoft SharePoint

Estos son los pasos para cargar un archivo desde el sitio de SharePoint a Azure Blob Storage, traducirlo y devolverlo traducido a SharePoint:

• Recuperar el contenido del archivo de origen del sitio de SharePoint.
• Crear un blob de Azure Storage a partir del archivo de origen.
• Traducir el archivo de origen.
• Obtener el estado de los documentos.
• Obtener contenido de blobs y metadatos.
• Crear una carpeta de SharePoint.
• Crear el archivo traducido en Sharepoint.

Obtener contenido de archivo

1. En la ventana emergente Elegir una operación, introduzca SharePoint, entonces seleccione el contenido Obtener contenido del archivo. Power Automate inicia sesión automáticamente en la cuenta de SharePoint.

   

2. En la ventana Obtener contenido del archivo, complete los campos siguientes:

   • Dirección del sitio. Seleccione la URL del sitio de SharePoint donde se encuentra el archivo en la lista desplegable.
   • Identificador de archivo. Seleccione el icono de carpeta y elija los documentos para la traducción.

Creación de un blob de almacenamiento

1. Seleccione Nuevo paso y escriba Azure Blob Storage en el cuadro de búsqueda.

2. Seleccione la acción Crear blob (V2).

3. Si es la primera vez que usa el paso de almacenamiento de Azure, debe escribir la autenticación del recurso de almacenamiento:

4. En el campo Tipo de autenticación, elija Integrado con Microsoft Entra y, después, seleccione el botón Iniciar sesión.

   

5. Elija la cuenta de Microsoft Entra asociada a las cuentas de los recursos de Azure Blob Storage y Traductor.

6. Una vez que complete la autenticación de Azure Blob Storage, aparecerá el paso Crear blob. Complete los campos como se indica a continuación:

   • Nombre de la cuenta de almacenamiento o punto de conexión de blob. Seleccione Escribir valor personalizado y escriba el nombre de la cuenta de almacenamiento.

   • Ruta de acceso de la carpeta. Seleccione el icono de carpeta y el contenedor de documentos de origen.

   • Nombre del blob. Escriba el nombre del archivo que va a traducir.

   • Contenido del blob. Seleccione el campo Contenido del blob para mostrar la lista desplegable Contenido dinámico y elija el icono Contenido del archivo de SharePoint.

     

Inicio de la traducción de documentos

1. Seleccione Nuevo paso.

2. Escriba Traductor V3 en el cuadro de búsqueda y elija Traductor de Microsoft V3.

3. Seleccione la acción Iniciar traducción de documentos.

4. Si es la primera vez que usa el conector de Translator V3, debe escribir las credenciales del recurso:

   • Nombre de la conexión. Escriba un nombre para la conexión.

   • Clave de suscripción. Escriba una de las claves que ha copiado de Azure Portal.

   • Nombre del recurso de Traductor. Escriba el nombre del recurso de Traductor que se encuentra en la parte superior de la página del recurso en Azure Portal.

   • Seleccione Crear.

     

     Nota:

     Después de configurar la conexión, no será necesario volver a escribir las credenciales para los flujos posteriores de Traductor.

5. Ahora aparece la ventana de la acción Iniciar traducción de documentos. Complete los campos como se indica a continuación:

6. En Tipo de almacenamiento de los documentos de entrada. Seleccione Archivo o Carpeta.

7. Seleccione un Idioma de origen en el menú desplegable o mantenga la opción Detección automática predeterminada.

8. Ubicación de los documentos de origen. Seleccione el campo y agregue Ruta de acceso seguido de Nombre en la lista desplegable Contenido dinámico.

9. Ubicación de los documentos traducidos. Escriba la dirección URL del contenedor de documentos de destino de Azure Storage.

   Para buscar la dirección URL del contenedor de destino:

   • Vaya a la cuenta de almacenamiento en Azure Portal.
   • En la barra lateral de la izquierda, en Almacenamiento de datos, seleccione Contenedores.
   • Active la casilla situada junto al contenedor de destino.
   • Seleccione los puntos suspensivos situados a la derecha y, después, elija Propiedades.
   • La dirección URL de destino se encuentra en la parte superior de la lista Propiedades. Seleccione el icono Copiar al Portapapeles.
   • Vuelva al flujo de Power Automate y pegue la dirección URL de destino en el campo Ubicación de los documentos traducidos.

10. Elija un Idioma de destino en el menú desplegable y seleccione Guardar.

    

Obtención del estado de los documentos

Antes de recuperar el estado de los documentos, se programará un retraso de 30 segundos para asegurarse de que el archivo se haya procesado para la traducción:

1. Seleccione Nuevo paso. Escriba Programación en el cuadro de búsqueda y elija Retraso.

   • Para Recuento. Escriba 30.
   • Para Unidad. Escriba Segundo en la lista desplegable.

   

2. Seleccione Nuevo paso. Escriba Traductor V3 en el cuadro de búsqueda y elija Traductor de Microsoft V3.

3. Seleccione Obtener el estado de los documentos (no Obtener estado del documento en singular).

   

4. A continuación, escribirá una expresión para recuperar el valor operation ID.

5. Seleccione el campo Id. de operación. Aparece una ventana desplegable Contenido dinámico / Expresión.

6. Seleccione la pestaña Expresión y escriba la siguiente expresión en el campo de función:

   
     body('Start_document_translation').operationID
   
   

   

7. Seleccione Aceptar. La función aparece en la ventana Id. de operación. Seleccione Guardar.

   

Obtención de contenido de blobs y metadatos

En este paso, recuperará el documento traducido de Azure Blob Storage y lo cargará en SharePoint.

1. Seleccione Nuevo paso, escriba Control en el cuadro de búsqueda y seleccione Aplicar a cada uno en la lista Acciones.

2. Seleccione el campo de entrada para mostrar la ventana Contenido dinámico y seleccione valor.

   

3. Seleccione Add an action(Agregar una acción).

   

4. Escriba Control en el cuadro de búsqueda y seleccione Repetir hasta en la lista Acciones.

5. Seleccione el campo Elegir un valor para mostrar la ventana Contenido dinámico y seleccione progreso.

6. Complete los tres campos de la siguiente manera: progreso → es igual a → 1:

   

7. Seleccione Agregar una acción, escriba Azure Blob Storage en el cuadro de búsqueda y seleccione la acción Obtener contenido de blob mediante la ruta de acceso (V2).

8. En el campo Nombre de la cuenta de almacenamiento o punto de conexión de blob, seleccione Escribir valor personalizado y escriba el nombre de la cuenta de almacenamiento.

9. Seleccione el campo Ruta de acceso del blob para mostrar la ventana Contenido dinámico; seleccione Expresión y escriba la siguiente lógica en el campo de fórmula:

   
      concat(split(outputs('Get_documents_status')?['body/path'],'/')[3],'/',split(outputs('Get_documents_status')?['body/path'],'/')[4],'/',split(outputs('Get_documents_status')?['body/path'],'/')[5])
   
   

10. Seleccione Agregar una acción, escriba Azure Blob Storage en el cuadro de búsqueda y seleccione la acción Obtener metadatos de blob mediante la ruta de acceso (V2).

11. En el campo Nombre de la cuenta de almacenamiento o punto de conexión de blob, seleccione Escribir valor personalizado y escriba el nombre de la cuenta de almacenamiento.

    

12. Seleccione el campo Ruta de acceso del blob para mostrar la ventana Contenido dinámico, seleccione Expresión y escriba la siguiente lógica en el campo de fórmula:

    
       concat(split(outputs('Get_documents_status')?['body/path'],'/')[3],'/',split(outputs('Get_documents_status')?['body/path'],'/')[4],'/',split(outputs('Get_documents_status')?['body/path'],'/')[5])
    
    

Creación de una carpeta

1. Seleccione Agregar una acción, escriba SharePoint en el cuadro de búsqueda y seleccione la acción Crear nueva carpeta.
2. Seleccione la dirección URL de SharePoint en la ventana desplegable Dirección del sitio.
3. En el campo siguiente, seleccione una lista o biblioteca en la lista desplegable.
4. Asigne un nombre a la nueva carpeta y escríbalo en el campo /Ruta de carpeta/ (asegúrese de incluir el nombre de la ruta entre barras diagonales).

Creación del archivo de SharePoint

1. Seleccione Agregar una acción, escriba SharePoint en el cuadro de búsqueda y seleccione la acción Crear archivo.

2. Seleccione la dirección URL de SharePoint en la ventana desplegable Dirección del sitio.

3. En el campo Ruta de carpeta, en la lista Contenido dinámico, en Crear nueva carpeta, seleccione Ruta de acceso completa.

4. En el campo Nombre de archivo, en la lista Contenido dinámico, en Obtener metadatos de blobs mediante la ruta de acceso (V2), seleccione Nombre.

5. En el campo Contenido de archivo, en la lista Contenido dinámico, en Obtener metadatos de blobs mediante la ruta de acceso (V2), seleccione Contenido de archivo.

6. Seleccione Guardar.

   

Prueba del flujo del conector

Ahora se comprobará el flujo y los resultados de la traducción de documentos.

1. Hay una barra verde en la parte superior de la página que indica que el flujo está listo para usarse.

2. Seleccione Probar en la esquina superior derecha de la página.

   

3. Seleccione Probar flujo → Manualmente → Probar en la ventana de la derecha.

4. En la ventana Ejecutar flujo, seleccione los botones Continuar y Ejecutar flujo.

5. Por último, seleccione el botón Listo.

6. Debe recibir un mensaje "El flujo se ha ejecutado correctamente" y verá marcas de verificación verdes que se alinean con cada paso correcto.

   

Eso es todo. Ha aprendido a automatizar los procesos de traducción de documentos mediante el conector de Traductor de Microsoft V3 y Power Automate.

Pasos siguientes

Exploración de la guía de referencia de traducción de documentos