Partilhar via


Instalar e configurar a aplicação Visibilidade do Inventário

Nota

O Azure Active Directory é agora o Microsoft Entra ID. Saber mais

Este artigo descreve como instalar o Suplemento de Visibilidade do Inventário para o Microsoft Dynamics 365 Supply Chain Management.

Tem de utilizar o Microsoft Dynamics Lifecycle Services para instalar o Suplemento de Visibilidade do Inventário. O Lifecycle Services é um portal de colaboração que fornece um ambiente e um conjunto de serviços atualizados regularmente que o ajudam a gerir o ciclo de vida das suas aplicações de finanças e operações. Para obter mais informações, consulte Recursos de Lifecycle Services.

Dica

Se for um consultor de caraterísticas ou consultor de soluções, recomendamos que adira ao grupo do Yammer para o do Suplemento de Visibilidade do Inventário, onde pode ler sobre os desenvolvimentos mais recentes, trocar sugestões com outros consultores e programadores e debater caraterísticas.

Se tiver problemas técnicos ou exceções, pode obter ajuda enviando um e-mail diretamente para a equipa de produto da Visibilidade do Inventário em inventvisibilitysupp@microsoft.com (certifique-se de que inclui o ID do seu ambiente do Supply Chain Management).

Para amostras de código úteis e guias de resolução de problemas, visite o Repositório do GitHub da Visibilidade do Inventário.

Pré-requisitos da Visibilidade do Inventário

Antes de instalar a Visibilidade do Inventário, tem de completar as seguintes tarefas:

  • Obtenha um projeto de implementação do Lifecycle Services onde esteja implementado, pelo menos, um ambiente.
  • Certifique-se de que os pré-requisitos para a definição de suplementos foram efetuados. Para obter informações sobre estes pré-requisitos, consulte Descrição geral de suplementos. A Visibilidade do Inventário não requer uma ligação de escrita dupla.

A tabela seguinte lista os países/regiões onde a Visibilidade do Inventário é atualmente suportada.

Região do Azure Nome abreviado da região
Leste da Ásia eas
Sudeste da Ásia seas
Leste da Austrália eau
Austrália Sudeste seau
Sul do Brasil sbr
Canadá Central cca
Leste do Canadá eca
Leste da China 2 cne2
Norte da China 2 cnn2
Norte da Europa neu
Oeste da Europa weu
França Central cfr
Sul da França sfr
Índia Central cin
Índia Sul sin
Leste do Japão ejp
Oeste do Japão wjp
Leste da Noruega eno
Oeste da Noruega wno
Oeste da África do Sul wza
Norte da África do Sul nza
Norte da Suíça nch
Oeste da Suíça wch
Norte dos EAU nae
Sul do Reino Unido suk
Oeste do Reino Unido wuk
EUA Leste eus
EUA Oeste wus

Se tiver alguma dúvida sobre estes pré-requisitos, contacte a equipa de produtos de Visibilidade do Inventário através de inventvisibilitysupp@microsoft.com.

Instalar o Suplemento de Visibilidade do Inventário

Antes de instalar o suplemento, registe uma aplicação e adicione um segredo do cliente no Microsoft Entra utilizando a sua subscrição Azure. Para obter instruções, consulte Registar uma aplicação e Adicionar um segredo do cliente. Certifique-se de tomar nota dos valores ID da Aplicação (cliente), Segredo do cliente e ID do inquilino, porque vai precisar deles mais tarde.

Importante

Se tiver mais de um ambiente do Lifecycle Services, crie uma aplicação Microsoft Entra diferente para cada um deles. Se utilizar o mesmo ID da aplicação e ID do inquilino para instalar o Suplemento de Visibilidade do Inventário em diferentes ambientes, ocorrerá um problema de token nos ambientes mais antigos. Como tal, só a última instalação será válida.

