Integraciones

Contentful (TMS)

El contenido se traduce automáticamente del inglés por Phrase Language AI.

Disponible para

  • Planes de negocio y empresa (no disponibles para planes LSP)

Ponte en contacto con el equipo de ventas para preguntar por nuestros planes.

Disponible para

  • Plan Enterprise (anterior)

Ponte en contacto con el equipo de ventas para preguntar por nuestros planes.

Consejo

Para información sobre la integración de Contentful en Phrase Strings, consulta Contentful (Strings).

Contentful proporciona una infraestructura de gestión de contenido sin cabeza para crear, gestionar y distribuir contenido a cualquier plataforma o dispositivo. Phrase se integra con Contentful de dos maneras: 

  • A través de un conector dedicado de Contentful (2.0, nivel de entrada, nivel de campo)

    El conector Contentful 2.0 actualmente soporta autenticación solo a través del centro de datos de EE. UU.

  • A través del plugin del mercado de Contentful para una experiencia personalizada

Nota

El conector no soporta la traducción de objetos JSON.

Métodos de localización soportados

Contentful soporta múltiples métodos de localización. Consulta documentación de Contentful para su descripción detallada.

El conector Contentful 2.0 es la integración actual y preferida que soporta localización a nivel de campo. También ofrece:

  • Espacios múltiples

  • Alias de entorno

  • Configuración de URL de vista previa

  • Importación de referencia

  • Filtrado de contenido basado en etiquetas

  • Configuración de vista previa en vivo

Localización a nivel de entrada (heredado)

Usar Contentful (nivel de entrada) conector.

El conector de nivel de entrada solo funciona con tipos de contenido que tienen campos de referencia localizados (por ejemplo, un campo referencia llamado Localizado que está habilitado para localización).

Localización a Nivel de Campo (Heredado)

Usar el conector Contentful (Nivel de Campo).

El conector a nivel de campo solo funciona con tipos de contenido que tienen un campo traducible (por ejemplo, ya sea un campo Texto o un campo Texto Enriquecido con localización habilitada) y opcionalmente Activos Multimedia. Importa entradas referenciadas y sus campos traducibles (si los campos de referencia están localizados).

Nota

Los conectores heredados ya no se mantienen activamente, pero siguen operativos.

Casos prácticos

Hay varios casos prácticos del conector:

  • Los project managers pueden añadir archivos directamente a proyectos desde un repositorio en línea. El contenido es buscable por ID de Entrada.

  • Configura el portal de solicitudes para que los solicitantes puedan añadir archivos a las solicitudes directamente desde el repositorio en línea. El contenido es buscable por ID de Entrada.

  • Usa creación automatizada de proyectos (APC) para que se creen nuevos proyectos automáticamente cuando se detecte un cambio en el tamaño del contenido de documentos o una carpeta supervisada.

Casos de uso para la aplicación:

  • Los editores de contenido pueden enviar directamente una entrada para localización desde dentro de Contentful. Esto permite a los editores o gerentes de contenido tener control total sobre el flujo de localización y recibir actualizaciones de estado al instante al ver una entrada.

    Una vez que la entrada ha sido finalizada:

    • Selecciona los idiomas de destino deseados para la localización.

    • Envía solo la entrada con los idiomas seleccionados a Phrase TMS o usa la pestaña Selección de Campos para seleccionar campos.

      • Si no se seleccionan campos, todos los campos localizables se envían para traducción.

      • Si se selecciona un campo no localizable, ese campo aún no se enviará para traducción. Solo se envían campos localizables.

      • Si solo se seleccionan algunos campos localizables, solo esos campos se enviarán para traducción.

    • Basado en la configuración de APC, los trabajos se crean automáticamente a partir del contenido enviado. Durante las ejecuciones de APC, solo se seleccionan las entradas en el estado enviado para la creación de trabajos.

    • Una vez que se crean trabajos a partir de una entrada enviada, el estado cambia a en progreso. Cuando las traducciones se envían de vuelta a Contentful, el estado cambia a completado.

    • Las entradas traducidas previamente pueden ser reenviadas después de cambios en el texto original.

  • Los editores de contenido pueden usar la pantalla de inicio de Phrase TMS para:

    • Enviar entradas en bloque.

    • Especificar idiomas de destino individuales al enviar en bloque.

    • Tener una visión general de los trabajos de traducción activos.

Configuración de Contentful

Al trabajar con la aplicación Phrase TMS:

  1. Descargar la aplicación Phrase TMS del mercado.

  2. Instalar la aplicación en el espacio activo actual y seleccionar los modelos de contenido donde se requiere la instalación de la aplicación.

  3. Ingresar el token de autenticación de Phrase TMS adquirido al crear el conector dentro de Phrase TMS.

  4. Haga clic en Instalar.

