Delen via

Microsoft-klantovereenkomst Hulpprogramma voor bulksgewijs attestation

  • Artikel

Juiste rollen: Globale beheerder | Beheerderagent

Toepasselijke clouds: Globaal

Met het Microsoft-klantovereenkomst hulpprogramma voor bulksgewijze acceptatie kunnen partners de acceptatie van de Microsoft-klantovereenkomst namens hun klanten bevestigen. Dit hulpprogramma is ontworpen om partners te helpen die veel klanten hebben en binnen het bereik van de activiteiten voor de vernieuwing van de Microsoft-klantovereenkomst vallen.

Het hulpprogramma voor bulk attestation heeft verschillende functies:

  • Opensource .NET-consoleprogramma met behulp van een opensource .NET SDK (7.0)
  • Ondersteunt de door komma's gescheiden bestandsindeling (.csv) voor het instellen van bulkattestaties
  • Er zijn geen codewijzigingen vereist en kunnen worden gebruikt met een .NET-opdracht
  • Code is uitbreidbaar en kan worden uitgebreid naarmate partners passend zijn
  • Uitgebreide logboekregistratie kan helpen bij het oplossen van problemen

Dit hulpprogramma is bedoeld voor directe factureringspartners en indirecte providers die via het CSP-programma handelen.

Vereisten

  • Partneraccounts moeten zijn ingeschakeld voor meervoudige verificatie (MFA), omdat API's voor klantwerkruimten MFA afdwingen. U kunt MFA toevoegen door de instructies te volgen in MFA voor uw partnertenant.

  • Zorg ervoor dat de .NET 7.0 SDK op de hostcomputer is geïnstalleerd.

  • Een systeemeigen toepassing configureren in Partnercentrum:

    1. Selecteer Instellingen (tandwielpictogram) >Accountinstellingen in Partnercentrum.

      Schermopname van het menu Partnercentrum-instellingen, met Accountinstellingen gemarkeerd.

    2. Selecteer de pagina App-beheer .

    3. Selecteer + Nieuwe systeemeigen app toevoegen. Er wordt een nieuwe toepassing voor u gemaakt. Kopieer de toepassings-id en houd deze bij de hand.

      Schermopname van de pagina App-beheer, met Nieuwe systeemeigen app toevoegen gemarkeerd.

      U moet nu de zojuist gemaakte toepassing in Azure Portal kunnen zien onder Azure Entra ID > App-registraties.

      Schermopname van de pagina App-registraties, met de systeemeigen partnercentrum-app gemarkeerd.

    4. Gebruik het tabblad Verificatie om een platform voor mobiele toepassingen en desktoptoepassingen toe te voegen.

      Schermopname van de pagina Verificatie, met de flyout Platformen configureren geopend en mobiele en bureaubladtoepassingen gemarkeerd.

    5. Configureer de http://localhost en andere omleidings-URI's voor de toepassing.

      Schermopname van de pagina Bureaublad en apparaten configureren, met omleidings-URI's weergegeven.

    6. Nadat u deze hebt opgeslagen, controleert u of de omleidings-URI's worden weergegeven onder het platform voor mobiele toepassingen en desktoptoepassingen en of id-tokens zijn geselecteerd onder Impliciete toekenning en hybride stromen.

    Zie Partnercentrum-verificatie voor meer informatie.

Het hulpprogramma Microsoft-klantovereenkomst Bulk Attestation uitvoeren

  1. Ga naar de DotNet-voorbeelden in het Partnercentrum op GitHub en selecteer Code>downloaden zip om de bestanden uit te pakken in een lokale map. In de uitgepakte map wordt een submap met de naam Microsoft-klantovereenkomst RefreshBulkAttestationCLITool. U bent nu klaar om het hulpprogramma uit te voeren.

  2. Open de opdrachtprompt en navigeer naar de map waarin u de bestanden hebt uitgepakt.

  3. Voer de volgende opdracht uit: dotnet run. Wacht zo nodig totdat de build is voltooid.

  4. Geef uw toepassings-id en UPN (User Principal Name) op. Gebruik de systeemeigen toepassings-id die u hebt gemaakt en uw UPN.

  5. Meld u aan bij uw account met MFA.

  6. Het hulpprogramma bevat de volgende opties, die worden beschreven in de volgende secties:

    Schermopname van de opties voor het Bulk Attestation-hulpprogramma voor het ophalen of bijwerken van klantovereenkomstrecords.