Depois de registar uma aplicação e adicionar um segredo do cliente no Microsoft Entra ID, siga estes passos para implementar o Suplemento de Visibilidade do Inventário.

  1. Inicie sessão no Lifecycle Services.

  2. Na página inicial, selecione o projeto onde o seu ambiente está implantado.

  3. Na página do projeto, selecione o ambiente onde pretende instalar o suplemento.

  4. Na página do ambiente, desloque-se até encontrar a secção Suplementos de ambiente na secção Integração de Power Platform. Aí pode encontrar o nome do ambiente Dataverse. Confirme que o nome do ambiente Dataverse é o que pretende utilizar para a Visibilidade do Inventário.

    Nota

    Atualmente, apenas os ambientes Dataverse que foram criados através da utilização do Lifecycle Services são suportados. Se o seu ambiente do Dataverse foi criado de outra forma (por exemplo, utilizando o Centro de Administração do PowerApps), e se estiver ligado ao seu ambiente do Supply Chain Management, tem primeiro de corrigir o problema de mapeamento antes de instalar o Suplemento da Visibilidade do Inventário.

    É possível que o seu ambiente de escrita dupla esteja associado a uma instância do Dataverse, enquanto o Lifecycle Services não está configurado para integração com o Power Platform. Este erro de correspondência da associação pode causar comportamento inesperado. Recomendamos que os detalhes do ambiente do Lifecycle Services correspondam ao que está associado na escrita dupla, para que a mesma ligação possa ser utilizada por eventos empresariais, tabelas virtuais e suplementos. Consulte Erro de correspondência da ligação para obter informações sobre como corrigir o problema de mapeamento. Uma vez resolvido o problema de mapeamento, pode proceder para a instalação da Visibilidade do Inventário.

  5. Na secção Suplementos de ambiente, selecione Instalar um novo suplemento.

    Página do ambiente no Lifecycle Services

  6. Selecione a ligação Instalar um novo suplemento. Aparece uma lista de suplementos disponíveis.

  7. Na lista, selecione Visibilidade do Inventário.

  8. Defina os seguintes campos para o seu ambiente:

    • ID da aplicação (cliente) Microsoft Entra — Introduza o ID da aplicação Microsoft Entra que criou e que anotou anteriormente.
    • ID do inquilino do Microsoft Entra — Introduza o ID do inquilino que anotou anteriormente.

    Página de configuração do suplemento

  9. Concorde com os termos e condições selecionando a caixa de verificação Termos e condições.

  10. Selecione Instalar. O estado do suplemento é indicado como A instalar. Quando a instalação estiver concluída, atualize a página. O estado deve mudar para Instalado.

  11. No Dataverse, selecione a secção Aplicações na navegação à esquerda e verifique se a Visibilidade do Inventário de Power Apps foi instalada com sucesso. Se a secção Aplicações não existir, contacte a equipa de produtos de Visibilidade do Inventário em inventvisibilitysupp@microsoft.com.

Nota

Se o sistema o avisar que não tem permissão para implementar a Visibilidade do Inventário no Lifecycle Services, tem de contactar o administrador para modificar a sua permissão.

Se demorar mais de uma hora a implementar a partir da página Lifecycle Services, a sua conta de utilizador provavelmente não tem permissão para implementar soluções no ambiente do Dataverse. Siga estes passos para resolver o problema:

  1. Cancele o processo de instalação do suplemento da Visibilidade do Inventário a partir da página Lifecycle Services.

  2. Inicie sessão no centro de administração do Microsoft 365 e certifique-se de que a conta de utilizador que pretende utilizar para implementar o suplemento tem a licença "Plano do Dynamics 365 Unified Operations" atribuída. Atribua a licença, se necessário.

  3. Inicie sessão no centro de administração do Power Platform com a conta de utilizador relevante. Em seguida, instale o suplemento da Visibilidade do Inventário efetuando os seguintes passos:

    1. Selecione o ambiente de onde pretende instalar o suplemento.
    2. Selecione Aplicações do Dynamics 365.
    3. Selecione Instalar Aplicação.
    4. Selecione Visibilidade do Inventário
  4. Após a conclusão da instalação, regresse à página Lifecycle Services e tente reinstalar o suplemento Visibilidade do Inventário.

Configurar a Visibilidade do Inventário no Supply Chain Management

Implementar o pacote de integração da Visibilidade do Inventário

