En este artículo se proporciona una receta sencilla para crear proyectos mediante la API continua. Uno de los aspectos más a entender es que la etiqueta que proporciona en el paso de creación identificará de forma única un proyecto entre otros proyectos de CI en Bureau Works.
Normalmente, un proyecto seguirá a estos estados en Bureau Works:
PREPARING - estado de borrador, cuando todavía se pueden agregar archivos al proyecto
PENDING - significa que el proyecto ha sido analizado y se puede adjuntar una estructura de costos
APROBADO - el proyecto se envía a producción - los archivos ya no se pueden agregar
DELIVERED - estado final, esto es bueno para la producción
INVOICED - proyecto está en créditos
Un proyecto continuo normalmente ejecutará esta ruta de acceso, en la secuencia anterior. Lo que esto significa es que puede extraer archivos de cualquiera de estos estados (suponiendo que existan), pero el contenido variará. Por ejemplo, en el estado PREPARING, lo más probable es que un trabajo sea una combinación de traducción automática, si está habilitado, y las memorias de traducción adjuntas al proyecto, ¡lo cual es genial! Sin embargo, si necesita cadenas de producción, tendrá que extraer del estado DELIVERED.
En este artículo se supone que se siente cómodo con el mecanismo de autenticación en la API.
Crear archivos de proyecto y carga
Invoque el punto de conexión siguiente:
POST https://<SUB>.bureau.works/api/pub/v1/project/async/continuous/<TAG>
Sustituya <SUB por su> manejador de Bureau Works, y <TAG con> una representación significativa de su proyecto, como , ios,, Android,, Windows, etc.
Este punto de conexión recibe un formulario-datos como entrada, con los siguientes parámetros:
archivo - archivo multiparte
referencia - algo para su referencia
idiomas - una lista / arreglo con los códigos de idiomas de Bureau Works (consulte https://dev.bureau.works/#languages )
Si no se informa a los parámetros de idiomas, Bureau Works asumirá los idiomas predeterminados configurados en el perfil del Cliente. Si no se encuentra ninguno, este punto de conexión producirá un error.
En caso de éxito recibirás un mensaje de 200, con un cuerpo como este:
•
"id": "9999999-3333-4555-2223-964c1e52cb88",
"estado": "NUEVO",
"datos":
"projectId": 999999,
"fileName": "Resources.resx",
"fileHash": "867423243877g24dg9gs2gg2sg23gs239gsgsg",
"productTag": "dispatch"
"error": null
?
Este punto de conexión, si se invoca en secuencia con archivos diferentes, agregará los archivos al mismo proyecto identificado por el <TAG>.
Los proyectos creados con este método normalmente son detectables y acceso en la interfaz de usuario web de Bureau Works, en https://<SUB>.bureau.works.
Descarga de archivos de proyectos de localización continua
Para descargar archivos, utilice el siguiente punto de conexión:
OBTENER https://<SUB>.bureau.works/api/pub/v1/project/continuous/<TAG / FILENAME><>/
Este punto de conexión tiene un parámetro de consulta opcional:
estado - si se proporciona, tratará de encontrar el estado deseado de la lista anterior
Al descargar archivos, el estado seguirá un mecanismo de reserva. Por ejemplo, si no se encuentra un proyecto PREPARING, intentará capturar automáticamente el proyecto con la misma etiqueta en estado PENDING. Si no se encuentra ninguno, se recurrirá a DELIVERED, y así sucesivamente.
La respuesta de este punto de conexión se puede guardar localmente como un archivo zip, que contiene todas las traducciones para todos los idiomas configurados en el proyecto.
Para cada etiqueta dada, es posible crear una configuración en el perfil de cliente que defina una estructura de directorios para cada una. De esta manera resulta fácil descargar paquetes listos para su implementación en la estructura de cada proyecto. Si no se proporciona ninguno, la estructura zip será:
/
lang1
file.xml
file2.json
lang2
file.xml
file2.json
lang3
file.xml
file2.json