Usar a versão 2 da interface do usuário do aplicativo Inventory Visibility
Este artigo descreve como usar o aplicativo Visibilidade de Estoque, que é executado no Microsoft Power Apps.
O aplicativo Visibilidade de Estoque oferece duas versões de uma experiência de usuário baseada em modelo para visualização. Os usuários agora podem escolher entre a nova interface de usuário (conhecida como Versão 2 da interface de usuário neste artigo) e a interface de usuário antiga (herdada) (conhecida como Versão 1 da interface de usuário neste artigo).
Pré-requisitos
Antes de poder usar a Versão 2 da interface de usuário para trabalhar com o aplicativo Visibilidade de Estoque, os seguintes pré-requisitos devem estar em vigor:
- Instale e configure visibilidade de estoque.
- Ative visibilidade de estoque interface do usuário versão 2.
Autenticar com o serviço de Visibilidade de Estoque
- Entre no seu ambiente do Power Apps e abra o aplicativo Visibilidade de Estoque.
- No painel de navegação, selecione Configurações de administração.
- No bloco Definir tokens, selecione Gerenciar.
- Na caixa de diálogo, insira os valores de ID do Cliente, ID do Locatário e Segredo do cliente. Esses valores foram definidos quando o Suplemento Visibilidade de Estoque foi instalado.
- Selecione Logon. O sistema gera um novo token de portador para suas sessões. Esse token expira após uma hora.
Alternar entre versões da interface do usuário
Independentemente de qual versão da interface do usuário está ativa, você pode alternar para outra versão a qualquer momento. No entanto, somente as configurações aplicadas na versão ativa da interface do usuário terão algum efeito. Para alternar entre as duas versões, siga estas etapas:
Entre no seu ambiente do Power Apps e abra o aplicativo Visibilidade de Estoque.
No menu Alterar área na parte inferior do painel de navegação, selecione uma das seguintes opções:
- visibilidade de estoque – O painel de navegação mostra as páginas da versão 2 da interface do usuário.
- Interface do usuário herdada– O painel de navegação mostra as páginas da interface do usuário versão 1.
Encontre seu ponto de extremidade de serviço e leia a configuração
O serviço de Visibilidade de Estoque é implantado no Azure Service Fabric, em várias geografias e regiões. No momento, não há um ponto de extremidade central para redirecionar automaticamente suas solicitações para a geografia e a região apropriada. Portanto, o ponto de extremidade de serviço usa o padrão a seguir, que inclui as informações necessárias:
https://inventoryservice.<RegionShortName>-il<IsLandNumber>.gateway.prod.island.powerapps.com
Para obter seu ponto de extremidade de serviço e configuração de runtime, siga estas etapas:
- No painel de navegação Versão 2 da interface do usuário, selecione Configurações do administrador.
- No bloco Mostrar detalhes do serviço, selecione Gerenciar.
- Na caixa de diálogo, você pode encontrar o ponto de extremidade de serviço e os detalhes da configuração.
Atualizar a configuração
Sempre que você modifica a configuração e salva as alterações, o sistema salva as novas definições de configuração somente temporariamente. As alterações não entrarão em vigor até que você confirme as novas configurações para o serviço. Siga estas etapas para confirmar as novas definições de configuração para o serviço:
No painel de navegação Versão 2 da interface do usuário, selecione Configurações do administrador.
No bloco Atualizar Configuração, selecione Gerenciar.
Revise as modificações na caixa de diálogo.
Importante
Certifique-se de verificar todas as modificações importantes que estão prestes a ser feitas em suas fontes de dados, medidas físicas e mapeamentos de dimensão.
Selecione Confirmar atualização para aplicar a alteração de configuração.
Regra de partição de dados
A Visibilidade de Estoque pode distribuir e armazenar dados de estoque de uma das seguintes maneiras:
- Por localização – Escolha esta opção se você sempre souber informações do site e do depósito ao fazer consultas disponíveis, ajustes de estoque, reservas de estoque ou alocações de estoque por meio do visibilidade de estoque.
- Por ID do produto – escolha essa opção se você geralmente não souber informações do site ou do depósito ao ligar para visibilidade de estoque. Por exemplo, ao fazer reservas na cesta do comércio eletrônico, o depósito de processamento pode ser desconhecido quando as ordens online são feitas inicialmente. Nesse caso, é importante poder chamar a Visibilidade de Estoque para consultar o estoque disponível e fazer reservas sem fornecer informações do depósito.
Para alterar a regra de partição de dados, siga estas etapas:
- Abrir o aplicativo Visibilidade de Estoque
- Selecione Regra de partição de dados e escolha a regra que deseja usar.
- Limpar todos os dados de estoque.
- Atualize a configuração para aplicar as alterações. (Haverá falha na operação de configuração de atualização se você não limpar os dados primeiro.)
A regra de partição de dados controla como os dados são distribuídos. As operações executadas dentro da mesma partição proporcionam melhor desempenho, a um custo menor, do que operações que cruzam partições. Portanto, é recomendável usar a opção Por ID do produto se você costuma consultar em locais diferentes. No entanto, recomendamos usar a opção Por local se você consultar com mais frequência vários produtos no mesmo local.
Ao usar a regra de partição Por local a regra na tabela a seguir será incluída na solução por padrão e não poderá ser alterada (isso se torna o conjunto 0 da hierarquia de índice). Ao usar Por ID do produto, a regra não tem efeito nas APIs da Visibilidade de Estoque.
| Dimensão base | Hierarquia |
|---|---|
| Id do Site | 1 |
| LocalizaçãoId | 2 |
Importante
Não personalize a configuração de partição. Se você excluí-la ou alterá-la sem orientações oficiais, provavelmente você receberá um erro inesperado.
Configuração de índice disponível
Em muitos casos, o estoque disponível é consultado não somente no nível mais detalhado, mas também em alguns níveis agregados, com base nas dimensões do estoque.
Para padrões de consulta usados com frequência, você pode ajudar a melhorar o desempenho da consulta configurando índices.
Um índice é composto por um número de conjunto, dimensões e uma hierarquia.
| Organização | Descrição |
|---|---|
| Número do conjunto | As dimensões no mesmo número de conjunto pertencerem ao mesmo conjunto (índice) serão agrupadas. |
| Dimensões | As dimensões são dimensões básicas nas quais os resultados da consulta são agregados. |
| Hierarquia | A hierarquia determina as combinações específicas das dimensões que podem aproveitar uma consulta de índice. Por exemplo, você configura um índice que tenha as seguintes dimensões e hierarquia: (ColorId, SizeId, StyleId). Nesse caso, somente as consultas que usam as quatro combinações de dimensões a seguir para seus campos de filtro e agrupamento por são aprimoradas:
(O campo de filtro não tem restrição de ordem.) O índice não acelera consultas que usam outras combinações de dimensões. |
A configuração de índice disponível padrão inclui um conjunto padrão de índices.
Dica
Essas dicas podem ajudar quando você define sua configuração de índice disponível:
- As dimensões básicas reservadas na configuração da partição (número de conjunto 0) não devem ser incluídas em outras configurações de índice disponíveis.
- Se não tiver interesse em consultar combinações de dimensões específicas, configure um índice que tenha somente uma dimensão básica, Vazio.
Definir a configuração de índice disponível
- No painel de navegação Versão 2 da interface do usuário, selecione Configurações de Índice.
- Adicione e remova linhas na grade conforme necessário para definir seu índice. Para obter mais informações, consulte a introdução desta seção e o exemplo na próxima subseção.
- Atualize a configuração para aplicar as alterações.
Exemplo de configuração de índice disponível
Essa seção fornece um exemplo que mostra um índice disponível funciona.
A tabela a seguir mostra uma lista de estoque disponível.
| Item | ColorId | SizeId | StyleId | Quantidade |
|---|---|---|---|---|
| D0002 | Preto | Pequeno | Largo | 1 |
| D0002 | Preto | Pequeno | Regular | 2 |
| D0002 | Preto | Grande | Largo | 3 |
| D0002 | Preto | Grande | Regular | 4 |
| D0002 | Vermelho | Pequeno | Largo | 5 |
| D0002 | Vermelho | Pequeno | Normal | 6 |
| D0002 | Vermelho | Grande | Normal | 7 |
A tabela a seguir mostra uma configuração de índice disponível.
| Definir Número | Dimensão | Hierarquia |
|---|---|---|
| 1 | ColorId | 1 |
| 1 | SizeId | 2 |
| 1 | StyleId | 3 |
Esse índice ajuda a melhorar o desempenho das seguintes consultas de estoque disponível:
() – Agrupados por todos
- D0002, 28
(ColorId) – Agrupado por ColorId
- D0002, Preto, 10
- D0002, Vermelho, 18
(ColorId, SizeId) – Agrupados pela combinação de ColorId e SizeId
- D0002, Preto, Pequeno, 3
- D0002, Preto, Grande, 7
- D0002, Vermelho, Pequeno, 11
- D0002, Vermelho, Grande, 7
(ColorId, SizeId, StyleId) – Agrupado pela combinação de ColorId, SizeId e StyleId
- D0002, Preto, Pequeno, Largo, 1
- D0002, Preto, Pequeno, Regular, 2
- D0002, Preto, Grande, Largo, 3
- D0002, Preto, Grande, Regular, 4
- D0002, Vermelho, Pequeno, Largo, 5
- D0002, Vermelho, Pequeno, Regular, 6
- D0002, Vermelho, Grande, Regular, 7
Gerenciamento de recursos
A tabela a seguir mostra os recursos que a Visibilidade de Estoque oferece. Cada um desses recursos pode ser ativado ou desativado em seu ambiente.
| Nome do recurso | Descrição |
|---|---|
| Disponível para promessa | Acompanhe sua disponibilidade para promessa (ATP) em todas as fontes e canais de dados. |
| Alocação de estoque | Aloque seu valioso estoque disponível para seus canais, clientes ou grupos predefinidos mais importantes e acompanhe o consumo de cada pool alocado. |
| Estoque avançado de depósito | Sincronize e exiba o estoque avançado de itens de depósito usando hierarquias de depósito. |
| Reserva flexível | Publique suas reservas de Omnicanal nas reservas flexíveis da Visibilidade de Estoque para verificações e atualizações de disponibilidade de estoque em tempo real. |
| Histórico de registro do estoque | Habilite a Visibilidade de Estoque para armazenar seus logs de transações com êxito. Você pode consultar o histórico de registro para obter detalhes sobre a organização, o produto, o intervalo de datas, o site e o armazém. |
| Resumo de estoque | Sincronize periodicamente o resumo do estoque bruto do cache para o Dataverse. Esse recurso não é compatível com itens de armazém avançados. Habilite esse recurso ou o recurso Pré-carregado disponível . Não habilite ambos os recursos. |
| Pré-carga disponível | Pré-carregue periodicamente o resumo do estoque no Dataverse a partir de um resultado de consulta. O resultado da consulta pode ser configurado com as dimensões mais relevantes para o seu negócio. Esse recurso é compatível com itens de armazém avançados. Habilite esse recurso ou o recurso Resumo de estoque. Não habilite ambos os recursos. |
Por padrão, todos esses recursos estão desabilitados. Para ativar ou desativar um recurso e para fazer definições de configuração relacionadas, siga estas etapas:
- No painel de navegação Versão 2 da interface do usuário, selecione Gerenciamento de recursos.
- Encontre o bloco do recurso que deseja ativar ou desativar e selecione Gerenciar.
- Ative e configure o recurso conforme necessário. Cada recurso oferece configurações diferentes. Para obter mais informações, consulte a documentação do recurso que você estiver configurando.
- Atualize a configuração para confirmar suas alterações para que elas entrem em vigor.
Excluir todas as configurações
Se necessário, você poderá excluir todas as configurações, exceto aquelas nas fontes de dados fno e @iv da Visibilidade de Estoque. As configurações excluídas não poderão ser restauradas.
- No painel de navegação Versão 2 da interface do usuário, selecione Configurações de Administração.
- No bloco Excluir todas as configurações, selecione Gerenciar.
- Será solicitado que você confirme a exclusão. Selecione OK para continuar.
Excluir todos os dados de estoque
Se necessário, você poderá excluir todos os dados da Visibilidade de Estoque, exceto as configurações, no cache e no Dataverse. Os dados excluídos não poderão ser restaurados e os usuários ficarão bloqueados até que a exclusão seja concluída.
- No painel de navegação Versão 2 da interface do usuário, selecione Configurações de Administração.
- No bloco Excluir todos os dados de estoque, selecione Gerenciar.
- Será solicitado que você confirme a exclusão. Selecione OK para continuar.
Consultas e atualizações de estoque
No painel de navegação, o grupo Visibilidade operacional fornece acesso a páginas em que você pode realizar consultas e atualizações de estoque disponível em tempo real. Quando o recurso reserva flexível está habilitado, você também pode lançar solicitações de reserva na API. Para obter mais detalhes sobre solicitações de API, consulte APIs públicas de Visibilidade de Estoque.
Os seguintes elementos são comuns a todas as páginas:
- Um botão Lançar ou Consultar na barra de ferramentas permite enviar solicitações de API para o serviço de Visibilidade de Estoque. Esse botão fica disponível somente depois que você insere todo o conteúdo necessário para a chamada de API na página.
- Uma seção Produto permite inserir uma ID de produto, uma ID de organização e valores de dimensão para a solicitação de API. Selecione o botão Editar Dimensões nessa seção para escolher quais das dimensões disponíveis incluir na solicitação.
- Uma seção Configurações (o nome exato varia) permite inserir configurações específicas da API, como consultar o conteúdo ATP para uma consulta de disponíveis.
- Um botão Referência do desenvolvedor na barra de ferramentas permite exibir o conteúdo bruto de sua solicitação de API (somente leitura).
- um botão Configurações na barra de ferramentas permite exibir e editar os detalhes de autenticação usados para acessar o serviço de Visibilidade de Estoque.
As subseções a seguir fornecem detalhes sobre como configurar e usar cada tipo de operação.
Consulta de disponíveis
Use a página Consulta de disponíveis no grupo Visibilidade operacional para consultar o estoque disponível em tempo real. Siga estas etapas para configurar e executar uma consulta.
No painel de navegação Versão 2 da interface do usuário, selecione Consulta de disponíveis.
Na seção Produto, insira os valores de ID da Organização, ID do Site e ID do Local dos produtos que deseja encontrar.
No campo ID do produto, insira um ou mais IDs de produto para obter uma correspondência exata para sua consulta. Alternativamente, deixe o campo em branco para incluir todos os produtos no site e local especificados.
Selecione Editar Dimensões para escolher quais dimensões incluir no corpo da consulta. Em seguida, insira valores para as dimensões selecionadas na seção Produto.
Observação
Se você planeja fazer uma consulta ATP, verifique se todas as dimensões incluídas no índice ATP também estão listadas na seção Produto . Por exemplo, se o índice ATP incluir
ColorIdeSizeId, ambas as dimensões deverão ser listadas na seção Produto . Se alguma dimensão estiver faltando, Select Edite as dimensões para adicioná-las. No formulário de pesquisa, você pode deixar alguns dos valores de dimensão em branco. No entanto, as dimensões devem ser incluídas no corpo da consulta se forem incluídas no índice ATP.Para cada campo que você deseja incluir na consulta, mas sem filtrar nenhum valor específico, selecione Usar todos os valores.
Na seção Configurações da Consulta, defina as seguintes opções:
- Consulta ATP – Select essa caixa de seleção para incluir informações ATP.
- Incluir quantidades negativas – Select essa caixa de seleção para incluir quantidades negativas nos resultados da medida calculada.
Selecione Consulta na barra de ferramentas para enviar a solicitação.
Ajuste de estoque
Use a página Ajuste de Estoque no grupo Visibilidade operacional para fazer atualizações em tempo real do estoque. Siga estas etapas para configurar e enviar uma atualização.
- No painel de navegação Versão 2 da interface do usuário, selecione Ajuste de Estoque.
- Na seção Produto, insira os valores de ID do Produto, ID da Organização, ID do Site e ID do Local dos produtos que deseja atualizar.
- Selecione Editar Dimensões para escolher quais dimensões incluir no corpo da solicitação. Em seguida, insira valores para as dimensões selecionadas na seção Produto.
- Na seção Medidas a serem atualizadas , selecione Adicionar para adicionar uma linha para a medida que você deseja atualizar. Para a nova linha, selecione uma fonte de dados, uma medida física e uma quantidade a ser atualizada. Você deve especificar pelo menos uma medida. Você pode adicionar várias medidas.
- Selecione Lançar na barra de ferramentas para enviar a solicitação.
Reserva flexível
Use a página Reserva flexível no grupo Visibilidade operacional para fazer reservas flexíveis de estoque.
Importante
A capacidade de fazer reservas flexíveis por meio da interface do usuário deve ser usada somente para testar o recurso. Toda solicitação de reserva flexível deve ser associada a uma alteração de linha de ordem de transação (criação, modificação, exclusão e assim por diante). Portanto, recomendamos que você faça somente reservas flexíveis vinculadas a ordens de back-end. Para obter mais informações, consulte Reservas flexíveis da Visibilidade de Estoque.
Siga estas etapas para configurar e enviar uma reserva flexível.
No painel de navegação Versão 2 da interface do usuário, selecione Reserva flexível.
Na seção Produto, insira os valores de ID do Produto, ID da Organização, ID do Site e ID do Local dos produtos que deseja atualizar.
Selecione Editar Dimensões para escolher quais dimensões incluir no corpo da solicitação. Em seguida, insira valores para as dimensões selecionadas na seção Produto.
Na seção Configurações da reserva, defina os seguintes campos:
- Habilitar estoque negativo para oferecer suporte a vendas excessivas – Select essa caixa de seleção para ignorar a verificação de disponível para reserva. Limpe-a para aplicar a verificação.
- Reserve na medida – Select a fonte de dados e a medida física para executar a reserva flexível.
- Quantidade – Especifique a quantidade a ser reservada.
Selecione Lançar na barra de ferramentas para enviar a solicitação.
Alterar uma agenda
Use a página da agenda de alterações de lançamento disponível no grupo Visibilidade operacional para lançar alterações de estoque com datas para o serviço de visibilidade de estoque. Siga estas etapas para configurar e enviar uma alteração de agenda.
- No painel de navegação da versão 2 da interface do usuário, Select Alterar agenda.
- Na seção Produto , insira os valores de dimensão dos produtos que você deseja atualizar.
- Na seção Alterar medida do cronograma, quantidade e data , seção Adicionar para especificar a data, a fonte de dados, a medida física e a quantidade da alteração.
- Selecione Lançar na barra de ferramentas para enviar a solicitação.
Procurar produtos no aplicativo Visibilidade de Estoque
O recurso pesquisa de produto permite aos usuários pesquisar produtos e informações de estoque disponível com base em atributos específicos, como tamanho e cor. Para obter detalhes sobre como configurar esse recurso, consulte Configurar pesquisa de produto para Visibilidade de Estoque. Para obter detalhes sobre como usá-lo no aplicativo Visibilidade de Estoque, consulte Procurar produtos usando o aplicativo Visibilidade de Estoque.