Comment générer et exécuter l’exemple d’adaptateur de facturation
S’applique à : Windows Azure Pack
L’exemple d’adaptateur de facturation est fourni dans le cadre des exemples du Kit de développement Windows Azure Pack disponibles à l’adresse https://www.microsoft.com/en-us/download/details.aspx?id=41146. La rubrique suivante montre comment générer et exécuter l’exemple en tant qu’application console ou en tant que service Windows. Un script est également fourni montrant comment exécuter l’exemple en tant que service Windows.
Notes
Lorsque l’adaptateur de facturation est démarré pour la première fois, l’utilisation de toutes les données historiques dans l’API Utilisation de Windows Azure Pack peut prendre un certain temps. S’il existe de nombreux événements à consommer, les fonctionnalités du locataire doivent être temporairement désactivées pour éviter tout problème de synchronisation. Si ce n’est pas le cas, certaines de leurs opérations d’achat peuvent être bloquées si les événements dépendants n’ont pas été traités dans le système de facturation au moment de l’achat. Pour ce faire, arrêtez les pools d’applications ou les services de site de TenantSite, TenantAPI et TenantPublicAPI.
Génération de l’exemple d’adaptateur de facturation
Pour générer l’exemple d’adaptateur de facturation
Extrayez le fichier zip du kit de développement Windows Azure Pack dans un dossier.
Dans le dossier extrait, recherchez la solution De l’adaptateur de facturation Visual Studio Microsoft.WindowsAzurePack.Samples.Billing.sln dans le dossier BillingAdapter.
Ouvrez le fichier de solution (.sln) dans Visual Studio.
Vérifiez que la dernière version du programme d’installation du package NuGet est installée en sélectionnant l’option de menu Outils, puis Extensions et Mises à jour. Dans la boîte de dialogue affichée, sélectionnez Online , puis Visual Studio Gallery pour voir s’il existe une mise à jour du Gestionnaire de package NuGet. Le cas échéant, installez-le.
Si le Gestionnaire de package NuGet n’est pas installé, consultez https://www.nuget.org/.
Ouvrez la boîte de dialogue Options du programme d’installation du package NuGet pour vous assurer que les packages requis sont automatiquement téléchargés. Pour ce faire, sélectionnez le menu Outils , Gestionnaire de package de bibliothèque, Gérer les packages Nuget pour la solution.... La boîte de dialogue Gérer les packages NuGet s’affiche. Cliquez sur Paramètres pour ouvrir la boîte de dialogue Options .
Sélectionnez Gestionnaire de package , puis Général.
Dans la section Restauration de package, assurez-vous que l’option Autoriser Nuget à télécharger les packages manquants et que case activée automatiquement pour les packages manquants lors de la génération dans Visual Studio sont vérifiés.
Cliquez sur OK pour fermer la boîte de dialogue paramètres, puis sur Fermer pour fermer la boîte de dialogue Gérer les packages NuGet .
Créez la solution dans Visual Studio.
Exécution de l’exemple d’adaptateur de facturation
L’exemple d’adaptateur de facturation peut être exécuté en tant qu’application console ou en tant que service Windows.
Il est recommandé de copier le répertoire de sortie de build (généralement sous bin\Debug ou bin\Release dans votre dossier projet) à un autre emplacement et de modifier les app.config à cet emplacement en fonction des paramètres de votre environnement de production. La copie des sorties de build vers un autre emplacement empêchera les builds futures de remplacer vos modifications app.config. Assurez-vous également que l’assembly propre au système de votre adaptateur de facturation se trouve dans le même dossier, y compris toutes ses dépendances (ou inscrit dans le Global Assembly Cache). Pour plus d’informations sur le fichier app.config, consultez À propos des exemples de fichiers du moteur core de l’adaptateur de facturation.
L’adaptateur de facturation émet des messages de suivi vers un canal du journal des événements Windows. Ce canal doit être inscrit avant de pouvoir être utilisé. Pour inscrire le canal, appelez l’exécutable de l’adaptateur de facturation avec l’argument registerlog. Par exemple, Microsoft.WindowsAzurePack.Samples.Billing.exe registerlog.
Pour exécuter l’adaptateur de facturation en tant qu’application console
Ouvrez une invite de commande
Exécutez Microsoft.WindowsAzurePack.Samples.Billing.exe avec l’argument registerlog du dossier de sortie (généralement sous bin\Debug ou bin\Release dans votre dossier de projet).
Pour exécuter l’adaptateur de facturation en tant que service Windows
Ouvrez une invite de commandes.
Exécutez Microsoft.WindowsAzurePack.Samples.Billing.exe avec le paramètre registerlog.
Dans le dossier de l’adaptateur de facturation, accordez les autorisations Read & Execute au compte qui sera utilisé pour exécuter le service.
Inscrivez l’adaptateur de facturation en tant que service Windows. Lors de l’inscription de l’exécutable de l’adaptateur de facturation en tant que service Windows, il est nécessaire de fournir l’argument « service » : Microsoft.WindowsAzurePack.Samples.Billing.exe service.
Démarrez le service Windows.
Script pour exécuter l’exemple d’adaptateur de facturation en tant que service Windows
Le script suivant montre comment exécuter l’exemple d’adaptateur de facturation en tant que service Windows
# \"Install\" the billing adapter (creates the event log channel where the service will log events)
<Path to Sample Build Location>\Microsoft.WindowsAzurePack.Samples.Billing.exe registerlog
# Give permissions to the account running the service to access the folder where it is installed and run the executable
icacls <Path to Sample Build Location>/T /grant "NT AUTHORITY\NETWORK SERVICE:(RX)"
# Create (register) the service to be run on startup using the account given access above.
sc create wapbill start= auto binPath= "<Path to Sample Build Location>\Microsoft.WindowsAzurePack.Samples.Billing.exe service" obj= "NT AUTHORITY\NetworkService" DisplayName= "Azure Pack Billing Adapter"
# start the service
sc start wapbill
Voir aussi
À propos des exemples de fichiers du moteur de cœur de l’adaptateur de facturation
Exemple d’adaptateur de facturation Windows Azure Pack