Dynamics 365 Finance & SCM 10.0.50: novidades, mudanças e o que está sendo removido.

Introdução

A versão 10.0.50 (build 10.0.2919) do Dynamics 365 Finance e Supply Chain Management chega em GA em dezembro de 2026, com auto-update em janeiro de 2027. É um release focado em impostos (Advanced tax / Tax calculation), qualidade, Rental management, ATP configurável e tags financeiras — mas também traz remoções e mudanças obrigatórias que os times técnicos não podem ignorar.

Marco	Data
Preview	Outubro de 2026
GA (self-update)	Dezembro de 2026
GA (auto-update)	Janeiro de 2027

Neste post resumo o que há de novo nos dois produtos, o que é ligado por padrão ou se torna obrigatório e, principalmente, o que a Microsoft está removendo ou depreciando — com um alerta específico para quem mantém código X++ e extensões.

Novidades no Dynamics 365 Finance

O destaque do Finance 10.0.50 é o módulo de Tax: quatro recursos (todos em preview) que tornam o Tax calculation / Advanced tax mais automatizável. Para quem atende América Latina, chega a expansão de globalização para a Argentina (preview).

Módulo	Recurso	O que muda	Como habilitar
Tax	Importação de alíquotas para Advanced tax via Electronic reporting (preview)	Nova página de setup de importação de alíquotas e upload ER em paralelo	Feature management
Tax	Concluir e criar versão draft em batch (preview)	Conclui uma versão do tax feature e cria o novo draft como job batch, a partir do workspace do designer	Feature management
Tax	Atualização automática da versão do tax feature (preview)	Torna corrente, por legal entity, uma versão concluída que não adiciona novos tax codes	Feature management
Tax	Gerenciar colunas de condição no Rate matrix (preview)	Adicionar, remover e reordenar colunas e ajustar a sequência de execução das linhas	Feature management
LATAM globalization	Argentina (preview)	Habilita a funcionalidade de globalização LATAM para a Argentina	Feature management
Accounts payable	Arquivos IRS IRIS 1099 para envio manual	Gera CSVs compatíveis com o IRS (1099-DIV, G, INT, MISC, NEC, OID e S) para upload no portal IRIS	Feature management
Accounts receivable	Reg F – Suécia: câmbio pela data do IVA	A taxa de câmbio passa a usar a VAT register date, e não a data de lançamento	Feature management
Accounts receivable	Tax exempt number em fatura de pré-pagamento	Preenche o número de isenção/VAT do cliente na fatura de pré-pagamento	Feature management
Budgeting	Financial tags em budget register entries	Tags financeiras no cabeçalho e nas linhas	Feature management
Subscription billing	Financial tags (preview)	Tags nas linhas do billing schedule, propagadas até a contabilização	Feature management
Global address book	Novas entidades otimizadas de cliente	Melhor desempenho nas entidades de cliente	Ligado por padrão
General ledger	Account reconciliation agent (production ready preview)	Reconciliação de budget control no workspace Accounting reconciliation; diferenças viram exceções a investigar (só com Budget control e Posting definitions)	Feature management

Fonte: What's new or changed in Finance 10.0.50.

Novidades no Supply Chain Management

No SCM 10.0.50 o grande lançamento é o Rental management (preview), ao lado de workflows de aprovação em qualidade, ATP configurável e captura de fotos e vídeos no app móvel de armazém.

Novos recursos

Módulo	Recurso	Como habilitar
Rental management	Rental management — gestão de locação nativa	(Preview) Rental management
Qualidade	Workflow de aprovação para casos CAPA	CAPA case approval workflow
Qualidade	Workflow de aprovação para quality orders	Quality order approval workflow
Qualidade	Batch stability testing — testes de estabilidade de lote	(Preview) Batch stability testing
Produção	Linhas de report-as-finished a partir de proposta	(Preview) Create report as finished journal lines from a proposal
Produção	Códigos de motivo de sucata flexíveis	(Preview) Flexible production scrap reason codes
Vendas	Responsável de vendas herdado do cliente	Ligado por padrão
Vendas	Excluir compras, produção e transferências de entrada do ATP	Configurable ATP with Receipt Control
Warehouse	Fotos e vídeos no app Warehouse Management via detours	(Preview) Media capture in the warehouse mobile app
Warehouse	Despatch advice para transfer orders a armazéns externos compartilhados	Ligado por padrão

Melhorias que merecem atenção

• Master planning (Planning Optimization): production pool e production group copiados do produto para as ordens planejadas; herança de tracking dimension em linhas de BOM; cálculo da data de recebimento de compras planejadas pelo calendário do armazém.
• Vendas / ATP: ATP passa a poder considerar o inventory status (novo parâmetro em Accounts receivable parameters) e permite escolher quais origens de recebimento contam.
• Unified pricing: atributos de preço configuráveis, Advanced Price Report incremental e verificação de margem no POS com aprovação de gerente.
• Asset management: nova API que enfileira o agendamento de planos de manutenção como job batch.
• Inventory Visibility: integração com o Commerce Scale Unit via managed identity, sem app ID, secret ou tenant ID.
• Produção: opção para não imprimir etiqueta de LP para co-produtos e subprodutos; ações do PFE restritas por aba.
• GA: registrar resultados de teste de quality orders direto no production floor execution deixou de ser preview.

Fonte: What's new or changed in SCM 10.0.50.

Ligado por padrão e obrigatório

Oito recursos chegam ligados após o update e um se torna obrigatório — teste-os em sandbox antes do auto-update de janeiro de 2027.

Recurso	Módulo	Estado
Remove Dynamics 365 Guides from the production floor execution interface	Produção	Obrigatório (não pode ser desligado)
Optimize transaction scope for Inventory management reports	Inventário	Ligado por padrão
Optimize transaction scope for sales and marketing reports	Vendas	Ligado por padrão
Optimize transaction scope for Sales reports	Vendas	Ligado por padrão
Optimize transaction scope for warehouse management reports	Warehouse	Ligado por padrão
Financial tags for plan to produce	Produção	Ligado por padrão
Financial tags for Asset management forecasts	Asset management	Ligado por padrão
Inventory Visibility integration with Commerce Scale unit managed identity	Inventário	Ligado por padrão
New optimized customer entities	Global address book (Finance)	Ligado por padrão

