Estensione del connettore JDBC
ThingWorx JDBC Extension offre una soluzione semplice e veloce per consentire agli amministratori ThingWorx di distribuire driver JDBC standard necessari per supportare i database di terze parti da utilizzare con un oggetto del database ThingWorx. Gli oggetti del database consentono agli sviluppatori e agli architetti di soluzioni ThingWorx di incorporare e sfruttare le funzionalità disponibili in un database all'interno di una soluzione distribuita in ThingWorx.
Criteri di supporto
Per utilizzare ThingWorx JDBC Extension, gli amministratori devono fornire il driver JDBC appropriato per il database desiderato. Sebbene PTC abbia adottato tutte le misure necessarie per garantire la funzionalità e la sicurezza generali dell'estensione del connettore JDBC, PTC non può verificare che ThingWorx sia compatibile con qualsiasi driver JDBC specifico, né elaborare richieste di supporto tecnico correlate a tali driver o a database non supportati.
Inoltre, PTC non fornisce e non è in grado di confermare la funzionalità o la protezione dei driver JDBC di terze parti necessari per utilizzare l'estensione per i provider di persistenza non supportati. PTC consiglia di esaminare i consigli di protezione dell'estensione prima di utilizzare i driver di terze parti con JDBC Extension.
Infine, i driver JDBC sopra menzionati sono utilizzabili solo con gli oggetti del database ThingWorx.
Panoramica
Se un'estensione JDBC non esiste in ThingWorx per il database in uso, è possibile aggiungere manualmente il driver JDBC, scaricando il/i driver e aggiungendo i file nella seguente posizione:/Tomcat folder/webapps/Thingworx/WEB-INF/lib
Dopo aver copiato i driver, è necessario riavviare ThingWorx.
Per evitare il riavvio di Tomcat, è possibile creare e importare un'estensione del database contenente il driver JDBC. Il vantaggio di questo approccio è che non è necessario caricare manualmente il driver. Il caricamento della classe viene gestito automaticamente ed è sicuro rispetto agli aggiornamenti, pertanto non è necessario ridistribuire il driver quando si aggiorna l'applicazione Web ThingWorx. Per ulteriori informazioni sulla creazione di un'estensione del database, attenersi alla procedura descritta di seguito.
Creazione di un'estensione JDBC per ThingWorx
Per generare un'estensione JDBC, attenersi alla procedura descritta di seguito.
1. Ottenere l'estensione del connettore JDBC ThingWorx dal sito support.ptc.com.
 |
Il modello di supporto dell'estensione ThingWorx è stato modificato di recente. La maggior parte delle estensioni non è più disponibile nella pagina di download. Per ulteriori informazioni, vedere questo articolo.
|
2. Scaricare il file JAR del driver JDBC per il database relazionale specifico, ad esempio Microsoft SQL Server o MySQL, dal sito Web ufficiale corrispondente.
3. Passare a ThingWorx Composer.
4. Importare l'estensione del connettore JDBC scaricata al passo 1.
5. Aprire il mashup JdbcCreator e fare clic su Visualizza mashup.
6. Fare clic su Seleziona file.
7. Selezionare il file del driver JDBC scaricato al passo 2.
8. Fare clic su Carica.
9. Fare clic su Download Extension File per scaricare l'estensione.
10. Importare il file ZIP scaricato al passo 9 in ThingWorx Composer.
11. Dopo l'importazione dovrebbe essere visualizzato un modello di oggetto denominato <JAR file name>Template.
12. Creare un nuovo oggetto utilizzando il modello di oggetto generato.
13. Configurare le impostazioni JDBC per la connessione al database relazionale.
|
Nome campo
|
Descrizione
|
|---|---|
|
Nome classe driver JDBC
|
Dipende dal driver utilizzato.
|
|
Stringa di connessione JDBC
|
Definisce le informazioni necessarie per stabilire una connessione con il database. La formattazione della stringa di connessione è disponibile nel sito connectionstrings.com.
|
|
ConnectionValidationString
|
Un'interrogazione semplice che verifica i valori restituiti dal database, indipendentemente dai nomi di tabella da eseguire.
|
Interrogazioni e comandi per il database
Una volta impostata la configurazione, in Servizi è possibile creare SQLQueries e SQLCommands da applicare al database a cui si è connessi.
Trasferimento di variabili
Durante la creazione dell'interrogazione, utilizzare [[Nome del parametro]] per la sostituzione di parametri/variabili e <<string replacement>> per la sostituzione delle stringhe.
Esempio
DELETE FROM <> WHERE (FieldName = '[[MatchName]]');
DELETE FROM << TableName >> WHERE ( FieldName = [[MatchNumber]]);
|
|
È estremamente pericoloso utilizzare la sostituzione delle stringhe << ... >>, poiché ciò espone al rischio di inserimento di codice SQL dannoso. Si consiglia di prestare attenzione nel prendere in considerazione questo metodo di trasferimento dei parametri. Tuttavia, per creare un insieme molto dinamico di interrogazioni, è necessario passare i nomi di tabella come << Nome della tabella >>. Inoltre, se è necessario utilizzare la clausola IN, la raccolta deve essere trasferita con << Elemento1, Elemento2, Elemento3,>>
|