Partager via

Utiliser la version 2 de l’interface utilisateur de l’application Visibilité des stocks

  • Article

Cet article décrit comment utiliser l’application de visibilité des stocks, qui s’exécute dans Microsoft Power Apps.

L’application Visibilité des stocks propose deux versions d’une expérience utilisateur pilotée par modèle pour la visualisation. Les utilisateurs peuvent désormais choisir entre la nouvelle interface utilisateur (appelée Interface version 2 dans cet article) et l’ancienne interface utilisateur (ancienne) (appelée Interface version 1 dans cet article).

Conditions préalables

Avant de pouvoir utiliser la version 2 de l’interface utilisateur pour utiliser l’application Visibilité des stocks, les conditions préalables suivantes doivent être remplies :

S’authentifier avec le service de visibilité des stocks

  1. Connectez-vous à votre environnement Power Apps et ouvrez l’application Visibilité des stocks.
  2. Dans le volet de navigation, sélectionnez Paramètres d’administrateur.
  3. Sur la vignette Définir les jetons, sélectionnez Gérer.
  4. Dans la boîte de dialogue, saisissez les valeurs ID client, ID de locataire et Clé secrète client. Ces valeurs ont été définies lors de l’installation du complément de visibilité des stocks.
  5. Sélectionnez Se connecter. Le système génère un nouveau jeton du porteur pour vos sessions. Ce jeton expire après une heure.

Basculer entre les versions de l’interface utilisateur

Quelle que soit la version de l’interface utilisateur active, vous pouvez à tout moment passer à l’autre version. Toutefois, seuls les paramètres que vous appliquez dans la version active de l’interface utilisateur ont un effet. Pour basculer entre les deux versions, procédez comme suit.

  1. Connectez-vous à votre environnement Power Apps et ouvrez l’application Visibilité des stocks.

  2. Sur le menu Changer de zone en bas du volet de navigation, sélectionnez l’une des options suivantes :

    • Visibilité des stocks : le volet de navigation affiche les pages de l’interface utilisateur version 2.
    • Interface utilisateur héritée : le volet de navigation affiche les pages de l’interface utilisateur version 1.

Recherchez votre point de terminaison de service et lisez la configuration

Le service de visibilité des stocks est déployé sur Microsoft Azure Service Fabric, dans plusieurs zones géographiques et plusieurs régions. Actuellement, il n’existe aucun point de terminaison central qui puisse rediriger automatiquement vos requêtes vers la zone géographique et la région appropriées. Par conséquent, le point de terminaison du service utilise le modèle suivant, qui inclut les informations requises :

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

Pour obtenir votre point de terminaison de service et votre configuration d’exécution, procédez comme suit.

  1. Sur le volet de navigation Interface utilisateur version 2, sélectionnez Paramètres d’administration.
  2. Sur la vignette Afficher les détails du service, sélectionnez Gérer.
  3. Dans la boîte de dialogue, vous pouvez trouver votre point de terminaison de service et les détails de configuration.

Mettre à jour la configuration

Chaque fois que vous modifiez la configuration et enregistrez vos modifications, le système enregistre les nouveaux paramètres de configuration uniquement temporairement. Les modifications ne prennent effet que lorsque vous validez les nouveaux paramètres dans le service. Suivez ces étapes pour valider les nouveaux paramètres de configuration dans le service.

  1. Sur le volet de navigation Interface utilisateur version 2, sélectionnez Paramètres d’administration.

  2. Sur la vignette Mettre à jour la configuration, sélectionnez Gérer.

  3. Vérifiez vos modifications dans la boîte de dialogue.

    Important

    Assurez-vous de vérifier toutes les modifications importantes qui sont sur le point d’être apportées à vos sources de données, mesures physiques et mappages de dimensions.

  4. Sélectionnez Confirmer la mise à jour pour appliquer votre changement de configuration.

Règle de partition des données

La visibilité des stocks peut distribuer et stocker les données de stock de l’une des manières suivantes :

  • Par emplacement : choisissez cette option si vous connaissez toujours les informations du site et de l’entrepôt lorsque vous exécutez les requêtes disponibles, des ajustements de stock, des réservations de stock ou des allocations de stock via la visibilité des stocks.
  • Par ID produit : choisissez cette option si vous connaissez rarement les informations sur le site ou l’entrepôt lors de l’appel à la visibilité des stocks. Par exemple, lors de réservations dans un panier de commerce électronique, l’entrepôt de traitement des commandes peut être inconnu au moment où les commandes en ligne sont initialement passées. Dans ce cas, il est important de pouvoir appeler la visibilité des stocks pour interroger le stock disponible et effectuer des réservations sans fournir d’informations sur l’entrepôt.