As quatro features de Optimize transaction scope fazem o pré-processamento de relatórios SSRS rodar fora do escopo de transação padrão do relatório, para evitar transações longas e crescimento do transaction log. Se você tem extensões em classes DP desses relatórios que dependem de ttsbegin/ttscommit ou de dados temporários gravados dentro da mesma transação, valide o comportamento.

O que está sendo removido ou depreciado

A 10.0.50 tem uma remoção funcional direta — o Dynamics 365 Guides sai do production floor execution (PFE), de forma obrigatória. As páginas de novidades não trazem outra lista própria de remoções, mas a janela desta versão coincide com vários prazos de descontinuação já anunciados.

Removido nesta versão

• Dynamics 365 Guides no PFE — a feature Remove Dynamics 365 Guides from the production floor execution interface é obrigatória. Remove o Guides da execução de manufatura, do setup e das importações de Guides, porque o Dynamics 365 Guides não é mais suportado. Quem usa instruções de trabalho em Guides no chão de fábrica precisa de uma alternativa antes do update.

Prazos que caem na janela da 10.0.50 e logo depois

Item	Situação	Prazo	Substituído por
Export to Azure Data Lake	Retirado	Para de funcionar em 30/11/2026, sem extensão	Azure Synapse Link for Dataverse
Asset Management mobile app	Depreciado	Deixa de ser distribuído no PPAC após 30/11/2026 (instalações existentes continuam)	Código aberto no GitHub (scmsamples-EnterpriseAssetManagement)
Data Integrator templates para Field Service	Depreciado	Indisponível após 28/02/2027	Integração Field Service – finance and operations
Regression Suite Automation Tool (RSAT)	Depreciado	Suportado até 15/05/2027	Sem substituto anunciado
Global Inventory Accounting (GIA)	Depreciado	Fim do suporte em 01/07/2027	Nova solução de custeio multi-ledger
Follow-up questions no Copilot sidecar (preview)	Removido	Nunca chegou a GA	—
Criação de novos projetos no LCS (novos clientes)	Congelado	Desde 16/02/2026	Power Platform admin center (PPAC)

Processos de mobile de armazém

• Adjustment out: a configuração com process guide é obrigatória desde a 10.0.45; a implementação antiga deixa de ser suportada cerca de um ano depois — ou seja, na janela atual.
• Spot cycle counting: obrigatório com process guide desde a 10.0.47; a versão antiga perde suporte por volta de um ano depois.

Lembrete da política da Microsoft: remoções e depreciações são anunciadas com pelo menos 12 meses de antecedência, exceto mudanças que afetam só o tempo de compilação (binário-compatíveis), que podem ter prazo menor — exatamente o caso das mudanças de compilador desta versão.

Alerta aos desenvolvedores

O maior risco técnico da 10.0.50 não é um objeto apagado, e sim o compilador: avisos que antes passavam agora quebram o build. Rode um build completo dos seus modelos contra a 10.0.50 antes do auto-update.

Mudanças no compilador X++ (plataforma 10.0.50)

Mudança	Impacto
Palavras-chave client e server	O warning virou erro de compilação. Métodos legados declarados como client static ou server static deixam de compilar.
IndexCannotContainVirtualField	Nova validação: um índice não pode conter campo com SaveContents = No.
FormControlNotFound	Nova validação da propriedade Target Control em formulários — controles apontando para algo inexistente geram erro.
BPErrorAggregateFieldInUpdateRecordsetSetting	Nova regra de best practice para expressões agregadas não suportadas em update_recordset.

Exemplo de correção para o caso mais comum, código herdado de AX 2012:

// Antes — não compila mais na 10.0.50
public server static void runJob()
{
}

// Depois
public static void runJob()
{
}

Uma busca rápida no repositório encontra os candidatos: procure por server static, client static, client server e static server nos arquivos .xml das suas classes e tabelas.

APIs já removidas que ainda aparecem em código legado

Estas remoções aconteceram em versões anteriores, mas continuam pegando projetos que pularam updates:

Objeto / API	Situação	Substituto
ADAL	Removido na 10.0.43; código com ADAL não compila	MSAL
CloudInfrastructure::GetCsuStorageConnectionString() e acesso por chave da storage account	Removido/desabilitado na 10.0.43	APIs SharedServiceUnitStorage, Managed Identity e user-delegated SAS
WindowsAzure.Storage e Microsoft.Azure.Storage.*	Deixaram de ser distribuídas a partir da 10.0.46	Azure.Storage.Blobs, Azure.Storage.Common, Azure.Data.Tables
GraphAPIClient (Azure AD Graph)	Sem suporte desde a 10.0.41	MicrosoftGraphClient
OdbcConnection	Não suportado	Connection / UserConnection
Visual Studio anterior ao 2022	Sem suporte desde a 10.0.41	Visual Studio 2022
Export to Azure Data Lake	Para em 30/11/2026	Azure Synapse Link for Dataverse

Se você estende o PFE ou relatórios SSRS

• Extensões que referenciam objetos de integração do Dynamics 365 Guides no production floor execution devem ser revisadas: a funcionalidade sai de forma obrigatória.
• As features Optimize transaction scope alteram como as classes DP de relatórios de inventário, vendas e warehouse rodam em relação à transação — teste extensões de processReport().
• Para a lista de objetos (tabelas, classes, formulários, EDTs) alterados ou excluídos, compare os metadados da 10.0.50 com os da sua versão atual — por exemplo, nos Technical reference reports publicados pela Microsoft para cada versão ou com um diff do PackagesLocalDirectory.

Checklist de atualização

• ☐ Compilar todos os modelos customizados contra a 10.0.50 e eliminar client/server das assinaturas
• ☐ Corrigir índices com campos SaveContents = No e controles com Target Control inválido
• ☐ Rodar o best practice check e tratar BPErrorAggregateFieldInUpdateRecordsetSetting
• ☐ Validar o production floor execution sem o Dynamics 365 Guides
• ☐ Testar relatórios SSRS de inventário, vendas e warehouse com Optimize transaction scope ligado
• ☐ Revisar integrações de cliente que usam as entidades de Global address book (novas entidades otimizadas)
• ☐ Confirmar a migração do Export to Azure Data Lake para Synapse Link antes de 30/11/2026
• ☐ Planejar a saída do GIA (julho/2027), do RSAT (maio/2027) e dos templates de Field Service (fevereiro/2027)
• ☐ Revisar no Feature management o que entrou ligado por padrão

