Personalizzare Windchill Navigate > Creare task personalizzati > Configurare il connettore OData
Configurare il connettore OData
Windchill Navigate supporta l'utilizzo del connettore OData con Windchill REST Services per accedere ai dati per il task personalizzato.
* 
WindchillConnector (ptc-windchill-demo-thing) è stato rimosso a partire da Windchill Navigate 9.2. Se necessario, aggiornare i task personalizzati per l'utilizzo del connettore OData.
Prerequisiti
ThingWorx Integration Runtime deve essere configurato prima di utilizzare il connettore OData. In generale, ThingWorx Integration Runtime viene configurato dallo strumento di installazione di Windchill Navigate come passo integrato del processo di installazione.
Creare il connettore
Per impostare il connettore OData sono disponibili due opzioni: creare una nuova istanza del connettore oppure utilizzare il connettore predefinito ptc-windchill-OData-connector. Scegliere l'opzione migliore per il caso di utilizzo.
Per i task personalizzati che utilizzano i task Info*Engine, si consiglia di utilizzare il predefinito ptc-windchill-OData-connector. Questo perché i servizi Info*Engine sono già disponibili nel connettore predefinito.
Per creare una nuova istanza del connettore OData, attenersi alla procedura descritta di seguito.
1. In ThingWorx Composer, passare a Modellazione > Connettori integrazione e fare clic su Nuovo.
2. Nella finestra Scegli modello, selezionare il modello di oggetto ODataConnector e fare clic su OK.
3. Immettere un nome e un progetto per il connettore.
A questo punto è possibile configurare il connettore.
Configurare il connettore
1. In Composer, aprire il connettore creato o cercare ptc-windchill-OData-connector e aprirlo. Viene visualizzata la pagina Informazioni generali.
2. Fare clic sulla scheda Configurazione. Viene visualizzata la pagina Configurazione.
La configurazione dipende dal metodo di autenticazione: Single Sign-On, autenticazione Windchill o autenticazione fissa.
Autenticazione Single Sign-On 
Se è stata configurata l'autenticazione Single Sign-On, attenersi alla procedura riportata di seguito.
1. In Impostazioni connessione connettore generico, alla voce Tipo di autenticazione, selezionare OAuth (Utente sessione).
2. In ID server di autorizzazione immettere il valore AuthorizationServerSettingsID specificato in sso-settings.json, ad esempio PingFed1.
3. In Impostazioni ambiti server di autorizzazione, fare clic su Aggiungi. Viene visualizzata la finestra AuthorizationServerScopesSettings.
4. In Ambito, immettere l'ambito Windchill registrato in PingFederate, ad esempio WINDCHILL.
5. Fare clic su Aggiungi.
6. In Impostazioni CSRF, immettere le seguenti informazioni:
◦ URL relativo per richiesta Get CSRF - servlet/odata
◦ Nome token CSRF - CSRF_NONCE
7. In Impostazioni connessione connettore HTTP immettere le informazioni riportate di seguito.
◦ URL base - L'URL Windchill. L'URL deve terminare con /oauth. Utilizzare il seguente formato:
[https]://[Windchill Host]:[port]/[Windchill-web-app]/oauth
Questo formato specifica che la connessione utilizza lo standard OAuth e attiva le richieste di dati nel provider di risorse.
◦ URL relativo - servlet/odata
Non è necessario immettere il nome utente e la password.
8. Fare clic su Salva. Il connettore OData è ora configurato per l'utilizzo nell'ambiente di autenticazione Single Sign-On.
Autenticazione Windchill 
Se è stata configurata l'autenticazione Windchill, attenersi alla procedura riportata di seguito.
1. In Impostazioni connessione connettore generico, alla voce Tipo di autenticazione, selezionare None.
2. In Impostazioni CSRF, immettere le seguenti informazioni:
◦ URL relativo per richiesta Get CSRF - servlet/odata
◦ Nome token CSRF - CSRF_NONCE
3. In Impostazioni connessione connettore HTTP immettere le informazioni riportate di seguito.
◦ URL base - Il server Windchill che riceve la richiesta Info*Engine da ODataConnector. Utilizzare il seguente formato:
[https]://[Windchill Host]:[port]/[Windchill-web-app]/sslClientAuth
◦ URL relativo - servlet/odata
◦ URL connessione - /servlet/WindchillGW/wt.httpgw.HTTPServer/ping
Non è necessario immettere un nome utente e una password.
4. Fare clic su Salva.
Se si utilizza il connettore ptc-windchill-OData-connector predefinito, il connettore è ora configurato per l'utilizzo nell'ambiente di autenticazione Windchill.
Se è stata creata una nuova istanza del connettore OData, completare la procedura aggiuntiva descritta di seguito.
1. Fare clic sulla scheda Servizi. Viene visualizzata la pagina Servizi.
2. Individuare il servizio GetCustomHeaderParameters e fare clic su Sostituisci per sostituire il servizio.
3. Incollare il codice seguente nel servizio:
/*Get Current User Language*/
var Language = Resources["CurrentSessionInfo"].GetCurrentUserLanguage();
/*If it is undefined or "Default" use "en-US"*/
if (Language === undefined || Language === null || Language.length <= 0) {
Language = "en-US";
} else if (Language.indexOf("Default") !== -1) {
Language = Language.replace("Default", "en-US");
}
var params = {
infoTableName: "InfoTable",
dataShapeName: "PTC.WCODataCustomHeaderDataShape"
};
var result = Resources["InfoTableFunctions"].CreateInfoTableFromDataShape(params);
params = {
tableName: "GenericConnectorConnectionSettings" /* STRING */
};
var configTable = me.GetConfigurationTable(params);
var row = configTable.getRow(0);
var authType = row.getStringValue("AuthenticationType");
if ("None".equals(authType)) {
/*This is a case for Windchill as IDP connectivity type*/
var CurrentUser = Resources["CurrentSessionInfo"].GetCurrentUser();
/*Add authorization header having Base64 Encoded value of "username:emptypassword" */
var baseEncodedStr = base64EncodeString (CurrentUser + ':');
var authHeaderValue = "Basic " + baseEncodedStr;
row = {
"Accept-Language": Language,
"Authorization": authHeaderValue,
"Content-Type": "application/json",
"Prefer": "odata.maxpagesize=2000"
};
} else {
row = {
"Accept-Language": Language,
"Content-Type": "application/json",
"Prefer": "odata.maxpagesize=2000"
};
}
result.AddRow(row);
4. Fare clic su Salva e continua per salvare il servizio. Quindi fare clic su Fine.
5. Fare clic su Salva per salvare il connettore. Il connettore OData ora è configurato per l'utilizzo nell'ambiente di autenticazione Windchill.
Autenticazione fissa 
Se è stata configurata l'autenticazione fissa, attenersi alla procedura descritta di seguito:
1. In Impostazioni connessione connettore generico, alla voce Tipo di autenticazione, selezionare Fixed.
2. In Impostazioni CSRF, immettere le seguenti informazioni:
◦ URL relativo per richiesta Get CSRF - servlet/odata
◦ Nome token CSRF - CSRF_NONCE
3. In Impostazioni connessione connettore HTTP immettere le informazioni riportate di seguito.
◦ Nome utente - Nome utente dell'amministratore Windchill
◦ Password - Password dell'amministratore Windchill
◦ URL base - Il server Windchill che riceve la richiesta Info*Engine da ODataConnector. Utilizzare il seguente formato:
[https]://[Windchill Host]:[port]/[Windchill-web-app]
◦ URL relativo - servlet/odata
4. Fare clic su Salva. Il connettore OData è ora configurato per l'utilizzo nell'ambiente di autenticazione fissa.
Esporre i servizi sul connettore
Dopo aver configurato il connettore, i passi successivi dipendono dai task personalizzati.
• Per i task personalizzati che non utilizzano i task Info*Engine, esporre i servizi necessari sul connettore. Per informazioni sull'esposizione dei servizi, vedere gli argomenti Esposizione dei servizi sui connettori di integrazione e Creazione di una nuova mappa API per il servizio in Help Center.
• Per i task personalizzati che utilizzano i task Info*Engine, passare all'argomento Eseguire i servizi Info*Engine con il connettore OData.
È stato utile?