Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Si applica a: Azure Logic Apps (Consumo + Standard)
Per automatizzare le attività che monitorano e gestiscono gli eventi in un hub eventi dall'interno del flusso di lavoro in App per la logica di Azure, usare le operazioni del connettore di Hub eventi di Azure . Ad esempio, il flusso di lavoro può controllare, inviare e ricevere eventi dall'hub eventi.
Questo articolo illustra come connettersi all'hub eventi aggiungendo un trigger o un'azione di Hub eventi al flusso di lavoro.
Informazioni di riferimento sui connettori
Per informazioni sulle operazioni di questo connettore, sui relativi parametri e su altre informazioni tecniche, ad esempio limiti, problemi noti e così via, vedere la pagina di riferimento del connettore di Hub eventi.
Prerequisiti
Un account e una sottoscrizione di Azure. Se non si ha una sottoscrizione, è possibile iscriversi per creare un account Azure gratuito.
Uno spazio dei nomi di Hub eventi e un hub eventi.
Assicurarsi di verificare che il flusso di lavoro possa accedere all'hub eventi. Per completare questa attività, seguire questa procedura:
Nel portale di Azure passare allo spazio dei nomi di Hub eventi, non a un hub eventi specifico.
Nel menu dello spazio dei nomi, selezionare Criteri di accesso condivisi in Impostazioni. Nella colonna Attestazioni verificare di disporre almeno delle autorizzazioni di gestione per tale spazio dei nomi.
Annotazioni
Quando successivamente si crea una connessione allo spazio dei nomi di Hub eventi, viene chiesto di selezionare un tipo di autenticazione per la connessione. In base alla selezione del tipo di autenticazione, potrebbe essere necessaria la stringa di connessione dello spazio dei nomi. Ad esempio, l'autenticazione della chiave di accesso richiede questa stringa di connessione.
Se si prevede di selezionare in un secondo momento un tipo di autenticazione che richiede la stringa di connessione per lo spazio dei nomi di Hub eventi, salvarla ora in modo da poter immettere le informazioni in un secondo momento:
Nella colonna Criteri selezionare RootManageSharedAccessKey.
Trovare la stringa di connessione della chiave primaria. Copiare e salvare la stringa di connessione per un uso successivo.
Per verificare che la stringa di connessione appartenga allo spazio dei nomi di Hub eventi e non a un hub eventi specifico, assicurarsi che la stringa di connessione non abbia il parametro
EntityPath. Se questo parametro è presente, la stringa di connessione appartiene a un Hub eventi e non è la stringa corretta da usare con il flusso di lavoro.
Flusso di lavoro dell'app per la logica in cui si desidera accedere all'hub di eventi
Per avviare un flusso di lavoro con un trigger di Hub eventi, è necessario un flusso di lavoro vuoto. Per usare un'azione di Hub eventi nel flusso di lavoro, è possibile usare qualsiasi trigger più adatto allo scenario per avviare il flusso di lavoro.
Aggiungere un trigger per Hub eventi
In App per la logica di Azure ogni flusso di lavoro deve iniziare con un trigger, che viene attivato quando viene soddisfatta una condizione specifica. Ogni volta che il trigger viene attivato, App per la logica di Azure crea un'istanza del flusso di lavoro e inizia a eseguire i passaggi nel flusso di lavoro.
I passaggi seguenti descrivono il modo generale per aggiungere un trigger Hub eventi, ad esempio Quando gli eventi sono disponibili nell'hub eventi. Questo esempio di trigger verifica la presenza di nuovi eventi nell'hub eventi e avvia un'esecuzione del flusso di lavoro quando esistono nuovi eventi.
Nel portale di Azure apri la risorsa dell'app per la logica.
In base alla disponibilità di una risorsa app per la logica a consumo o standard, seguire i passaggi corrispondenti:
Consumo: nella barra laterale delle risorse, in Strumenti di sviluppo, selezionare la finestra di progettazione per aprire il flusso di lavoro vuoto.
Standard: nella barra laterale della risorsa, in Flussi di lavoro selezionare Flussi di lavoro e quindi selezionare il flusso di lavoro vuoto. Nella barra laterale del flusso di lavoro, in Strumenti, selezionare la finestra di progettazione per aprire il flusso di lavoro vuoto.
Nella finestra di progettazione seguire questi passaggi generali per aggiungere il trigger di Hub eventi desiderato al flusso di lavoro.
Per altre informazioni, vedere Hub eventi - Trigger. Questo esempio continua con il trigger denominato Quando ci sono eventi disponibili in Hub eventi. Questo trigger controlla la presenza di nuovi eventi nell'Hub eventi e avvia un'esecuzione del flusso di lavoro quando sono presenti nuovi eventi.
Se richiesto, specificare le informazioni di connessione per l'Hub eventi.
Nel trigger specificare le informazioni necessarie per il trigger selezionato.
Per il trigger di esempio, le tabelle seguenti descrivono i parametri disponibili, a partire dal parametro predefinito seguente:
Parametro Obbligatoria Descrizione Nome hub eventi Sì Nome dell'hub eventi da monitorare. In Frequenza con cui si desidera verificare la presenza di elementi, sono disponibili i parametri predefiniti seguenti:
Parametro Obbligatoria Descrizione Interval Sì Numero intero positivo che indica l'intervallo con cui viene eseguito il flusso di lavoro in base alla frequenza. Frequenza Sì Unità di tempo per la ricorrenza. Fuso orario No Valido solo quando si specifica un'ora di inizio, perché il trigger non accetta la differenza dall'ora UTC. Selezionare il fuso orario che si desidera applicare.
Per altre informazioni, vedere Pianificare ed eseguire flussi di lavoro ricorrenti.Ora di inizio No Specificare un'ora di inizio nel formato seguente:
AAAA-MM-GGThh:mm:ss se si seleziona un fuso orario
-oppure-
AAAA-MM-GGThh:mm:ssZ se non si seleziona un fuso orarioPer altre informazioni, vedere Pianificare ed eseguire flussi di lavoro ricorrenti.
Nell'elenco dei Parametri avanzati sono disponibili i parametri facoltativi seguenti:
Parametro Obbligatoria Descrizione Tipo contenuto No Tipo di contenuto dell'evento. Per impostazione predefinita, è selezionato application/octet-stream. Schema contenuto No Schema di contenuto dell'evento. Nome gruppo di consumer No Nome del gruppo di consumer di Hub eventi da usare per la lettura degli eventi. Se non specificato, viene usato il gruppo di consumer predefinito. Chiave di partizione minima No Immettere l'ID di partizione minima da leggere. Per impostazione predefinita, vengono lette tutte le partizioni. Chiave di partizione massima No Immettere l'ID di partizione massima da leggere. Per impostazione predefinita, vengono lette tutte le partizioni. Numero massimo di eventi No Numero massimo di eventi. Il trigger restituisce un valore compreso tra uno e il numero di eventi specificato da questa proprietà. Al termine, sulla barra degli strumenti della finestra di progettazione selezionare Salva.
Continuare ora ad aggiungere una o più azioni in modo da poter eseguire altre attività usando gli output del trigger.
Ad esempio, per filtrare gli eventi in base a un valore specifico, ad esempio una categoria, è possibile aggiungere una condizione in modo che l'azione Invia evento invii solo gli eventi che soddisfano la condizione.
Comportamento di trigger
Attivare il comportamento di polling
Tutti i trigger di Hub eventi sono trigger di polling lungo. Questo comportamento significa che quando un trigger viene attivato, il trigger elabora tutti gli eventi e attende 30 secondi per visualizzare altri eventi nell'hub eventi. Per impostazione predefinita, se non vengono visualizzati eventi in 30 secondi, il trigger viene ignorato. In caso contrario, il trigger continua a leggere gli eventi finché l'hub eventi non è vuoto. Il polling successivo si baserà sull'intervallo di ricorrenza impostato nelle proprietà del trigger.
Ad esempio, se il trigger è configurato con quattro partizioni, questo ritardo potrebbe richiedere fino a due minuti prima che il trigger termini il polling di tutte le partizioni. Se non vengono ricevuti eventi entro questo ritardo, l'esecuzione del trigger viene ignorata. In caso contrario, il trigger continua a leggere gli eventi finché l'hub eventi non è vuoto. Il polling successivo si baserà sull'intervallo di ricorrenza specificato nelle proprietà del trigger.
Se si conoscono le partizioni specifiche in cui vengono visualizzati i messaggi, è possibile aggiornare il trigger per leggere gli eventi solo da tali partizioni. Impostare le chiavi di partizione massime e minime del trigger. Per altre informazioni, vedere la sezione Aggiungi trigger di Hub eventi.
Comportamento del checkpoint del trigger
Quando un trigger di Hub eventi legge gli eventi da ogni partizione in un hub eventi, il trigger usa il proprio stato per mantenere le informazioni sull'offset del flusso (la posizione dell'evento in una partizione) e le partizioni da cui il trigger legge gli eventi.
Ogni volta che viene eseguito il flusso di lavoro, il trigger legge gli eventi da una partizione, a partire dall'offset del flusso archiviato nello stato del trigger. In modo round robin, il trigger esegue l'iterazione su ogni partizione nell'hub eventi e legge gli eventi nelle esecuzioni successive del trigger. Una singola esecuzione ottiene eventi da una singola partizione alla volta.
Il trigger non usa questa funzionalità di checkpoint nell'archiviazione, senza costi aggiuntivi. L'aggiornamento del trigger di Hub eventi reimposta lo stato del trigger, che potrebbe causare la lettura degli eventi all'inizio del flusso.
Aggiungere un'azione per Hub eventi
In App per la logica di Azure un'azione segue il trigger o un'altra azione ed esegue alcune attività nel flusso di lavoro. La procedura seguente descrive il modo generale per aggiungere un'azione di Hub eventi, ad esempio Invia evento. Per questo esempio, il flusso di lavoro inizia con un trigger di Hub eventi che verifica la presenza di nuovi eventi nell'hub eventi.
Nel portale di Azure apri la risorsa dell'app per la logica.
In base alla disponibilità di una risorsa app per la logica a consumo o standard, seguire i passaggi corrispondenti:
Consumo: nella barra laterale delle risorse, in Strumenti di sviluppo, selezionare la finestra di progettazione per aprire il flusso di lavoro.
Standard: nella barra laterale delle risorse, in Flussi di lavoro, selezionare Flussi di lavoro e quindi selezionare il flusso di lavoro. Nella barra laterale del flusso di lavoro, in Strumenti, selezionare lo strumento di progettazione per aprire il flusso di lavoro.
Nella finestra di progettazione seguire questi passaggi generali per aggiungere l'azione di Hub eventi desiderata al flusso di lavoro.
Per altre informazioni, vedere Hub eventi - Azioni. Questo esempio continua con l'azione denominata Invia evento.
Se richiesto, specificare le informazioni di connessione per l'Hub eventi.
Nell'azione specificare le informazioni necessarie per l'azione selezionata.
Per l'azione di esempio, le tabelle seguenti descrivono i parametri disponibili, a partire dal parametro predefinito seguente:
Parametro Obbligatoria Descrizione Nome hub eventi Sì Il nome dell'hub eventi a cui inviare l'evento. Nell'elenco dei Parametri avanzati sono disponibili i parametri facoltativi seguenti:
Parametro Obbligatoria Descrizione Chiave di partizione No L'ID di partizione per dove inviare l'evento. Contenuto No Contenuto dell'evento da inviare. Proprietà No Proprietà dell'app e valori da inviare. Ad esempio, è possibile inviare l'output dal trigger di Hub eventi a un altro hub eventi:
Al termine, sulla barra degli strumenti della finestra di progettazione selezionare Salva.
Creazione di una connessione
Quando si aggiunge un trigger o un'azione di Hub eventi per la prima volta, viene richiesto di creare una connessione all'hub eventi. Per questa connessione, specificare le informazioni seguenti e selezionare Crea nuovo:
| Parametro | Obbligatoria | Descrizione |
|---|---|---|
| Connection Name (Nome connessione) | Sì | Il nome per identificare la connessione. |
| Tipo di autenticazione | Sì | Tipo di autenticazione per la connessione, in base allo scenario. Vengono visualizzati altri parametri di autenticazione, in base alla selezione. Nell'esempio la chiave di accesso richiede una stringa di connessione per lo spazio dei nomi di Hub eventi. Per altre informazioni, vedere Hub eventi - Creazione di una connessione. |
Dopo aver creato la connessione, continuare con Aggiungere un trigger per Hub eventi oppure Aggiungere un'azione per Hub eventi.