Conclusão

A 10.0.50 é um release mais de evolução do que de ruptura no lado funcional, com Tax, Rental management e qualidade como destaques. O cuidado técnico está no compilador mais rígido e nos prazos de descontinuação que se acumulam entre novembro de 2026 e julho de 2027: quem preparar o build e o roadmap agora passa pelo auto-update de janeiro sem surpresas.

Referências

• What's new or changed in Dynamics 365 Finance 10.0.50
• What's new or changed in Dynamics 365 Supply Chain Management 10.0.50
• Platform updates for version 10.0.50
• Removed or deprecated platform features
• Removed or deprecated features in Supply Chain Management
• Feature management overview
• Regulatory updates
• Bug fixes da 10.0.50 (requer login no LCS)

D365 Finance & Operations e Microsoft Fabric

---

Configurando o Fabric Link com Service Principal e Azure Key Vault

Configurar o Fabric Link parece simples: selecionar o workspace, informar as credenciais e avançar. Na prática, alguns detalhes podem transformar essa etapa em uma sequência de erros de autenticação.

Durante uma configuração no Dynamics 365 Finance & Operations, recebi mensagens de acesso negado ao Key Vault, falha na recuperação do segredo e credenciais inválidas.

Neste post, organizei o fluxo de configuração e os principais pontos de atenção para quem precisa utilizar um service principal com o client secret armazenado no Azure Key Vault.

1. Entendendo o cenário

O Link to Microsoft Fabric permite vincular um ambiente do Dataverse a um workspace do Fabric. Quando o ambiente está vinculado ao Dynamics 365 Finance & Operations, também é possível selecionar tabelas dessas aplicações no assistente.[learn.microsoft]

Neste tutorial, o foco é a configuração da autenticação:

Ambiente Dataverse vinculado ao D365 F&O
                  |
             Fabric Link
                  |
       Autenticação por Service Principal
                  |
        Tenant ID + Client ID + Secret
                                  |
                       Azure Key Vault

O Azure Key Vault centraliza o armazenamento do segredo do cliente. No Fabric, uma referência identifica o cofre e o segredo a serem consultados para autenticar a conexão.[learn.microsoft]

Nota: a documentação atual recomenda Workspace identity quando essa opção atende ao cenário, pois elimina a necessidade de administrar client secrets. Este post trata da alternativa com service principal e segredo, utilizada quando há esse requisito na solução.[learn.microsoft]

2. Pré-requisitos

Antes de configurar a conexão, valide:

• Ambiente Dataverse vinculado ao F&O, para disponibilizar as tabelas do ERP.
• Permissão de System Administrator no ambiente Power Platform para configurar o link.
• Acesso administrativo ao workspace de destino.
• Capacidade ou licenciamento compatível com o Fabric Link.
• Permissão para administrar conexões no Fabric.
• Aplicação registrada no Microsoft Entra ID.
• Azure Key Vault disponível e acessível pelo caminho de rede utilizado pela conexão.[learn.microsoft][learn.microsoft]

Este tutorial não substitui a validação dos requisitos de versão e build do F&O. Consulte os requisitos atuais da Microsoft, especialmente se o ambiente utilizar o mecanismo de sincronização de baixa latência.[learn.microsoft]

3. Identifique corretamente as credenciais

Na configuração por service principal, os campos principais são:

Campo	Informação utilizada
Tenant ID	Directory (tenant) ID
Service principal client ID	Application (client) ID
Service principal Key	Valor do client secret da aplicação

O Client ID identifica a aplicação. O client secret é a credencial que ela usa para comprovar sua identidade.[learn.microsoft][learn.microsoft]

Dois erros comuns nessa etapa:

• Utilizar o Object ID em vez do Application/Client ID.
• Utilizar o Secret ID no lugar do valor do client secret.[learn.microsoft][learn.microsoft]

Os três elementos — tenant, aplicação e segredo — precisam corresponder entre si.

4. Cadastre a aplicação no Dataverse

Não basta registrar a aplicação no Entra ID. Para o Fabric Link, o service principal também precisa ser adicionado como Application User no ambiente do Dataverse e receber o papel apropriado.[learn.microsoft]

No Power Platform admin center:

1. Abra o ambiente utilizado pelo Fabric Link.
2. Acesse a área de usuários de aplicação.
3. Selecione New app user.
4. Adicione a aplicação pelo nome ou pelo Application/Client ID.
5. Defina a Business Unit.
6. Atribua o papel de segurança apropriado.
7. Conclua o cadastro.

O procedimento documentado pela Microsoft normalmente utiliza o System Administrator para essa identidade. Como esse papel possui privilégios elevados, sua concessão deve seguir as diretrizes de governança do ambiente.[learn.microsoft]

5. Armazene o segredo no Azure Key Vault

No portal do Azure:

1. Abra o Key Vault.
2. Acesse Objects > Secrets.
3. Clique em + Generate/Import.
4. Selecione a opção Manual.
5. Informe o nome do segredo.
6. No campo de valor, cole o client secret da aplicação.
7. Clique em Create.     [learn.microsoft]

Exemplo ilustrativo:

Key Vault:
kv-fabric-prod

Nome do segredo:
fabric-link-client-secret

Valor:
[valor do client secret da aplicação]

Guarde a distinção:

Informação	Onde será utilizada
Nome do Key Vault	Na criação da referência no Fabric
Nome do segredo	No campo Secret da conexão
Valor do segredo	Armazenado dentro do Key Vault

O Fabric utiliza o nome do segredo para localizar a credencial no cofre.[learn.microsoft]

6. Configure as permissões do Key Vault

Uma das principais armadilhas está no nome do papel. Key Vault Reader.

Apesar de permitir consultar os metadados dos objetos, esse papel não permite ler o conteúdo dos segredos.[learn.microsoft]

Em um cofre configurado com Azure RBAC:

Papel	Finalidade
Key Vault Reader	Consultar metadados do cofre e dos objetos
Key Vault Secrets User	Ler o conteúdo dos segredos
Key Vault Secrets Officer	Criar e administrar segredos, sem administrar permissões

Para recuperar o client secret, a identidade que acessa o cofre precisa de permissão para ler o conteúdo do cofre. Não é necessário conceder administração completa do Key Vault apenas para essa finalidade.[learn.microsoft]

Qual identidade deve receber acesso?

