Utilizar a IU da aplicação Visibilidade do Inventário versão 2

Este artigo descreve como utilizar a aplicação Visibilidade do Inventário, que é executada no Microsoft Power Apps.

A aplicação Visibilidade do Inventário oferece duas versões de uma experiência de utilizador condicionada por modelo para visualização. Os utilizadores podem agora escolher entre a nova interface de utilizador (referida como versão 2 da IU neste artigo) e a antiga interface de utilizador antiga (referida como versão 1 da IU neste artigo).

Pré-requisitos

Antes de poder usar a versão 2 da IU para trabalhar com a aplicação Visibilidade do Inventário, os seguintes pré-requisitos devem estar em vigor:

Autenticar com o serviço de Visibilidade do Inventário

  1. Inicie sessão no seu ambiente do Power Apps e abra a aplicação Visibilidade do Inventário.
  2. No painel de navegação, selecione Definições de administração.
  3. No mosaico Definir tokens, selecione Gerir.
  4. Na caixa de diálogo, introduza os valores de ID de Cliente, ID do Inquilino e de Segredo do cliente. Estes valores foram definidos quando o Suplemento de Visibilidade do Inventário foi instalado.
  5. Selecione Iniciar sessão. O sistema gera um novo token de portador para as suas sessões. Este token expira após uma hora.

Alternar entre versões da interface de utilizador

Independentemente da versão da interface de utilizador que estiver ativa, pode mudar para a outra versão em qualquer altura. No entanto, apenas as definições que aplicar na versão ativa da IU têm efeito. Para alternar entre as duas versões, siga estes passos.

  1. Inicie sessão no seu ambiente do Power Apps e abra a aplicação Visibilidade do Inventário.

  2. No menu Alterar área na parte inferior do painel de navegação, selecione uma das seguintes opções:

    • Visibilidade do Inventário — O painel de navegação mostra as páginas da versão 2 da IU.
    • IU Legada — O painel de navegação mostra as páginas da versão 1 da IU.

Localizar o seu ponto final de serviço e ler a configuração

O serviço de Visibilidade do Inventário é implementado no Azure Service Fabric em múltiplas geografias e várias regiões. Atualmente, não existe um ponto final central para redirecionar automaticamente os seus pedidos para a geografia e região apropriadas. Por conseguinte, o ponto final de serviço utiliza o seguinte padrão, que inclui as informações necessárias:

https://inventoryservice.<RegionShortName>-il<IsLandNumber>.gateway.prod.island.powerapps.com

Para obter o ponto final de serviço e a configuração de runtime, siga estes passos.

  1. No painel de navegação da versão 2 da IU, selecione Definições de administração.
  2. No mosaico Mostrar detalhes do serviço, selecione Gerir.
  3. Na caixa de diálogo, pode encontrar o ponto final de serviço e os detalhes da configuração.

Atualizar a configuração

Sempre que o utilizador modificar a configuração e guardar as alterações, o sistema guarda as novas definições de configuração apenas temporariamente. As alterações só entram em vigor depois de confirmar as novas definições no serviço. Siga estes passos para confirmar novas definições de configuração no serviço.

  1. No painel de navegação da versão 2 da IU, selecione Definições de administração.

  2. No mosaico Atualizar Configuração, selecione Gerir.

  3. Reveja as suas modificações na caixa de diálogo.

    Importante

    Certifique-se de que verifica todas as modificações importantes que estão prestes a ser efetuadas nas suas origens de dados, medidas físicas e mapeamentos de dimensões.

  4. Selecione Confirmar Atualização para aplicar a sua alteração à configuração.

Regra de partição de dados

A Visibilidade do inventário pode distribuir e armazenar dados de inventário de uma das seguintes formas:

  • Por localização – Escolha essa opção se souber sempre as informações do local e do armazém ao fazer consultas de disponibilidade, ajustes de inventário, reservas de inventário ou alocações de inventário através da Visibilidade do Inventário.
  • Por ID do produto – Escolha esta opção se muitas vezes não souber as informações do local ou do armazém ao chamar a Visibilidade do Inventário. Por exemplo, ao efetuar reservas no cesto de compras de comércio eletrónico, o armazém de cumprimento pode ser desconhecido quando as encomendas em online são inicialmente efetuadas. Neste caso, é importante poder chamar a Visibilidade do Inventário para consultar o inventário disponível e efetuar reservas sem fornecer informações sobre o armazém.

Para alterar a regra da partição de dados, siga estes passos:

  1. Abrir a aplicação Visibilidade do Inventário
  2. Selecione Regra de partição de dados e escolha a regra que pretende utilizar.
  3. Eliminar todos os dados do inventário.
  4. Confirmar a configuração para aplicar as suas alterações. (A operação de atualização da configuração falhará se não limpar os dados primeiro).

