Definizione del modello ThingWorx in Composer > Modellazione > Connettori di integrazione > Creazione dei connettori di integrazione
Creazione dei connettori di integrazione
Per creare connettori di integrazione, attenersi alla procedura riportata di seguito.
1. In Composer selezionare MODELLAZIONE > Connettori integrazione, quindi fare clic su Nuovo.
2. Selezionare uno dei modelli di oggetto riportati di seguito, quindi fare clic OK.
◦ GenericConnector
◦ HTTPConnector
◦ ODataConnector
◦ SAPODataConnector
◦ SwaggerConnector
◦ WindchillSwaggerConnector
Per ulteriori informazioni sui modelli di oggetto precedenti, vedere Panoramica dei connettori di integrazione.
3. Immettere un nome e una descrizione.
4. A seconda del modello di oggetto selezionato, stabilire la connessione al sistema back-end nell'area Configurazione.
Configurazione dei modelli di oggetto
Modelli di oggetto
Descrizione
Impostazioni connessione connettore generico
• Intervallo di aggiornamento (min): specificare l'intervallo per l'aggiornamento della cache degli endpoint. Il valore di default è 60 minuti.
• Tipo di autenticazione: immettere uno dei valori riportati di seguito.
◦ Nessuno
◦ Fissa
Questo tipo di autenticazione richiede un account di servizio sull'applicazione back-end. Questo account non corrisponde a un utente effettivo; il suo scopo è consentire l'accesso a un'altra applicazione. Tutte le operazioni di accesso dalle applicazioni ThingWorx utilizzano questo account di servizio sull'applicazione back-end.
◦ SSO
Per ulteriori informazioni, vedere Autenticazione Single Sign-On.
* 
Connettori di integrazione diversi possono disporre di un'autenticazione diversa.
• ID server di autorizzazione: solo per il tipo di autenticazione SSO.
Immettere l'ID del server di autorizzazione a cui connettersi.
L'ID viene assegnato da un amministratore di server quando ThingWorx è configurato per SSO. Per recuperare il valore, fare riferimento alla variabile <IdServerAutorizzazione> utilizzata dall'impostazione authServerId.clientID nel file sso-settings.json in cui è installato ThingWorx. È possibile contattare l'amministratore del server Apache Tomcat per richiedere l'ID del server di autorizzazione.
Per ulteriori informazioni, consultare l'argomento Configurazione di sso-settings.json.
Impostazioni connessione connettore HTTP: solo per il tipo di autenticazione Fissa.
• Immettere i valori nei campi riportati di seguito.
◦ Nome utente
◦ Password
◦ Conferma password
URL di instradamento del servizio per il sistema back-end OData. Immettere più righe se si dispone di più domini. Se si immette un URL relativo di seguito, tale URL viene utilizzato come parte del percorso.
Ad esempio, se l'URL relativo è /servlet/odata e gli URL di instradamento del servizio sono /ProdMgmt e /DataAdmin, gli URL del servizio effettivi relativi all'URL di base sono /servlet/odata/ProdMgmt e /servlet/odata/DataAdmin. Questi URL di instradamento del servizio indicano una o più specifiche OData. Per ogni URL di instradamento del servizio, viene aggiunto il percorso /$metadata e alla risorsa viene richiesto di recuperare la specifica OData.
• Per tutti i tipi di autenticazione, immettere le informazioni nei campi URL riportati di seguito. Se un valore di default è stato fornito dal modello di oggetto, non modificare tale valore. Ad esempio, URL relativo e URL connessione vengono forniti per SAPODataConnector. Questi URL indirizzano a un servizio del catalogo che individua le specifiche correlate.
◦ URL base: l'URL di base è richiesto per accedere al sistema back-end. Tale URL include l'host, la porta e l'applicazione del sistema back-end.
Per SSO, immettere un URL che supporta OAuth. Per ulteriori informazioni, vedere Working with Scopes.
* 
Se il nuovo connettore di integrazione aggiunge un ambito che non esiste nel server di autorizzazione e si effettua la disconnessione, viene visualizzato un errore e non si ha la possibilità di eseguire l'accesso. Si resterà scollegati finché l'ambito non viene registrato sul server di autorizzazione. Per ulteriori informazioni, vedere Risoluzione dei problemi relativi a Single Sign-On.
◦ URL relativo: URL su cui l'API viene gestita, relativo all'URL base.
◦ URL connessione: l'URL utilizzato per verificare la connessione, relativo all'URL base.
Impostazioni connessione connettore OData: solo per ODataConnector.
SAPODataConnector
Impostazioni connessione connettore Swagger
• URL relativo della specifica Swagger: URL utilizzato per ottenere la specifica Swagger dal sistema back-end. È relativo all'URL base.
In Impostazioni ambiti server di autorizzazione: solo per il tipo di autenticazione SSO.
Immettere i nomi di ambito esattamente come vengono visualizzati nel server di autorizzazione. Questi ambiti sono definiti nel provider di risorse e registrati nel server di autorizzazione. Per ulteriori informazioni, vedere Working with Scopes.
6. Fare clic su Salva.
* 
Le informazioni sullo stato della connessione sono disponibili da Monitoraggio > STATO > Connettori integrazione. Per ulteriori informazioni, vedere Monitoraggio dello stato dei connettori di integrazione.