Neste fluxo existem duas identidades com funções diferentes:

1. A conta utilizada para autenticar a referência do Key Vault no Fabric.
2. O principal serviço utilizado na conexão do Fabric Link.

O Fabric consulta o Key Vault usando a autenticação armazenada na referência. Portanto, conceder acesso apenas ao service principal não substitui a autorização da conta utilizada nessa referência. A documentação exige as permissões Get e List para a identidade do usuário.[learn.microsoft]

No Azure:

Key Vault
  > Access control (IAM)
  > Add role assignment
  > Key Vault Secrets User
  > Selecionar a identidade correta

Esses papéis se aplicam ao modelo de RBAC do Azure. Se o cofre utiliza o modelo legado de Vault access policy, as permissões devem ser configuradas nas políticas de acesso. Não altere o modelo de um cofre existente sem avaliar as aplicações dependentes: a mudança para RBAC invalida as permissões das access policies.[learn.microsoft]

Nota sobre a documentação: o guia geral de referências do Fabric também lista o Key Vault Certificate User como pré-requisito para a criação da referência. Isso não deve ser confundido com o papel específico de leitura de segredos; confira os requisitos atuais caso o erro ocorra durante a criação da referência.[learn.microsoft][learn.microsoft]

7. Crie a referência do Key Vault no Fabric

No portal do Fabric:

1. Abra a engrenagem de configurações.
2. Selecione Manage connections and gateways.
3. Abra a aba Azure Key Vault references.
4. Clique em New.

5. Preencha:

   • Reference alias: nome amigável da referência.
   • Account Name: nome do recurso Key Vault.
6. Clique em Edit credentials.
7. Autentique com a conta autorizada.
8. Clique em Create.
9. Verifique se a referência está disponível online.[learn.microsoft]

Exemplo:

Campo	Valor ilustrativo
Reference alias	akv-fabric-prod
Account Name	kv-fabric-prod

O alias pertence ao Fabric; o Account Name identifica o cofre existente no Azure.[learn.microsoft]

8. Utilize o segredo no Fabric Link

No Power Apps, abra o assistente do Fabric Link e configure a conexão:

1. Selecione Authentication kind = Service principal.
2. Informe o Tenant ID.
3. Informe o Application/Client ID.
4. Selecione a credencial do tipo Key.
5. Clique em Use Azure Key Vault.
6. Escolha a referência criada.
7. No campo Secret, informe somente o nome do segredo.
8. Clique em Apply e valide a conexão. A configuração por service principal faz parte do assistente do Fabric Link, enquanto a referência do Key Vault fornece a credencial pelo nome do segredo.[learn.microsoft][learn.microsoft]

Exemplo:

Azure Key Vault reference:
akv-fabric-prod

Secret:
fabric-link-client-secret

No campo Secret, não informe:

• O valor do client secret.
• A URL completa do segredo.
• O identificador da versão.
• O Secret ID da aplicação.

A configuração documentada utiliza a referência existente e o nome do segredo.[learn.microsoft]

9. Erros encontrados e roteiro de diagnóstico

Durante a configuração, apareceram três mensagens importantes. Elas ajudam a organizar a investigação, mas não devem ser interpretadas isoladamente como prova de uma causa específica.

“User does not have necessary permissions to access the Key Vault”

Comece verificando a identidade autenticada na referência e suas permissões.

Ter apenas Key Vault Reader não permite recuperar o valor do segredo. No Azure RBAC, confira a atribuição Key Vault Secrets User no cofre correto. Após alterar os papéis, aguarde alguns minutos para que as permissões sejam atualizadas.[learn.microsoft]

“Please ensure Key Vault exists and contains the necessary secrets”

Confira:

• Se o Account Name aponta para o cofre correto.
• Se o segredo existe nesse cofre.
• Se o campo Secret contém seu nome.
• Se a identidade da referência tem acesso.
• Se a rede permite alcançar o Key Vault.[learn.microsoft]

O Fabric consulta a versão atual, mais recente, do segredo. A referência não permite fixar uma versão específica. Por isso, revise a versão atual sempre que houver alterações no cofre.[learn.microsoft]

Se o Key Vault for privado, o guia prevê acesso por meio de um on-premises data gateway com conectividade via private endpoint. Não abra acesso público irrestrito apenas para contornar o erro.[learn.microsoft]

“Invalid credentials”

Confira a combinação:

Tenant ID
   +
Application/Client ID
   +
Valor do client secret dessa aplicação

Verifique se o segredo foi copiado corretamente, se pertence à aplicação informada e se não expirou no Entra ID. O fato de estar armazenado no Key Vault não torna válida uma credencial incorreta ou expirada.[learn.microsoft][learn.microsoft]

Quando permitido pela política da empresa, um teste temporário com a credencial preenchida diretamente na conexão ajuda a separar duas situações:

• Credencial aceita diretamente, mas não pela referência: investigar o cofre, o valor armazenado e a referência.
• Credencial rejeitada também diretamente: investigar primeiro o tenant, a aplicação e o segredo.

Esse teste é uma etapa de diagnóstico, não uma recomendação para abandonar o Key Vault.

10. Cuidados após a conexão funcionar

A configuração não termina na primeira validação bem-sucedida.

• Documente qual aplicação é utilizada pelo link e quem administra as credenciais dessa aplicação.
• Acompanhe a expiração do client secret no Entra ID.[learn.microsoft]
• Planeje a renovação: a referência do Fabric consulta a versão mais recente do segredo, portanto uma atualização no cofre precisa conter uma credencial válida para a mesma aplicação.[learn.microsoft]
• Separe as permissões de leitura das permissões de administração dos segredos.[learn.microsoft]
• Antes de publicar capturas de tela, oculte segredos, tokens e informações internas desnecessárias.
• Avalie Workspace identity em novos cenários, pois é a opção recomendada atualmente para evitar o gerenciamento de segredos.[learn.microsoft]

Conclusão

O maior aprendizado dessa configuração foi separar três perguntas:

1. Quem está acessando o Key Vault?
2. Qual segredo está sendo recuperado?
3. Para qual aplicação esse segredo é válido?

Quando essas três respostas estão alinhadas, fica muito mais fácil distinguir uma falha de permissão, um problema de referência e um erro de autenticação.

D365F&O PPAC e o Planning Optimization Add-in for Dynamics 365 SCM

 Aos que já utilizam o F&O via PPAC e também o Planning Optimization...