Opcional - Lanzar App (obsoleto por Contentful)

Si se utiliza el soporte de flujo de trabajo a través de la Lanzar App de Contentful, siga estos pasos:

  1. Instalar la aplicación Lanzar de Contentful en uno o más espacios.

    Nota

    Solo se puede crear un flujo de trabajo por espacio. Si se requieren diferentes enfoques para los tipos de contenido dentro de un espacio de Contentful, comuníquese con el Gerente de Éxito del Cliente dedicado.

  2. Configura el flujo de trabajo de localización requerido.

  3. Selecciona el tipo de contenido o los tipos que siguen el flujo de trabajo descrito.

Si se establecen flujos de trabajo en un conector, la Creación Automática de Proyectos (APC) creará automáticamente nuevos proyectos cuando se detecte un cambio en los pasos del flujo de trabajo para artículos o tipos de contenido monitoreados.

Los trabajos enviados pueden ser cancelados, permitiendo que el contenido sea reenviado después de realizar cambios. Estos trabajos seguirán existiendo en Phrase y deberán ser eliminados por un project manager.

Configuración de TMS de Phrase (Contentful 2.0)

Nota

La aplicación Contentful Launch no es compatible con el conector 2.0.

  1. En la página Configuración Setup_gear.png, baja hasta la sección Integraciones.

  2. Haz clic en Conectores.

    Se abre la página Conectores.

  3. Haz clic en Nuevo conector.

    Se abre la página Crear conector.

  4. Cambia el Tipo a Contentful 2.0.

  5. Proporciona un nombre para el conector.

  6. Haz clic en Conectar a Contentful 2.0.

    Se abre la ventana de inicio de sesión de Contentful.

  7. Proporciona los detalles de inicio de sesión y haz clic en Iniciar sesión (o usa métodos de inicio de sesión alternativos). La ventana de inicio de sesión se cierra y se muestra Conectado.

  8. Opcionalmente, selecciona la casilla Aplicación Phrase Contentful si usas el conector con la aplicación.

    1. Haz clic en Generar token.

      Se abre la ventana Generar Token de Contentful.

    2. Haz clic en Generar token.

      Se genera un token que debe ser copiado al portapapeles o a un archivo de texto. Asegúrate de que el token esté copiado antes de cerrar la ventana, ya que no será visible nuevamente. Este identificador único se utilizará al conectarse a la aplicación.

    3. Cierra la ventana y se muestra Token generado.

  9. Si se utilizan Etiquetas de Contentful para identificar contenido traducible, ingresa un ID de etiqueta y presiona Entrar.

    El ID se presenta y se pueden agregar más.

    • Seleccionar estrategia de listado

      • Con todas las etiquetas 

        Muestra contenido dentro de Contentful con todas las etiquetas listadas.

      • Con al menos una etiqueta 

        Muestra contenido de Contentful con al menos una de las etiquetas listadas.

  10. Si es necesario, selecciona Incluir activos.

  11. Si es necesario, selecciona Incluir entradas referenciadas (contenido anidado).

    Se muestran los ajustes de entradas referenciadas. Aplica los filtros deseados para establecer un control más granular sobre cómo el sistema recorre las relaciones de contenido.

    • Establece la profundidad de importación de las entradas vinculadas 

      Limita cuán lejos sigue Phrase las entradas referenciadas durante la importación.

      El valor predeterminado es 10,000. Si es necesario, selecciona otros valores o especifica un valor entero personalizado.

    • Tipo de contenido

      Selecciona si detenerse o seguir entradas cuyo tipo de contenido coincide con la lista especificada.

    • Tipos de contenido de elemento raíz

      Excluye entradas cuyo tipo de contenido padre coincide con la lista especificada.

    • Etiquetas

      Selecciona si detenerse o seguir entradas que tienen alguna de las etiquetas de contenido especificadas.

    • IDs del campo

      Selecciona si detenerse o seguir entradas que son referenciadas por los IDs de campo especificados.

  12. Si es necesario, selecciona Incluir taxonomía.

    Se muestra el campo ID de Organización de Contentful. Ingrese un valor para habilitar la configuración de taxonomía.

    • Cuando se selecciona, el conector obtiene taxonomías de Contentful y las incluye en el .XLIFF file. El nota de contexto del CAT Editor enumerará los valores de taxonomía de Contentful para cada segmento.

    • Si los metadatos de taxonomía no están disponibles o el conector no está configurado con ellos, el nota de contexto simplemente se omite.

    • Si un proyecto no requiere contexto de función/pantalla, se recomienda dejar la taxonomía deshabilitada para optimizar el rendimiento al exportar .XLIFF.

  13. Si es necesario, seleccione Seguir alias.

    El alias se utiliza para todo el monitoreo de APC y reimportaciones/exportaciones de trabajos. Si el objetivo del alias se cambia en el futuro, APC monitorea el contenido en el nuevo objetivo y los trabajos se reimportarán/exportarán desde/hacia el nuevo objetivo del alias.

    • Deshabilitado (predeterminado y recomendado)

      Los APC y los trabajos creados están vinculados al entorno al que apuntaba el alias en el momento de la creación del trabajo/APC. Los APC solo monitorean ese entorno y contenido; los trabajos se exportan y reimportan a él.

    • Habilitado 

      Los APC y los trabajos creados están vinculados al alias en sí. Los APC solo monitorean ese alias y contenido; los trabajos se exportan y reimportan a él.

      Si se cambia el objetivo del alias, los APC monitorean el nuevo objetivo del alias (entorno); los trabajos ahora se exportarán y reimportarán a él.

  14. Si es necesario, proporcione la URL de vista previa.

    Esta es la plantilla de URL que lleva al contenido renderizado desde Contentful. Se admiten los siguientes marcadores de posición:

    • {env_id}: ID del entorno

    • {entry.id}: ID de entrada

    • {space_id}: ID de espacio

    Una plantilla de URL puede verse así:

    https://contentfulapp.tld/?spaceId={space_id}&environmentId={env_id}&entryId={entry_id}

    Nota

    La URL debe llevar a una aplicación desplegada que renderice el contenido de Contentful. Para usar la vista previa en vivo, reemplace contentfulapp.tld en la plantilla de URL con el dominio real de la aplicación.

    Consulte la documentación de Contentful para obtener más información sobre cómo configurar vista previa de contenido.

    No se puede usar la localización como marcador de posición en estos momentos. Para usar la localización en la URL, especifique un valor fijo y cree múltiples instancias de conector.

  15. Si es necesario, proporcione ContentIDs que deben omitirse de la importación a Phrase.

  16. Proporcione ID de espacio y Token para mapa de token de vista previa de espacio (requerido).

    La API de vista previa requiere un token de acceso de Contentful llamado API de vista previa de contenido – token de acceso que debe configurarse en la configuración de API del espacio de Contentful.

    La integración de Contentful 2.0 utiliza esta API para importar contenido y monitorear cambios (APC).

    • Seleccione cada espacio y entorno para monitorear/importar desde Contentful.

    • La configuración y el acceso se gestionan dentro de Contentful mismo.

  17. Haz clic en Guardar.

    El conector se añade a la lista de la página Conectores.