Pour modifier la règle de partitionnement des données, procédez comme suit :

  1. Ouvrir l’application Visibilité des stocks
  2. Sélectionnez Règle de partitionnement des données et choisissez la règle que vous souhaitez utiliser.
  3. Effacer toutes les données de stock.
  4. Mettez à jour la configuration pour appliquer vos changements. (L’opération de mise à jour de la configuration échouera si vous n’effacez pas les données au préalable.)

La règle de partitionnement des données contrôle la façon dont les données sont distribuées. Les opérations effectuées au sein de la même partition offrent de meilleures performances, à moindre coût, que les opérations qui traversent des partitions. Nous recommandons donc d’utiliser l’option Par ID produit si vous effectuez souvent des requêtes sur différents emplacements. Nous vous recommandons cependant d’utiliser l’option Par emplacement si vous recherchez plus souvent plusieurs produits au même emplacement.

Lors de l’utilisation de la règle de partitionnement Par emplacement, la règle du tableau suivant est incluse dans la solution par défaut et ne peut pas être modifiée (elle est définie sur 0 dans la hiérarchie d’index). Lors de l’utilisation de l’option Par ID produit, la règle n’a aucun effet sur les API de visibilité des stocks.

Dimension de base Hiérarchie
SiteId 1
LocationId 2

Important

Ne personnalisez pas la configuration de partition. Si vous la supprimez ou modifiez la configuration sans instructions officielles, vous risquez de rencontrer une erreur inattendue.

Configuration d’index disponible

Dans de nombreux cas, le stock disponible est interrogé non seulement au niveau le plus détaillé, mais également à certains niveaux agrégés, en fonction des dimensions du stock.

Pour les modèles de requête fréquemment utilisés, vous pouvez contribuer à améliorer les performances des requêtes en configurant les index.

Un index est composé d’un nombre de précharge, de dimensions et d’une hiérarchie.

Name Description
Numéro d’ensemble Les dimensions sous le même nombre de précharge appartiennent au même ensemble (index) et sont regroupées.
Dimensions Les dimensions sont les dimensions de base sur lesquelles les résultats de requête sont agrégés.
Hiérarchie

La hiérarchie détermine les combinaisons spécifiques de dimensions qui peuvent tirer parti d’une requête d’index. Par exemple, vous configurez un index comportant les dimensions et la hiérarchie suivantes : (ColorId, SizeId, StyleId). Dans ce cas, seules les requêtes qui utilisent les quatre combinaisons de dimensions suivantes pour leurs champs de filtre et de regroupement sont améliorées :

  • Première combinaison : Vide
  • Deuxième combinaison :(ColorId)
  • Troisième combinaison :(ColorId, SizeId)
  • Quatrième combinaison :(ColorId, SizeId, StyleId)

(Le champ de filtre n’est pas limité par l’ordre.)

L’index n’accélère pas les requêtes qui utilisent d’autres combinaisons de dimensions.

La configuration d’index disponible par défaut inclut un ensemble standard d’index.

Conseil

Ces conseils peuvent vous aider lorsque vous configurez votre index disponible :

  • Les dimensions de base réservées dans la configuration de la partition (nombre de précharge 0) ne doivent pas être incluses dans d’autres configurations d’index disponibles.
  • Si vous ne souhaitez pas interroger des combinaisons de dimensions spécifiques, vous pouvez configurer un index qui n’a qu’une seule dimension de base, Vide.

Définir la configuration d’index disponible

  1. Sur le volet de navigation Interface utilisateur version 2, sélectionnez Configuration d’index.
  2. Ajoutez et supprimez des lignes dans la grille selon vos besoins pour définir votre index. Pour plus d’informations, consultez l’introduction de cette section et l’exemple dans la sous-section suivante.
  3. Mettez à jour la configuration pour appliquer vos changements.

Exemple de configuration d’index disponible

Cette section fournit un exemple qui montre comment fonctionne un index disponible.