Após mover o banco de dados de um ambiente para outro, esse recurso não é reconfigurado automaticamente. Verificando nas configurações do Master Planning no F&O, você verá o status "Not Connected":

Com este status, o job não será executado.

Tive que abrir um chamado na Microsoft para solicitar a reinstalação do Add-in, já que, como sabemos, não temos como removê-lo pelo PPAC.

A resposta foi rápida e até simples. Eu realmente não pensei nesta possibilidade em momento algum!

A solução é ir ao make.powerapps.com, selecionar o seu ambiente e remover a solution de nome "master planning anchor":

Depois de removê-la do make.powerapps.com, volte ao PPAC e instale o Add-in novamente em seu ambiente:

Agora o status no F&O muda para connected:

Tudo pronto para testar os trabalhos em lote do seu Master Plan!

A documentação disponibilizada não especifica que podemos desinstalar um add-in. Eu não sabia disso, aprendi hoje! 

A fonte oficial foi o chamado na Microsoft!

O link fornecido por eles é este: 

Cause 2: Connection lost after a database refresh

A solução apresentada acima foi enviada por e-mail. Não consta no link da Microsoft.

"Em primeira mão é só aqui, oh páh!"

Taming D365 F&O Storage: Finding Files in the Database and Cleaning Them Up

Most Dynamics 365 Finance and Operations environments store far more files than anyone planned for. Some stay under a few GB; others pass 500 GB or even 1 TB of file and database consumption. This post gathers, in one place, how to find out where those files live, how to clean them up with standard and custom routines, and how to move them out of the expensive storage tiers.

Why this matters now

Storage capacity for finance and operations apps is reported and enforced in the Power Platform admin center (PPAC). Each environment shows two numbers under Resources > Capacity > Finance and Operations:

Metric	What it measures
Finance and operations database usage	Size of the environment’s Azure SQL database, including large container (BLOB) and memo fields
Finance and operations file usage	Files kept in the Microsoft-managed Azure Blob Storage behind the environment (usually shown as AXDB.File)

Database capacity is the scarcer and more expensive of the two. A file that sits inside a database table counts against it. The same file in blob storage counts as file capacity, and the same file in SharePoint or your own Azure Storage Account does not count against F&O capacity at all.

The database usage figure has a table-level drill-down in PPAC. That drill-down is the single most useful starting point for everything below.

Before you start. Every environment is different: version, localizations, ISV solutions, customizations, integrations and legal retention rules all change the picture. Menu paths, table names and field values in this post reflect what I have seen and what Microsoft documents at the time of writing. Items marked Verify are not confirmed for every version and must be checked by the professional responsible for each customer, in a sandbox, before anything is changed or deleted in production.

Where a file can live in F&O

Location	How it is stored	Counts against
Database	A container (BLOB) field in a table, for example DocuValue.File when a document type uses Location = Database, or any standard or custom table with a binary field	Database capacity
Azure storage (Microsoft-managed blob)	The file is in the environment’s blob storage; the database keeps only a pointer (DocuRef/DocuValue)	File capacity
SharePoint Online	The file is in a SharePoint library; the database keeps only a pointer	SharePoint storage, outside F&O capacity
Your own storage (custom)	The file is in an Azure Storage Account or DMS you own, reached through an integration; F&O keeps a URL or reference	Your Azure or DMS subscription

Two practical rules come out of this table:

• “Azure storage” in document management means the Microsoft-managed blob of the environment, not a Storage Account in your subscription. As far as I know, F&O has no standard option to point document management at your own Storage Account. Verify for the version you run.
• A large container field anywhere, standard or custom, is effectively a file inside the database, even when document management is never involved.

Part 1 – Finding files in the database

Work in a sandbox with a recent copy of production. You will need System administrator access in F&O, PPAC access to the capacity pages, and SQL access to the sandbox database (just-in-time access for Tier-2+ sandboxes, direct access on development environments). Never run heavy diagnostic queries against production.

A good order of work:

1. Export the PPAC table drill-down for database usage and note the 30 largest tables.
2. Run the table-size query below in the sandbox and compare it with PPAC.
3. Go through the seven areas in this section.
4. Record each finding (source, tables, MB, database or blob, proposed action, owner).

Start here: the largest tables and their LOB space

SELECT TOP 50
       t.name AS table_name,
       SUM(CASE WHEN p.index_id IN (0,1) THEN p.rows ELSE 0 END) AS row_count,
       SUM(a.total_pages) * 8 / 1024.0 AS total_mb,
       SUM(CASE WHEN a.type = 2 THEN a.total_pages ELSE 0 END) * 8 / 1024.0 AS lob_mb
FROM sys.tables t
JOIN sys.partitions p ON p.object_id = t.object_id
JOIN sys.allocation_units a ON a.container_id = p.partition_id
GROUP BY t.name
ORDER BY total_mb DESC;

lob_mb (LOB_DATA allocation units) is the space used by large fields: containers, memos and XML. A table with a high lob_mb is a strong candidate for “files hidden in the database”. Sandbox numbers can differ slightly from PPAC because of indexes and compression; use PPAC as the official figure and SQL to find the cause.

1. Document management (attachments)

This is the most common source, especially in environments upgraded from AX 2012, where old attachments may arrive with their binary still inside DocuValue.

In F&O:

1. Organization administration > Document management > Document types: for each type note Class (Attach file, Attach URL, Simple note), Group and Location. Any type with Class = Attach file and Location = Database sends files into the database.
2. Document management parameters: check the allowed file types, any file size limit, and the SharePoint tab.
3. Active document tables: which tables users can attach to.
4. Check the document types other features use: Electronic reporting parameters, print archive, vendor invoice automation, ISV solutions and custom integrations.

Key tables: DocuType (types and location), DocuRef (link to the business record: RefTableId, RefRecId, TypeId, ValueRecId) and DocuValue (file name, StorageProviderId, AccessInformation and the FILE_ container).

StorageProviderId = 0 means database and 1 means Azure storage. SharePoint uses another value, often reported as 2. Verify: run the first query below to see which values actually exist in your environment.

-- Where attachments live and how much sits inside the database
SELECT v.STORAGEPROVIDERID,
       COUNT(*) AS files,
       SUM(CAST(DATALENGTH(v.FILE_) AS BIGINT)) / 1048576.0 AS mb_in_database
