Scrittura di un'applicazione del listener per una soluzione Microsoft Azure

Data di pubblicazione: gennaio 2017

Si applica a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

In questo argomento viene descritto come scrivere un'applicazione del listener della soluzione Microsoft Azure che potrà leggere ed elaborare i messaggi di Microsoft Dynamics 365 che vengono pubblicati in Bus di servizio di Microsoft Azure. Come prerequisito, è necessario familiarizzare con la scrittura di un listener di Bus di servizio di Microsoft Azure prima di provare ad apprendere i dettagli sul listener di Microsoft Dynamics 365. Per ulteriori informazioni, vedi la documentazione del bus di servizio di Azure.

In questo argomento

Scrivere un listener coda

Scrivere un listener unidirezionale, bidirezionale o REST

Filtrare i messaggi

Leggi il contesto dei dati in più formati di dati

Scrivere un listener coda

Una coda di messaggi è un archivio di messaggi ricevuti agli endpoint del bus di servizio. Un listener coda è un'applicazione che legge ed elabora tali messaggi in coda. Poiché i messaggi del bus di servizio vengono archiviati in una coda, un listener non deve attivamente ascoltare, affinché i messaggi siano ricevuti nella coda. Un listener coda può essere avviato in seguito all'arrivo dei messaggi nella coda ed elaborare tali messaggi. Altri tipi di listener illustrati nella sezione successiva devono essere attivamente in ascolto o non colgono l'opportunità di leggere un messaggio. Tali messaggi possono essere originati da Microsoft Dynamics 365 o avere altre origini. .

È possibile effettuare una lettura distruttiva del messaggio utilizzando Ricevi in modalità ReceiveAndDelete, in cui il messaggio viene letto e rimosso dalla coda, o una lettura non distruttiva utilizzando la modalità PeekLock, in cui il messaggio viene letto ma rimane disponibile nella coda. Il codice di esempio di listener coda permanente fornito nel presente SDK esegue una lettura distruttiva. Per ulteriori informazioni sulla lettura di messaggi da una coda, vedere How to Receive Messages from a Queue (Come ricevere messaggi da una coda).

Un argomento è simile a una coda ma implementa un modello Pubblica/Sottoscrivi. Uno o più listener possono sottoscrivere il topic e ricevere messaggi dalla relativa coda.Ulteriori informazioni:Code, argomenti e sottoscrizioni

Utilizzare code e argomenti della progettazione software multisistema può comportare il disaccoppiamento dei sistemi. Se l'applicazione listener dovesse non essere disponibile, la consegna dei messaggi da Microsoft Dynamics 365 riuscirà comunque e l'applicazione listener potrà continuare a elaborare i messaggi in coda quando tornerà online.Ulteriori informazioni:Code, argomenti e sottoscrizioni

Scrivere un listener unidirezionale, bidirezionale o REST

Oltre al listener coda descritto in precedenza, è possibile scrivere un listener per altri tre contratti del bus di servizio che sono supportati da Microsoft Dynamics 365: unidirezionale bidirezionale, e REST. Un listener unidirezionale può leggere e elaborare un messaggio pubblicato nel bus di servizio. Un listener bidirezionale può fare lo stesso ma può anche restituire una stringa di alcune informazioni a Dynamics 365. Un listener REST è uguale al listener bidirezionale a eccezione del fatto che funziona con un endpoint REST. Si noti che questi listener devono essere attivamente in ascolto in un endpoint servizio per leggere un messaggio inviato attraverso il bus di servizio. Se il listener non è in ascolto quando Microsoft Dynamics 365 tenta di pubblicare un messaggio nel bus di servizio, il messaggio viene inviato.

La scrittura di u listener è strutturata intorno al cosiddetto ABC: indirizzo, binding e contratto (address, binding e contract). Le informazioni seguenti identificano gli ABC di un listener unidirezionale.

• Indirizzo: servizio URI

• Binding: WS2007HttpRelayBinding

• Contratto: IServiceEndpointPlugin

Dopo avere registrato il listener in un endpoint, il metodo Execute del listener è richiamato ogni volta che un messaggio viene pubblicato nel bus di servizio da Microsoft Dynamics 365. Il metodo Execute non restituisce alcun dato dalla chiamata al metodo. Per ulteriori informazioni, vedere l'esempio di listener unidirezionale, Esempio: listener unidirezionale.

