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.
Inicie sessão no Lifecycle Services.
Na página inicial, selecione o projeto onde o seu ambiente está implantado.
Na página do projeto, selecione o ambiente onde pretende instalar o suplemento.
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.
Na secção Suplementos de ambiente, selecione Instalar um novo suplemento.
Selecione a ligação Instalar um novo suplemento. Aparece uma lista de suplementos disponíveis.
Na lista, selecione Visibilidade do Inventário.
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.
Concorde com os termos e condições selecionando a caixa de verificação Termos e condições.
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.
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:
Cancele o processo de instalação do suplemento da Visibilidade do Inventário a partir da página Lifecycle Services.
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.
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:
- Selecione o ambiente de onde pretende instalar o suplemento.
- Selecione Aplicações do Dynamics 365.
- Selecione Instalar Aplicação.
- Selecione Visibilidade do Inventário
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.
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.
Aceda a Gestão do Inventário>Configuração>Parâmetros de integração com a Visibilidade do Inventário.
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.
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.
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.
Correções à integração com a Visibilidade do Inventário
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.
- No Power Apps, elimine todos os dados do inventário.
- Configure um sistema para enviar pedidos de API para Visibilidade do Inventário.
- Depois de os dados serem eliminados, chame a API
Get
com um corpo denone
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. - Chame a API
Post
com um corpo denone
para alterar o esquema da partição (utilizando/api/environment/{environmentId}/updatePartitionSchema?newversion=2
). - No Power Apps, ative a caraterística inventário de armazém avançado e atualize a configuração.
- No Power Apps, reveja a configuração de runtime. O campo
CachePartitonIdVersion
deve mostrar um valor deByLocationAndProductIdMod64
. - 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:
Inicie sessão no Centro de administração do Power Platform.
No painel de navegação, selecione Ambientes.
Abra o ambiente onde pretende atualizar o Suplemento de Visibilidade do Inventário.
Na secção Recursos, selecione aplicações do Dynamics 365.
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.
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.
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.
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:
Inicie sessão no Supply Chain Management.
Aceda a Gestão do Inventário>Periódico>Integração com a Visibilidade do Inventário e desative a tarefa.
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).
Selecione Desinstalar.
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.
Abra Power Apps.
Selecione Ambiente na barra de navegação.
Selecione o ambiente do Dataverse que está vinculado ao seu ambiente do Lifecycle Services.
Aceda a Soluções e elimine as seguintes soluções por esta ordem:
- Visibilidade do Inventário do Dynamics 365 — Âncora
- Visibilidade do Inventário do Dynamics 365 — Plug-ins
- Visibilidade do Inventário do Dynamics 365 — Aplicação
- Visibilidade do Inventário do Dynamics 365 — Controlos
- 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:
- Inicie sessão no Supply Chain Management.
- Aceda a Gestão do Inventário>Periódico>Integração com a Visibilidade do Inventário e desative a tarefa.
- Pare de enviar pedidos para a Visibilidade do Inventário a partir de quaisquer outros sistemas de terceiros.
- 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.
- 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.
- 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.