FROM DOCUVALUE v
GROUP BY v.STORAGEPROVIDERID;

-- Which source tables and years hold the most attachments
SELECT t.NAME AS source_table,
       YEAR(r.CREATEDDATETIME) AS year_created,
       v.STORAGEPROVIDERID,
       COUNT(*) AS files,
       SUM(CAST(DATALENGTH(v.FILE_) AS BIGINT)) / 1048576.0 AS mb_in_database
FROM DOCUREF r
JOIN DOCUVALUE v ON v.RECID = r.VALUERECID
LEFT JOIN TABLEIDTABLE t ON t.ID = r.REFTABLEID
GROUP BY t.NAME, YEAR(r.CREATEDDATETIME), v.STORAGEPROVIDERID
ORDER BY files DESC;

-- Orphan DocuValue rows (no DocuRef pointing to them)
SELECT COUNT(*) FROM DOCUVALUE v
WHERE NOT EXISTS (SELECT 1 FROM DOCUREF r WHERE r.VALUERECID = v.RECID);

Verify: the column is usually FILE_ because File is a reserved word (sp_columns 'DOCUVALUE' confirms it). TABLEIDTABLE maps table IDs to names in the versions I have used; if it is not available, use SQLDICTIONARY with FIELDID = 0. Rows with STORAGEPROVIDERID = 1 and a filled FILE_ suggest binaries duplicated in the database, which I have seen after migrations.

2. Print archive and print management

Every SSRS report printed with the Archive destination keeps a copy. With high volumes of invoices, confirmations and packing slips, this grows quickly and has no standard automatic cleanup.

• Organization administration > Inquiries and reports > Print archive: filter by date and report to see the monthly volume.
• Print management per module (for example Accounts receivable > Setup > Forms > Form setup > Print management): which documents include Archive.
• Print destination settings saved on batch jobs, which can archive without going through print management.
• The archive’s files are attachments of PrintJobHeader; run the source-table query above and look for that table.

3. Electronic reporting (ER)

ER keeps its files permanently: templates, files sent to the Archive destination and outputs of ER jobs. Unlike Data management, there is no automatic retention; a file is deleted only together with the record it is attached to (Microsoft Learn).

• Electronic reporting parameters > Attachments: the document types used for configurations, job archive, temporary files and others, and their Location.
• Electronic reporting destination: formats with Archive enabled.
• Electronic reporting jobs: volume and age of jobs (table ERFormatMappingRunJobTable and its attachments).
• Old, unused configuration versions also keep their templates.

4. Data management framework (DMF)

DMF keeps package files in the managed blob, but its staging tables and execution history live in the database. High-frequency recurring integrations can push staging and log tables to tens of GB.

• Job history volume per day and project, and the Job history cleanup settings.
• Projects that could use Skip staging.
• Recurring data jobs and their frequency; export projects whose packages nobody downloads.
• Tables to measure: all *Staging tables, DMFDefinitionGroupExecution, DMFDefinitionGroupExecutionHistory, DMFExecution, DMFStagingLog, DMFStagingLogDetail, DMFStagingExecutionErrors, DMFStagingValidationLog.

5. Email, batch, alerts and logs

Several standard features write binaries or large payloads straight into container fields.

Table	What it holds	Where to look in F&O
SysOutgoingEmailTable / SysOutgoingEmailData	Body and attachments of every email sent by the email distributor (invoice PDFs, for example)	System administration > Periodic tasks > Email processing > Email history
SysEmailHistory	Email history	Email parameters / View email history
BatchJobHistory / BatchHistory	Batch history and infolog	System administration > Inquiries > Batch jobs
EventInbox / EventInboxData	Alerts and notifications	Alerts
SysDatabaseLog	Database log (audit of changes)	System administration > Inquiries > Database > Database log
HcmPersonImage, CompanyImage	Photos and logos	Workers / Legal entities

-- Email attachments per year
SELECT YEAR(e.CREATEDDATETIME) AS year_created,
       COUNT(DISTINCT e.EMAILITEMID) AS emails,
       SUM(CAST(DATALENGTH(d.DATA) AS BIGINT)) / 1048576.0 AS attachment_mb
FROM SYSOUTGOINGEMAILTABLE e
LEFT JOIN SYSOUTGOINGEMAILDATA d ON d.EMAILITEMID = e.EMAILITEMID
GROUP BY YEAR(e.CREATEDDATETIME)
ORDER BY year_created;

-- Every binary column in the database
SELECT t.name AS table_name, c.name AS column_name, ty.name AS data_type
FROM sys.columns c
JOIN sys.tables t ON t.object_id = c.object_id
JOIN sys.types ty ON ty.user_type_id = c.user_type_id
WHERE ty.name IN ('varbinary', 'image')
ORDER BY t.name;

For each relevant table returned, measure the real volume with SUM(CAST(DATALENGTH(<column>) AS BIGINT)).

6. Localizations and electronic invoicing

Localizations with electronic fiscal documents (Brazil, Mexico, Italy, India and others) store submitted XML, authority responses and events. They may be attachments or long text (nvarchar(max)) fields in localization tables. Check the electronic document submission log, the document types used by electronic invoicing, and the long-text columns in country-specific tables. Removing anything here depends on legal retention rules, which differ per country and per company: this is a decision for the tax team, not only for IT.

7. Customizations and integrations

In environments with hundreds of GB, the cause is often custom code: integration logs that keep the full payload of every call, custom log tables without retention, or attachments created automatically for each processed record.

• In the metadata, look for container fields (AxTableFieldContainer) and unlimited string fields used for payloads.
• In X++, look for DocumentManagement::attachFile, direct DocuRef/DocuValue inserts, BinData, con2Buf, MemoryStream written into table fields, and tables named *Log, *Payload, *Request, *Response.
• Cross the results with the table-size query using your model’s table prefix.

Get-ChildItem -Recurse -Filter *.xml -Path .\<YourModel>\AxTable |
  Select-String -Pattern 'AxTableFieldContainer' |
  Select-Object Path -Unique

Part 2 – Cleanup routines

Cleanup in F&O deletes data permanently; there is no recycle bin. Microsoft’s own guidance is to run cleanup routines only after the business has confirmed the data is no longer needed, and to test each one in a non-production environment first (Microsoft Learn). The retention periods below are starting points for discussion, not recommendations for any specific company.

