Condividi tramite

Usare lo strumento di attestazione bulk del Contratto del cliente Microsoft

Ruoli appropriati: Agente amministratore | Agente di vendita

Cloud applicabili: globali

Lo strumento di attestazione in blocco consente ai partner di confermare l'accettazione del Contratto del cliente Microsoft per conto dei clienti. Questo strumento è progettato per aiutare i partner che hanno molti clienti e sono inclusi nell'ambito dell'aggiornamento del Contratto del cliente Microsoft.

Lo strumento di attestazione di massa include diverse funzionalità:

  • Strumento console .NET open source che utilizza il .NET SDK (7.0) anch'esso open source
  • Supporta il formato di file delimitato da virgole (.csv) per la configurazione di attestazioni in massa.
  • Non sono necessarie modifiche al codice e possono essere usate con un comando .NET
  • Il codice è estendibile e può essere migliorato come ritenuto opportuno dai partner.
  • La registrazione estesa consente di risolvere i problemi

Questo strumento è destinato ai partner con fatturazione diretta e ai provider indiretti che effettuano transazioni tramite il programma CSP.

Prerequisiti

  • Gli account partner devono essere abilitati per l'autenticazione a più fattori (MFA) perché le API dell'area di lavoro del cliente applicano l'autenticazione a più fattori. È possibile aggiungere MFA seguendo le istruzioni riportate in Obbligare l'MFA per il tenant del tuo partner.

  • Assicurarsi di avere installato .NET 7.0 SDK nel computer host.

  • Configurare un'applicazione nativa nel Centro per i partner:

    1. Nel Centro per i partner selezionare Impostazioni (icona a forma di ingranaggio) >.

      Screenshot del menu Impostazioni del Centro per i Partner, con le Impostazioni dell'Account evidenziate.

    2. Selezionare la pagina Gestione app .

    3. Selezionare + Aggiungi nuova app nativa. Viene creata automaticamente una nuova applicazione. Copiare l'ID applicazione e tenerlo a portata di mano.

      Screenshot della pagina Gestione app con l'opzione Aggiungi nuova app nativa evidenziata.

      A questo punto dovrebbe essere possibile visualizzare l'applicazione appena creata in portale di Azure in Azure Entra ID > Registrazioni app.

      Screenshot della pagina Registrazioni app con l'app nativa del Centro per i partner evidenziata.

    4. Usare la scheda Autenticazione per aggiungere una piattaforma per le applicazioni per dispositivi mobili e desktop.

      Screenshot della pagina Autenticazione, con il riquadro a comparsa

    5. Configurare http://localhost e altri URI di reindirizzamento per l'applicazione.

      Screenshot della pagina

    6. Dopo il salvataggio, verificare che gli URI di reindirizzamento siano elencati nella piattaforma delle applicazioni mobili e desktop e che il token ID sia selezionato in flussi di concessione implicita e ibridi.

    Per altre informazioni, vedere Autenticazione del Centro per i partner.

Eseguire lo strumento di attestazione in blocco del Contratto cliente Microsoft

  1. Vai ai Centro per i partner su GitHub - DotNet Samples e seleziona Code>Download ZIP (Scarica codice ZIP) per estrarre i file in una cartella locale. Nella cartella estratta è presente una sottocartella denominata Microsoft Customer Agreement Refresh Bulk Attestation CLI Tool. A questo momento è possibile eseguire lo strumento.

  2. Aprire il prompt dei comandi e passare alla cartella in cui sono stati estratti i file.

  3. Eseguire questo comando: dotnet run. Se necessario, attendere il completamento della compilazione.

  4. Specificare l'ID applicazione e il nome dell'entità utente (UPN). Usa l’ID dell’applicazione nativa che hai configurato e il tuo UPN.

  5. Accedi al tuo account con l'autenticazione multifattoriale.

  6. Lo strumento mostra le opzioni seguenti, descritte nelle sezioni seguenti:

    Schermata delle opzioni dello strumento di attestazione collettiva per recuperare o aggiornare i record dell'accordo con il cliente.

Completare l'autenticazione

Dopo aver avviato lo strumento, tenta di recuperare automaticamente un token di autenticazione. In caso di esito negativo, viene attivata una modalità interattiva e viene aperta una finestra del browser e viene chiesto di eseguire l'accesso. Usare le stesse credenziali usate per l'accesso al Centro per i partner.

Dopo l'autenticazione, viene visualizzato il messaggio seguente. Chiudere la finestra del browser e tornare all'applicazione console.

Screenshot della finestra localhost del browser con un messaggio che indica che è OK per chiudere la scheda del browser.

Comprendere gli scenari supportati

Prima di usare lo strumento, prendere nota:

  • Lo strumento non è progettato per fornire dettagli per i dettagli di accettazione diretta dei clienti
  • Lo strumento ha la convalida dei dati di input in parità con l'API Create Agreement del Centro per i partner

Esistono due scenari supportati dallo strumento: recuperare i record del contratto del cliente e aggiornare i record del contratto del cliente.

Recuperare i registri dei contratti dei clienti