Le tableau suivant présente une liste des stocks disponibles.

Item ColorId SizeId StyleId Quantité
D0002 Noir Petit Paysage 1
D0002 Noir Petit Régulier 2
D0002 Noir Grand Paysage 3
D0002 Noir Grand Régulier 4
D0002 Rouge Petit Paysage 5
D0002 Rouge Petit Normal 6
D0002 Rouge Étendu Normal 7

Le tableau suivant montre une configuration d’index disponible.

Numéro d’ensemble Dimension Hiérarchie
1 ColorId 1
1 SizeId 2
1 StyleId 3

Cet index permet d’améliorer la performance des requêtes de stock disponibles suivantes :

  • () – Groupé par tous

    • D0002, 28

  • (ColorId) – Groupé par ColorId

    • D0002, Noir, 10
    • D0002, Rouge, 18

  • (ColorId, SizeId) – Groupé par la combinaison de ColorId et SizeId

    • D0002, Noir, Petit modèle, 3
    • D0002, Noir, Grand modèle, 7
    • D0002, Rouge, Petit modèle, 11
    • D0002, Rouge, Grand modèle, 7

  • (ColorId, SizeId, StyleId) – Groupé par la combinaison de ColorId, SizeId et StyleId

    • D0002, Noir, Petit modèle, Large, 1
    • D0002, Noir, Petit modèle, Normal, 2
    • D0002, Noir, Grand modèle, Large, 3
    • D0002, Noir, Grand modèle, Normal, 4
    • D0002, Rouge, Petit modèle, Large, 5
    • D0002, Rouge, Petit modèle, Normal, 6
    • D0002, Rouge, Grand modèle, Normal, 7

Gestion des fonctions

Le tableau suivant présente les fonctionnalités offertes par Visibilité des stocks. Chacune de ces fonctionnalités peut être activée ou désactivée pour votre environnement.

Nom de la fonction Description
Disponible à la vente Suivez votre disponibilité à la vente (ATP) sur toutes les sources de données et tous les canaux.
Répartition des stocks Allouez votre précieux stock disponible à vos canaux, clients ou groupes prédéfinis les plus importants, et suivez la consommation de chaque pool alloué.
Stocks des entrepôts avancés Synchronisez et affichez les stocks avancés des articles de l’entrepôt à l’aide des hiérarchies d’entrepôt.
Réservation provisoire Publiez vos réservations omnicanales dans les réservations logicielles Visibilité des stocks pour des vérifications et des mises à jour de la disponibilité des stocks en temps réel.
Historique des journaux de stock Activez la visibilité des stocks pour stocker vos journaux de transactions réussies. Vous pouvez interroger l’historique des journaux pour obtenir des détails sur l’organisation, le produit, la plage de dates, le site et l’entrepôt.
Résumé du stock Synchronisez périodiquement votre résumé de stock brut du cache vers Dataverse. Cette fonctionnalité n’est pas compatible avec les articles d’entrepôt avancés. Activez cette fonctionnalité ou la fonctionnalité Requêtes disponibles préchargées. N’activez pas les deux fonctionnalités.
Stock disponible préchargé Préchargez périodiquement le résumé des stocks vers Dataverse à partir d’un résultat de requête. Le résultat de la requête peut être configuré avec les dimensions les plus pertinentes pour votre entreprise. Cette fonctionnalité est compatible avec les articles d’entrepôt avancés. Activez cette fonctionnalité ou la fonctionnalité Résumé des stocks. N’activez pas les deux fonctionnalités.

Par défaut, toutes ces fonctionnalités sont désactivées. Pour activer ou désactiver une fonctionnalité et définir les paramètres de configuration associés, procédez comme suit.

  1. Sur le volet de navigation Interface utilisateur version 2, sélectionnez Gestion des fonctionnalités.
  2. Trouvez la vignette pour la fonctionnalité à activer ou désactiver, puis sélectionnez Gérer.
  3. Activer et configurer la fonctionnalité, le cas échéant. Chaque fonctionnalité fournit des paramètres différents. Pour plus d’informations, consultez la documentation de la fonctionnalité que vous configurez.
  4. Mettez à jour la configuration pour valider vos modifications afin qu’elles prennent effet.

Supprimer toutes les configurations