Configuración de Phrase TMS

Importante

Si accede desde un dominio personalizado (por ejemplo, mydomain.phrase.jp), abra una ventana de navegador en modo incógnito e inicie sesión a través de cloud.memsource.com o us.cloud.memsource.com para aplicar la autenticación requerida para la creación o el guardado del conector. Después de guardar, el conector se puede acceder a través del dominio personalizado.

  1. En la página Setup_gear.png Configuración, baja hasta la sección Integraciones.

  2. Haz clic en Conectores.

    Se abre la página Conectores.

  3. Haz clic en Nuevo conector.

    Se abre la página Crear conector.

  4. Cambie el Tipo a ya sea Contentful (Nivel de Entrada) o Contentful (Nivel de Campo) y proporcione un nombre para el conector.

  5. Opcionalmente, selecciona la casilla Aplicación Phrase Contentful si usas el conector con la aplicación.

    • Token de aplicación de Contentful

      Genere un token de aplicación que se ingresará en la Aplicación Contentful de Phrase TMS. Guarde el conector después de generar el token y copiarlo en la aplicación de Contentful.

    Nota

    Una vez guardado, el token no se puede cambiar desde dentro de Contentful. Para actualizarlo, revoque el token de la configuración del conector en Phrase TMS y genere uno nuevo.

  6. Configure la configuración independiente del idioma.

    • Idioma fuente

      Seleccione un idioma de origen para sobrescribir el idioma predeterminado de Contentful. El conector luego extraerá contenido del idioma configurado en la configuración del conector.

      Ejemplo:

      Si EN-US está configurado como el idioma predeterminado en Contentful, pero DE-DE se requiere como el idioma de origen para la localización en un espacio o modelo de contenido específico, la configuración se puede ajustar para que el espacio (carpeta remota) extraiga contenido de DE-DE en lugar de EN-US.

    Nota

    No aplicable al usar la aplicación.

  7. Seleccione cómo procesar el contenido anidado a través de Modo de importación de entrada. El contenido puede usar un campo de referencia para referenciar otro contenido, permitiendo crear una jerarquía de entidades.

    Nota

    No aplicable al usar la aplicación.

    • Contentful (Nivel de Entrada)

      El conector de nivel de entrada recorre automáticamente toda la jerarquía de contenido anidado.

    • Contentful (Nivel de Campo)

      Seleccione cómo el conector de nivel de campo debe importar contenido anidado.

      • Solo entrada seleccionada

        • El contenido que se selecciona explícitamente al agregar desde el repositorio se importa.

        • Los cambios detectados por APC se importan para traducción.

      • Importar entradas referenciadas

        • El conector recorre toda la jerarquía de contenido anidado e importa todos los campos traducibles para traducción.

  8. Cree una lista separada por comas en Omitir campos traducibles para omitir campos que se marcan para Habilitar la localización de este campo de la importación a Phrase TMS. Utilice la siguiente estructura: contentTypeID:fieldID.

    • Seleccione Dejar campos omitidos vacíos si los campos listados deben dejarse vacíos. Esta configuración se aplicará a todas las entradas indicadas.

    • Seleccione Copiar fuente a destino si los campos listados deben contener valores de la fuente. Esta configuración se aplicará a todas las entradas indicadas.

  9. Seleccione Usar idioma de respaldo si faltan datos para un campo particular en el idioma fuente.

    Seleccione un Idioma de respaldo de fuente de la lista desplegable si es necesario. Esta localización de idioma se utilizará en caso de datos faltantes.

    Nota

    No hay relación entre el idioma de respaldo de Contentful y esta configuración.

  10. Si es necesario, proporcione la URL de vista previa en vivo (BETA).

    Esta es la plantilla de URL que lleva al contenido renderizado desde Contentful. Se admiten los siguientes marcadores de posición:

    • {env_id}: ID del entorno

    • {entry.sys.id}: ID de entrada

    • {space_id}: ID de espacio

    Una plantilla de URL puede verse así:

    https://contentfulapp.tld/?spaceId={space_id}&environmentId={env_id}&entryId={entry.sys.id}

    Nota

    La URL debe llevar a una aplicación desplegada que renderice el contenido de Contentful. Para usar la vista previa en vivo, reemplace contentfulapp.tld en la plantilla de URL con el dominio real de la aplicación.

    Consulte la documentación de Contentful para obtener más información sobre cómo configurar vista previa de contenido.

    No se puede usar la localización como marcador de posición en estos momentos. Para usar la localización en la URL, especifique un valor fijo y cree múltiples instancias de conector.

  11. Si se solicita el registro de información de depuración por parte del equipo de soporte técnico, seleccione Registrar información de depuración.

  12. Haga clic en Conectar a Contentful.

    Aparecerá una marca de verificación en la configuración del conector si la conexión fue exitosa. Si no es así, aparecerá un signo de exclamación rojo. Pasa el cursor sobre el icono para ver más detalles.

  13. Contentful (Nivel de Entrada) solamente:

    Establezca el Idioma de origen.

    Nota

    Este idioma debe coincidir con la localización predeterminada del espacio de Contentful que está configurado en la configuración de Locales de Contentful.

  14. Haz clic en Guardar.

    El conector se añade a la lista de la página Conectores.

  15. Opcionalmente, edite el conector para seleccionar flujos de trabajo de Contentful.

    • Traducir artículos de:

      El conector supervisa los artículos en la etapa seleccionada (p. ej. Traducir). El autor puede aplicar esta etiqueta a los artículos cuando estén listos para traducción.

    A la importación desde Contentful:

    • Configurar artículos fuente como

      El conector avanza el flujo de trabajo a la etapa seleccionada (por ejemplo, Traducción en Progreso) cuando se descargan los artículos de origen.

    A la exportación a Contentful:

    • Configurar artículos fuente como

      El conector establece la etapa del flujo de trabajo de los artículos de origen en la etapa seleccionada (por ejemplo, Traducciones Completadas) cuando se exporta la traducción.

    Nota

    El soporte para flujos de trabajo fue descontinuado por Contentful el 1 de junio de 2023. El uso continuado no está soportado.

¿Fue útil este artículo?

Sorry about that! In what way was it not helpful?

The article didn’t address my problem.
I couldn’t understand the article.
The feature doesn’t do what I need.
Other reason.

Note that feedback is provided anonymously so we aren't able to reply to questions.
If you'd like to ask a question, submit a request to our Support team.
Thank you for your feedback.