Este artigo fornece uma receita simples para criar projetos usando a API Contínua. Um dos aspectos mais a entender é que a tag fornecida na etapa de criação identificará exclusivamente um projeto entre outros projetos de CI em Bureau Works.

Normalmente, um projeto seguirá esses estados em Bureau Works:

PREPARAÇÃO - estado de rascunho, quando você ainda pode adicionar arquivos ao projeto
PENDÊNCIA - significa que o projeto foi analisado e uma estrutura de custos pode ser anexada
APROVADO - o projeto é enviado à produção - os arquivos não podem mais ser adicionados
ENTREGUE - estado final, isso é bom para a produção
FATURADO - projeto está em recebíveis

Um projeto contínuo normalmente executará esse caminho, na sequência acima. O que isso significa é que você pode puxar arquivos de qualquer um desses estados (assumindo que eles existem), mas o conteúdo vai variar. Por exemplo, no estado de PREPARAÇÃO, um trabalho provavelmente será uma mistura de Tradução automática, se habilitada, e as Memórias de Tradução anexadas ao projeto - o que é ótimo! No entanto, se você precisar de strings de produção, você precisará retirar do estado DELIVERED.

Este artigo assume que você está confortável com o mecanismo de autenticação na API.

Criar arquivos de projeto e upload

Invoque o seguinte ponto final:

POST https://<SUB>.bureau.works/api/pub/v1/project/async/continuous/<TAG>

Substitua <o SUB para o seu manuseio> Bureau Works e TAG <com uma> representação significativa do seu projeto, como , ios,, android,, Windows, etc.

Este ponto final recebe um formulário de dados como entrada, com os seguintes parâmetros:

arquivo - arquivo multipart
referência - algo para sua referência
idiomas - uma lista/matriz com os códigos de idiomas Bureau Works (por favor, consulte https://dev.bureau.works/#languages)

Se os parâmetros de idiomas não forem informados, o Bureau Works assumirá os idiomas padrão configurados no perfil do Cliente. Se nenhum pode ser encontrado, então este ponto final vai jogar um erro.

Em caso de sucesso você receberá uma mensagem de 200 mensagens, com um corpo como este:

{
 "id": "9999999-3333-4555-2223-964c1e52cb88",
 "status": "NOVO",
 "dados": {
 "projectId": 999999,
 "fileName": "Resources.resx",
 "fileHash": "867423243877g24dg9gs2gg23gs239gsg",
 "productTag": "dispatch"
 },
 "error": null
}

Este ponto final, se invocado em sequência com arquivos diferentes, adicionará os arquivos ao mesmo projeto identificado pelo <TAG>.

Os projetos criados com este método são normalmente descobertos e de acesso na interface web bureau Works, em https://<SUB>.bureau.works.

Baixando arquivos de projetos de localização contínua

Para baixar arquivos, use o seguinte ponto final:

OBTER https://<SUB>.bureau.works/api/pub/v1/project/continuous/<TAG /><FILENAME>/

Este ponto final tem um parâmetro de consulta opcional:

status - se fornecido, tentará encontrar o estado desejado a partir da lista acima

Ao baixar arquivos, o estado seguirá um mecanismo de recuo. Por exemplo, se um projeto DE PREPARAÇÃO não for encontrado, ele tentará automaticamente buscar o projeto com a mesma tag em estado pendente. Se nenhum encontrado, ele vai recuar para delivered, e assim por diante.

A resposta deste ponto final pode ser salva localmente como um arquivo zip, contendo todas as traduções para todas as configurações de idiomas no projeto.

Para cada tag, é possível criar uma configuração no perfil do Cliente que define uma estrutura de diretório para cada uma. Dessa forma, torna-se fácil baixar pacotes prontos para implantação na estrutura de cada projeto. Se nenhum for fornecido, a estrutura zip será:

/
- lang1
  - arquivo.xml
  - file2.json
- lang2
  - arquivo.xml
  - file2.json
- lang3
  - arquivo.xml
  - file2.json