Questa operazione usa l'API del Centro per i partner per recuperare tutti i record del contratto del cliente inclusi nell'ambito dell'aggiornamento Contratto del cliente Microsoft per il tenant partner. Lo strumento salva quindi i record in un file CSV (CustomerAgreementRecords.csv) in un percorso scelto.

Se un contratto del cliente è stato aggiornato (tramite lo strumento in blocco, il portale del Centro per i partner o l'API Crea contratto), il record non viene restituito nell'operazione di recupero e non è incluso nel file CSV. Tutti i record restituiti nel file CSV sono utilizzabili e devono essere aggiornati.

Esempio di esecuzione dell'operazione di recupero:

Screenshot dello Strumento di Attestazione Bulk, con un messaggio che ha recuperato 14 record del contratto del cliente dal Partner Center.

Parte dei campi restituiti include i dettagli di contatto del cliente per l'ultimo contratto confermato dal partner. Se esiste un'attestazione precedente (contratto confermato dal partner per conto del cliente), i dettagli di contatto del cliente per tale conferma vengono visualizzati nei campi seguenti. In caso contrario, sono vuoti. Questi dettagli vengono forniti per comodità nel caso in cui l'agente di accettazione sia lo stesso al momento dell'aggiornamento dell'accettazione, ma in caso contrario deve essere aggiornato per riflettere in modo accurato i dettagli di accettazione. Una notifica tramite posta elettronica viene inviata al cliente usando il messaggio di posta elettronica fornito dopo che il partner conferma l'accettazione del Contratto del cliente Microsoft.

Il file CSV contiene i campi seguenti:

  • ID tenant del cliente: ID tenant/Microsoft del cliente
  • Dettagli contatto cliente:
    • FirstName: nome del responsabile per l'accettazione nell'organizzazione del cliente relativo all'ultimo accordo confermato dal partner
    • LastName: cognome dell'agente incaricato dell'accettazione nell'organizzazione cliente relativa all'ultimo accordo confermato dal partner
    • Email: indirizzo di posta elettronica dell'agente di accettazione nell'organizzazione del cliente dell'ultimo contratto confermato dal partner
    • PhoneNumber: numero di telefono dell'agente di accettazione nell'organizzazione del cliente dell'ultimo contratto confermato dal partner
    • LastAgreementDate: data/ora dell'ultimo contratto confermato dal partner
  • Attestazione partner completata: valore booleano che indica se lo strumento in blocco aggiorna un record del contratto del cliente. Questo campo è impostato su False per impostazione predefinita e deve essere impostato su True per tutti i record da aggiornare.
  • Collegamento all'account cliente: campo non operativo usato per visualizzare un collegamento diretto alla pagina dell'account del cliente nel Centro per i partner. Lo strumento popola questo campo, ma non viene usato per alcuna operazione e non deve essere modificato.

File CSV di esempio:

Schermata dell'output di esempio dal file CSV.

Suggerimento

Prima di attivare la prima operazione di aggiornamento, è consigliabile salvare una copia dei record del contratto del cliente restituiti in un'altra posizione per i propri record. Quando i record del contratto del cliente vengono aggiornati correttamente, vengono considerati risolti e non verranno restituiti in futuro.

Aggiornare i record del contratto del cliente

Questa operazione usa l'API del Centro per i partner per aggiornare i record del contratto del cliente dal file CSV creato dall'operazione di recupero.

Prima di aggiornare un record del contratto del cliente, assicurarsi che i dettagli di contatto del cliente per l'agente di accettazione nell'organizzazione del cliente siano accurati e up-to-date. A tale scopo, aggiornare i campi seguenti nel file CSV:

  • FirstName
  • LastName
  • E-mail
  • PhoneNumber (facoltativo)

Il valore della data e ora del contratto viene popolato automaticamente nel Partner Center.

Per contrassegnare un record del contratto del cliente da aggiornare, impostare il campo Partner Attestation Completed (Attestazione partner completata) su True nel record all'interno del file CSV. Lo strumento elabora solo i record con questo campo impostato su True.

Esempio di aggiornamento del file CSV per i primi 2 clienti restituiti dall'operazione di recupero:

Screenshot dell'output di esempio del file CSV, in cui Attestazione partner completata è True.

Dopo aver contrassegnato i record del contratto del cliente da aggiornare, salvare e chiudere il file CSV e attivare l'operazione di aggiornamento dal menu degli strumenti. Lo strumento richiede di specificare il percorso del file CSV. Dopo aver analizzato correttamente i record, lo strumento visualizza il numero di record interattivi trovati e inizia a inviare le operazioni di aggiornamento.

Per grandi quantità di contratti, gli aggiornamenti possono richiedere del tempo perché il numero massimo di contratti da aggiornare per ogni chiamata inviata è 500. Le operazioni di aggiornamento vengono eseguite in modo asincrono dopo aver raggiunto il Centro per i partner. È possibile prevedere un ritardo da quando lo strumento completa le operazioni di aggiornamento e quando i record del contratto del cliente vengono aggiornati nel Centro per i partner.

Esempio di esecuzione dell'operazione di aggiornamento:

Screenshot dello strumento di attestazione di massa, con un messaggio che indica che ha elaborato due record di azioni eseguibili e ha completato l'operazione.

Contenuto correlato