Document management

There is no standard retention policy for attachments. Reduction comes from four directions:

1. Limit what comes in. Keep only the file types the business uses, set a size limit if your version offers one, and switch any Attach file document type with Location = Database to Azure storage or SharePoint. The change applies to new attachments only.
2. Clean orphans. The batch job Scan for orphaned document references finds attachments whose business record no longer exists and creates Deletes a bundle of orphaned document references jobs to remove them. Check under System administration > Inquiries > Batch jobs that it exists and recurs. Verify the job names and behavior in your version.
3. Watch deferred deletion. If attachment recovery (deferred deletion) is enabled, deleted attachments are kept for a number of days and keep consuming space until then. Verify whether your version has this setting and how it is configured.
4. Apply retention by document type. For attachments with no value after a period (delivery photos, integration files, generated PDFs), agree a rule per document type and source table and implement a custom batch job (pattern in Part 3).

Print archive

• Prevent: remove the Archive destination from documents that are already emailed and logged, can be reprinted from the journal, or are stored in a DMS or tax portal. Review print destination settings saved on batch jobs too.
• Clean: in Organization administration > Inquiries and reports > Print archive, filter by date and delete. Deleting the record removes its attached file. For large volumes, use a custom batch job or a third-party tool that adds a print archive cleanup (Docentric AX, for example, offers one in its free edition; evaluate any third-party option yourself).

Electronic reporting

• Prevent: keep the Archive destination only for formats that really need a copy inside F&O. Use a SharePoint document type for the job archive if files must be kept long term.
• Clean: in Electronic reporting jobs, filter by date and format, export the list as evidence and delete. Attached files are removed with the jobs. Remove configuration versions that are no longer used, keeping at least the current and the previous version.

Data management

Since September 2023, job history and related staging data older than 90 days are deleted automatically. For a shorter retention, use the Execution history cleanup feature; the old Staging cleanup routine is deprecated (Microsoft Learn).

• In the Data management workspace, open Job history cleanup, set the number of days, the maximum execution hours per run and, if needed, export history before deleting. Schedule it daily, outside business hours.
• Use Skip staging where the entity and the process allow it.
• Review the frequency of recurring data jobs and fix entities that fail repeatedly.

Email, batch, alerts and logs

Routine	Path (may vary by version)	What it removes
Email history retention	Email parameters: Number of days to retain email history, plus the batch job SysEmailHistoryCleanupBatch	SysEmailHistory
Sent email cleanup	No standard routine in many versions; Microsoft support has suggested a custom X++ script	SysOutgoingEmailTable, SysOutgoingEmailData
Batch job history clean-up	System administration > Periodic tasks	BatchJobHistory, BatchHistory, BatchConstraintsHistory
Batch job clean-up	System administration > Periodic tasks	Finished batch jobs
Notification clean up	System administration > Periodic tasks	EventInbox, EventInboxData
Database log clean up	System administration > Inquiries > Database > Database log	SysDatabaseLog

For sent emails, delete only those already sent, never queued or failed ones, and test in a sandbox first. For the database log, also review Database log setup: auditing high-volume transactional tables is a common cause of growth. Records with electronic signatures cannot be deleted by the standard routine.

Sources for the email items are Microsoft support articles KA-23493 and KA-23879 on the Dynamics community site. Verify the parameter names and batch class in your version.

Functional history routines

They do not remove files, but they often clear the tables at the top of the PPAC drill-down. All need approval from the process owner.

Module	Examples
Sales and procurement	Sales update history cleanup, Order events cleanup, Purchase update history cleanup
General ledger and projects	Clean up ledger journals, Delete project journals (posted journals can no longer be reversed afterwards)
Inventory	Inventory journals cleanup, On-hand entries cleanup, Transfer order update history cleanup
Warehouse	Work creation history, Wave processing history, Mobile device activity log, Work user session log, Work exceptions log
Production and costing	Production orders cleanup, Clean up registrations, Clean up the costing sheet cache
Master planning	Plan version cleanup (monthly, while MRP is not running)

Some routines, such as Inventory dimensions cleanup and Inventory journal data correction, delete data without any log. Use them only with a clear reason and after testing.

A starting schedule

Adjust frequency and retention to the policy each customer approves.

Routine	Frequency	Starting retention
DMF job history cleanup	Daily	7–30 days for recurring integrations, up to 90 for manual loads
Batch job history clean-up	Daily	30–90 days
Email history	Daily	30–90 days
Sent emails (custom)	Weekly	Around 90 days
Notification clean up, batch job clean-up	Weekly	30 days
Orphaned document references	Daily or weekly	—
Print archive, ER jobs, old attachments	Monthly	Per document type and legal requirement
Database log	Monthly	As agreed with audit
Functional routines	Monthly or quarterly	As agreed with each process owner

For the first cleanup of a large volume, work from the oldest data forward, in slices (one year at a time, for example), outside period-end closing, and record the space released in PPAC after each slice.

Part 3 – Moving files out of the database and to your own storage

There are two different moves, and it helps to keep them apart:

• Database → managed blob or SharePoint, which converts database usage into file usage (or SharePoint storage).
• Managed blob → storage you own, which takes files out of F&O capacity altogether.

Option 1: SharePoint for new attachments (standard)

Set the document type’s Location to SharePoint. New files go to SharePoint Online; existing ones do not move by themselves. Current requirements include granting Sites.ReadWrite.All to the Microsoft Dynamics 365 finance and operations application in Entra ID, because the older Microsoft-managed connection has been deprecated, and avoiding SharePoint managed-device policies, which block the integration (Microsoft Learn). SharePoint storage has its own cost and governance; it is simply outside F&O capacity.

Option 2: migrate database attachments to Azure storage

For attachments with StorageProviderId = 0 and a filled FILE_: change the document type’s Location so the database stops growing, then run a custom batch job that reads each container, stores the file again through the document management API, updates the pointer, and clears the binary. Validate samples (open migrated attachments in F&O) before clearing anything, and run by year or document type.

Option 3: export to your own Azure Storage Account (custom)

This is the pattern I would consider for large legacy volumes. It is a design outline, not a tested product; each customer’s security, legal and access requirements will shape the details.

