Dynamics Translation Service (versión preliminar)
Operaciones de traducción, alineación y regeneración con tecnología de Dynamics Translation Service.
Este conector está disponible en los siguientes productos y regiones:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Aplicaciones lógicas | Estándar | Todas las regiones de Logic Apps excepto las siguientes: - Regiones de Azure Government - Regiones de Azure China - Departamento de Defensa de EE. UU. (DoD) |
| Power Apps | Premium | Todas las regiones de Power Apps excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Power Automate | Premium | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Contacto | |
|---|---|
| Nombre | Dynamics Translation Service |
| URL | https://lcs.dynamics.com |
| Correo Electrónico | dtssup@microsoft.com |
| Metadatos del conector | |
|---|---|
| Publicador | Microsoft Corporation |
| Sitio web | https://lcs.dynamics.com/ |
| Directiva de privacidad | https://privacy.microsoft.com/privacystatement |
| Categorías | Contenido y archivos |
El conector de Dynamics 365 Translation Service se integra con Power Platform, lo que permite a los usuarios acceder a DTS directamente desde un flujo o aplicación. Este conector llama a la API de DTS en nombre de su usuario y los guarda un viaje al sitio web. Este conector permite traducir archivos de interfaz de usuario (UI), regenerar solicitudes de traducción y crear archivos de memoria de traducción (TM). Al aprovechar estas funcionalidades, podrá automatizar el flujo de trabajo de traducción.
Prerrequisitos
Necesitará lo siguiente para continuar:
- Un plan de Microsoft Power Apps o Power Automate con una característica de conector personalizada.
- Una cuenta con acceso a Dynamics Lifecycle Services.
Obtención de credenciales
Este conector usa OAuth a través de una aplicación microsoft Entra ID para la autenticación. Dado que DTS reside en LCS, necesita permisos de LA API de LCS en la aplicación. El procedimiento siguiente le guía por el proceso de registro de aplicaciones de una aplicación de Id. de Microsoft Entra para su uso con este conector.
- Inicie sesión en Azure Portal como el usuario que se usará para comunicarse con la API de LCS.
- En Servicios Azure, seleccione Registros de aplicaciones.
- En la página Registros de aplicaciones, seleccione Nuevo registro.
- En la página Registrar una aplicación , en el campo Nombre , escriba un nombre para la aplicación.
- En Tipos de cuenta admitidos, seleccione una opción para especificar qué cuentas se deben admitir.
- Seleccione Registrar.
- En la página del nuevo registro de aplicaciones, en el panel de navegación izquierdo, en Administrar, seleccione Permisos de API.
- En la página Permisos de API , seleccione Agregar un permiso.
- En la pestaña API que usa mi organización , busque y seleccione la API de servicios de ciclo de vida de Dynamics .
- Active la casilla para el permiso de API que tiene el ámbito de user_impersonation y, a continuación, seleccione Agregar permisos.
- Seleccione el botón para conceder el consentimiento del administrador para los permisos. Cuando se le pida que confirme la acción, seleccione Sí.
- En el panel de navegación izquierdo, en Administrar, seleccione Autenticación.
- En la página Autenticación , en Configuración avanzada, establezca la opción Permitir flujos de cliente públicos en Sí.
- En el panel de navegación izquierdo, seleccione Información general.
- La página de información general del registro de la aplicación muestra el identificador de cliente.
- En el panel de navegación izquierdo, seleccione Certificados y secretos. Desde aquí, puede generar el secreto de cliente necesario para configurar la conexión.
Introducción al conector
- Almacene los recursos de DTS en algún lugar desde el que se pueda acceder desde el conector. Por ejemplo, puede cargarlos en OneDrive y usar el conector de OneDrive para recuperar los archivos.
- En función de su escenario, querrá empezar con las acciones Traducir, Alinear o Regenerar. En cualquier caso, deberá proporcionar un archivo ZIP con los archivos de memoria de recursos o traducción. Al traducir o regenerar, puede usar las operaciones Descargar resultado de traducción o Descargar resultado de alineación para recuperar los resultados.
- La entrada de Traducción, Alineación y Regeneración es la misma que en la interfaz de usuario web. La entrada de todas las demás operaciones será la salida de estas.
Problemas y limitaciones conocidos
- Solo se admiten solicitudes de interfaz de usuario.
- La operación Alinear devuelve una dirección URL para el archivo de alineación, pero la operación de alineación de descarga toma el nombre de archivo como entrada. Deberá manipular la dirección URL para extraer el nombre de archivo antes de usar la operación Alinear.
Errores y soluciones comunes
- Una solicitud con el código de estado 200 no siempre indica que se ha realizado correctamente. Compruebe el cuerpo de la respuesta en caso de resultados inesperados.
{ "status": "InvalidSourceLanguage", "message": "The source language either does not match the product, or does not exist." }
Creación de una conexión
El conector admite los siguientes tipos de autenticación:
| Predeterminado | Parámetros para crear una conexión. | Todas las regiones | No se puede compartir |
Predeterminado
Aplicable: Todas las regiones
Parámetros para crear una conexión.
Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.
Limitaciones
| Nombre | Llamadas | Período de renovación |
|---|---|---|
| Llamadas API por conexión | 100 | 60 segundos |
Acciones
| Align |
Use la herramienta Alinear para crear un archivo de memoria de traducción a partir de archivos nativos traducidos anteriormente. |
| Descargar resultado de alineación |
Descargue el resultado de alineación. |
| Descargar resultado de traducción |
Descargue la salida de una solicitud de traducción. |
| Recuperar |
Sondee el estado de una solicitud de traducción. |
| Regenerar |
Regenera una traducción mediante memorias de traducción actualizadas. |
| Translate |
Envíe una nueva solicitud de traducción. |
Align
Use la herramienta Alinear para crear un archivo de memoria de traducción a partir de archivos nativos traducidos anteriormente.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Tipo de producto
|
productType | True | string |
Seleccione el tipo de producto. |
|
Versión del producto
|
productVersion | True | string |
Seleccione la versión del producto. |
|
Lengua origen
|
sourceLanguage | True | string |
Idioma de origen de traducción. |
|
Idioma de destino
|
targetLanguage | True | string |
Idioma de destino de traducción. |
|
Archivo de origen
|
sourceFile | True | binary |
Archivo de recursos nativo. |
|
Archivo de destino
|
targetFile | True | binary |
Archivo de destino nativo. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
estado
|
status | string |
Cadena que describe el estado de la solicitud. |
|
Mensaje
|
message | string |
Cadena que describe el estado de la solicitud. |
|
Tasa de alineación
|
alignmentRate | float |
Porcentaje de unidades de traducción de origen y destino coincidentes. |
|
Dirección URL del archivo alineado
|
alignedFile | string |
Dirección URL para recuperar la salida de alineación. |
Descargar resultado de alineación
Descargue el resultado de alineación.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Nombre del archivo
|
filename | True | string |
Nombre de archivo devuelto en la salida de alineación. |
Devoluciones
Contenido binario del archivo a partir de la salida de alineación.
- Salida de archivo
- binary
Descargar resultado de traducción
Descargue la salida de una solicitud de traducción.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Tipo de descarga
|
downloadType | True | string |
Tipo de descarga. |
|
Id. de traducción
|
translationId | True | integer |
Identificador de traducción. Obtenga este valor de la salida de la operación de traducción. |
Devoluciones
Contenido binario del archivo de la salida de traducción.
- Contenido del archivo
- binary
Recuperar
Sondee el estado de una solicitud de traducción.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de traducción
|
translationId | True | integer |
Id. de traducción que está sondeando. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
estado
|
status | string |
Cadena que describe el estado de la solicitud. |
|
Mensaje
|
message | string |
Cadena que elabora sobre el estado. |
|
parentTranslationID
|
parentTranslationID | integer |
El proyecto al que pertenece esta solicitud de traducción. |
|
requestName
|
requestName | string |
Nombre de la solicitud de traducción. |
|
productType
|
productType | integer |
Producto para el que se traduciron los archivos. |
|
productVersion
|
productVersion | integer |
Versión del producto para la que se traduciron los archivos. |
|
translationType
|
translationType | string |
Tipo de traducción: documentación o interfaz de usuario. |
|
sourceLanguage
|
sourceLanguage | string |
Los archivos de idioma se traducen de . |
|
targetLanguage
|
targetLanguage | string |
Los archivos de idioma se traducen en. |
Regenerar
Regenera una traducción mediante memorias de traducción actualizadas.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de traducción
|
translationId | True | integer |
Id. de traducción que está regenerando. |
|
Regenerar archivo
|
regenerateFile | True | binary |
Archivo ZIP con archivos de memoria de traducción revisados. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
estado
|
status | string |
Cadena que describe el estado de la solicitud. |
|
Mensaje
|
message | string |
Cadena que elabora sobre el estado. |
Translate
Envíe una nueva solicitud de traducción.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Tipo de producto
|
productType | True | string |
Seleccione el tipo de producto. |
|
Versión del producto
|
productVersion | True | string |
Seleccione la versión del producto. |
|
Lengua origen
|
sourceLanguage | True | string |
Idioma del que se va a traducir. |
|
Idioma de destino
|
targetLanguage | True | string |
Idioma al que se va a traducir. |
|
Nombre de solicitud
|
requestName | True | string |
Nombre de la solicitud de traducción. |
|
Tipo de traducción
|
translationType | True | string |
Tipo de traducción. Actualmente, solo se admiten las traducciones de la interfaz de usuario. |
|
Archivos de origen
|
sourceFile | True | binary |
Archivo ZIP que contiene archivos que se van a traducir. |
|
Modelo de MT personalizado
|
trainMTWithTM | boolean |
Cree un sistema MT personalizado basado en archivos de memoria de traducción cargados. |
|
|
Archivos de memoria de traducción
|
tmFile | binary |
Archivo ZIP que contiene archivos de memoria de traducción. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
estado
|
status | string |
Cadena que describe el estado de la solicitud. |
|
Mensaje
|
message | string |
Cadena que elabora sobre el estado. |
|
translationId
|
translationId | integer |
Identificador de solicitud de traducción, que se usa para recuperar y descargar operaciones. |
Definiciones
binary
Este es el tipo de datos básico "binary".