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.
Funzioni di Azure fornisce estensioni trigger e binding che si integrano con vari servizi, principalmente i servizi Azure. L'estensione Connector amplia queste integrazioni a una gamma molto più ampia di servizi, inclusi sistemi aziendali e piattaforme dati.
Ad esempio, usa il Connector Trigger per eseguire una funzione quando una nuova email arriva in Office 365 Outlook, un file viene creato in SharePoint o una registrazione delle modifiche in Salesforce. Il trigger riceve eventi da un connettore gestito nello spazio di nomi Azure Connector. Per esplorare i connettori gestiti disponibili, consulta il riferimento ai connettori.
Per maggiori informazioni sui connettori gestiti, quando usarli e sulla disponibilità delle funzionalità, consulta Usa connettori gestiti in Funzioni di Azure.
Note
Il Connector Trigger non è attualmente supportato per questo linguaggio.
Modalità di consegna
I connettori gestiti supportano due modalità di consegna:
-
Polling: L'host Functions si collega in uscita allo spazio dei nomi del connettore per ricevere eventi. Imposta
deliveryMode: 'Poll', e fornisciconnectionetriggerConfigNamenelle opzioni di registrazione. -
Webhook: Il Namespace del Connettore invia eventi all'endpoint di callback dell'estensione. Webhook è il predefinito quando ometti
deliveryMode.
Entrambe le modalità supportano aiutanti nominati come connectors.office365.onNewEmail e l'aiutante generico connectorTrigger . Per assistenza nella scelta di una modalità, vedi Scegli una modalità di consegna.
Get started
Segui il percorso di configurazione per la modalità di consegna:
- Installa i pacchetti Node.js e configura il pacchetto di estensioni.
- Crea o riutilizza uno spazio dei nomi e una connessione, e crea una configurazione di trigger di sondaggio.
- Trova l'endpoint del sondaggio.
- Configura le credenziali del chiamante, l'accesso alla connessione e le impostazioni locali o distribuite.
- Usa un esempio di sondaggio qui sotto, abbinando i suoi
connectionvaloritriggerConfigNamealle tue impostazioni.
Il sondaggio non richiede un endpoint di callback pubblico o una chiave di sistema. Per la consegna tramite webhook, la funzione di destinazione e l'endpoint di callback devono essere pronti prima di creare la configurazione del trigger.
Modalità di consegna
I connettori gestiti supportano due modalità di consegna:
-
Polling: L'host Functions si collega in uscita allo spazio dei nomi del connettore per ricevere eventi. Imposta
delivery_mode=func.DeliveryMode.POLL, e alimentaconnectionetrigger_config_namesu@app.connector_trigger. -
Webhook: Il Namespace del Connettore invia eventi all'endpoint di callback dell'estensione. Webhook è la funzione predefinita quando si omette
delivery_mode.@app.connector_trigger
Per assistenza nella scelta di una modalità, vedi Scegli una modalità di consegna.
Get started
Segui il percorso di configurazione per la modalità di consegna:
- Installa i pacchetti Python e configura il pacchetto di estensioni.
- Crea o riutilizza uno spazio dei nomi e una connessione, e crea una configurazione di trigger di sondaggio.
- Trova l'endpoint del sondaggio.
- Configura le credenziali del chiamante, l'accesso alla connessione e le impostazioni locali o distribuite.
- Usa un esempio di sondaggio qui sotto, abbinando i suoi
connectionvaloritrigger_config_namealle tue impostazioni.
Il sondaggio non richiede un endpoint di callback pubblico o una chiave di sistema. Per la consegna tramite webhook, la funzione di destinazione e l'endpoint di callback devono essere pronti prima di creare la configurazione del trigger.
Modalità di consegna
I connettori gestiti supportano due modalità di consegna:
-
Polling: L'host Functions si collega in uscita allo spazio dei nomi del connettore per ricevere eventi. Imposta
DeliveryMode = ConnectorTriggerDeliveryMode.Poll, e aggiungi le impostazioni di connessione e attiva la configurazione su[ConnectorTrigger]. -
Webhook: Il Namespace del Connettore invia eventi all'endpoint di callback dell'estensione. Webhook è la funzione predefinita quando ometti
DeliveryModel'attributo[ConnectorTrigger].
Per assistenza nella scelta di una modalità, vedi Scegli una modalità di consegna.
Get started
Segui il percorso di configurazione per la modalità di consegna:
- Installa l'estensione.
- Crea o riutilizza uno spazio dei nomi e una connessione, e crea una configurazione di trigger di sondaggio.
- Trova l'endpoint del sondaggio.
- Configura le credenziali del chiamante, l'accesso alla connessione e le impostazioni locali o distribuite.
- Usa un esempio qui sotto, abbinando i suoi
ConnectionvaloriTriggerConfigNamealle impostazioni tue.
Il sondaggio non richiede un endpoint di callback pubblico o una chiave di sistema. Per la consegna tramite webhook, la funzione di destinazione e l'endpoint di callback devono essere pronti prima di creare la configurazione del trigger.
Examples
Gli esempi di Office 365 Outlook e SharePoint Online utilizzano payload fortemente tipati dall'SDK Azure Connectors. Per le operazioni di connettore che non hanno ancora payload fortemente tipati, assegna a string per ricevere il payload JSON grezzo. Questi esempi registrano intenzionalmente solo le informazioni basilari del payload per rimanere concentrati su come definire funzioni attivate dal connettore. Sostituisci la registrazione con la logica di elaborazione della tua applicazione.
Per trovare quali operazioni di connettore supportano payload fortemente tipati per .NET, consulta Operations to Funzioni di Azure signature mapping.
La modalità di consegna tramite sondaggio supporta anche proprietà opzionali sull'attributo [ConnectorTrigger] . Per descrizioni, valori supportati e valori predefiniti, vedi Proprietà dell'attributo di interrogazione.
Outlook di Office 365
Il seguente esempio viene eseguito quando una nuova email arriva nella cassetta Office 365 Outlook configurata:
Questo esempio riceve batch di fino a quattro eventi connettori, ciascuno contenente una email, e viene utilizzato ConnectorEvent<T> per accedere al payload e MessageIdal payload di ciascun evento.
using Microsoft.Azure.Functions.Worker;
using Microsoft.Azure.Functions.Worker.Extensions.Connector;
using Microsoft.Extensions.Logging;
using Azure.Connectors.Sdk.Office365.Models;
namespace Office365App;
public sealed class O365Functions(ILogger<O365Functions> logger)
{
[Function("OnNewEmail")]
public void OnNewEmail(
[ConnectorTrigger(
DeliveryMode = ConnectorTriggerDeliveryMode.Poll,
Connection = "ConnectorNamespace",
TriggerConfigName = "%OnNewEmailTriggerConfigName%",
IsBatched = true,
MaxBatchSize = 4,
TargetPendingEventThreshold = 16)]
ConnectorEvent<Office365OnNewEmailTriggerPayload>[] emails)
{
foreach (var email in emails)
{
var messageCount = email.Data.Body?.Value?.Count ?? 0;
logger.LogInformation(
"Poll event {MessageId}: received {MessageCount} new email message(s).",
email.MessageId,
messageCount);
}
}
}
Per lo sviluppo locale, includi le impostazioni di connessione e il nome della configurazione del trigger nella Values sezione local.settings.json:
{
"ConnectorNamespace__pollingEndpoint": "https://<connector-namespace-host>",
"OnNewEmailTriggerConfigName": "<polling-trigger-config-name>"
}
Le proprietà dell'attributo si riferiscono a queste impostazioni:
-
Connection = "ConnectorNamespace"Identifica il prefisso delle Impostazioni. L'estensione legge l'endpoint di polling daConnectorNamespace__pollingEndpoint. Per come ottenere l'endpoint e le informazioni sulle credenziali richieste e sulle politiche di accesso, consulta Interrogazione dell'endpoint. -
TriggerConfigName = "%OnNewEmailTriggerConfigName%"risolve il valore dell'impostazioneOnNewEmailTriggerConfigName. Imposta il suo valore al nome della configurazione del trigger di polling nel tuo Namespace del Connettore.
I nomi dei prefissi e delle impostazioni sono illustrativi; se li modifichi, aggiorna sia le proprietà dell'attributo sia le impostazioni per corrispondere. Per un'app di funzione distribuita, aggiungi le stesse impostazioni alle impostazioni dell'app di funzione invece di local.settings.json.
Il Office365OnNewEmailTriggerPayload tipo è definito nello Azure.Connectors.Sdk.Office365.Models spazio dei nomi.
Per l'esempio completo di codice, inclusi infrastrutture e registrazione dei trigger, vedi Office 365 Outlook trigger per .NET.
SharePoint Online
Il seguente esempio viene eseguito quando un file viene creato nella libreria documentale SharePoint Online configurata:
Questo esempio riceve un evento di connettore contenente un file per ogni invocazione (impostazione predefinita) e lo utilizza ConnectorEvent<T> per accedere al suo payload e MessageId.
using Microsoft.Azure.Functions.Worker;
using Microsoft.Azure.Functions.Worker.Extensions.Connector;
using Microsoft.Extensions.Logging;
using Azure.Connectors.Sdk.SharePointOnline.Models;
namespace SharePointApp;
public sealed class SharePointFunctions(ILogger<SharePointFunctions> logger)
{
[Function("OnNewFile")]
public void OnNewFile(
[ConnectorTrigger(
DeliveryMode = ConnectorTriggerDeliveryMode.Poll,
Connection = "ConnectorNamespace",
TriggerConfigName = "%OnNewFileTriggerConfigName%")]
ConnectorEvent<SharePointOnlineOnNewFileItemsTriggerPayload> file)
{
var fileCount = file.Data.Body?.Value?.Count ?? 0;
logger.LogInformation(
"Poll event {MessageId}: received {FileCount} new SharePoint file(s).",
file.MessageId,
fileCount);
}
}
Per lo sviluppo locale, includere questi valori nell'oggetto Values in local.settings.json:
{
"ConnectorNamespace__pollingEndpoint": "https://<connector-namespace-host>",
"OnNewFileTriggerConfigName": "<polling-trigger-config-name>"
}
Le proprietà dell'attributo si riferiscono a queste impostazioni:
-
Connection = "ConnectorNamespace"Identifica il prefisso delle Impostazioni. L'estensione legge l'endpoint di polling daConnectorNamespace__pollingEndpoint. Per come ottenere l'endpoint e le informazioni sulle credenziali richieste e sulle politiche di accesso, consulta Interrogazione dell'endpoint. -
TriggerConfigName = "%OnNewFileTriggerConfigName%"risolve il valore dell'impostazioneOnNewFileTriggerConfigName. Imposta il suo valore al nome della configurazione del trigger di polling SharePoint nel tuo Namespace Connector.
I nomi dei prefissi e delle impostazioni sono illustrativi; se li modifichi, aggiorna sia le proprietà dell'attributo sia le impostazioni per corrispondere. Per un'app di funzione distribuita, aggiungi le stesse impostazioni alle impostazioni dell'app di funzione invece di local.settings.json.
Il SharePointOnlineOnNewFileItemsTriggerPayload tipo è definito nello Azure.Connectors.Sdk.SharePointOnline.Models spazio dei nomi.
Per l'esempio completo di codice, inclusi infrastrutture e registrazione dei trigger, vedi SharePoint Online triggers per .NET.
Connettore senza un carico utile fortemente tipato
Alcuni eventi di connettore non hanno ancora un payload .NET fortemente tipizzato. Il seguente esempio viene eseguito quando viene aggiunto un nuovo messaggio a una chat o a un canale Microsoft Teams. Il polling utilizza ConnectorEvent<string> per ricevere il payload JSON grezzo con i metadati di consegna; la consegna tramite webhook si lega direttamente a string:
Questo esempio riceve un evento connettore per ogni invocazione (predefinito) e lo utilizza ConnectorEvent<string> per accedere al suo payload JSON e MessageId.
using Microsoft.Azure.Functions.Worker;
using Microsoft.Azure.Functions.Worker.Extensions.Connector;
using Microsoft.Extensions.Logging;
namespace TeamsApp;
public sealed class TeamsFunctions(ILogger<TeamsFunctions> logger)
{
[Function("OnNewTeamsMessage")]
public void OnNewTeamsMessage(
[ConnectorTrigger(
DeliveryMode = ConnectorTriggerDeliveryMode.Poll,
Connection = "ConnectorNamespace",
TriggerConfigName = "%OnNewTeamsMessageTriggerConfigName%")]
ConnectorEvent<string> message)
{
logger.LogInformation(
"Poll event {MessageId}: received a Teams payload of {PayloadLength} characters.",
message.MessageId,
message.Data.Length);
}
}
Per lo sviluppo locale, includere questi valori nell'oggetto Values in local.settings.json:
{
"ConnectorNamespace__pollingEndpoint": "https://<connector-namespace-host>",
"OnNewTeamsMessageTriggerConfigName": "<polling-trigger-config-name>"
}
Le proprietà dell'attributo si riferiscono a queste impostazioni:
-
Connection = "ConnectorNamespace"Identifica il prefisso delle Impostazioni. L'estensione legge l'endpoint di polling daConnectorNamespace__pollingEndpoint. Per come ottenere l'endpoint e le informazioni sulle credenziali richieste e sulle politiche di accesso, consulta Interrogazione dell'endpoint. -
TriggerConfigName = "%OnNewTeamsMessageTriggerConfigName%"risolve il valore dell'impostazioneOnNewTeamsMessageTriggerConfigName. Imposta il suo valore al nome della configurazione del trigger di sondaggio Teams nel tuo Namespace del Connettore.
I nomi dei prefissi e delle impostazioni sono illustrativi; se li modifichi, aggiorna sia le proprietà dell'attributo sia le impostazioni per corrispondere. Per un'app di funzione distribuita, aggiungi le stesse impostazioni alle impostazioni dell'app di funzione invece di local.settings.json.
Per l'esempio completo di codice, inclusa l'infrastruttura e la registrazione dei trigger, vedi Trigger generici dei connettori per .NET.
Mappature degli eventi dei connettori
Il nome dell'operazione è definito dal connettore gestito. Scegli il nome della funzione nel tuo codice. Gli esempi di polling e webhook utilizzano gli stessi nomi di evento, operazioni e funzioni:
| Evento connettore | Nome dell'operazione | Nome della funzione |
|---|---|---|
| Email di nuova Office 365 Outlook | OnNewEmailV3 |
OnNewEmail |
| Nuovo file SharePoint Online | GetOnNewFileItems |
OnNewFile |
| Nuovo messaggio di chat o canale di Microsoft Teams | WebhookNewMessageTrigger |
OnNewTeamsMessage |
I payload Webhook possono contenere più elementi, a seconda della configurazione del trigger.
La consegna tramite sondaggio abilita splitOnsempre , quindi ogni evento in coda contiene un elemento diviso. Tuttavia, la modalità di sondaggio può raggruppare gli eventi in un'unica invocazione di funzione impostando IsBatched = true. Per la configurazione del batching, vedi Attributi.
Tipi di associazioni
Per le funzioni worker isolate .NET, entrambe le modalità di consegna supportano i seguenti tipi di parametri:
| Tipo | Description |
|---|---|
string |
Riceve il corpo dell'evento come JSON grezzo. Usa questo tipo quando non è disponibile un modello SDK fortemente tipizzato o quando vuoi deserializzare il payload da solo. |
| Modello SDK del connettore | Deserializza il corpo dell'evento JSON in un modello specifico per operazioni da Azure.Connectors.Sdk, come Office365OnNewEmailTriggerPayload oppure SharePointOnlineOnNewFileItemsTriggerPayload. |
| JSON-deserializzabile POCO | Deserializza il corpo dell'evento JSON in un tipo .NET la cui forma corrisponde al payload del connettore utilizzando il serializer worker configurato. |
ConnectorEvent<T> |
Incapsula un tipo di payload supportato in Data.
MessageId contiene l'identificatore di consegna per il polling ed è null per la consegna tramite webhook. |
Parametri della matrice
I parametri dell'array hanno significati diversi in ogni modalità di consegna.
Per il polling, IsBatched determina la forma del parametro della funzione, dove T è un tipo di payload di evento supportato:
IsBatched |
Tipo di parametro di funzione |
|---|---|
false (predefinito) |
T o ConnectorEvent<T> |
true |
T[] oppure ConnectorEvent<T>[], anche quando MaxBatchSize = 1 |
Impostato MaxBatchSize da 1 a 32; senza batching, la dimensione effettiva del lotto deve essere 1. La dimensione del batch conta gli eventi dei connettori, non gli elementi all'interno del payload di un evento. Il batching non cambia il tipo di payload all'interno di ogni evento. La raccolta di Body.Value un payload SDK è separata dall'array esterno di eventi forniti a un'invocazione batch.
Per webhook, usare T[] la deserializzazione del corpo dell'array JSON di un singolo callback in un array di elementi di payload. Non si tratta di un lotto di eventi consegnati separatamente. La consegna Webhook elabora un callback per ogni invocazione; IsBatched si applica solo al sondaggio.
Examples
L'estensione del connettore Node.js fornisce contesti tipizzati per le operazioni Office 365 Outlook, SharePoint Online e Microsoft Teams mostrate in questa sezione. Questi esempi registrano intenzionalmente solo le informazioni di base sul payload per mantenere il focus su come definire le funzioni attivate dal Connector. Sostituisci la registrazione con la logica di elaborazione della tua applicazione.
Per trovare quali operazioni di connettore supportano payload fortemente tipati per JavaScript e TypeScript, consulta il riferimento di estensioneNode.js connettore.
Outlook di Office 365
Il seguente esempio viene eseguito quando una nuova email arriva nella cassetta Office 365 Outlook configurata:
Questo esempio riceve fino a quattro eventi di connettore per ogni invocazione. L'assistente fornisce le email di quegli eventi come un'unica lista.
import { InvocationContext } from '@azure/functions';
import {
connectors,
EmailTriggerContext,
} from '@azure/functions-extensions-connectors';
connectors.office365.onNewEmail('OnNewEmail', {
deliveryMode: 'Poll',
connection: 'ConnectorNamespace',
triggerConfigName: '%OnNewEmailTriggerConfigName%',
cardinality: 'many',
maxBatchSize: 4,
targetPendingEventThreshold: 16,
handler: async (
context: EmailTriggerContext,
invocationContext: InvocationContext,
) => {
invocationContext.log(
`Received ${context.emails.length} new email message(s).`,
);
},
});
Il EmailTriggerContext tipo espone i messaggi come un array tipizzato emails .
Per ulteriori esempi, vedi Office 365 Outlook trigger per TypeScript.
SharePoint Online
Il seguente esempio viene eseguito quando un file viene creato nella libreria documentale SharePoint Online configurata:
Questo esempio riceve un evento di connettore per ogni invocazione, il valore predefinito. L'aiutante fornisce i suoi record di proprietà del file come un elenco.
import { InvocationContext } from '@azure/functions';
import {
connectors,
SharepointItemTriggerContext,
} from '@azure/functions-extensions-connectors';
connectors.sharepoint.onNewFileItems('OnSharepointNewFile', {
deliveryMode: 'Poll',
connection: 'ConnectorNamespace',
triggerConfigName: '%OnSharepointNewFileTriggerConfigName%',
handler: async (
context: SharepointItemTriggerContext,
invocationContext: InvocationContext,
) => {
invocationContext.log(
`Received ${context.records.length} new SharePoint file(s).`,
);
},
});
Il SharepointItemTriggerContext tipo espone i record delle proprietà file per records l'operazione GetOnNewFileItems . L'aiutante conserva i campi forniti dal connettore senza convertirli in uno schema di file fisso. Per ulteriori esempi, consulta i trigger di SharePoint Online per TypeScript.
Microsoft Teams
Il seguente esempio viene eseguito quando un nuovo messaggio viene aggiunto a un canale Microsoft Teams:
Questo esempio riceve un evento di connettore per ogni invocazione, il valore predefinito. L'aiutante fornisce il suo payload di messaggi sotto forma di elenco.
import { InvocationContext } from '@azure/functions';
import {
ChannelMessageTriggerContext,
connectors,
} from '@azure/functions-extensions-connectors';
connectors.teams.onNewChannelMessage('OnNewChannelMessage', {
deliveryMode: 'Poll',
connection: 'ConnectorNamespace',
triggerConfigName: '%OnNewTeamsMessageTriggerConfigName%',
handler: async (
context: ChannelMessageTriggerContext,
invocationContext: InvocationContext,
) => {
invocationContext.log(
`Received ${context.messages.length} new Teams message(s).`,
);
},
});
Il ChannelMessageTriggerContext tipo espone i messaggi come un array tipizzato messages .
Per ulteriori esempi, consulta i trigger di Microsoft Teams per TypeScript.
Payload generico del connettore
Usa l'aiutante generico quando un'operazione non ha una registrazione nominata. Accedi context.rawPayload quando il tuo codice deve elaborare il payload originale stesso.
Questo esempio riceve un evento di connettore per ogni invocazione, il valore predefinito. L'aiutante fornisce gli oggetti del suo carico come un elenco.
import { InvocationContext } from '@azure/functions';
import {
connectorTrigger,
ConnectorTriggerContext,
} from '@azure/functions-extensions-connectors';
connectorTrigger('OnConnectorEvent', {
deliveryMode: 'Poll',
connection: 'ConnectorNamespace',
triggerConfigName: '%GenericTriggerConfigName%',
handler: async (
context: ConnectorTriggerContext,
invocationContext: InvocationContext,
) => {
invocationContext.log(`Received ${context.items.length} payload item(s).`);
},
});
Il contesto generico imposta di default il tipo di elemento su unknown. Convalida gli elementi prima di accedere alle proprietà specifiche dell'operazione.
context.rawPayload Conserva l'input analizzato prima della normalizzazione, incluso l'array di eventi esterno per il polling batch.
Examples
L'estensione Node.js connettore fornisce contesti specifici per il connettore per le operazioni Office 365 Outlook, SharePoint Online e Microsoft Teams mostrate in questa sezione. Questi esempi registrano intenzionalmente solo le informazioni di base sul payload per mantenere il focus su come definire le funzioni attivate dal Connector. Sostituisci la registrazione con la logica di elaborazione della tua applicazione.
Per trovare quali operazioni di connettore supportano payload fortemente tipati per JavaScript e TypeScript, consulta il riferimento di estensioneNode.js connettore.
Outlook di Office 365
Il seguente esempio viene eseguito quando una nuova email arriva nella cassetta Office 365 Outlook configurata:
Questo esempio riceve fino a quattro eventi di connettore per ogni invocazione. L'assistente fornisce le email di quegli eventi come un'unica lista.
const {
connectors,
} = require('@azure/functions-extensions-connectors');
connectors.office365.onNewEmail('OnNewEmail', {
deliveryMode: 'Poll',
connection: 'ConnectorNamespace',
triggerConfigName: '%OnNewEmailTriggerConfigName%',
cardinality: 'many',
maxBatchSize: 4,
targetPendingEventThreshold: 16,
handler: async (context, invocationContext) => {
invocationContext.log(
`Received ${context.emails.length} new email message(s).`,
);
},
});
Il contesto del gestore espone i messaggi attraverso l'array emails .
SharePoint Online
Il seguente esempio viene eseguito quando un file viene creato nella libreria documentale SharePoint Online configurata:
Questo esempio riceve un evento di connettore per ogni invocazione, il valore predefinito. L'aiutante fornisce i suoi record di proprietà del file come un elenco.
const {
connectors,
} = require('@azure/functions-extensions-connectors');
connectors.sharepoint.onNewFileItems('OnSharepointNewFile', {
deliveryMode: 'Poll',
connection: 'ConnectorNamespace',
triggerConfigName: '%OnSharepointNewFileTriggerConfigName%',
handler: async (context, invocationContext) => {
invocationContext.log(
`Received ${context.records.length} new SharePoint file(s).`,
);
},
});
Il contesto del gestore espone i record delle proprietà file per records l'operazione GetOnNewFileItems . L'aiutante conserva i campi forniti dal connettore senza convertirli in uno schema di file fisso.
Microsoft Teams
Il seguente esempio viene eseguito quando un nuovo messaggio viene aggiunto a un canale Microsoft Teams:
Questo esempio riceve un evento di connettore per ogni invocazione, il valore predefinito. L'aiutante fornisce il suo payload di messaggi sotto forma di elenco.
const {
connectors,
} = require('@azure/functions-extensions-connectors');
connectors.teams.onNewChannelMessage('OnNewChannelMessage', {
deliveryMode: 'Poll',
connection: 'ConnectorNamespace',
triggerConfigName: '%OnNewTeamsMessageTriggerConfigName%',
handler: async (context, invocationContext) => {
invocationContext.log(
`Received ${context.messages.length} new Teams message(s).`,
);
},
});
Il contesto del gestore espone i messaggi attraverso l'array messages .
Payload generico del connettore
Usa l'aiutante generico quando un'operazione non ha una registrazione nominata. Accedi context.rawPayload quando il tuo codice deve elaborare il payload originale stesso.
Questo esempio riceve un evento di connettore per ogni invocazione, il valore predefinito. L'aiutante fornisce gli oggetti del suo carico come un elenco.
const {
connectorTrigger,
} = require('@azure/functions-extensions-connectors');
connectorTrigger('OnConnectorEvent', {
deliveryMode: 'Poll',
connection: 'ConnectorNamespace',
triggerConfigName: '%GenericTriggerConfigName%',
handler: async (context, invocationContext) => {
invocationContext.log(`Received ${context.items.length} payload item(s).`);
},
});
Convalida gli elementi prima di accedere alle proprietà specifiche dell'operazione.
context.rawPayload Conserva l'input analizzato prima della normalizzazione, incluso l'array di eventi esterno per il polling batch.
Impostazioni di sondaggio locale
Aggiungi i nomi delle configurazioni endpoint e trigger di polling alocal.settings.json:
{
"IsEncrypted": false,
"Values": {
"ConnectorNamespace__pollingEndpoint": "https://<connector-namespace-host>",
"OnNewEmailTriggerConfigName": "<outlook-polling-trigger-config-name>",
"OnSharepointNewFileTriggerConfigName": "<sharepoint-polling-trigger-config-name>",
"OnNewTeamsMessageTriggerConfigName": "<teams-polling-trigger-config-name>",
"GenericTriggerConfigName": "<generic-polling-trigger-config-name>"
}
}
Il valore degli connection: 'ConnectorNamespace' esempi identifica il prefisso delle impostazioni. Ogni triggerConfigName espressione si risolve alla relativa impostazione dell'app. Per le impostazioni distribuite e i permessi di connessione, vedi Interrogazione dell'autenticazione.
Per un altro esempio di registrazione al voto, vedi il campioneNode.js sondaggio.
Examples
Gli esempi di Office 365 Outlook e SharePoint Online utilizzano convertitori forniti da azurefunctions-extensions-connectors. L'esempio generico riceve JSON grezzo senza annotazione SDK. Questi esempi registrano solo le informazioni basilari del payload; sostituisci la registrazione con la logica di elaborazione della tua applicazione.
Per trovare quali operazioni di connettore supportano payload fortemente tipati per Python, vedi Concetti chiave nell'estensione del connettore Python.
Outlook di Office 365
Il seguente esempio viene eseguito quando una nuova email arriva nella cassetta Office 365 Outlook configurata:
Questo esempio riceve fino a quattro eventi di connettore per ogni invocazione. Il convertitore fornisce le email di quegli eventi come un unico elenco.
import logging
import azure.functions as func
import azurefunctions.extensions.connectors.office365 as office365
app = func.FunctionApp()
@app.function_name(name="OnNewEmail")
@app.connector_trigger(
arg_name="emails",
delivery_mode=func.DeliveryMode.POLL,
connection="ConnectorNamespace",
trigger_config_name="%OnNewEmailTriggerConfigName%",
cardinality=func.Cardinality.MANY,
max_batch_size=4,
target_pending_event_threshold=16,
)
def on_new_email(
emails: list[office365.GraphClientReceiveMessage],
) -> None:
logging.info(
"Received %s new email message(s).",
len(emails),
)
Il GraphClientReceiveMessage binding supporta l'operazione OnNewEmailV3 . Per la registrazione completa del codice, dell'infrastruttura e dei trigger per entrambe le modalità, vedi Office 365 Outlook trigger per Python.
SharePoint Online
Il seguente esempio viene eseguito quando un file viene creato nella libreria documentale SharePoint Online configurata:
Questo esempio riceve un evento di connettore per ogni invocazione, il valore predefinito. Il convertitore fornisce i suoi record di proprietà file sotto forma di elenco.
import logging
import azure.functions as func
import azurefunctions.extensions.connectors.sharepointonline as sharepoint
app = func.FunctionApp()
@app.function_name(name="OnSharepointNewFile")
@app.connector_trigger(
arg_name="files",
delivery_mode=func.DeliveryMode.POLL,
connection="ConnectorNamespace",
trigger_config_name="%OnSharepointNewFileTriggerConfigName%",
)
def on_sharepoint_new_file(files: list[sharepoint.Item]) -> None:
logging.info(
"Received %s new SharePoint file(s).",
len(files),
)
Il Item binding supporta l'operazione GetOnNewFileItems e preserva le proprietà del file in dynamic_properties. Per codice, infrastruttura e registrazione dei trigger completi per entrambe le modalità, vedi SharePoint Online triggers per Python.
Payload generico del connettore
Usa la azure-functions libreria per ricevere eventi come stringhe JSON grezze quando un'operazione non dispone di un convertitore tipizzato supportato, o quando desideri analizzare il JSON da solo.
Questo esempio riceve un evento connettore per ogni invocazione, la versione predefinita, come stringa JSON grezza.
import logging
import azure.functions as func
app = func.FunctionApp()
@app.function_name(name="OnConnectorEvent")
@app.connector_trigger(
arg_name="payload",
delivery_mode=func.DeliveryMode.POLL,
connection="ConnectorNamespace",
trigger_config_name="%GenericTriggerConfigName%",
)
def on_connector_event(payload: str) -> None:
logging.info("Received a connector event.")
Per esempi completi, vedi Trigger generici dei connettori per Python.
Per il polling locale, definisci i nomi delle configurazioni degli endpoint e dei trigger sotto Values inlocal.settings.json:
{
"IsEncrypted": false,
"Values": {
"ConnectorNamespace__pollingEndpoint": "https://<connector-namespace-host>",
"OnNewEmailTriggerConfigName": "<outlook-polling-trigger-config-name>",
"OnSharepointNewFileTriggerConfigName": "<sharepoint-polling-trigger-config-name>",
"GenericTriggerConfigName": "<generic-polling-trigger-config-name>"
}
}
Il valore degli connection="ConnectorNamespace" esempi identifica il prefisso delle impostazioni. Ogni trigger_config_name espressione si risolve alla relativa impostazione dell'app. Per le impostazioni distribuite e i permessi di connessione, vedi Interrogazione dell'autenticazione.
Tipi di associazioni
Entrambe le modalità di consegna supportano le seguenti forme di registrazione e di payload:
| Registration | Input del gestore |
|---|---|
app.connectorTrigger da @azure/functions |
Riceve l'input originale del trigger senza normalizzazione dell'aiutante. Il tipo di input TypeScript è predefinito unknown; per il polling batch, usa un tipo di array come unknown[]. |
connectorTrigger da @azure/functions-extensions-connectors |
Riceve un ConnectorTriggerContext<T> con normalizzato payload e items, analizzato rawPayload, e toJSON() serializzazione. Il tipo di elemento TypeScript è predefinito unknownsu . |
Aiutanti nominati come connectors.office365.onNewEmail |
Ricevi il contesto normalizzato con un array nominato, come emails, , o messages, che aliasa itemsrecords. TypeScript deduce il tipo di elemento SDK supportato. |
Gli aiutanti accettano input di oggetti o stringhe JSON. Normalizzano { body: item } e { body: { value: [...] } } avvolgono. Per il sondaggio a batch, appiattino l'array esterno delle buste e gli elementi del payload in un unico items array, mantenendo l'ordine.
rawPayload Conserva l'input analizzato prima della normalizzazione, incluso l'array di eventi esterno.
Imposta cardinality: 'many' per abilitare il batching di invocazione. Un array nel contesto o un tipo di array TypeScript da solo non abilita il batching.
maxBatchSize Conta gli eventi del connettore, non gli elementi nell'array normalizzato. Ogni invocazione del webhook gestisce un callback, che può contenere più elementi di payload.
I tipi TypeScript descrivono il payload atteso ma non convalidano o trasformano i campi specifici dell'operazione in runtime. Convalida il payload prima di accedere alle proprietà quando la sua forma non è nota. Per registrazioni tipate supportate e tipi di payload SDK, consulta il riferimento all'estensioneNode.js connettore.
Tipi di associazioni
Il trigger Connector supporta questi tipi di parametri Python:
| Tipo | Description |
|---|---|
str |
Riceve il corpo dell'evento come stringa JSON. |
dict |
Accettato come annotazione, ma il convertitore grezzo non analizza le stringhe JSON nei dizionari. Per analizzare il JSON grezzo, assegna e str usa json.loads. |
bytes |
Riceve il corpo dell'evento come byte raw. |
typing.List[str] o typing.List[bytes] |
Riceve eventi connettori consegnati separatamente come elenco quando il polling utilizza cardinality=func.Cardinality.MANY. Importa List da typing per queste annotazioni. |
| Annotazione Connector SDK supportata | Utilizza un convertitore registrato da azurefunctions-extensions-connectors per deserializzare il payload in un elenco di modelli SDK specifici per l'operazione. |
Per i binding SDK, annota il parametro con il tipo di binding supportato o un elenco di quel tipo, come list[office365.GraphClientReceiveMessage]. Le associazioni SDK supportate restituiscono elenchi sia per invocazioni a singolo evento che per batch. Per il polling a batch, il convertitore appiattisce gli eventi di trasporto e i loro elementi di payload in un'unica lista.
Imposta cardinality=func.Cardinality.MANY il decoratore per abilitare il batching di invocazione. Un'annotazione di elenco da sola non abilita il batching. L'impostazione di dimensione batch conta gli eventi del connettore, non gli elementi all'interno del payload di un evento o il numero di modelli nell'elenco restituito.
L'accesso alla connessione e l'autorizzazione al callback sono separati. Il Namespace del Connettore gestisce automaticamente il proprio accesso alla connessione del connettore gestito. Configura l'accesso dell'app funzionale in base alla modalità di consegna.
Attributes
L'attributo ConnectorTrigger supporta le seguenti proprietà quando DeliveryMode è impostato su ConnectorTriggerDeliveryMode.Poll:
| Property | Required | Predefinito | Description |
|---|---|---|---|
DeliveryMode |
Sì, per il sondaggio | ConnectorTriggerDeliveryMode.Webhook |
Impostato su ConnectorTriggerDeliveryMode.Poll per usare il sondaggio. |
Connection |
Yes | null |
Identifica il prefisso di configurazione per l'endpoint di polling del Namespace del Connettore e le impostazioni di identità. Ad esempio, "ConnectorNamespace" seleziona ConnectorNamespace__pollingEndpoint. |
TriggerConfigName |
Yes | null |
Il nome della configurazione del trigger di polling nel Spazio dei nomi del connettore. Fornisci direttamente il nome oppure usa un'espressione di impostazione dell'app come "%OnNewEmailTriggerConfigName%". |
IsBatched |
No | false |
Se ogni invocazione riceve un lotto di eventi connettori. Quando false, ogni invocazione riceve un evento. Imposta su true e usa un parametro dell'array per ricevere batch. I lotti vengono elaborati uno alla volta per ogni ascoltatore. |
MaxBatchSize |
No | 1 |
Massimo eventi di connettore per invocazione, da 1 a 32. Quando omesso o impostato su 0, utilizza l'impostazione dell'host defaultMaxBatchSize , che predefinisce su 1 se non è configurato diversamente in host.json. La dimensione effettiva del lotto deve essere 1 quando IsBatched è false. |
MaxConcurrentCalls |
No | 16 |
Compiti massimi di elaborazione simultanea a singolo evento per ascoltatore su un'istanza, inclusa preparazione, invocazione e conferma. Deve essere non negativo. Quando omesso o impostato su 0, utilizza l'impostazione dell'host defaultMaxConcurrentCalls , che predefinisce su 16 se non è configurato diversamente in host.json. Si applica solo quando IsBatched è false. Le invocazioni batched elaborano un batch alla volta per ogni ascoltatore. |
TargetPendingEventThreshold |
No | 16 |
Numero desiderato di eventi connettori in sospeso per istanza per scalabilità basata su target. Deve essere non negativo. Quando omesso o impostato su 0, utilizza l'impostazione dell'host defaultTargetPendingEventThreshold , che predefinisce su 16 se non è configurato diversamente in host.json. Il runtime può sovrascrivere questo obiettivo di scala. Questa proprietà non modifica la dimensione del batch né la concorrenza di invocazione. |
Per le impostazioni predefinite a livello di app, consulta Impostazioni di sondaggio host.json. La dimensione del batch conta gli eventi dei connettori, non gli elementi all'interno del payload di un evento.
Decoratori di sondaggi
Imposta delivery_mode=func.DeliveryMode.POLL@app.connector_trigger e configura la connessione di sondaggio e la configurazione del trigger:
| Parametro | Required | Predefinito | Description |
|---|---|---|---|
arg_name |
Yes | None | Identifica il parametro di funzione che riceve il payload. |
delivery_mode |
Sì, per il sondaggio | func.DeliveryMode.WEBHOOK |
Impostato su func.DeliveryMode.POLL per usare il sondaggio. Le corde "Poll" e "Webhook" sono anch'esse supportate. |
connection |
Yes | None | Identifica il prefisso delle impostazioni per l'endpoint di polling e le impostazioni di identità. Ad esempio, "ConnectorNamespace" seleziona ConnectorNamespace__pollingEndpoint. |
trigger_config_name |
Yes | None | Identifica la configurazione del trigger di sondaggio. Fornisci direttamente il nome oppure usa un'espressione di impostazione dell'app come "%OnNewEmailTriggerConfigName%". |
cardinality |
No | func.Cardinality.ONE |
Impostato su func.Cardinality.MANY o "many" per abilitare il batching di invocazione. Le invocazioni in batch vengono elaborate una alla volta per ogni ascoltatore. |
max_batch_size |
No | Host predefinito: 1 |
Massimo eventi di connettore per invocazione, da 1 a 32. Quando viene omesso o impostato su 0, si usa defaultMaxBatchSize da host.json. Senza batching, la dimensione effettiva del lotto deve essere 1. |
max_concurrent_calls |
No | Host predefinito: 16 |
Massimo di attività di elaborazione a singolo evento simultaneo per ascoltatore su un'istanza. Quando viene omesso o impostato su 0, si usa defaultMaxConcurrentCalls da host.json. Deve essere non negativo. Non si applica alle invocazioni a batch. |
target_pending_event_threshold |
No | Host predefinito: 16 |
Indirizza gli eventi pendenti per ogni istanza per scalare basato su target. Quando viene omesso o impostato su 0, si usa defaultTargetPendingEventThreshold da host.json. Deve essere non negativo. Non modifica la dimensione del batch o la concorrenza di invocazione; l'esecuzione può sovrascrivere l'obiettivo di scala. |
Per le impostazioni predefinite a livello di app, consulta Impostazioni di sondaggio host.json. Per le forme dei parametri e le annotazioni SDK, vedi Tipi di binding.
Opzioni di registrazione per il voto
Imposta deliveryMode: 'Poll' su un helper nominato, l'helper generico connectorTrigger , oppure app.connectorTrigger, e configura la connessione di interrogazione e la configurazione del trigger:
| Option | Required | Predefinito | Description |
|---|---|---|---|
deliveryMode |
Sì, per il sondaggio | 'Webhook' |
Impostato su 'Poll' per usare il sondaggio. |
connection |
Yes | None | Identifica il prefisso delle impostazioni per l'endpoint di polling e le impostazioni di identità. Ad esempio, 'ConnectorNamespace' seleziona ConnectorNamespace__pollingEndpoint. |
triggerConfigName |
Yes | None | Identifica la configurazione del trigger di sondaggio. Fornisci direttamente il nome oppure usa un'espressione di impostazione dell'app come '%OnNewEmailTriggerConfigName%'. |
cardinality |
No | 'one' |
Imposta su 'many' per abilitare il batching di invocazione. Le invocazioni in batch vengono elaborate una alla volta per ogni ascoltatore. |
maxBatchSize |
No | Host predefinito: 1 |
Massimo eventi di connettore per invocazione, da 1 a 32. Quando viene omesso o impostato su 0, si usa defaultMaxBatchSize da host.json. Senza batching, la dimensione effettiva del lotto deve essere 1. |
maxConcurrentCalls |
No | Host predefinito: 16 |
Massimo di attività di elaborazione a singolo evento simultaneo per ascoltatore su un'istanza. Quando viene omesso o impostato su 0, si usa defaultMaxConcurrentCalls da host.json. Deve essere non negativo. Non si applica alle invocazioni a batch. |
targetPendingEventThreshold |
No | Host predefinito: 16 |
Indirizza gli eventi pendenti per ogni istanza per scalare basato su target. Quando viene omesso o impostato su 0, si usa defaultTargetPendingEventThreshold da host.json. Deve essere non negativo. Non modifica la dimensione del batch o la concorrenza di invocazione; l'esecuzione può sovrascrivere l'obiettivo di scala. |
Per le impostazioni predefinite a livello di app, consulta Impostazioni di sondaggio host.json. Per le forme di input del gestore, vedi Tipi di binding.
Endpoint di interrogazione
L'impostazione di connessione della funzione seleziona il prefisso per l'endpoint di polling. Ad esempio, il prefisso "ConnectorNamespace" utilizza ConnectorNamespace__pollingEndpoint. Definisci questa impostazione sotto Values inlocal.settings.json per lo sviluppo locale o nelle impostazioni dell'app per una funzione applicata distribuita, come mostrato negli esempi di sondaggio.
Recupera l'endpoint di polling dal portale Connector Namespace, oppure derivalo dal servizio generato pollingEndpoints.receiveUri dalla configurazione del trigger come segue. Sostituisci i segnaposto con i valori delle risorse.
Richiede interfaccia della riga di comando di Azure, jq, e sed.
triggerConfigId="/subscriptions/<subscription-id>/resourceGroups/<resource-group>/providers/Microsoft.Web/connectorGateways/<namespace-name>/triggerConfigs/<trigger-config-name>"
triggerConfig=$(az rest --method get \
--url "${triggerConfigId}?api-version=2026-05-01-preview" \
--query '{receiveUri:properties.pollingEndpoints.receiveUri,name:name}' \
--output json)
receiveUri=$(printf '%s' "$triggerConfig" | jq -r '.receiveUri')
pollingEndpoint=$(printf '%s' "$receiveUri" |
sed -E 's#/(api/)?trigger[Cc]onfigs/[^/]+/receive$##')
triggerConfigName=$(printf '%s' "$triggerConfig" | jq -r '.name')
printf '%s\n' "ConnectorNamespace__pollingEndpoint=$pollingEndpoint" \
"OnNewEmailTriggerConfigName=$triggerConfigName"
Ricava l'impostazione dall'URI di ricezione generato dal servizio come segue:
Servizio pollingEndpoints.receiveUri |
<Connection>__pollingEndpoint |
|---|---|
https://<connector-namespace-host>/api/triggerconfigs/<name>/receive |
https://<connector-namespace-host> |
https://<host>/api/connectorGateways/<id>/triggerconfigs/<name>/receive |
https://<host>/api/connectorGateways/<id> |
Preserva l'identificatore host e gateway fornito dal servizio; non indovinare un nome host né configurare l'URL di ricezione completo, un percorso operativo, una base standalone /api o una stringa di query.
L'estensione utilizza questo endpoint con il nome di configurazione del trigger per costruire gli URL delle operazioni di polling. Per le credenziali e le politiche di accesso necessarie per chiamare questi URL, vedi Interrogazione dell'autenticazione.
Configurazione del trigger di polling
Il nome della configurazione del trigger della funzione identifica la configurazione da cui ricevere gli eventi.
Interrogazione dei valori di configurazione dei trigger
| Valore di configurazione | Description |
|---|---|
| Connessione | La connessione autorizzata al connettore gestito, come Office 365 Outlook o SharePoint Online. Questo è separato dall'impostazione di connessione della funzione, che identifica un prefisso app-settings. |
| Nome dell'operazione | L'operazione di innesco del connettore, come OnNewEmailV3 o GetOnNewFileItems. |
| Parameters | Valori richiesti dall'operazione, come una cartella Outlook o un sito SharePoint e una libreria di documenti. |
| Nome della configurazione del trigger | Il nome di questa configurazione di trigger di polling, richiamato direttamente dalla funzione o tramite un'impostazione dell'app. |
| Modalità di consegna | Come gli eventi vengono erogati dai servizi, tramite sondaggi o modalità webhook. |
Crea una configurazione di trigger di polling
Se non hai già un namespace per connettori, crea uno spazio per connettori.
Vai al portale Connector Namespace, poi seleziona il tuo namespace.
Nel menu dello spazio dei nomi, seleziona Trigger, poi seleziona Crea.
Trova il connettore gestito che vuoi usare e poi seleziona l'evento che dovrebbe attivare la funzione.
Nella pagina di configurazione dei trigger, crea una connessione o seleziona una connessione esistente. La creazione di una connessione richiede un'autenticazione una tantum con il servizio esterno.
Fornisci gli input richiesti dall'evento. Ad esempio, l'evento Office 365 Outlook nuova email richiede che la cartella monitori i nuovi messaggi.
Per il tipo di destinazione, scegli Funzioni di Azure.
Per la modalità di consegna, scegli Sondaggio.
Controllare la configurazione e quindi selezionare Crea.
Verifica dell'autenticazione tramite interrogatorio
Per il sondeggio, concede una policy di accesso a livello di connessione all'identità gestita dell'app di funzione (distribuita) o alla tua identità di sviluppatore (locale). L'host delle funzioni utilizza le credenziali Microsoft Entra di questa identità per ricevere e confermare gli eventi tramite l'endpoint di sondaggio. L'accesso alla connessione del Connector Namespace viene gestito automaticamente.
La policy del chiamante concede l'accesso alla connessione del connettore gestito, non allo spazio dei nomi stesso. L'accesso o l'abilitazione di un'identità gestita non concedono automaticamente al chiamante questo accesso.
A differenza della consegna tramite webhook, il polling non richiede un URL di callback pubblico né una chiave di sistema dell'app funzionale perché l'app di funzione recupera eventi dal namespace invece di ricevere callback.
Le impostazioni di autenticazione nelle sottosezioni seguenti utilizzano il prefisso ConnectorNamespace, corrispondente agli esempi di trigger. Se la tua funzione utilizza un prefisso diverso per l'impostazione della connessione, usa invece quel prefisso.
Concedere politiche di accesso
Usa uno dei due metodi per concedere al chiamante di interrogazione l'accesso alla connessione. È necessario il permesso per gestire le politiche di accesso sulla connessione. Utilizza l'ID principale (oggetto) del chiamante, non l'ID dell'applicazione (client).
- Portale
- interfaccia della riga di comando di Azure
- Vai al portale Connector Namespace, poi seleziona il tuo namespace.
- Apri Connessioni e seleziona la connessione connettore gestita utilizzata dalla configurazione del trigger di sondaggio.
- Apri la scheda Politiche di accesso della connessione.
- Aggiungi una policy di accesso per l'identità del chiamante. Per lo sviluppo locale, usa l'ID oggetto del tuo account sviluppatore. Per un'app di funzione distribuita, utilizza l'ID principale (oggetto) dell'identità gestita che la tua app utilizza.
- Verifica che il chiamante abbia una policy di accesso sulla connessione.
Sviluppo locale
- Accedi con la tua identità di sviluppatore, ad esempio eseguendo
az login. Questo è l'account Microsoft Entra che l'estensione utilizza per autenticare localmente le richieste di sondaggio. - Concedere una policy di accesso alla connessione connettore gestita per quell'identità. Effettuare il solo login non concede l'accesso alla connessione.
- Definisci le impostazioni di connessione sotto
Valueslocal.settings.json. OmettereConnectorNamespace__credentialdi usare le credenziali dello sviluppatore.
App di funzione distribuita
- Abilita un'identità gestita assegnata dal sistema nell'app di funzione, oppure assegna un'identità gestita assegnata dall'utente.
- Concedere una policy di accesso alla connessione connettore gestita per quell'identità.
- Configura le seguenti impostazioni di autenticazione nelle impostazioni dell'app di funzione:
| Impostazione app | Value |
|---|---|
ConnectorNamespace__credential |
managedidentity |
ConnectorNamespace__clientId |
L'ID client dell'identità gestita assegnata dall'utente da utilizzare per il sondaggio. Impostato solo quando si utilizza un'identità assegnata dall'utente. |
In alternativa, imposta ConnectorNamespace__managedIdentityResourceId l'ID della risorsa dell'identità assegnata dall'utente invece di impostare ConnectorNamespace__clientId. Per un'identità assegnata dal sistema, ometti entrambi i selettori.
Utilizzo nei sondaggi
L'host Functions si collega in uscita allo spazio dei nomi del connettore per interrogare eventi e confermare le invocazioni riuscite. L'estensione trasmette gli eventi alla tua funzione; non scrivi un ciclo di sondaggio.
La consegna è almeno una volta. Le invocazioni fallite non vengono riconosciute e gli eventi possono essere riconsegnati dopo la scadenza del blocco gestito dal servizio. Rendere l'elaborazione idempotente.
Se usi ConnectorEvent<T>.MessageId per la deduplicazione, impostalo al namespace e alla configurazione dei trigger; non dare per scontato che gli ID dei messaggi siano unici tra i trigger.
Impostati DeliveryMode = ConnectorTriggerDeliveryMode.Poll su [ConnectorTrigger], e fornisce le Connection proprietà e TriggerConfigName . Consulta gli esempi di sondaggi.
Per le proprietà degli attributi, i valori supportati e i valori predefiniti, vedi Interrogazione delle proprietà degli attributi.
Imposta delivery_mode=func.DeliveryMode.POLL su @app.connector_trigger, e fornisci connection e trigger_config_name. Consulta gli esempi di sondaggi.
L'host riceve un evento per ogni invocazione a meno che cardinality=func.Cardinality.MANY non venga abilitato il batching. Per i lotti grezzi, utilizzare typing.List[str] le annotazioni SDK supportate o typing.List[bytes]; fornire un elenco di modelli. Per opzioni, valori supportati e valori predefiniti, consulta Addetti ai decoratori dei sondaggi.
Imposta deliveryMode: 'Poll', e fornisci connection e triggerConfigName nelle opzioni di registrazione. Consulta gli esempi di sondaggi.
L'host riceve un evento per ogni invocazione a meno che cardinality: 'many' non venga abilitato il batching. Gli aiutanti nominati e generici combinano gli elementi del payload di tutti gli eventi in un unico contesto. I gestori diretti app.connectorTrigger invece ricevono l'array di eventi esterno. Per opzioni, valori supportati e impostazioni predefinite, vedi Opzioni di registrazione per il sondaggio.
Ridimensionamento e concorrenza
Consegna tramite Webhook
In modalità webhook, il Connector Namespace invia richieste HTTP all'endpoint di callback dell'estensione. I trigger dei connettori scalano come quelli HTTP, in base al comportamento e ai limiti di scalabilità HTTP del piano hosting. Per dettagli, vedi Event-driven scaling in Funzioni di Azure.
Distribuzione dei sondaggi
In modalità polling, il Connector Trigger utilizza una scalabilità basata su target basata sull'arretrato stimato degli eventi per la configurazione del trigger nel Spazio dei Nomi del Connettore. Il target di scalabilità è indipendente dalla concorrenza di elaborazione per istanza e dalla dimensione del batch. Per l'equazione di scaling, le impostazioni di configurazione e le linee guida di tuning, vedi Managed connectors targeting scaling (scalabilità target-basata).
Registration
Usa la funzione generica connectorTrigger per un'operazione che non ha una registrazione specifica per il connettore:
import { InvocationContext } from '@azure/functions';
import {
connectorTrigger,
ConnectorTriggerContext,
} from '@azure/functions-extensions-connectors';
connectorTrigger('OnConnectorEvent', {
handler: async (
context: ConnectorTriggerContext,
invocationContext: InvocationContext,
) => {
invocationContext.log(JSON.stringify(context.rawPayload));
},
});
La registrazione generica predefinisce il tipo di articolo a unknown. Valida il payload prima di accedere alle proprietà specifiche dell'operazione. Configura il connettore, il funzionamento, i parametri operativi, la funzione di destinazione e l'autenticazione di callback nella configurazione del trigger in Azure Connector Namespace.
Registration
Usa la funzione generica connectorTrigger per un'operazione che non ha una registrazione specifica per il connettore:
const {
connectorTrigger,
} = require('@azure/functions-extensions-connectors');
connectorTrigger('OnConnectorEvent', {
handler: async (context, invocationContext) => {
invocationContext.log(JSON.stringify(context.rawPayload));
},
});
La registrazione generica normalizza l'inviluppo di callback ma non convalida la forma specifica del payload operazionale. Valida il payload prima di accedere alle proprietà specifiche dell'operazione. Configura il connettore, il funzionamento, i parametri operativi, la funzione di destinazione e l'autenticazione di callback nella configurazione del trigger in Azure Connector Namespace.
Decorators
Applica connector_trigger alla funzione che riceve il payload evento:
import azure.functions as func
app = func.FunctionApp()
@app.function_name(name="OnConnectorEvent")
@app.connector_trigger(arg_name="payload")
def on_connector_event(payload: str) -> None:
# Process the raw JSON payload.
pass
Il arg_name valore identifica il parametro di funzione che riceve il payload. Configura il connettore, il funzionamento, i parametri operativi, la funzione di destinazione e l'autenticazione di callback nella configurazione del trigger in Azure Connector Namespace.
Attributes
A differenza del polling, la consegna tramite webhook non richiede proprietà aggiuntive sull'attributo [ConnectorTrigger] perché webhook è la modalità di consegna predefinita. Puoi anche impostare DeliveryMode = ConnectorTriggerDeliveryMode.Webhook esplicitamente. Le proprietà specifiche per il suffragio non si applicano alla consegna tramite webhook.
Configurazione del trigger webhook
L'URL di callback della configurazione del trigger identifica la funzione di destinazione.
Valori di configurazione dei trigger Webhook
| Valore di configurazione | Description |
|---|---|
| Connessione | La connessione autorizzata al connettore gestito, come Office 365 Outlook o SharePoint Online. |
| Nome dell'operazione | L'operazione di innesco del connettore, come OnNewEmailV3 o GetOnNewFileItems. |
| Parameters | Valori richiesti dall'operazione, come una cartella Outlook o un sito SharePoint e una libreria di documenti. |
| URL di richiamo | L'estensione Connector webhook endpoint per la funzione di destinazione. Vedi autenticazione Webhook. |
| Nome della funzione | Il nome della funzione registrata nel codice dell'app. |
| Authentication | La configurazione di autenticazione utilizzata per chiamare l'app di funzione. |
Il functionName valore della stringa di query nell'URL di callback deve corrispondere al nome della funzione registrata. I nomi validi delle funzioni webhook contengono da 1 a 128 lettere, numeri, sottolineamenti o trattini.
Crea una configurazione di trigger webhook
Crea una configurazione di trigger usando interfaccia della riga di comando di Azure o il portale Connector Namespace.
Configurazione del trigger
Una configurazione di trigger in Azure Connector Namespace associa un evento di servizio esterno al callback della funzione di destinazione.
Valori di configurazione dei trigger
| Valore di configurazione | Description |
|---|---|
| Connessione | La connessione autorizzata al connettore gestito, come Office 365 Outlook o SharePoint Online. |
| Nome dell'operazione | L'operazione di innesco del connettore, come OnNewEmailV3 o GetOnNewFileItems. |
| Parameters | Valori richiesti dall'operazione, come una cartella Outlook o un sito SharePoint e una libreria di documenti. |
| URL di richiamo | L'estensione Connector webhook endpoint per la funzione di destinazione. Vedi autenticazione Webhook. |
| Nome della funzione | Il nome della funzione registrata nel codice dell'app. |
| Authentication | La configurazione di autenticazione utilizzata per chiamare l'app di funzione. |
Il functionName valore della stringa di query nell'URL di callback della configurazione del trigger deve corrispondere al nome della funzione registrata. I nomi validi delle funzioni contengono da 1 a 128 lettere, numeri, sottolinee o trattini.
Il nome dell'operazione è definito dal connettore gestito. Scegli il nome della funzione nel tuo codice e la configurazione del trigger mappa l'operazione a quella funzione. Gli esempi in questo articolo utilizzano queste mappazi:
| Evento connettore | Nome dell'operazione | Nome della funzione |
|---|---|---|
| Email di nuova Office 365 Outlook | OnNewEmailV3 |
OnNewEmail |
| Nuovo file SharePoint Online | GetOnNewFileItems |
OnSharepointNewFile |
| Nuovo messaggio del canale Microsoft Teams | OnNewChannelMessage |
OnNewChannelMessage |
| Evento connettore selezionato | L'operazione selezionata nella configurazione del trigger | OnConnectorEvent |
| Evento connettore | Nome dell'operazione | Nome della funzione |
|---|---|---|
| Email di nuova Office 365 Outlook | OnNewEmailV3 |
OnNewEmail |
| Nuovo file SharePoint Online | GetOnNewFileItems |
OnSharepointNewFile |
| Evento connettore selezionato | L'operazione selezionata nella configurazione del trigger | OnConnectorEvent |
Crea una configurazione di trigger
Crea una configurazione di trigger usando interfaccia della riga di comando di Azure o il portale Connector Namespace.
Prima che l'estensione possa ricevere un evento, crea queste risorse e configurazioni:
- Un namespace dei connettori.
- Una connessione connettore gestita autorizzata ad accedere al servizio esterno.
- Una configurazione del trigger che seleziona l'evento del connettore, i parametri operativi e la modalità di consegna.
Per la consegna tramite webhook, la configurazione del trigger include anche l'URL di callback e l'autenticazione di callback.
Le configurazioni dei trigger sono risorse del Namespace del Connettore che puoi anche distribuire tramite ARM o Bicep.
Gli esempi di interfaccia della riga di comando di Azure qui sotto utilizzano un'app di funzione distribuita. Distribuisci l'app con l'estensione e la funzione di destinazione prima di eseguirle.
- interfaccia della riga di comando di Azure (Bash)
- interfaccia della riga di comando di Azure (PowerShell)
- Portale
Il seguente esempio di Bash utilizza interfaccia della riga di comando di Azure e jq per creare un trigger Office 365 Outlook nuova email. Sostituisci i valori segnaposto delle tue risorse e della tua connessione:
resourceGroup="<RESOURCE_GROUP>"
namespaceName="<CONNECTOR_NAMESPACE>"
functionAppName="<FUNCTION_APP>"
functionName="OnNewEmail"
triggerName="<TRIGGER_NAME>"
connectionName="<CONNECTION_NAME>"
connectorName="office365"
operationName="OnNewEmailV3"
subscriptionId=$(az account show --query id --output tsv)
connectorKey=$(az functionapp keys list \
--resource-group "$resourceGroup" \
--name "$functionAppName" \
--query "systemKeys.connector_extension" \
--output tsv)
callbackUrl="https://${functionAppName}.azurewebsites.net/runtime/webhooks/connector?functionName=${functionName}"
notificationFile=$(mktemp)
trap 'rm -f "$notificationFile"' EXIT
jq -n \
--arg callbackUrl "$callbackUrl" \
--arg connectorKey "$connectorKey" \
'{
callbackUrl: $callbackUrl,
authentication: {
type: "QueryString",
name: "code",
value: $connectorKey
}
}' > "$notificationFile"
az connector-namespace trigger create \
--resource-group "$resourceGroup" \
--namespace "$namespaceName" \
--name "$triggerName" \
--connection-details "{connectionName:${connectionName},connectorName:${connectorName}}" \
--operation-name "$operationName" \
--parameters "[{name:folderPath,value:'Inbox'}]" \
--notification-details "@$notificationFile" \
--description "${connectorName} ${operationName} -> ${functionName}" \
--metadata "{destinationType:functionApp,functionAppName:${functionAppName},functionAppResourceGroup:${resourceGroup},functionAppSubscriptionId:${subscriptionId},functionName:${functionName},recurrenceFrequency:Minute,recurrenceInterval:'5'}"
rm -f "$notificationFile"
trap - EXIT
Il --parameters valore è specifico per l'operazione del connettore. In questo esempio, folderPath seleziona la cartella Outlook da monitorare. L'URL di callback non contiene la chiave di sistema. L'oggetto notificationDetails.authentication aggiunge la chiave come segreto di query quando il Namespace del Connettore invoca la funzione.
Autenticazione Webhook
Il Namespace del Connettore invia eventi all'app di funzione, invece che l'app di funzione interroghi il namespace. Per impostazione predefinita, l'host Functions autentica questi callback validando la chiave di sistema dell'estensione Connector, denominata connector_extension.
Il Namespace Connettore gestisce automaticamente l'accesso alla connessione connettore gestita. A differenza del polling, l'identità dell'app di funzione non necessita di una politica di accesso alla connessione esclusivamente per ricevere callback webhook; la chiave di sistema autorizza tali richieste all'app di funzione.
Webhook callback URL
App distribuita
Usa l'endpoint di callback dell'estensione, senza una chiave nell'URL:
https://<FUNCTION_APP_HOSTNAME>/runtime/webhooks/connector?functionName=<FUNCTION_NAME>
Il functionName valore deve corrispondere al nome della funzione registrata: l'attributo [Function] in C#, il @app.function_name decoratore in Python o la registrazione del trigger in Node.js.
Per un'app distribuita con autenticazione predefinita, utilizza il tasto di sistema dell'estensione connector_extension Connector, non un singolo tasto di funzione. Dopo aver distribuito l'app di funzione con l'estensione, recupera la chiave di sistema:
az functionapp keys list \
--resource-group <RESOURCE_GROUP> \
--name <FUNCTION_APP_NAME> \
--query "systemKeys.connector_extension" \
--output tsv
Nella configurazione del trigger, memorizza la chiave in notificationDetails.authentication, separatamente dall'URL di callback:
{
"notificationDetails": {
"callbackUrl": "https://<FUNCTION_APP_HOSTNAME>/runtime/webhooks/connector?functionName=<FUNCTION_NAME>",
"authentication": {
"type": "QueryString",
"name": "code",
"value": "<CONNECTOR_EXTENSION_KEY>"
}
}
}
Quando si esegue un evento, il Connector Namespace aggiunge la chiave come parametro code query-string. Mantenere la chiave separata dall'URL di callback salvato permette al portale di mascherarla come segreto. Non includere la chiave nell'URL di callback salvato né compilarla nel controllo sorgente.
Le configurazioni di trigger esistenti che includono la chiave nell'URL di callback continuano a funzionare. Quando modifichi e salvi una configurazione di trigger esistente, la chiave viene spostata in notificationDetails.authentication.
I tasti di sistema non possono essere definiti per ogni trigger e richiedono una rotazione coordinata tra l'app funzione e lo spazio dei nomi del connettore. Per i callback basati sull'identità senza chiave condivisa, vedi Autenticazione integrata.
Sviluppo locale di webhook
I callback Webhook devono raggiungere il tuo host delle funzioni in esecuzione dal namespace Connector. Quando esegui localmente:
Avvia l'app di funzioni con Funzioni di Azure Core Tools, abilitando l'autorizzazione:
func start --enableAuthImportante
Usa
--enableAuthsempre quando esponi la tua app tramite un dev tunnel. Senza di essa, il tuo endpoint di funzione è completamente non autenticato sul sito pubblico internet.Utilizza un tunnel di sviluppo Microsoft per inoltrare un endpoint HTTPS pubblico alla porta host locale delle Funzioni. Imposta la visibilità della porta del tunnel su Pubblica così che il namespace del connettore possa raggiungerla.
Compila l'URL di callback con il nome host del tunnel e il nome della funzione registrata, e usalo nella configurazione del trigger webhook. Ad esempio, una porta di inoltro tunnel 7071 verso la
OnNewFilefunzione utilizza un URL come:https://<tunnel-id>-7071.usw2.devtunnels.ms/runtime/webhooks/connector?functionName=OnNewFilePer un host locale che memorizza segreti in Azurite, recupera la chiave di
connector_extensionsistema utilizzando questi comandi PowerShell. Impostato$connStrsulla nota stringa di connessione Azurite:$connStr = "<azurite-connection-string>" # Find the most recent host.json blob $blobs = az storage blob list --container-name azure-webjobs-secrets --connection-string $connStr -o json | ConvertFrom-Json $blobName = ($blobs | Where-Object { $_.name -match '(^|/)host\.json$' } | Sort-Object { $_.properties.lastModified } | Select-Object -Last 1).name # Download and parse az storage blob download --container-name azure-webjobs-secrets --name $blobName --connection-string $connStr --file host-keys.json --no-progress $keys = Get-Content host-keys.json | ConvertFrom-Json $connectorKey = ($keys.systemKeys | Where-Object { $_.name -eq "connector_extension" }).value Remove-Item -LiteralPath host-keys.jsonMemorizza separatamente la chiave di sistema dell'host
connector_extensionlocale innotificationDetails.authentication, utilizzando ilQueryStringformato di autenticazione mostrato sopra.Mantieni l'host e il tunnel in funzione durante i test. Aggiorna la configurazione del trigger se il nome host del tunnel cambia.
Autenticazione predefinita
Per i callback webhook senza chiavi condivise, utilizza l'autenticazione integrata dell'App Service (chiamata anche Easy Auth) con un'identità gestita. Questa configurazione è indipendente dal linguaggio di programmazione della funzione.
Il Namespace del Connettore utilizza la sua identità gestita assegnata dal sistema o dall'utente per richiedere un token Microsoft Entra ID per ogni callback. L'autenticazione integrata convalida il token e l'identità del chiamante prima che la richiesta raggiunga l'host delle funzioni. Per un'implementazione end-to-end senza segreti client, consulta l'esempio di autenticazione integrata.
Questa sezione tratta l'autenticazione dal namespace all'app di funzione. Il Namespace Connettore gestisce automaticamente l'accesso alla connessione connettore gestita. Per l'autenticazione ai servizi upstream, consulta la panoramica dei connettori Azure.
Configurazione dell'app per le funzioni
Importante
Questa configurazione richiede l'autenticazione sull'intera app di funzione, non solo /runtime/webhooks/connector, e limita l'accesso all'identità di callback del namespace. Le funzioni HTTP esistenti che richiedono tasti funzione continuano a richiederle oltre all'autenticazione a livello di app. Prima di applicare questa configurazione a un'app esistente, assicurati che i client API e le sonde di salute soddisfino la policy di autenticazione e autorizzazione a livello di app e qualsiasi requisito di chiave a livello di funzione. Altrimenti, le richieste possono fallire con HTTP 401 o 403. Se l'app deve accettare altri chiamanti, adatta la policy di autorizzazione invece di copiare questa lista di autorizzazione invariata. Per le opzioni di policy, vedi Configura l'autorizzazione Microsoft Entra.
Configura l'autenticazione integrata tramite la risorsa ARM dellauthsettingsV2'app di funzione o il suo equivalente in Bicep. L'esempio utilizza le seguenti impostazioni chiave:
| Setting | Purpose |
|---|---|
platform.enabled: true |
Abilita l'autenticazione integrata. |
globalValidation.requireAuthentication: true |
Richiede l'autenticazione prima che le richieste raggiungano l'host delle funzioni. |
globalValidation.unauthenticatedClientAction: Return401 |
Restituisce HTTP 401 per callback non autenticati invece di reindirizzare a una pagina di accesso. |
identityProviders.azureActiveDirectory.enabled: true |
Abilita la validazione del token Microsoft Entra. |
registration.clientId |
L'ID dell'applicazione (client) della registrazione dell'app Microsoft Entra che rappresenta l'app funzionale. |
registration.openIdIssuer |
URL dell'emittente per il tenant: https://login.microsoftonline.com/{tenantId}/v2.0. |
validation.allowedAudiences |
L'ID client e l'URI identificatore dell'app Entra. I token devono avere un pubblico consentito nella aud rivendicazione. |
validation.defaultAuthorizationPolicy.allowedPrincipals.identities |
Gli ID degli oggetti (principal) consentivano di chiamare l'app di funzione. L'esempio consente solo l'identità gestita del callback dello spazio di nomi. Adatta questa policy se la tua app ha altri chiamanti. Un token valido con una oid richiesta non presente nella lista consentita viene negato con HTTP 403. |
Le registration impostazioni e validation in questa tabella sono sotto identityProviders.azureActiveDirectory.
L'esempio assegna inoltre un'identità gestita assegnata dall'utente all'app di funzione e la federa alla registrazione dell'app Entra. L'autenticazione integrata utilizza questa credenziale di identità federata per ottenere asserzioni client senza memorizzare un segreto cliente. L'esempio imposta l'impostazione OVERRIDE_USE_MI_FIC_ASSERTION_CLIENTID dell'app sull'ID client dell'identità dell'app di funzione e imposta registration.clientSecretSettingName sul nome di quell'impostazione.
L'identità dell'app di funzione utilizzata per la federazione è separata dall'identità di callback dello spazio dei nomi. L'identità dello spazio dei nomi è il chiamante consentito da allowedPrincipals.identities.
Dopo che l'autenticazione integrata è configurata per convalidare i callback, disabilita il check-in ridondante della chiave di sistemahost.json:
{
"version": "2.0",
"extensions": {
"connector": {
"system": {
"webhookAuthorizationLevel": "Anonymous"
}
}
}
}
Utilizzare Anonymous solo quando un altro livello di autenticazione convalida le richieste prima che raggiungano l'host delle funzioni. Questa impostazione non abilita la validazione del token da sola.
Configurazione dello spazio dei nomi del connettore
Abilita un'identità gestita assegnata dal sistema nel Namespace del Connettore oppure associa un'identità assegnata dall'utente. Nella configurazione notificationDetails.authenticationdel trigger , imposta:
| Property | Value |
|---|---|
type |
ManagedServiceIdentity |
audience |
L'ID client della registrazione dell'app Entra, che corrisponde a un pubblico accettato dall'app funzionale. |
identity |
L'ID della risorsa dell'identità gestita assegnata dall'utente collegato. Ometti questa proprietà per un'identità assegnata dal sistema. |
Il namespace utilizza quell'identità per ottenere un token e lo invia nell'intestazione del Authorization: Bearer <token> callback. Il token iss identifica il tenant, aud identifica l'app target e oid identifica l'identità gestita dello namespace.
Il namespace gestisce automaticamente il proprio accesso alla connessione connettore gestita. Questo accesso è separato dall'autorizzazione di callback, che si configura tramite l'autenticazione integrata nell'app di funzione.
Flusso di autenticazione e validazione
- Il Connector Namespace ottiene un token per l'audience configurata utilizzando la sua identità gestita da callback.
- Il namespace invia il token con l'evento all'endpoint webhook dell'estensione.
- L'autenticazione integrata convalida la firma, la scadenza, l'emittente e il pubblico del token e verifica che corrisponda
oida un'identità consentita. I token mancanti o non validi ricevono HTTP 401; i token validi da un'identità non presente nella lista consentita ricevono HTTP 403. - Solo le richieste autorizzate raggiungono l'host delle funzioni. Con il controllo ridondante della chiave di sistema disabilitato, l'estensione invoca la funzione di destinazione e lega il corpo dell'evento al suo parametro.
La tua funzione non necessita di codice applicativo per eseguire questi controlli di accesso.
Documentazione di autenticazione correlata
- Autenticazione e autorizzazione in Servizio app di Azure e Funzioni di Azure
- Configura il servizio app o l'app Funzioni di Azure per accedere con Microsoft Entra
- Configurazione basata su file nell'autenticazione del servizio App
- Federazione delle identità dei carichi di lavoro in Microsoft Entra ID
- Identità gestite per le risorse di Azure
Utilizzo di Webhook
Il Namespace del Connettore invia eventi all'endpoint webhook dell'estensione, dove il functionName valore query-string seleziona la funzione. L'estensione lega il corpo dell'evento al parametro della tua funzione; non implementi un gestore HTTP.
Il nome della funzione deve corrispondere al nome contenuto nel tuo [Function] attributo. I callback possono includere x-ms-* header che identificano la configurazione del trigger, la connessione, il tipo di evento e l'ID di correlazione, ma queste header non sono disponibili per la tua funzione tramite il Connector Trigger.
Usa [ConnectorTrigger] senza proprietà di sondaggio. Webhook è il predefinito quando ometti DeliveryMode. Consulta gli esempi di webhook.
La tua funzione può ricevere il payload dell'evento utilizzando uno qualsiasi dei tipi di binding .NET supportati.
L'estensione accetta HTTP POST e PUT richieste con il tipo di application/json contenuto. Un corpo di richiesta non vuoto deve contenere un JSON valido. Le richieste sono soggette al limite di richiesta host di Functions e ai limiti di servizio a monte; l'estensione non impone un limite separato di dimensione del payload.
Per configurare il limite del corpo della richiesta host, imposta l'impostazione dell'app a livello FUNCTIONS_REQUEST_BODY_SIZE_LIMIT dell'app in byte e riavvia l'host. Questa non è un'impostazione host.json e non modifica i download a output collegato di Poll, che utilizzano extensions.connector.maxLinkedOutputSizeInBytes. Limiti più elevati non garantiscono le dimensioni del payload supportate; tengono conto del buffering, della memoria di lavoro e dei limiti a monte.
Utilizzo di Webhook
L'aiutante generico riceve un ConnectorTriggerContext<T>. La sua payload proprietà contiene l'involucro di callback normalizzato, items contiene gli elementi degli eventi e rawPayload conserva l'input analizzato prima della normalizzazione. Le registrazioni specifiche per connettori forniscono array denominati, come emails, records, o messages.
Ogni invocazione gestisce un callback, che può contenere più elementi di payload. Per un'operazione senza una registrazione specifica del connettore, il tipo di elemento TypeScript è predefinito unknownsu . Valida il payload prima di accedere alle proprietà specifiche dell'operazione. Per le registrazioni tipate supportate, consulta il riferimento delle estensioniNode.js connettore.
Utilizzo di Webhook
Il trigger può associare il corpo della richiesta a str, dict, oppure bytes. Quando azurefunctions-extensions-connectors registra un convertitore per l'annotazione SDK della funzione, il worker invece deserializza il corpo della richiesta nel tipo specifico per l'operazione supportato.
Ogni invocazione gestisce un callback. I binding SDK supportati forniscono gli elementi del payload come elenco; usa un'annotazione come list[office365.GraphClientReceiveMessage]. Per le annotazioni specifiche per operazioni supportate, consulta la mappatura della firma operazionale.
L'estensione accetta HTTP POST e PUT richieste con il tipo di application/json contenuto. Un corpo di richiesta non vuoto deve contenere un JSON valido. Le richieste sono soggette al limite del corpo della richiesta host delle Funzioni, e ai limiti del servizio a monte.
Metadata
Il trigger Connector attualmente non espone le header di callback o altri metadati delle richieste come dati di binding. L'estensione definisce un contratto dati di binding vuoto, quindi la funzione riceve solo il corpo della richiesta JSON in un tipo di binding supportato dal linguaggio selezionato.