Un listener bidirezionale è codificato in modo simile al listener unidirezionale. Gli ABC di un listener bidirezionale sono i seguenti:

• Indirizzo: servizio URI

• Binding: WS2007HttpRelayBinding

• Contratto: ITwoWayServiceEndpointPlugin

Per il contratto bidirezionale, il metodo Esegui restituisce una stringa dalla chiamata al metodo. Per ulteriori informazioni, vedere l'esempio di listener bidirezionale, Esempio: listener bidirezionale.

Un listener REST è codificato in modo simile al listener bidirezionale. Gli ABC di un listener REST sono i seguenti:

• Indirizzo: servizio URI

• Binding: WebHttpRelayBinding

• Contratto: IWebHttpServiceEndpointPlugin

Per il contratto REST, il metodo Execute restituisce una stringa dalla chiamata al metodo. Per ulteriori informazioni, vedere REST esempio di listener Esempio: listener REST. Si noti che nel listener REST nell'esempio, viene creata un'istanza di WebServiceHost e non di ServiceHost come nell'esempio bidirezionale.

Filtrare i messaggi

Esiste un contenitore di proprietà con informazioni aggiuntive che viene aggiunto a ogni proprietà delle Proprietà dei messaggi negoziati inviata da Microsoft Dynamics 365 e Dynamics 365 (online). Il contenitore di proprietà, disponibile per le code, i relè e gli endpoint del contratto di argomento permanenti, contiene le informazioni seguenti:

• Organizzazione URI

• ID utente chiamante

• ID dell'utente di avvio

• Nome logico entità

• Nome richiesta

Tali informazioni identificano l'organizzazione, l'utente, l'entità e la richiesta di messaggio elaborati da Microsoft Dynamics 365 che hanno ottenuto come risultato la pubblicazione del messaggio del bus di servizio. La disponibilità di queste proprietà indica che il messaggio è stato inviato da Microsoft Dynamics 365. Il codice del listener può decidere come elaborare il messaggio in base a tali valori.

Leggi il contesto dei dati in più formati di dati

Il contesto di dati dall'operazione Microsoft Dynamics 365 corrente è passato all'applicazione del listener della soluzione Azure nel corpo di un messaggio del bus di servizio. Nelle versioni precedenti era supportato solo un formato binario .NET. Per l'interoperabilità su più piattaforme (diverse .NET), puoi specificare uno dei tre formati dati per il corpo del messaggio: Binario .NET, JSON o XML. Questo formato è specificato nell'attributo MessageFormat dell'entità ServiceEndpoint.

Quando ricevi i messaggi, l'applicazione del listener può leggere il contesto dei dati nel corpo del messaggio in base al tipo di contenuto del messaggio. Il codice di esempio per eseguire questa operazione è indicato di seguito.

var receivedMessage = inboundQueueClient.Receive(TimeSpan.MaxValue);

if (receivedMessage.ContentType = "application/msbin1")
{
    RemoteExecutionContext context = receivedMessage.GetBody<RemoteExecutionContext>();
}
else if (receivedMessage.ContentType = "application/json")
{
    //string jsonBody = new StreamReader(receivedMessage.GetBody<Stream>(), Encoding.UTF8).ReadToEnd();
    RemoteExecutionContext contextFromJSON = receivedMessage.GetBody<RemoteExecutionContext>(
        new DataContractJsonSerializer(typeof(RemoteExecutionContext)));
}
else if (receivedMessage.ContentType = "application/xml")
{
    //string xmlBody = new StreamReader(receivedMessage.GetBody<Stream>(), Encoding.UTF8).ReadToEnd();
    RemoteExecutionContext contextFromXML = receivedMessage.GetBody<RemoteExecutionContext>(
        new DataContractSerializer(typeof(RemoteExecutionContext)));
}

Vedere anche

Estensioni Azure per Microsoft Dynamics 365
Scrivere un plug-in personalizzato che riconosce Azure
Esempio: listener di coda persistente
Esempio: listener unidirezionale
Esempio: listener bidirezionale
Esempio: listener REST
Utilizzo dei dati di Dynamics 365 nella soluzione Azure
Utilizzo dei dati di evento di Dynamics 365 nella soluzione Hub eventi di Azure

Microsoft Dynamics 365

© 2017 Microsoft. Tutti i diritti sono riservati. Copyright