A regra de partição dados controla a forma como os dados são distribuídos. As operações que são efetuadas dentro da mesma partição proporcionam um melhor desempenho, a um custo mais baixo, do que as operações que atravessam partições. Por conseguinte, recomendamos a utilização da opção Por ID de produto se efetuar consultas frequentes em diferentes localizações. No entanto, recomendamos a utilização da opção Por localização se consultar com mais frequência vários produtos na mesma localização.

Ao utilizar a regra de partição Por localização, a regra na tabela seguinte é incluída na solução por predefinição e não pode ser alterada (torna-se o conjunto 0 da hierarquia de índices). Ao usar Por ID de produto, a regra não tem efeito nas APIs de Visibilidade do Inventário.

Dimensão de base Hierarquia
SiteId 1
LocationId 2

Importante

Não personalize a configuração de partição. Se a eliminar ou alterar a configuração sem orientações oficiais, é provável que encontre um erro inesperado.

Configurações de índices disponíveis

Em muitos casos, o inventário disponível é consultado não só ao nível mais detalhado, mas também a alguns níveis agregados, com base nas dimensões do inventário.

Para padrões de consulta utilizados com frequência, pode ajudar a melhorar o desempenho da consulta configurando índices.

Um índice é composto por um número definido, dimensões e uma hierarquia.

Nome Descrição
Número definido As dimensões sob o mesmo número definido pertencem ao mesmo conjunto (índice) e são agrupadas em conjunto.
Dimensões As dimensões são dimensões base nas quais os resultados da consulta são agregados.
Hierarquia

A hierarquia determina as combinações específicas de dimensões que podem tirar partido de uma consulta de índice. Por exemplo, configura um índice que tem as seguintes dimensões e hierarquia: (ColorId, SizeId, StyleId). Neste caso, apenas as consultas que utilizam as quatro combinações de dimensões a seguir para os seus campos de filtro e de agrupar por são melhoradas:

  • Primeira combinação: Vazio
  • Segunda combinação:(ColorId)
  • Terceira combinação:(ColorId, SizeId)
  • Quarta combinação:(ColorId, SizeId, StyleId)

(O campo de filtro não é restringido por encomenda).

O índice não acelera consultas que utilizam outras combinações de dimensões.

A configuração predefinida de índice disponível inclui um conjunto padrão de índices.

Dica

Estas dicas podem ajudar quando configurar a sua configuração de índice disponível:

  • As dimensões base são reservadas na configuração da partição (número definido 0) não devem ser incluídas noutras configurações de índice disponível.
  • Se não estiver interessado em consultar combinações de dimensões específicas, configure um índice que tenha apenas uma dimensão base, Vazio.

Configurar a configuração de índice disponível

  1. No painel de navegação da versão 2 da IU, selecione Configuração do Índice.
  2. Adicione e remova linhas na grelha conforme necessário para definir o seu índice. Para mais informações, consulte a introdução a esta secção e o exemplo na subsecção a seguir.
  3. Confirmar a configuração para aplicar as suas alterações.

Exemplo de configuração de índice disponível

Esta secção dá um exemplo que mostra como um índice disponível funciona.

A tabela a seguir mostra uma lista de inventário disponível.

Item ColorId SizeId StyleId Quantidade
D0002 Preto Pequeno Largo 1
D0002 Preto Pequeno Normal 2
D0002 Preto Grande Largo 3
D0002 Preto Grande Normal 4
D0002 Vermelho Pequeno Largo 5
D0002 Vermelho Pequeno Normal 6
D0002 Vermelho Grande Normal 7

A tabela seguinte mostra una configuração de índice disponível.

Número definido Dimensão Hierarquia
1 ColorId 1
1 SizeId 2
1 StyleId 3

Este índice ajuda a melhorar o desempenho das seguintes consultas de inventário disponível:

  • () — Agrupado por todos

    • D0002, 28
  • (ColorId) — Agrupado por ColorId

    • D0002, Preto, 10
    • D0002, Vermelho, 18
  • (ColorId, SizeId) — Agrupado 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

Gestão de funcionalidades

A tabela a seguir mostra as caraterísticas que a Visibilidade do Inventário oferece. Cada uma destas caraterísticas pode ser ativada ou desativada para o seu ambiente.

