Tester un plan SaaS
Cet article explique comment tester une offre SaaS (Software as a Service) en préversion.
Voici quelques instructions générales à prendre en compte lorsque vous testez votre offre.
- Si votre offre SaaS prend en charge la facturation mesurée à l’aide du service de mesure de la Place de marché commerciale, passez en revue et suivez les bonnes pratiques de test détaillées dans API de facturation mesurée de la Place de marché.
- Passez en revue et suivez les instructions de test de Implémentation d’un webhook sur le service SaaS pour vous assurer que votre offre est correctement intégrée aux API.
- Si l’étape de validation de l’offre a entraîné des avertissements, un lien Afficher le rapport de validation s’affiche sur la page Vue d’ensemble de l’offre. Veillez à passer en revue le rapport et à résoudre les problèmes avant de sélectionner le bouton Démarrer en direct. Sinon, la certification risque d’échouer et de retarder votre offre de passer en direct.
- Si vous devez apporter des modifications après l’aperçu et le test de l’offre, vous pouvez modifier et soumettre à nouveau pour publier une nouvelle préversion. Pour plus d’informations, consultez Mettre à jour une offre existante dans la place de marché.
Remarque
Dans cet exemple, nous utilisons l'Accélérateur SaaS pour la page d’accueil.
Vérifier l’achat d’un plan de test privé
Les éditeurs peuvent utiliser la Place de marché commerciale pour vérifier l’achat d’un plan de test.
Dans la page d’accueil, sélectionnez la vignette Insights.
Dans le menu de gauche, sélectionnez Commandes.
En haut à droite, sélectionnez l’icône de filtre et filtrez par nom de l’offre. Le widget Commandes par offres affiche le nombre d’abonnements achetés. Le nombre total de nouvelles commandes augmente.
Remarque
L’affichage des commandes dans le rapport peut prendre jusqu’à 48 heures.
Dans la barre de navigation de gauche, sélectionnez Téléchargements.
Dans la liste type de rapport, sélectionnez Commandes.
Dans la liste Sélectionner la période, sélectionnez 3 mois.
Sous extension de fichier, sélectionnez CSV.
Cliquez sur Générer.
Téléchargez le fichier . Fichier CSV et vérifiez que le nouvel abonnement pour votre plan de test est affiché dans le rapport.
Envoyer un événement d’utilisation limitée
Si votre plan de test est configuré pour envoyer des événements d’utilisation, il est important de tester l’utilisation du plan facturé au prorata en envoyant des événements facturés au prorata à API Facturée du Marché. Voici un exemple d’envoi d’événements d’utilisation limitée à l’aide d’un outil capable d’envoyer des requêtes HTTP pour tester votre solution, par exemple :
Visual Studio Code avec une extension de Visual Studio Marketplace
-
Avertissement
Dans les scénarios comprenant des données sensibles, comme des informations d’identification, des secrets, des jetons d’accès, des clés API et d’autres informations similaires, veillez à utiliser un outil qui protège vos données avec les fonctionnalités de sécurité nécessaires, qui fonctionne en mode hors connexion ou localement, qui ne synchronise pas vos données avec le cloud, et qui ne vous impose pas de vous connecter à un compte en ligne. Vous réduirez ainsi les risques liés à l’exposition de données sensibles au public.
Lorsque vous testez l’utilisation limitée, nous vous recommandons d’envoyer plus que le nombre d’événements d’utilisation couverts par les frais de base, puis de vérifier que seul le nombre d’événements d’utilisation qui dépassent les frais de base sont envoyés à Microsoft.
Envoyer une demande
À l’aide d’un outil d’API capable d’envoyer des requêtes HTTP pour tester votre solution, envoyez un corps de requête comme celui présenté dans cet exemple.
Exemple de corps de la requête :
{
"resourceId": <guid>, // unique identifier of the resource against which usage is emitted.
"quantity": 5.0, // how many units were consumed for the date and hour specified in effectiveStartTime, must be greater than 0 or a double integer
"dimension": "dim1", // custom dimension identifier
"effectiveStartTime": "2018-12-01T08:30:14", // time in UTC when the usage event occurred, from now and until 24 hours back
"planId": "plan1", // id of the plan purchased for the offer
}
Paramètres de requête :
Paramètre | Commentaire |
---|---|
resourceId | Il s’agit de votre id d’abonnement SaaS |
quantité | Vous pouvez entrer 1 pour la quantité comme valeur de test |
dimension | Entrez le nom de la dimension définie dans le plan mesuré |
planId | Entrez l’ID du plan mesuré |
Afficher la réponse
Vous devez recevoir une réponse semblable à celle présentée dans cet exemple.
Exemple de charge utile de réponse :
{
"usageEventId": <guid>, // unique identifier associated with the usage event in Microsoft records
"status": "Accepted" // this is the only value in case of single usage event
"messageTime": "2020-01-12T13:19:35.3458658Z", // time in UTC this event was accepted
"resourceId": <guid>, // unique identifier of the resource against which usage is emitted. For SaaS it's the subscriptionId.
"quantity": 5.0, // amount of emitted units as recorded by Microsoft "dimension":
"dim1", // custom dimension identifier
"effectiveStartTime": "2018-12-01T08:30:14", // time in UTC when the usage event occurred, as sent by the ISV
"planId": "plan1", // id of the plan purchased for the offer
}
Pour plus d’informations sur l’envoi d’événements d’utilisation mesurée, consultez API de facturation mesurée de la Marketplace.
Vérifier les informations d’utilisation mesurée
Dans la page d’accueil, sélectionnez la vignette Insights.
Dans le menu de gauche, sélectionnez Utilisation.
Dans la liste en haut de la page, sélectionnez Utilisation limitée.
Dans la liste des alias de l’offre, sélectionnez le nom de votre offre.
Dans la liste ID du compteur, sélectionnez un ID de dimension (compteur) que vous avez entré dans le plan. L’utilisation limitée est affichée dans le widget d’utilisation limitée.
Remarque
Vous ne devriez voir que l'utilisation mesurée au-dessus des frais de base.
Télécharger le rapport
Remarque
L’affichage des commandes dans le rapport peut prendre jusqu’à 48 heures.
Dans le menu de gauche, sélectionnez Téléchargements.
Dans la liste de rapports de type, sélectionnez Utilisation.
Dans la liste Sélectionner la période, sélectionnez 3 mois.
Sous l'extension de fichier , sélectionnez CSV.
Sélectionnez Générer.
Téléchargez le fichier . Fichier CSV et vérifiez que le nouvel abonnement pour votre plan de test est affiché dans le rapport.