Creare un connettore personalizzato per App per la logica di Azure (SOAP) (anteprima)
[Questo argomento fa parte della documentazione di pre-rilascio, pertanto è soggetto a modifiche.]
Per integrare i servizi SOAP nei flussi di lavoro di App per la logica di Azure, è possibile creare e registrare un connettore SOAP (Simple Object Access Protocol) personalizzato usando WSDL (Web Services Descrizione Language) che descrive il servizio SOAP. I connettori SOAP funzionano come connettori predefiniti, quindi puoi utilizzarli allo stesso modo di altri connettori nelle app per la logica. Attualmente, i connettori personalizzati SOAP non supportano le operazioni unidirezionali.
Importante
- Questa è una funzionalità di anteprima.
- Le funzionalità di anteprima non sono destinate ad essere utilizzate per la produzione e sono soggette a restrizioni. Queste funzionalità sono disponibili prima di una versione ufficiale in modo che i clienti possano ottenere l'accesso iniziale e fornire dei commenti.
Prerequisiti
Per registrare il connettore SOAP, sono necessari:
Una sottoscrizione di Azure. Se non hai una sottoscrizione, puoi utilizzare un account di Azure gratuito. In alternativa, puoi iscriverti a una sottoscrizione con pagamento in base al consumo.
Uno dei seguenti:
- Un URL per un file WSDL che definisce il servizio SOAP e le API.
- Un file WSDL che definisce il servizio SOAP e le API.
Per questa procedura, puoi usare il nostro esempio, Servizi SOAP per ordini (
http://fazioapisoap.azurewebsites.net/FazioService.svc?singleWsdl).Facoltativo: un'immagine da usare come icona per il connettore personalizzato.
1. Crea il connettore
Nel portale di Azure nel menu principale di Azure seleziona Nuovo.
Nella casella di ricerca, immetti connettore app per la logica e quindi premi INVIO.
Nell'elenco dei risultati scegli Connettore per app per la logica > Crea.
Immetti i dettagli per la registrazione del connettore come descritto nella tabella. Al termine, seleziona la casella di controllo Aggiungi al dashboard , quindi seleziona Crea.
Proprietà Valore suggerito Descrzione Name soap-connector-name Immetti un nome per il connettore. Sottoscrizione Azure-subscription-name Seleziona la tua sottoscrizione di Azure. Resource group Azure-resource-group-name Crea o seleziona un gruppo di Azure per l'organizzazione delle risorse di Azure. Location deployment-region Seleziona la stessa area di Azure dell'app per la logica.
Dopo che Azure ha distribuito il connettore, viene aperto il menu del connettore app per la logica. In caso contrario, seleziona il connettore SOAP dal dashboard di Azure.
2. Definisci il connettore
Specifica ora il file WSDL o l'URL per creare il connettore, l'autenticazione usata dal connettore, nonché le azioni e i trigger forniti dal connettore SOAP.
2a. Specifica il file WSDL o l'URL per il connettore
Nel menu del connettore, se non è già selezionato, seleziona Connettore app per la logica.
Nella barra degli strumenti, seleziona Modifica.
Seleziona Generale per fornire i dettagli in queste tabelle per la creazione, la protezione e la definizione delle azioni e dei trigger per il connettore SOAP.
Per Connettori personalizzati, seleziona SOAP per Endpoint API per fornire il file WSDL che descrive l'API.
Opzione Formato Descrizione Carica WSDL da file File WSDL Passa al percorso del file WSDL e seleziona il file. Carica WSDL da URL http://path-to-wsdl-file Immetti l'URL per il file WSDL del servizio. Da SOAP a REST Non applicabile Trasforma le API nel servizio SOAP in API REST. Per Informazioni generali, carica un'icona per il tuo connettore.
In genere, i campi Descrizione, Host e URL di base vengono compilati automaticamente dal tuo file WSDL. In caso contrario, aggiungi queste informazioni come descritto nella tabella e quindi seleziona Continua.
Opzione o impostazione Formato Descrizione Carica icona png-or-jpg-file-under-1-MB Un'icona che rappresenta il tuo connettore Colore: preferibilmente un logo bianco su uno sfondo colorato.
Dimensioni: un logo di circa 160 × 160 pixel all'interno di un quadrato di 230 × 230 pixel
Colore di sfondo dell'icona icon-brand-color-hexadecimal-code Il colore dietro l'icona che corrisponde al colore di sfondo nel file icona. Formato: esadecimale. Ad esempio, #007ee5 rappresenta il colore blu.
Descrzione connector-description Immetti una breve descrizione per il tuo connettore. Organizzatore evento connector-host Immetti il dominio host per il servizio SOAP. URL di base connector-base-URL Immetti l'URL di base per il servizio SOAP.
2b. Descrivere l'autenticazione utilizzata dal connettore
Seleziona Sicurezza e quindi esamina o descrivi l'autenticazione utilizzata dal connettore. L'autenticazione garantisce che le identità degli utenti passano correttamente tra il tuo servizio e tutti i client.
Per impostazione predefinita, il Tipo di autenticazione del connettore è impostato per Nessuna autenticazione.
Per modificare il tipo di autenticazione, seleziona Modifica. Puoi selezionare Autenticazione di base. Per utilizzare le etichette di parametri diverse dai valori predefiniti, aggiornale in Etichetta parametro.
Per salvare il connettore dopo aver inserito le informazioni di sicurezza, seleziona nella parte superiore della pagina Aggiorna connettore, quindi seleziona Continua.
2c. Rivedere, aggiornare o definire le azioni e i trigger per il connettore
Seleziona Definizione quindi esamina, modifica o definisci nuove azioni e trigger che gli utenti possono aggiungere ai propri flussi di lavoro.
Le azioni e i trigger si basano sulle operazioni definite nel file WSDL, che popolano automaticamente la pagina Definizione e includono i valori di richiesta e risposta. Se le operazioni richieste sono già visualizzate, puoi andare al passaggio successivo del processo di registrazione senza apportare modifiche in questa pagina.
(Facoltativo) Se desideri modificare azioni e trigger esistenti o aggiungerne di nuovi, vai a un esempio di modifica della definizione API.
3. Termina la creazione del connettore
Quando sei pronto, seleziona Aggiorna connettore per distribuire il connettore.
Congratulazioni. Ora quando crei un'app per la logica, puoi trovare il connettore in Progettazione app per la logica e aggiungere quel connettore all'app per la logica.
Condividi il tuo connettore con altri utenti di App per la logica
I connettori personalizzati registrati ma non certificati funzionano come i connettori predefiniti con un'eccezione. Sono disponibili solo per l'autore del connettore e gli utenti che hanno lo stesso tenant Microsoft Entra ID e sottoscrizione di Azure per le app per la logica nell'area in cui vengono distribuite le app. Sebbene la condivisione sia facoltativa, potresti avere scenari in cui desideri condividere i tuoi connettori con altri utenti.
Importante
Se condividi un connettore, altri potrebbero iniziare a dipendere da quel connettore. L'eliminazione del connettore elimina tutte le connessioni a quel connettore.
Per condividere il connettore con utenti esterni al di fuori di questi limiti, ad esempio con tutti gli utenti di app per la logica, certifica il connettore. Per saperne di più, vai a Certificare il connettore.
Domande frequenti
D: Il connettore SOAP è generalmente disponibile?
D: Il connettore SOAP è in anteprima e non è ancora un servizio generalmente disponibile.
D: Esistono limitazioni o problemi noti relativi al connettore SOAP?
R: Sì. Per saperne di più, vai a Restrizioni del connettore SOAP e problemi noti.
D: Esistono limitazioni per i connettori personalizzati?
R: Sì. Per saperne di più, vai a Limiti del connettore personalizzato.
Richiedere supporto
Per supporto con lo sviluppo e l'onboarding o per richiedere funzionalità non disponibili nella procedura guidata di registrazione, contatta condevhelp@microsoft.com. Microsoft monitora questo account per domande e problemi degli sviluppatori e le indirizza al team appropriato.
Per porre o rispondere a domande o vedere cosa stanno facendo altri utenti di App per la logica, vai a Forum delle app per la logica di Azure.
Per migliorare le app per la logica, vota o invia idee al Sito di feedback degli utenti di App per la logica.
Informazioni correlate
Certificare il connettore
Domande frequenti sul connettore personalizzato per App per la logica di Azure, Power Automate e Power Apps
Inviare commenti
L'invio da parte degli utenti di feedback sui problemi riscontrati con la piattaforma di connettori o di idee su nuove funzionalità è molto apprezzato. Per fornire un feedback, vai a Inviare problemi o ottenere assistenza per i connettori e seleziona il tipo di commenti.