Nome da caraterística Descrição
Disponível para promessa Monitorize a sua disponibilidade para promessa (ATP) entre todas as origens de dados e canais.
Alocação do inventário Atribua o seu valioso inventário disponível aos seus canais, clientes ou grupos predefinidos mais importantes e monitorize o consumo de cada conjunto alocado.
Inventário de armazém avançado Sincronize e veja o inventário avançado de itens de armazém ao utilizar hierarquias de armazém.
Reserva flexível Publique as suas reservas de omnicanal nas reservas flexíveis da Visibilidade do Inventário para verificações e atualizações de disponibilidade do inventário em tempo real.
Histórico do registo do inventário Ative a Visibilidade do Inventário para armazenar os seus registos de transações bem-sucedidas. Pode consultar o histórico do registo para detalhes sobre a organização, o produto, o intervalo de datas, o local e o armazém.
Resumo do inventário Sincronize periodicamente o resumo do inventário não processado da cache para o Dataverse. Esta caraterística não é compatível com itens de armazém avançados. Ative esta caraterística ou a caraterística Disponível pré-carregado. Não ative ambas as caraterísticas.
Pré-carregar disponibilidade Pré-carregue periodicamente o resumo do inventário para o Dataverse a partir de um resultado de consulta. O resultado da consulta pode ser configurado com as dimensões mais relevantes para a sua empresa. Esta caraterística é compatível com itens de armazém avançados. Ative esta caraterística ou a caraterística Resumo do inventário. Não ative ambas as caraterísticas.

Por predefinição, todas estas caraterísticas estão desativadas. Para ativar ou desativar uma caraterística e efetuar definições de configuração relacionadas, siga estes passos.

  1. No painel de navegação da versão 2 da IU, selecione Gestão de caraterísticas.
  2. Localize o mosaico da caraterística que pretende ativar ou desativar e, em seguida, selecione Gerir.
  3. Ative e configure a caraterística como precisar. Cada caraterística fornece definições diferentes. Para mais informações, consulte a documentação da caraterística que está a configurar.
  4. Atualize a configuração para confirmar as suas alterações de modo a que estas entrem em vigor.

Eliminar todas as configurações

Se necessário, pode eliminar todas as configurações, exceto as das origens de dados fno e @iv da Visibilidade do Inventário. As configurações eliminadas não podem ser restauradas.

  1. No painel de navegação da versão 2 da IU, selecione Definições de Administração.
  2. No mosaico Eliminar todas as configurações, selecione Gerir.
  3. É-lhe pedido que confirme a eliminação. Selecione OK para continuar.

Eliminar todos os dados do inventário

Se necessário, pode eliminar todos os dados da Visibilidade do Inventário, exceto configurações. na cache e no Dataverse. Os dados eliminados não podem ser restaurados e os utilizadores são bloqueados até que a eliminação seja concluída.

  1. No painel de navegação da versão 2 da IU, selecione Definições de Administração.
  2. No mosaico Eliminar todos os dados do inventário, selecione Gerir.
  3. É-lhe pedido que confirme a eliminação. Selecione OK para continuar.

Consultas e atualizações de inventário

No painel de navegação, o grupo Visibilidade operacional fornece acesso a páginas onde pode realizar consultas e atualizações de inventário em tempo real. Quando a caraterística de reserva flexível está ativada, também pode enviar pedidos de reserva para a API. Para mais detalhes sobre pedidos de API, consulte APIs públicas da Visibilidade do Inventário.

Os elementos seguintes são comuns a todas as páginas:

  • Um botão Publicar ou Consultar na barra de ferramentas permite-lhe enviar pedidos de API para o serviço de Visibilidade do Inventário. Este botão só fica disponível depois de introduzir todo o conteúdo necessário para a chamada à API na página.
  • Uma secção Produto permite-lhe introduzir um ID de produto, um ID de organização e valores de dimensão para o pedido de API. Selecione o botão Editar Dimensões nesta secção para escolher que dimensões disponíveis incluir no pedido.
  • Uma secção Definições (o nome exato varia) permite-lhe introduzir definições específicas da API, como, por exemplo, se deve consultar os conteúdos de ATP para uma consulta de disponibilidade.
  • Um botão Referência do programador na barra de ferramentas permite-lhe ver os conteúdos não processados do seu pedido de API (só de leitura).
  • Um botão Definições na barra de ferramentas permite-lhe ver e editar os detalhes de autenticação que são utilizados para aceder ao serviço de Visibilidade do Inventário.

As subsecções seguintes fornecem detalhes sobre como configurar e utilizar cada tipo de operação.

Consulta de disponibilidade

