Compartilhar via

Rastrear a origem e criar metadados em extensões

  • Artigo

Importante

Esse conteúdo está arquivado e não está sendo atualizado. Para obter a documentação mais recente, acesse Novidades ou alterações no Business Central. Para ver os planos de lançamento mais recentes, acesse Planos de lançamento do Dynamics 365, do Power Platform e do Cloud for Industry.

Habilitado para Versão preliminar pública Disponibilidade geral
Administradores, criadores, profissionais de marketing ou analistas, automaticamente 16 de agosto de 2023 2 de out. de 2023

Valor do negócio

Para ajudar a rastrear extensões criadas como parte de pipelines DevOps, estamos introduzindo as propriedades Source e Build no manifesto de extensões de app.json. Isso permite encontrar facilmente o repositório de origem relevante, a ID de confirmação e o sistema de compilação usado para criar a extensão.

Detalhes do recurso

O manifesto de extensões de app.json agora contém duas novas propriedades, Source e Build. Eles podem ser usados para rastrear a localização de origem e o contexto de criação.

Para origem, damos suporte a:

  • repositoryUrl, que é a URL do repositório onde pode ser encontrado o código-fonte do projeto.
  • commit, que é uma ID do código-fonte da versão atual do projeto, que permite voltar à confirmação que disparou a compilação da extensão.

Para a compilação, damos suporte a:

  • by, que é útil para rastrear o agente/sistema de compilação que orquestrou a compilação; por exemplo, AL-Go for GitHub.
  • url, que pode ser usado como URL para a invocação do sistema de compilação onde a compilação pode ser encontrada.

Você pode definir esses valores diretamente no app.json, mas dada a natureza dinâmica, o cenário usual seria defini-los como parte de pipelines de build por meio de parâmetros de linha de comando para o executável do compilador alc.exe usado. Os valores passados aqui substituirão quaisquer valores no arquivo-fonte de app.json.

Se estiver usando BcContainerHelper, as funções Compile-AppInBcContainer e Compile-AppWithCompilerFolder agora recebem parâmetros para "SourceRepositoryUrl", "SourceCommit", "BuildBy" e "BuildUrl". Agora eles estão sendo definidos se você usar AL:Go for GitHub para compilar suas extensões.

Nesta versão, nenhum desses valores ainda está aparecendo na página Gerenciamento de Extensões, no TAC ou por meio de comandos do PowerShell, como NAV-AppInfo. Caso queira ler os valores, a opção atualmente é utilizar o BcContainerHelper "Extract-AppFileToFolder", que permitirá obter o arquivo app.json com as configurações.

Aqui está um exemplo de metadados de compilação e origem em app.json. Normalmente, isso é definido pelo processo de compilação e não manualmente.

Exemplo de metadados de compilação e origem em app.json

Diga-nos o que você pensa

Ajude-nos a melhorar o Dynamics 365 Business Central debatendo ideias, dando sugestões e fazendo comentários. Use o fórum em https://aka.ms/bcideas.

Consulte também

Arquivos JSON (docs)