Verificatie

Nadat u het hulpprogramma hebt gestart, wordt geprobeerd een verificatietoken op de achtergrond op te halen. Als dit mislukt, worden er interactieve modustriggers geactiveerd en wordt er een browservenster geopend waarin u wordt gevraagd u aan te melden. Gebruik dezelfde referenties die u gebruikt bij het aanmelden bij Het Partnercentrum.

Na een geslaagde verificatie wordt het volgende bericht weergegeven. Sluit het browservenster en ga terug naar de consoletoepassing.

Schermopname van het localhost-venster van de browser, met een bericht dat het goed is om het browsertabblad te sluiten.

Scenario's

Voordat u het hulpprogramma gebruikt, moet u rekening houden met het volgende:

  • Het hulpprogramma is niet ontworpen om details te verstrekken voor directe klantacceptatiedetails
  • Het hulpprogramma heeft invoergegevensvalidatie bij pariteit met de API voor het maken van een overeenkomst in partnercentrum

Er zijn twee scenario's die het hulpprogramma ondersteunt: klantovereenkomstrecords ophalen en klantovereenkomstrecords bijwerken.

Klantovereenkomstrecords ophalen

Deze bewerking maakt gebruik van de Partnercentrum-API om alle klantovereenkomstrecords op te halen die binnen het bereik van de Microsoft-klantovereenkomst Vernieuwen voor uw partnertenant vallen. Het hulpprogramma slaat de records vervolgens op in een CSV-bestand (CustomerAgreementRecords.csv) in een pad van uw keuze.

Als een klantovereenkomst is vernieuwd (via het bulkprogramma, partnercentrumportal of de API voor het maken van overeenkomsten), wordt de record niet geretourneerd in de ophaalbewerking. Het wordt ook niet opgenomen in het CSV-bestand. Alle records die in het CSV-bestand worden geretourneerd, kunnen worden uitgevoerd en moeten worden bijgewerkt.

Voorbeeld van het uitvoeren van de ophaalbewerking:

Schermopname van het hulpprogramma Bulk Attestation, met een bericht dat er 14 klantovereenkomstrecords zijn opgehaald uit het Partnercentrum.

Een deel van de geretourneerde velden bevat de contactgegevens van de klant voor de laatste door de partner bevestigde overeenkomst. Als er een eerdere attestation (overeenkomst bevestigd door de partner namens de klant) bestond, worden de contactgegevens van de klant voor die bevestiging weergegeven in de volgende velden. Anders zijn ze leeg. Deze gegevens worden voor uw gemak verstrekt in het geval dat de accepterende agent hetzelfde is op het moment van het vernieuwen van de acceptatie, maar anders moet worden bijgewerkt om de details van de acceptatie nauwkeurig weer te geven. Er wordt een e-mailmelding verzonden naar de klant met behulp van de opgegeven e-mail zodra de partner de acceptatie van de Microsoft-klantovereenkomst bevestigt.