Si nécessaire, vous pouvez supprimer toutes les configurations à l’exception de celles des sources de données fno et @iv de la visibilité des stocks. Les configurations supprimées ne peuvent pas être restaurées.

  1. Sur le volet de navigation Interface utilisateur version 2, sélectionnez Paramètres d’administration.
  2. Sur la vignette Supprimer toutes les configurations, sélectionnez Gérer.
  3. Vous êtes invité à confirmer la suppression. Cliquez sur OK pour continuer.

Supprimer toutes les données de stocks

Si nécessaire, vous pouvez supprimer toutes les données de la visibilité des stocks, hormis les configurations, à la fois dans le cache et dans Dataverse. Les données supprimées ne peuvent pas être restaurées et les utilisateurs sont bloqués jusqu’à ce que la suppression soit terminée.

  1. Sur le volet de navigation Interface utilisateur version 2, sélectionnez Paramètres d’administration.
  2. Sur la vignette Supprimer toutes les données de stocks, sélectionnez Gérer.
  3. Vous êtes invité à confirmer la suppression. Cliquez sur OK pour continuer.

Requêtes et mises à jour des stocks

Dans le volet de navigation, le groupe Visibilité opérationnelle permet d’accéder aux pages dans lesquelles vous pouvez effectuer des requêtes et des mises à jour des stocks disponibles en temps réel. Lorsque la fonctionnalité Réservation provisoire est activée, vous pouvez également valider des demandes de réservation sur l’API. Pour plus d’informations sur les requêtes des API, voir API publiques de la Visibilité des stocks.

Les éléments suivants sont communs à toutes les pages :

  • Un bouton Valider ou Interroger de la barre d’outils vous permet d’envoyer des requêtes API au service de visibilité des stocks. Ce bouton devient disponible uniquement après avoir saisi tout le contenu requis pour l’appel d’API sur la page.
  • Une section Produit vous permet de saisir un ID de produit, un ID d’organisation et des valeurs de dimension pour la demande d’API. Sélectionnez le bouton Modifier les dimensions dans cette section pour choisir laquelle des dimensions disponibles inclure dans la demande.
  • Une section Paramètres (le nom exact varie) vous permet de saisir des paramètres spécifiques à l’API, par exemple s’il faut interroger le contenu ATP pour une requête disponible.
  • Un bouton Référence du développeur sur la barre d’outils vous permet d’afficher le contenu brut de votre requête API (lecture seule).
  • Un bouton Paramètres sur la barre d’outils vous permet d’afficher et de modifier les détails d’authentification utilisés pour accéder au service de visibilité des stocks.

Les sous-sections suivantes fournissent des détails sur la configuration et l’utilisation de chaque type d’opération.

Requête de stock disponible

Utilisez la page Requête disponible dans le groupe Visibilité opérationnelle pour interroger le stock disponible en temps réel. Procédez comme suit pour configurer et exécuter une requête.

  1. Sur le volet de navigation Interface utilisateur version 2, sélectionnez Requête disponible.

  2. Dans la section Produit, saisissez les valeurs ID organisation, ID site et ID emplacement des produits que vous souhaitez trouver.

  3. Dans le champ ID produit, entrez un ou plusieurs ID produit pour obtenir une correspondance exacte pour votre requête. Sinon, laissez le champ vide pour inclure tous les produits du site et de l’emplacement spécifiés.

  4. Sélectionnez Modifier les dimensions pour choisir les dimensions à inclure dans le corps de la requête. Saisissez ensuite les valeurs des dimensions sélectionnées dans la section Produit.

    Note

    Si vous envisagez d’effectuer une requête ATP, assurez-vous que chaque dimension incluse dans l’index ATP est également répertoriée dans la section Produit . Par exemple, si votre index ATP inclut ColorId et SizeId, ces deux dimensions doivent être répertoriées dans la section Produit . Si des dimensions manquent, Sélectionner Modifiez les dimensions pour les ajouter. Dans le formulaire de recherche, vous pouvez laisser certaines valeurs de dimension vides. Cependant, les dimensions doivent être incluses dans le corps de la requête si elles sont incluses dans l’index ATP.

  5. Pour chaque champ que vous souhaitez inclure dans la requête, mais sans filtrer sur une valeur spécifique, sélectionnez Utiliser toutes les valeurs.

  6. Dans la section Paramètres de requête, définissez les options suivantes :

    • Requête ATP : cochez cette case pour inclure les informations ATP.
    • Inclure les quantités négatives : cochez cette case pour inclure les quantités négatives dans les résultats de mesure calculés.

  7. Sélectionnez Requête dans la barre d’outils pour envoyer la requête.