Se estiver a executar a versão 10.0.17 ou anterior do Supply Chain Management, contacte a equipa de suporte de integração da Visibilidade do Inventário em inventvisibilitysupp@microsoft.com para obter o ficheiro de pacote. Em seguida, implemente o pacote no Lifecycle Services.

Nota

Se ocorrer um erro de incompatibilidade da versão durante a implementação, deve importar manualmente o projeto X++ para o seu ambiente de desenvolvimento. Em seguida, crie o pacote implementável no seu ambiente de desenvolvimento e implemente-o no seu ambiente de produção.

O código está incluído na versão 10.0.18 do Supply Chain Management. Se estiver a executar esta versão ou posterior, não é necessária a implementação.

Certifique-se de que as seguintes funcionalidades estão ativadas no seu ambiente do Supply Chain Management. (Por predefinição, estão ativadas.)

Descrição de funcionalidades Versão do código Classe de alternância
Ativar ou desativar usando as dimensões de inventário na tabela InventSum 10.0.11 InventUseDimOfInventSumToggle
Ativar ou desativar usando as dimensões de inventário na tabela InventSumDelta 10.0.12 InventUseDimOfInventSumDeltaToggle

Configurar Integração de Visibilidade do inventário

Depois de ter instalado o suplemento, prepare o sistema Supply Chain Management para trabalhar com o suplemento, efetuando os seguintes passos.

  1. No Supply Chain Management, abra a área de trabalho Gestão de caraterísticas e ative a caraterística Integração da Visibilidade do Inventário.

  2. Aceda a Gestão do Inventário>Configuração>Parâmetros de integração com a Visibilidade do Inventário.

  3. Abra o separador Geral e efetue as seguintes definições:

    • Ponto final da Visibilidade do Inventário — Introduza o URL do ambiente onde está a executar a Visibilidade do Inventário. Para mais informações, consulte Localizar o seu ponto final de serviço e leia a configuração.
    • Número máximo de registos num único pedido — Defina o número máximo de registos a incluir num único pedido. Deve introduzir um número inteiro positivo inferior ou igual a 1000. O valor predefinido é 512. Recomendamos vivamente manter o valor predefinido a menos que tenha recebido uma indicação do Suporte da Microsoft ou tenha a certeza de que precisa de o alterar.
  4. As seguintes caraterísticas opcionais melhoram a funcionalidade da Visibilidade do Inventário. Decida se pretende utilizar uma ou ambas as caraterísticas. Se o fizer, configure-as. (Também pode configurá-las mais tarde.)

    • Reservas e compensações flexíveis — As reservas flexíveis ajudam as organizações a obter uma única fonte de verdade para o inventário disponível, especialmente durante o processo de cumprimento de encomendas. Para mais informações sobre como ativar e configurar esta caraterística, consulte Reservas de Visibilidade do Inventário.
    • Suporte para itens de processos do Warehouse Management (WMS) — Esta caraterística permite-lhe utilizar itens do WMS com a Visibilidade de Inventário. Para mais informações sobre como ativar e configurar esta caraterística, consulte Suporte da Visibilidade do Inventário para itens do WMS.
    • Resumo do inventário — Esta caraterística Fornece um resumo do inventário para produtos juntamente com todas as dimensões. Para mais informações sobre como ativar e configurar esta caraterística, consulte Resumo do inventário.
    • Pré-carregar uma consulta de disponibilidade simplificada — Esta caraterística fornece um resumo de inventário agregado para produtos por dimensões configuradas. Para obter informações sobre como ativar e configurar esta caraterística, consulte Pré-carregar uma consulta de disponibilidade simplificada.
  5. Depois de terminar de configurar as caraterísticas opcionais que selecionou, aceda a Gestão do Inventário>Periódico>Integração da Visibilidade do Inventário e ative a tarefa. Todos os eventos de alteração de inventário no Supply Chain Management serão agora lançados na Visibilidade do Inventário.

Nota

Quando ativar a tarefa de integração com a Visibilidade do Inventário, se receber um erro que indica que tem de atualizar o esquema da partição, consulte a secção Atualizar esquema da partição para dois se receber um erro ao ativar a tarefa de integração com a Visibilidade do Inventário deste artigo para obter instruções.

