Adición de un idioma a un informe en Translations Builder
Al abrir un proyecto .pbix en Translations Builder por primera vez, la cuadrícula de traducciones muestra una fila para cada tabla, medida y columna no ocultas en el modelo de datos subyacente del proyecto. La cuadrícula de traducciones no muestra filas para objetos del modelo de datos en el modelo de datos que están ocultos en la vista de informe. Los objetos ocultos no se muestran en un informe y no requieren traducciones.
En la captura de pantalla siguiente se muestra el punto de partida de un modelo de datos simple antes de que se modifique para admitir idiomas secundarios.
Nota:
Si aún no ha instalado Translations Builder, consulte Creación de informes de varios idiomas con Translations Builder.
Si examina la cuadrícula de traducciones de este proyecto .pbix, puede ver que las tres primeras columnas contienen columnas de solo lectura usadas para identificar cada traducción de metadatos. Cada traducción de metadatos tiene unos elementos Object Type, Property y Name. Las traducciones de la propiedad Caption siempre se usan. Puede agregar traducciones para las propiedades Description y DisplayFolder si es necesario.
La cuarta columna de la cuadrícula de traducciones siempre muestra las traducciones del idioma y la configuración regional predeterminados del modelo de datos, que en este caso es English [en-US].
Nota:
Translations Builder permite actualizar las traducciones del idioma predeterminado. Use esta técnica con moderación. Puede resultar confuso porque las traducciones del idioma predeterminado no se cargan en Power BI Desktop.
Agregar idiomas
Translations Builder proporciona una opción Add Language para agregar idiomas secundarios al modelo de datos del proyecto.
Translations Builder no agrega traducciones de metadatos para un idioma específico. En su lugar, agrega traducciones de metadatos para un nombre de referencia cultural que identifica un idioma y una configuración regional. Para obtener más información, consulte Uso de valores de configuración regional en informes de Power BI de varios idiomas.
Translations Builder abstrae las diferencias entre un idioma y un nombre de referencia cultural para simplificar la experiencia del usuario. Los creadores de contenido pueden pensar en términos de idiomas en lugar de nombres de referencias culturales.
Para agregar uno o varios idiomas secundarios, siga estos pasos.
Seleccione Add Language para mostrar el cuadro de diálogo Add Language.
Seleccione un idioma en la lista o use Ctrl para seleccionar varios idiomas.
Seleccione Add Language.
El idioma o los idiomas agregados aparecen ahora en la lista Secondary Languages.
En Power BI Desktop, seleccione Guardar.
Importante
Translations Builder puede modificar el modelo de datos cargado en memoria, pero no puede guardar los cambios en memoria en el archivo .pbix subyacente. Vuelva siempre a Power BI Desktop y seleccione el comando Guardar después de agregar idiomas o crear o actualizar traducciones.
Al agregar un nuevo idioma, se agrega una nueva columna de celdas editables a la cuadrícula de traducciones.
Si los creadores de contenido hablan todos los idiomas implicados, pueden agregar y actualizar traducciones para idiomas secundarios directamente en la cuadrícula de traducciones con una experiencia de edición similar a Excel.
Prueba de traducciones en el servicio Power BI
No puede comprobar el trabajo de varios idiomas en Power BI Desktop. En su lugar, debe probar el trabajo en el servicio Power BI de un área de trabajo asociada a una capacidad Premium. Después de agregar compatibilidad con la traducción con Translations Builder, siga estos pasos:
En Power BI Desktop, guarde los cambios en el archivo .pbix subyacente.
En la cinta de opciones Inicio, seleccione Publicar.
En el cuadro de diálogo Publicar en Power BI, elija un área de trabajo y Seleccionar.
Cuando finalice la publicación, seleccione el vínculo para abrir el proyecto en el servicio Power BI.
Una vez que el informe se cargue con su idioma predeterminado, seleccione la barra de direcciones del explorador y agregue el siguiente parámetro language a la dirección URL del informe.
?language=es-ES
Al agregar el parámetro language al final de la dirección URL del informe, asigne un valor que sea un nombre de referencia cultural válido. Después de agregar el parámetro language y presionar ENTRAR, puede comprobar que el explorador ha aceptado el parámetro al recargar el informe.
Si olvida agregar el signo de interrogación (?) o si no aplica el formato correcto al parámetro language, el explorador rechazará el parámetro y lo quitará de la dirección URL. Después de cargar correctamente un informe con un valor de parámetro language de es-ES, debería ver la experiencia del usuario para toda la interfaz de usuario de servicio Power BI cambiar de inglés a español.
El informe también muestra las traducciones al español de los nombres de las columnas y medidas.
Implementación del flujo de trabajo de varios idiomas
Después de probar el trabajo y comprobar que las traducciones funcionan correctamente, puede almacenar el archivo .pbix en un sistema de control de código fuente, como GitHub o Azure Repos. Este enfoque puede formar parte de una estrategia de administración del ciclo de vida de las aplicaciones (ALM) en la que la compatibilidad con idiomas secundarios y traducciones evolucione con el tiempo.
A medida que empiece a trabajar con idiomas secundarios y traducciones para localizar un proyecto .pbix, siga el mismo conjunto de pasos:
- Haga los cambios en Power BI Desktop.
- Publique el proyecto .pbix en el servicio Power BI.
- Pruebe el trabajo con un explorador en el servicio Power BI mediante el parámetro language.
- Repita estos pasos hasta completar todas las traducciones.
Inserción de informes de Power BI mediante un idioma y una configuración regional específicos
Si va a desarrollar con la inserción de Power BI, puede usar la API de JavaScript para Power BI para cargar informes con un idioma y una configuración regional específicos. Para completar esta tarea, extienda el objeto config pasado a powerbi.embed con un objeto localeSettings que contiene una propiedad language como se muestra en el código siguiente.
let config = {
type: "report",
id: reportId,
embedUrl: embedUrl,
accessToken: embedToken,
tokenType: models.TokenType.Embed,
localeSettings: { language: "de-DE" }
};
let report = powerbi.embed(reportContainer, config);