Ajustement de stock

Utilisez la page Ajustement des stocks dans le groupe Visibilité opérationnelle pour faire les mises à jour en temps réel des stocks. Suivez la procédure ci-après pour configurer et soumettre une mise à jour.

  1. Sur le volet de navigation Interface utilisateur version 2, sélectionnez Ajustement des stocks.
  2. Dans la section Produit, saisissez les valeurs ID produit, ID organisation, ID site et ID emplacement des produits que vous souhaitez mettre à jour.
  3. Sélectionnez Modifier les dimensions pour choisir les dimensions à inclure dans le corps de la requête. Saisissez ensuite les valeurs des dimensions sélectionnées dans la section Produit.
  4. Dans la section Mesures à mettre à jour, sélectionnez Ajouter pour ajouter une ligne pour la mesure que vous souhaitez mettre à jour. Pour la nouvelle ligne, sélectionnez une source de données, une mesure physique et une quantité à mettre à jour. Vous devez spécifier au moins une mesure. Vous pouvez ajouter plusieurs mesures.
  5. Sélectionnez Valider dans la barre d’outils pour envoyer la requête.

Réserver de manière provisoire

Utilisez la page Réserve provisoire du groupe Visibilité opérationnelle pour effectuer des réservations provisoires des stocks.

Important

La possibilité d’effectuer des réservations provisoires par l’interface utilisateur doit être utilisée uniquement pour tester la fonctionnalité. Chaque demande de réservation provisoire doit être associée à un changement de ligne d’ordre de transaction (création, modification, suppression, etc.). Ainsi, nous vous recommandons de n’effectuer que des réservations provisoires liées à des commandes principales. Pour plus d’informations, voir Réservations provisoires dans la visibilité des stocks.

Pour configurer et envoyer une réservation provisoire, procédez comme suit.

  1. Sur le volet de navigation Interface utilisateur version 2, sélectionnez Réserve provisoire.

  2. Dans la section Produit, saisissez les valeurs ID produit, ID organisation, ID site et ID emplacement des produits que vous souhaitez mettre à jour.

  3. Sélectionnez Modifier les dimensions pour choisir les dimensions à inclure dans le corps de la requête. Saisissez ensuite les valeurs des dimensions sélectionnées dans la section Produit.

  4. Dans la section Paramètres de réservation, définissez les champs suivants :

    • Activer les stocks négatifs pour prendre en charge les ventes excessives : cochez cette case pour ignorer la vérification de la disponibilité à la réservation. Décochez-la pour appliquer le contrôle.
    • Réserver sur mesure : sélectionnez la source de données et la mesure physique sur lesquelles effectuer la réservation provisoire.
    • Quantité : spécifiez la quantité à réserver.

  5. Sélectionnez Valider dans la barre d’outils pour envoyer la requête.

Modifier un horaire

Utilisez la page Publier le calendrier des changements de stock dans le groupe Visibilité opérationnelle pour publier les changements de stock avec des dates dans le service de visibilité des stocks. Suivre ces étapes pour configurer et soumettre un changement d’horaire.

  1. Dans le volet de navigation version 2 de l’interface utilisateur , Sélectionner Modifier le calendrier.
  2. Dans la section Produit , saisissez les valeurs de dimension des produits que vous souhaitez mettre à jour.
  3. Dans la section Mesure, quantité et date du calendrier de modification , section Ajouter pour spécifier la date, la source de données, la mesure physique et la quantité du changement.
  4. Sélectionnez Valider dans la barre d’outils pour envoyer la requête.

Rechercher des produits dans l’application Visibilité des stocks

La fonctionnalité Recherche de produit permet aux utilisateurs de rechercher des produits et des informations sur l’inventaire disponible en fonction d’attributs spécifiques, tels que la taille et la couleur. Pour plus d’informations sur la configuration de cette fonctionnalité, consultez Configurer la recherche de produit pour Inventory Visibility. Pour plus de détails sur la façon de l’utiliser dans l’application Inventory Visibility, voir Rechercher des produits à l’aide de l’application Inventory Visibility.