Para obter uma lista das correções mais recentes disponíveis para as caraterísticas de integração da Visibilidade do Inventário no Supply Chain Management, consulte Correções recentes do Dynamics 365 SCM.

Atualize o esquema da partição para dois se receber um erro ao ativar a tarefa de integração com a Visibilidade do Inventário

Quando tenta ativar a tarefa de lote de integração com a Visibilidade do Inventário a partir do Supply Chain Management, poderá receber o seguinte erro:

Não pode sincronizar mais do que 500000 registos no mesmo armazém. Para mitigar este problema, atualize o esquema da partição para 2 no suplemento Visibilidade do Inventário. Contacte a Equipa de Suporte da Visibilidade do Inventário em inventvisibilitysupp@microsoft.com para obter mais informações.

Se receber este erro, siga estes passos para atualizar o seu esquema da partição para ajudar a evitar problemas de falta de memória. Se não receber este erro, pode ignorar este procedimento.

  1. No Power Apps, elimine todos os dados do inventário.
  2. Configure um sistema para enviar pedidos de API para Visibilidade do Inventário.
  3. Depois de os dados serem eliminados, chame a API Get com um corpo de none para obter todos os IDs de partição (utilizando /api/environment/{environmentId}/allpartitionids). Reveja a resposta para confirmar que os dados foram completamente limpos. O resultado deve estar vazio.
  4. Chame a API Post com um corpo de none para alterar o esquema da partição (utilizando /api/environment/{environmentId}/updatePartitionSchema?newversion=2).
  5. No Power Apps, ative a caraterística inventário de armazém avançado e atualize a configuração.
  6. No Power Apps, reveja a configuração de runtime. O campo CachePartitonIdVersion deve mostrar um valor de ByLocationAndProductIdMod64.
  7. No Supply Chain Management, aceda a Gestão do Inventário>Periódico>Integração com a Visibilidade do Inventário e ative a tarefa.

Atualizar o Suplemento de Visibilidade do Inventário

Para atualizar uma versão instalada do Suplemento de Visibilidade do Inventário para a versão mais recente, siga estes passos:

  1. Inicie sessão no Centro de administração do Power Platform.

  2. No painel de navegação, selecione Ambientes.

  3. Abra o ambiente onde pretende atualizar o Suplemento de Visibilidade do Inventário.

  4. Na secção Recursos, selecione aplicações do Dynamics 365.

  5. Na lista, localize a linha onde o Nome é Visibilidade do Inventário do Dynamics 365. Verifique o valor na coluna Estado para esta linha.

    • Se o Estado for Instalado, já está a executar a versão mais recente, por isso, pode ignorar o resto deste procedimento.
    • Se o Estado for Atualização disponível, está disponível uma atualização. Continue com o próximo passo.

    Dica

    Para ver qual a versão do suplemento está a executar atualmente, independentemente do estado, abra o menu Mais ações da aplicação (botão de reticências) e, em seguida, selecione Detalhes.

  6. Se a página mostrar que está disponível uma atualização, abra o menu Mais ações da aplicação (botão de reticências) e, em seguida, selecione Atualizar.

  7. Abre-se uma caixa de diálogo. Selecione a caixa de verificação Concordo com os termos do serviço e, em seguida, selecione Atualizar.

  8. Abre-se uma janela de pop-up a pedir-lhe para confirmar a ação. Para prosseguir, introduza o nome do seu ambiente no campo fornecido e, em seguida, selecione Atualizar.

Desinstalar o Suplemento de Visibilidade do Inventário