Utilize a página Consulta de disponibilidade no grupo Visibilidade operacional para consultar o inventário disponível em tempo real. Siga estes passos para configurar e executar uma consulta.

  1. No painel de navegação da versão 2 da IU, selecione Consulta de disponibilidade.

  2. Na secção Produto, introduza os valores de ID da Organização, ID do Site e ID da Localização dos produtos que pretende encontrar.

  3. No campo ID do Produto, introduza um ou mais IDs de produto para obter uma correspondência exata para a sua consulta. Em alternativa, deixe o campo em branco para incluir todos os produtos no site e localização especificados.

  4. Selecione Editar Dimensões para escolher que dimensões incluir no corpo da consulta. Em seguida, introduza valores para as dimensões selecionadas na secção Produto.

    Nota

    Se planear fazer uma consulta ATP, certifique-se de que todas as dimensões incluídas no índice ATP também estão listadas na secção Product . Por exemplo, se o seu índice ATP incluir ColorId e SizeId, ambas as dimensões devem ser listadas na secção Produto . Se faltarem dimensões, seleccione Edit Dimensions para as adicionar. No formulário de pesquisa, é possível deixar alguns dos valores de dimensão em branco. No entanto, as dimensões devem ser incluídas no corpo da consulta se estiverem incluídas no índice ATP.

  5. Para cada campo que pretende incluir na consulta, mas sem filtrar um valor específico, selecione Utilizar todos os valores.

  6. Na secção Definições da Consulta, defina as seguintes opções:

    • Consultar ATP — Selecione esta caixa de verificação para incluir informações de ATP.
    • Incluir quantidades negativas — Selecione esta caixa de verificação para incluir quantidades negativas nos resultados de medidas calculadas.
  7. Selecione Consultar na barra de ferramentas para enviar o pedido.

Ajuste de inventário

Utilize a página Ajuste de Inventário no grupo Visibilidade operacional para realizar atualizações em tempo real ao inventário. Siga estes passos para configurar e submeter uma atualização.

  1. No painel de navegação da versão 2 da IU, selecione Ajuste de Inventário.
  2. Na secção Produto, introduza os valores de ID do Produto, ID da Organização, ID do Site e ID da Localização dos produtos que pretende atualizar.
  3. Selecione Editar Dimensões para escolher que dimensões incluir no corpo do pedido. Em seguida, introduza valores para as dimensões selecionadas na secção Produto.
  4. Na secção Medidas a atualizar, selecione Adicionar para adicionar uma linha à medida que pretende atualizar. Para a nova linha, selecione uma origem de dados, medida física e quantidade a atualizar. Tem de especificar, pelo menos, uma medida. Pode adicionar várias medidas.
  5. Selecione Publicar na barra de ferramentas para enviar o pedido.

Reserva flexível

Utilize a página Reserva flexível no grupo Visibilidade operacional para efetuar reservas flexíveis de inventário.

Importante

A capacidade de efetuar reservas flexíveis através da interface de utilizador deve ser utilizada apenas para testar a caraterística. Cada pedido de reserva flexível deve ser associado a uma alteração de linha de ordem de transação (criar, modificar, eliminar, etc.). Por conseguinte, recomendamos que só efetue reservas flexíveis que estejam associadas a encomendas de back-end. Para mais informações, consulte Reservas flexíveis de Visibilidade do Inventário.

Siga estes passos para configurar e submeter uma reserva flexível.

  1. No painel de navegação da versão 2 da IU, selecione Reserva flexível.

  2. Na secção Produto, introduza os valores de ID do Produto, ID da Organização, ID do Site e ID da Localização dos produtos que pretende atualizar.

  3. Selecione Editar Dimensões para escolher que dimensões incluir no corpo do pedido. Em seguida, introduza valores para as dimensões selecionadas na secção Produto.

  4. Na secção Definições da reserva, defina os seguintes campos:

    • Ativar inventário negativo para suportar venda excessiva — Selecione esta caixa de verificação para ignorar a verificação de disponível para reserva. Desmarque-a para impor a verificação.
    • Reservar na medida — Selecione a origem de dados e a medida física em que efetuar a reserva flexível.
    • Quantidade — Especifique a quantidade a reservar.
  5. Selecione Publicar na barra de ferramentas para enviar o pedido.

Alterar um horário

Utilize a página Calendário de registo de alterações manuais no grupo Visibilidade operacional para registar alterações de inventário com datas no serviço de visibilidade do inventário. Siga estes passos para configurar e apresentar uma alteração de horário.

  1. No painel de navegação UI versão 2 , seleccione Alterar calendário.
  2. Na secção Product , introduza os valores das dimensões dos produtos que pretende atualizar.
  3. Na secção Modificar medida, quantidade e data do programa , seleccione Adicionar para especificar a data, a origem de dados, a medida física e a quantidade da modificação.
  4. Selecione Publicar na barra de ferramentas para enviar o pedido.

Pesquisar por produtos na aplicação Visibilidade do Inventário

A caraterística de pesquisa de produtos permite que os utilizadores pesquisem por produtos e informações de inventário disponível com base em atributos específicos, como tamanho e cor. Para detalhes sobre como configurar esta caraterística, consulte Configurar a pesquisa de produtos para a Visibilidade do Inventário. Para detalhes sobre como utilizá-la na aplicação Visibilidade do Inventário, consulte Pesquisar por produtos com a aplicação Visibilidade do Inventário.