Integrazione dei partner per Supporto dei dati del dispositivo in Gestione assistenza (anteprima)

[Questo articolo fa parte della documentazione non definitiva, pertanto è soggetto a modifiche.]

La funzionalità Supporto dei dati dei dispositivi in Gestione assistenza (anteprima) definisce API personalizzate in entrata e in uscita per consentire a clienti e partner di integrare i propri servizi di gestione dei dispositivi. Le API abilitano le seguenti funzionalità:

• Crea una soluzione Power Automate snella intorno al tuo connettore HTTPS e utilizza le API personalizzate per attivare i tuoi flussi Power Automate e inserire dati in Dataverse.
• Utilizza le API personalizzate in entrata per elaborare le risposte del flusso Power Automate in Dataverse.
• Utilizza le API personalizzate in uscita per i trigger Dataverse.
• Configura un flusso Power Automate per eseguire tutte le operazioni pertinenti in un sistema partner utilizzando i connettori Power Automate. Per attivare il flusso Power Automate, utilizza il trigger di azione di Dataverse. Per ulteriori informazioni, vedi Attivare flussi con azioni.

Le seguenti API in uscita definiscono il trigger per ogni processo:

Dopo che il flusso Power Automate ha completato tutte le operazioni necessarie, invia un risposta a un'API personalizzata in entrata tramite l'azione non associata del connettore Dataverse. L'API personalizzata in entrata elabora la risposta in Dataverse.

Il diagramma seguente illustra il modo in cui il flusso invia la risposta a un'azione non associata in uno scenario corretto.

La tabella seguente definisce l'API in entrata per ciascun processo:

I seguenti parametri API specificano il contratto dati generico per tutti i fornitori di dispositivi:

Il flusso Ottieni dispositivi richiede un altro parametro Contenuto oltre ai quattro parametri elencati.

Formato:

{
  "ResponseFormat": "<Format in which the responses are bundled>",
  "Devices": [
    {
      "Name": "<Device name>",
      "Model": "<Device model>",
      "SerialNumber": "<Device's unique serial number>"
    }
  ]
}

Esempio:

{
  "ResponseFormat": "default",
  "Devices": [
    {
      "Name": "Device 1",
      "Model": "Thermometer",
      "SerialNumber": "AutomatedTIP1"
    },
    {
      "Name": "Device 2",
      "Model": "Weighing machine",
      "SerialNumber": "AutomatedTIP2"
    }
  ]
}

Il diagramma seguente illustra il modo in cui il flusso invia la risposta a un'azione non associata in uno scenario non corretto.

Per tutti i processi elencati in questo articolo, il trigger dell'utente avvia la catena di azioni da Dataverse al fornitore del dispositivo e viceversa. Puoi vedere le notifiche relative a un'operazione riuscita o non riuscita nell'applicazione. Dopo aver aggiornato la pagina, puoi anche vedere l'interfaccia utente aggiornata per un'operazione riuscita.

Prerequisiti per l'integrazione senza partner Microsoft

Per gli utenti che integrano la funzionalità senza partner Microsoft, devi avere la configurazione seguente:

1. Due endpoint privati per stabilire una connessione con il tenant di Azure. Un endpoint è per Azure Key Vault e l'altro è per il servizio Hub eventi di Azure. Ti consigliamo di distribuire gli endpoint privati ​​in una rete virtuale per una maggiore sicurezza.

2. Un'app multi-tenant per inviare i dati del dispositivo emessi al tuo tenant Azure. Devi fornire l'ID applicazione corrispondente nel tenant di Azure. Questa registrazione dell'applicazione autentica anche l'accesso all'insieme di credenziali delle chiavi dall'endpoint privato.

3. I flussi Power Automate specificati nella sezione Integrazione partner che utilizzano i trigger citati. Utilizza le API personalizzate in entrata specificate per elaborare le risposte in Dataverse.

Informazioni correlate

• Configurare il supporto dei dati del dispositivo (anteprima)
• Generare dati di esempio per il supporto dei dati del dispositivo (anteprima)
• Risoluzione dei problemi relativi al supporto dei dati del dispositivo (anteprima)
• Usare il supporto dei dati del dispositivo (anteprima)