Het CSV-bestand bevat de volgende velden:

  • Tenant-id van de klant: de tenant/Microsoft-id van de klant
  • Contactgegevens van de klant:
    • FirstName: De voornaam van de accepterende agent in de organisatie van de klant van de laatste door de partner bevestigde overeenkomst
    • LastName: De achternaam van de accepterende agent in de organisatie van de klant van de laatste door de partner bevestigde overeenkomst
    • E-mail: Het e-mailadres van de accepterende agent in de organisatie van de klant van de laatste door de partner bevestigde overeenkomst
    • Telefoonnummer: het telefoonnummer van de accepterende agent in de organisatie van de klant van de laatste door de partner bevestigde overeenkomst
    • LastAgreementDate: De datum/tijd van de laatste door de partner bevestigde overeenkomst
  • Partner Attestation Completed: Een Booleaanse waarde die aangeeft of de record van de klantovereenkomst moet worden bijgewerkt door het bulkhulpprogramma. Dit veld is standaard ingesteld False op en moet worden ingesteld op True alle records die u wilt bijwerken.
  • Koppeling klantaccount: een niet-operationeel veld dat wordt gebruikt om een directe koppeling naar de accountpagina van de klant weer te geven in partnercentrum. Het hulpprogramma vult dit veld in, maar wordt niet gebruikt voor bewerkingen en mag niet worden gewijzigd.

Voorbeeld van CSV-bestand:

Schermopname van voorbeelduitvoer uit het CSV-bestand.

Tip

Voordat u de eerste updatebewerking activeert, wordt u aangeraden een kopie van de klantovereenkomstrecords op te slaan die zijn geretourneerd naar een andere locatie voor uw eigen records. Zodra klantovereenkomstrecords zijn bijgewerkt, worden ze behandeld als opgelost en worden ze in de toekomst niet geretourneerd.

Klantovereenkomstrecords bijwerken

Deze bewerking maakt gebruik van de Partnercentrum-API om de klantovereenkomstrecords bij te werken vanuit het CSV-bestand dat is gemaakt door de ophaalbewerking.

Voordat u een klantovereenkomstrecord bijwerkt, moet u ervoor zorgen dat de contactgegevens van de klant voor de accepterende agent in de organisatie van de klant nauwkeurig en up-to-date zijn. Werk hiervoor de volgende velden in het CSV-bestand bij:

  • FirstName
  • LastName
  • E-mailadres
  • PhoneNumber (optioneel)

De datum/tijd van de overeenkomst wordt automatisch ingevuld in het Partnercentrum.

Als u een record voor een klantovereenkomst wilt markeren die moet worden bijgewerkt, stelt u het veld Partner Attestation Completed in op Waar voor de record in het CSV-bestand. Het hulpprogramma verwerkt alleen records waarvoor dit veld is ingesteld op Waar.

Voorbeeld van het bijwerken van het CSV-bestand voor de belangrijkste 2 klanten die zijn geretourneerd door de ophaalbewerking:

Schermopname van voorbeelduitvoer van het CSV-bestand, waarbij Partner Attestation Completed waar is.

Nadat u de records van de klantovereenkomst hebt gemarkeerd die u wilt bijwerken, slaat u het CSV-bestand op en sluit u het bestand en activeert u de updatebewerking in het menu van het hulpprogramma. Het hulpprogramma vraagt u om het pad naar het CSV-bestand op te geven. Nadat de records zijn geparseerd, wordt in het hulpprogramma weergegeven hoeveel actiebare records het heeft gevonden en wordt gestart met het verzenden van updatebewerkingen.

Voor grote hoeveelheden overeenkomsten kan het enige tijd duren voordat de updates worden bijgewerkt omdat de maximumovereenkomsten per verzonden oproep 500 zijn. De updatebewerkingen worden asynchroon uitgevoerd zodra het Partnercentrum wordt bereikt. U kunt een vertraging verwachten vanaf het moment dat het hulpprogramma de updatebewerkingen voltooit en wanneer de records van de klantovereenkomst worden bijgewerkt in partnercentrum.

Voorbeeld van het uitvoeren van de updatebewerking:

Schermopname van het hulpprogramma bulksgewijs attestation, met een bericht waarin wordt aangegeven dat er twee bruikbare records zijn verwerkt en de bewerking is voltooid.

Gerelateerde inhoud