1. Select attachments by document type, source table, age and storage provider.
2. Read the content with the document management API (for example DocumentManagement::getAttachmentStream; Verify the method available in your version).
3. Send the stream to an Azure Storage Account the customer owns, ideally through an intermediary such as an Azure Function or Logic App using Managed Identity, so no storage keys live in F&O.
4. Use a deterministic path, for example <company>/<table>/<year>/<RecId>_<filename>.
5. Confirm the upload (size or hash) before deleting anything.
6. If users still need access, replace the attachment with a URL-type attachment that points to an endpoint issuing short-lived access (a short SAS, for example). Never store a long-lived SAS in a URL.
7. Delete the original attachment through DocuRef.delete() so the managed file is removed too.
8. In the Storage Account, use Cool or Archive tiers with lifecycle rules, and immutability for documents under legal retention.

A custom cleanup batch pattern (X++)

The skeleton below shows the shape of a SysOperation batch job that deletes attachments by document type, source table and age. It is illustrative and untested: review, compile and test it in your own environment, and adapt it to the tables you need (PrintJobHeader, ERFormatMappingRunJobTable, SysOutgoingEmailTable and custom logs follow the same idea).

// Illustrative only - review, compile and test before any use.
class XXXAttachmentCleanupService extends SysOperationServiceBase
{
    private const int CommitSize = 500;

    public void process(XXXAttachmentCleanupContract _contract)
    {
        DocuRef     docuRef;
        TableId     refTableId = tableName2Id(_contract.parmRefTableName());
        utcdatetime cutOff     = DateTimeUtil::addDays(DateTimeUtil::utcNow(),
                                                       -_contract.parmRetentionDays());
        int         maxRecords = _contract.parmMaxRecords();
        int         total, inBlock;

        if (_contract.parmRetentionDays() <= 0)
        {
            throw error("Retention must be greater than zero.");
        }

        if (_contract.parmSimulate())
        {
            select count(RecId) from docuRef
                where docuRef.TypeId          == _contract.parmDocuTypeId()
                   && docuRef.RefTableId      == refTableId
                   && docuRef.CreatedDateTime <  cutOff;
            info(strFmt("Simulation: %1 attachments would be deleted.", docuRef.RecId));
            return;
        }

        do
        {
            inBlock = 0;
            ttsbegin;
            while select forupdate docuRef
                where docuRef.TypeId          == _contract.parmDocuTypeId()
                   && docuRef.RefTableId      == refTableId
                   && docuRef.CreatedDateTime <  cutOff
            {
                // Optional: export to your own storage first (see Option 3)
                docuRef.delete();   // standard logic also removes DocuValue and the stored file
                inBlock++;
                total++;
                if (inBlock >= CommitSize || (maxRecords && total >= maxRecords))
                {
                    break;
                }
            }
            ttscommit;
        }
        while (inBlock >= CommitSize && (!maxRecords || total < maxRecords));

        info(strFmt("%1 attachments deleted.", total));
    }
}

Principles that matter more than the code itself:

• Delete through the table’s delete() method. delete_from with skipDeleteMethod, skipDataMethods or direct SQL removes the row but can leave the file behind as an orphan in blob storage.
• Commit in blocks, cap records per run, offer a simulation mode, and log what was removed.
• New custom tables should be born with a retention parameter and a cleanup job; integration logs should keep a summary, not the full payload.

Governance and monitoring

Cleanup is easier to get right when the roles are clear:

Role	Responsibility
Business process owner	Approves the retention period for each kind of data
Tax / finance	Confirms legal retention and where the legally valid copy lives
F&O administrator	Configures and schedules the batch jobs
Developer	Builds custom cleanup and fixes customizations that create volume
Power Platform administrator	Follows capacity in PPAC

A light monthly routine keeps the problem from coming back:

1. Record database and file usage for each production environment in PPAC.
2. Compare the 20 largest tables in the drill-down with the previous month.
3. Confirm every cleanup job ran successfully.
4. After each sandbox refresh, rerun the attachment queries by year and source table.

Useful warning signs: growth of more than a few percent a month without a business reason, any new growth in attachments stored in the database, failed cleanup jobs, or a custom table entering the top 20.

Checklist

• PPAC table drill-down exported and compared with the SQL table-size query
• Document types reviewed; any Location = Database identified
• Attachments measured by storage provider, source table and year
• Print archive volume and print management Archive destinations reviewed
• ER parameters, Archive destinations and ER job volume reviewed
• DMF job history retention and staging size checked
• Email, batch, alert and database log tables measured
• Binary and long-text columns listed across the database
• Localization XML storage and legal retention confirmed with the tax team
• Custom code scanned for container fields, automatic attachments and payload logs
• Retention policy approved and recurring cleanup jobs scheduled
• Monthly monitoring in place

What to verify in your own environment

These points are based on experience and community sources rather than on official documentation for every version. Treat them as hypotheses to confirm:

Item	Why it needs checking
StorageProviderId values beyond 0 and 1 (SharePoint)	Values may differ; query your own data
Column and helper table names (FILE_, TABLEIDTABLE)	Physical names can change between versions
Menu paths and routine names	Microsoft moves and renames items; use page search
Orphaned attachment jobs and deferred deletion	Availability and behavior depend on version and features enabled
Email cleanup parameters and batch class	Based on Microsoft support articles, not core documentation
Third-party tools mentioned	Evaluate licensing, support and fit yourself
X++ sample	Illustrative and untested
Retention periods suggested	Starting points only; legal and business rules decide

Closing note

There is no single right answer for every customer. One environment’s problem is a print archive nobody cleaned for five years; another’s is a custom integration log keeping every payload; a third simply has a document type still pointing at the database since the AX 2009/2012 upgrade. Measure first, agree retention with the people who own the data, automate the cleanup, and keep watching the numbers.

If you have found other sources of growth, or other ways to deal with them, I would like to hear about them.

Sources

• Cleanup routines in Dynamics 365 Finance and Supply Chain Management (Microsoft Learn)
• Archive ER destination type (Microsoft Learn)
• Configure document management (Microsoft Learn)
• How to select the document management storage location (Microsoft, archived blog)
• Finance and operations storage capacity (Microsoft Learn)
• KA-23493: cleaning SysEmailHistory and EventInboxData (Dynamics Community)
• KA-23879: cleaning SysOutgoingEmail tables (Dynamics Community)
• KA-24904: orphaned attachments and attachment retention (Dynamics Community)
• Keep D365FO Print Archive Small to Pay Less (Docentric)