Para desinstalar o Suplemento de Visibilidade do Inventário, siga estes passos:

  1. Inicie sessão no Supply Chain Management.

  2. Aceda a Gestão do Inventário>Periódico>Integração com a Visibilidade do Inventário e desative a tarefa.

  3. Aceda ao Lifecycle Services e abra a página do ambiente de onde pretende desinstalar o suplemento (consulte também a secção Instalar o Suplemento de Visibilidade do Inventário).

  4. Selecione Desinstalar.

  5. O processo de desinstalação agora termina o Suplemento de Visibilidade do Inventário, anula o registo do suplemento no Lifecycle Services e elimina quaisquer dados temporários que sejam armazenados na cache de dados da Visibilidade do Inventário. No entanto, os dados de inventário principais que foram sincronizados com a sua subscrição do Dataverse ainda estão armazenados lá. Para eliminar estes dados e todas as soluções relacionadas com a Visibilidade de Inventário, conclua o resto deste procedimento.

  6. Abra Power Apps.

  7. Selecione Ambiente na barra de navegação.

  8. Selecione o ambiente do Dataverse que está vinculado ao seu ambiente do Lifecycle Services.

  9. Aceda a Soluções e elimine as seguintes soluções por esta ordem:

    1. Visibilidade do Inventário do Dynamics 365 — Âncora
    2. Visibilidade do Inventário do Dynamics 365 — Plug-ins
    3. Visibilidade do Inventário do Dynamics 365 — Aplicação
    4. Visibilidade do Inventário do Dynamics 365 — Controlos
    5. Visibilidade do Inventário do Dynamics 365 — Base

    Depois de eliminar estas soluções, os dados que estão armazenados em tabelas também serão eliminados.

Importante

Só deve eliminar os dados e as soluções relacionados com a Visibilidade do Inventário no Power Apps se tiver a certeza de que nunca mais voltará a utilizar a Visibilidade do Inventário no ambiente atual. Se os eliminar e depois tentar reinstalar a Visibilidade do Inventário a partir da página do LCS novamente mais tarde, poderá encontrar problemas, tal como ficar preso durante a instalação e não conseguir recuperar.

Se precisar de desinstalar e reinstalar o suplemento porque restaurou a base de dados do Supply Chain Management, não elimine os dados e as soluções no Power Apps. Em vez disso, siga o procedimento em Limpar dados da Visibilidade do Inventário do Dataverse antes de restaurar a base de dados do Supply Chain Management para corrigir quaisquer problemas de dados.

Limpar dados da Visibilidade do Inventário do Dataverse antes de restaurar a base de dados do Supply Chain Management

Se estiver a utilizar a Visibilidade do Inventário e, em seguida, restaurar a sua base de dados do Supply Chain Management, a sua base de dados restaurada poderá conter dados que já não são consistentes com os dados previamente sincronizados pela Visibilidade do Inventário com o Dataverse. Esta inconsistência de dados pode causar erros de sistema e outros problemas. Por isso, é importante que limpe sempre todos os dados da Visibilidade do Inventário do Dataverse antes de restaurar uma base de dados do Supply Chain Management.

Se precisar de restaurar uma base de dados do Supply Chain Management, utilize o seguinte procedimento:

  1. Inicie sessão no Supply Chain Management.
  2. Aceda a Gestão do Inventário>Periódico>Integração com a Visibilidade do Inventário e desative a tarefa.
  3. Pare de enviar pedidos para a Visibilidade do Inventário a partir de quaisquer outros sistemas de terceiros.
  4. No Power Apps, abra a página Configuração para a Visibilidade do Inventário. Em seguida, selecione Limpar Dados de Utilizador no canto superior direito. Isto limpa os dados de inventário irrelevantes de um base de dados restaurada sem afetar as configurações existentes.
  5. Restaure a sua base de dados do Supply Chain Management, por exemplo, conforme descrito em Restauro para um ponto anterior no tempo (PITR) da base de dados ou Restauro para um ponto anterior no tempo da base de dados de produção para um ambiente de sandbox.
  6. Aceda a Gestão do Inventário>Periódico>Integração com a Visibilidade do Inventário e reative a tarefa.

Importante

Existem várias maneiras de migrar dados entre ambientes do Dataverse, mas recomendamos que não o faça porque os dados do Dataverse incluem o seu próprio EnvironmentId, o que significa que migrar dados diretamente entre diferentes ambientes resultará em corrupção de dados. Se tiver este problema, contacte inventvisibilitysupp@microsoft.com para obter assistência.