Informazioni sulle proprietà di associazione di Associazione BizTalk per Oracle E-Business Suite
L'adapter Microsoft BizTalk per Oracle E-Business Suite presenta diverse proprietà di associazione. Impostando queste proprietà, è possibile controllare alcuni dei comportamenti dell'adattatore. Questa sezione descrive le proprietà di associazione dell'adattatore Oracle E-Business. Illustra anche come accedervi usando la programmazione .NET o impostando le proprietà in un'associazione di porte fisiche BizTalk Server.
Proprietà di associazione dell'adapter
Oracle E-Business Suite è un livello applicazione sul database Oracle sottostante. Alcune proprietà di associazione configurano il comportamento dell'adapter durante l'interfaccia con Oracle E-Business Suite, mentre altre proprietà configurano il comportamento durante l'interfaccia con il database Oracle. La tabella seguente mostra tutte le proprietà di associazione dell'adapter Oracle E-Business raggruppate in base alla categoria. La categoria fa riferimento al nodo in cui ogni proprietà di associazione viene visualizzata nelle finestre di dialogo presentate da applicazioni diverse per configurare l'adapter (o l'associazione).
| Binding, proprietà | Category | Descrizione | Tipo di .NET |
|---|---|---|---|
| Clientcredentialtype | Generale | Specifica il set di credenziali specificato durante la creazione di una connessione con Oracle E-Business Suite. I valori possibili sono Database e EBusiness. - Se impostato su Database, i client della scheda devono specificare le credenziali del database per stabilire la connessione e le credenziali di E-Business Suite per le proprietà di associazione OracleUserName e OraclePassword . - Se impostato su EBusiness, i client dell'adapter devono specificare le credenziali di E-Business Suite per stabilire la connessione e le credenziali del database per le proprietà di associazione OracleUserName e OraclePassword . Importante: Se la proprietà di associazione ClientCredentialType è impostata su EBusiness, specificando il nome utente del database e la password per le proprietà di associazione OracleUserName e OraclePassword è obbligatorio. Il valore predefinito è Database. |
enumerazione (ClientCredential) |
| CloseTimeout | Generale | Timeout di chiusura della connessione WCF. Specifica un valore di intervallo di tempo che indica l'intervallo di tempo specificato per il completamento dell'operazione di chiusura del canale WCF interno. Il valore predefinito è 1 minuto. Non supportato. | System.TimeSpan |
| EnableBizTalkCompatibilityMode | Generale | Specifica il modo in cui l'adapter genera lo schema per un Oggetto DataSet. Impostare questa opzione su True per generare correttamente lo schema per DataSet. Quando si usano gli adattatori da BizTalk Server, è sempre necessario impostare la proprietà su True. Quando si usano gli adapter da Visual Studio, è sempre necessario impostare la proprietà su False. |
bool (System.Boolean) |
| InboundOperationType | Generale | Specifica se si vuole eseguire l'operazione polling o notifica in ingresso. Il valore predefinito è Polling. Per altre informazioni sul polling , vedere Supporto per le chiamate in ingresso tramite polling. Per altre informazioni sulla notifica, vedere Considerazioni sulla ricezione delle notifiche di modifica del database tramite l'adattatore Oracle Database. |
enum |
| Nome | Generale | Valore di sola lettura che restituisce il nome del file generato dal plug-in Add Adapter Service Reference Visual Studio per contenere la classe client WCF. Il plug-in Add Adapter Service Reference forma il nome del file aggiungendo "Client" al valore della proprietà Name . Il valore restituito è "OracleEBSBinding"; per questo valore, il file generato sarà denominato "OracleEBSBindingClient". | string |
| OpenTimeout | Generale | Timeout di apertura connessione WCF. Specifica un valore di intervallo di tempo che indica l'intervallo di tempo specificato per il completamento dell'operazione di apertura del canale interno. Il valore predefinito è 1 minuto. Importante: L'adapter Oracle E-Business usa sempre OpenTimeout per impostare il timeout di apertura della connessione quando apre una connessione al database Oracle. L'adapter ignora i parametri timeout (System.TimeSpan) passati quando si apre un oggetto di comunicazione, ad esempio un canale. |
System.TimeSpan |
| ReceiveTimeout | Generale | Timeout di ricezione del messaggio WCF. Specifica un valore intervallo di tempo che indica l'intervallo di tempo massimo per cui l'adapter attende un messaggio in ingresso. Il valore predefinito è 10 minuti. Importante: Per le operazioni in ingresso, ad esempio il polling, è consigliabile impostare il timeout sul valore massimo possibile, ovvero 24.20:31:23.6470000 (24 giorni). Quando si usa l'adattatore con BizTalk Server, l'impostazione del timeout su un valore elevato non influisce sulla funzionalità dell'adattatore. |
System.TimeSpan |
| SendTimeout | Generale | Timeout di invio del messaggio WCF. Specifica un valore di intervallo di tempo che indica l'intervallo di tempo specificato per il completamento dell'operazione di invio del canale interno. Il valore predefinito è 5 minuti. | System.TimeSpan |
| UseAmbientTransaction | Generale | Specifica se l'adapter Oracle E-Business esegue le operazioni usando il contesto di transazione fornito dal chiamante. Il valore predefinito è true, ovvero che l'adapter esegue sempre le operazioni in un contesto di transazione, presupponendo che il client fornisca il contesto transazionale. Se sono presenti altre risorse che partecipano alla transazione, le connessioni create in System.Transaction vengono elevate in una transazione MSDTC. Tuttavia, è possibile che ci siano scenari in cui non si vuole che l'adapter esegua operazioni in un contesto transazionale. Ad esempio: - Durante l'esecuzione di un'operazione SELECT semplice nel database Oracle (in una porta di invio) - Specificare un'istruzione di polling che esegue un'operazione SELECT e non comporta alcuna modifica alla tabella tramite un'istruzione DELETE o richiamando una stored procedure (su una porta di ricezione) Entrambe queste operazioni non apportano aggiornamenti alla tabella di database e quindi elevano queste operazioni per l'uso di una transazione MSDTC possono essere un sovraccarico delle prestazioni. In questi scenari è possibile impostare la proprietà di associazione su false in modo che l'adapter Oracle E-Business non esegua le operazioni in un contesto di transazione. Nota: Non eseguire operazioni in un contesto transazionale è consigliabile solo per le operazioni che non apportano modifiche al database. Per le operazioni che aggiornano i dati nel database, è consigliabile impostare la proprietà di associazione su true in caso contrario, è possibile che si verifichino perdite di messaggi o messaggi duplicati a seconda che si eseguono operazioni in ingresso o in uscita. |
bool (System.Boolean) |
| DataFetchSize | Gestione del buffer | ODP.NET proprietà. Specifica la quantità di dati in byte che ODP.NET recupera dal set di risultati in un solo server. Il valore predefinito è 65536. Questa proprietà viene usata per l'ottimizzazione delle prestazioni. | long (System.Int64) |
| InsertBatchSize | Gestione del buffer | Specifica le dimensioni batch per più operazioni di inserimento record. Il valore predefinito è 20. Per i valori di InsertBatchSize maggiore di uno, l'adapter Oracle E-Business esegue il batch del numero specificato di record in una singola chiamata ODP.NET. Se il numero di record nell'operazione di inserimento non è un multiplo delle dimensioni del batch, il batch finale conterrà un numero inferiore di record rispetto al valore delle dimensioni del batch. Ad esempio, se il messaggio di inserimento contiene 10 record e InsertBatchSize è impostato su 1, l'adattatore legge i singoli record e li scrive nel database Oracle. L'adattatore esegue quindi 10 operazioni separate nel database Oracle. Analogamente, se il messaggio di inserimento contiene 10 record e InsertBatchSize è impostato su 5, l'adapter leggerà e scriverà 5 record alla volta nel database Oracle, pertanto eseguendo solo 2 operazioni di inserimento. Un valore ben scelto per InsertBatchSize può migliorare notevolmente le prestazioni dell'adattatore per più operazioni di inserimento di record. |
int (System.Int32) |
| LongDatatypeColumnSize | Gestione del buffer | Specifica le dimensioni massime in byte di una colonna del tipo di dati Long Oracle. Il valore massimo di questa proprietà di associazione può essere 32512. Il valore predefinito è 0. Se non si esegue un'operazione sul tipo di dati long, è necessario utilizzare il valore predefinito. È necessario impostare in modo esplicito un valore appropriato per questa proprietà di associazione, se si è: - Esecuzione di una stored procedure contenente parametri di tipo long. - Esecuzione di un'operazione Select in una tabella contenente colonne con tipo di dati long e l'istruzione SELECT non include la colonna chiave primaria. Se si desidera impostare il valore massimo per questa proprietà di associazione, impostare il valore su -1. Nota: Questa proprietà di associazione è deprecata. |
INT |
| MaxOutputAssociativeArrayElements | Gestione del buffer | Specifica le dimensioni della matrice associata creata dall'adattatore durante l'esecuzione di operazioni che restituiscono una matrice associativa nella risposta. L'adattatore comunica le dimensioni della matrice a ODP.NET, che a sua volta crea un buffer a seconda delle dimensioni della matrice. Il valore predefinito è 32. Questa proprietà di associazione è utile quando si eseguono operazioni che coinvolgono tipi di tabella PL/SQL. |
int (System.Int32) |
| MetadataPooling | Gestione del buffer | ODP.NET proprietà. Specifica se ODP.NET memorizza nella cache le informazioni sui metadati per le query eseguite. Il valore predefinito è true, che abilita il pool di metadati. La memorizzazione nella cache di queste informazioni migliora le prestazioni; Tuttavia, se le modifiche apportate agli artefatti Oracle sottostanti si verificano nel sistema Oracle, questi metadati in pool non saranno sincronizzati. Ciò potrebbe causare l'esecuzione di operazioni sul sistema Oracle per restituire eccezioni impreviste. Questa proprietà viene utilizzata per l'ottimizzazione delle prestazioni. | bool (System.Boolean) |
| StatementCachePurge | Gestione del buffer | ODP.NET proprietà. Specifica se la cache delle istruzioni ODP.NET associata a una connessione viene rimossa quando la connessione viene restituita al pool di connessioni. Il valore predefinito è false, che disabilita l'eliminazione della cache delle istruzioni. Questa proprietà viene utilizzata per l'ottimizzazione delle prestazioni. | bool (System.Boolean) |
| StatementCacheSize | Gestione del buffer | ODP.NET proprietà. Specifica il numero massimo di istruzioni che possono essere memorizzate nella cache da ogni ODP.NET connessione. L'impostazione di questa proprietà su un valore diverso da zero abilita la memorizzazione nella cache delle istruzioni per le connessioni. Il valore predefinito è 10. Questa proprietà viene utilizzata per l'ottimizzazione delle prestazioni. | int (System.Int32) |
| OracleConnectionClientId | Debug | Specifica un identificatore client (ID) per la connessione utilizzata dall'adattatore per la connessione a Oracle. Ciò è utile se è stata abilitata la traccia sul lato server Oracle e si vuole tracciare in modo selettivo le operazioni per un ID client specifico. In questo modo è anche possibile filtrare e visualizzare le tracce del server Oracle in base a un ID client. | string |
| EnablePerformanceCounters | Diagnostica | Specifica se abilitare i contatori delle prestazioni dell'SDK dell'adapter LOB WCF e il contatore delle prestazioni lob dell'adapter Oracle E-Business. Il valore predefinito è False; I contatori delle prestazioni sono disabilitati. Il contatore delle prestazioni latenza LOB misura il tempo totale impiegato dall'adattatore Oracle E-Business per effettuare chiamate a Oracle E-Business Suite. | bool (System.Boolean) |
| EnableSafeTyping | Metadati | Abilita o disabilita la digitazione sicura. Il valore predefinito è false; la digitazione sicura è disabilitata. Questa funzionalità controlla la modalità di visualizzazione di determinati tipi di dati Oracle da parte dell'adattatore. Per altre informazioni sulla digitazione sicura, vedere Tipi di dati Oracle di base. | bool (System.Boolean) |
| UseSchemaInNameSpace | Metadati | Specifica se il nome dello schema (SCOTT, HR e così via) è incluso nello spazio dei nomi xml per le operazioni e i relativi tipi associati sugli artefatti del database sottostante. Il valore predefinito è True; il nome dello schema è incluso nello spazio dei nomi . Il vantaggio di non includere il nome dello schema nello spazio dei nomi è che se è presente una tabella con lo stesso nome (ad esempio, EMP) in due schemi diversi, è possibile usare lo stesso codice XML per eseguire le semplici operazioni SQL (Insert, Update, Delete, Select) in entrambe le tabelle. Ad esempio, se la proprietà UseSchemaInNamespace è true, lo spazio dei nomi per queste operazioni su SCOTT. La tabella EMP è ; se è http://schemas.microsoft.com/OracleEBS/Tables/SCOTT/EMPfalse, lo spazio dei nomi è http://schemas.microsoft.com/OracleEBS/Tables/EMP.Importante: L'azione del messaggio non è interessata dalla proprietà di associazione UseSchemaInNamesapce ; include sempre il nome dello schema. Importante: È consigliabile impostare questa proprietà di associazione su True durante la generazione dei metadati. Se si imposta questa proprietà su false, i nomi degli schemi Oracle (ad esempio SCOTT) non saranno disponibili nello spazio dei nomi XML dello schema generato. Pertanto, se sono presenti due tabelle con lo stesso nome in due schemi Oracle diversi e vengono aggiunti allo stesso progetto BizTalk, il progetto BizTalk non riuscirà a compilare e distribuire. Se si desidera includere tali schemi nello stesso progetto BizTalk, è necessario modificarli manualmente per includere il nome dello schema Oracle nello spazio dei nomi XML. |
bool (System.Boolean) |
| MlsSettings | Supporto per più lingue | Un'istanza di Oracle E-Business Suite può avere più Language Pack installati. Pertanto, se l'adattatore sta recuperando metadati da un'istanza di Oracle E-Business Suite con supporto multilingue ,l'adattatore deve presentare informazioni con la stessa impostazione della lingua preferita dall'utente connesso. La proprietà di associazione MlsSettings consente ai client dell'adattatore di specificare le opzioni specifiche di MLS. Questa proprietà di associazione può essere specificata sia in fase di progettazione che in fase di esecuzione. La proprietà di associazione MlsSettings è una proprietà di associazione complessa che a sua volta contiene più proprietà di associazione. Tutte queste proprietà di associazione sono facoltative. L'adattatore usa le proprietà di associazione nel modo seguente per impostare il contesto mls: - Per le proprietà di associazione con valori specificati, l'adattatore usa tali valori per impostare il contesto mls. - Per le proprietà di associazione che non dispongono di valori specificati, l'adattatore usa le impostazioni mls per il client ODP.NET nello stesso computer in cui è installata l'adapter. Nella tabella seguente sono elencate le proprietà di associazione che fanno parte della proprietà di associazione MlsSettings . Tutte queste proprietà sono facoltative. Calendario: specifica il sistema di calendario. Questa proprietà di associazione viene mappata all'impostazione NLS_CALENDAR nel client ODP.NET. Confronto: specifica un metodo di confronto per le clausole WHERE e il confronto nei blocchi PL/SQL. Questa proprietà di associazione viene mappata all'impostazione di NLS_COMP nel client ODP.NET. Valuta: specifica la stringa da utilizzare come simbolo di valuta locale per l'elemento formato numero L. Per informazioni sui vari elementi di formato numerico e sui modelli di formato in Oracle, vedere https://go.microsoft.com/fwlink/?LinkId=135807. Questa proprietà di associazione esegue il mapping all'impostazione NLS_CURRENCY nel client ODP.NET. DateFormat:specifica il formato in cui viene presentata la data. Questa proprietà di associazione esegue il mapping all'impostazione di NLS_DATE_FORMAT nel client ODP.NET. DateLanguage: specifica la lingua per i nomi di giorno e mese. Questa proprietà di associazione esegue il mapping all'impostazione di NLS_DATE_LANGUAGE nel client ODP.NET DualCurrency: specifica il simbolo della doppia valuta, ad esempio Euro, per l'elemento formato numero U. Per informazioni sui vari elementi di formato numero e modelli di formato in Oracle, vedere https://go.microsoft.com/fwlink/?LinkId=135807. Questa proprietà di associazione esegue il mapping all'impostazione di NLS_DUAL_CURRENCY nel client ODP.NET. ISOCurrency:Specifica la stringa da usare come simbolo di valuta internazionale per l'elemento formato numero C. Per informazioni sui vari elementi di formato numero e modelli di formato in Oracle, vedere https://go.microsoft.com/fwlink/?LinkId=135807. Questa proprietà di associazione esegue il mapping all'impostazione NLS_ISO_CURRENCY nel client ODP.NET. Lingua: specifica la lingua da impostare come parte del contesto di MLS. Questa proprietà di associazione esegue il mapping all'impostazione di NLS_LANGUAGE nel client ODP.NET. Importante: Il valore per la proprietà di associazione OracleEBSResponsibilityName deve essere specificato nello stesso linguaggio specificato per la proprietà di associazione Language . Ad esempio, se si imposta la proprietà Language binding su Spagnolo, il nome di responsabilità specificato per la proprietà di associazione OracleEBSResponsibilityName deve essere anche in spagnolo. LengthSemantics: abilita la creazione di colonne CHAR e VARCHAR2 usando la semantica di lunghezza di byte o carattere (impostazione predefinita). Questa proprietà di associazione esegue il mapping all'impostazione di NLS_LENGTH_SEMANTICS nel client ODP.NET. NCharConversionException: specifica se la perdita di dati durante una conversione implicita o esplicita del tipo di carattere segnala un errore o meno. Il valore predefinito è True. Questa proprietà di associazione esegue il mapping all'impostazione di NLS_NCHAR_CONV_EXCP nel client ODP.NET. NumericCharacters: specifica il separatore di caratteri decimali e gruppo. Questa proprietà di associazione esegue il mapping all'impostazione NLS_NUMERIC_CHARACTERS nel client ODP.NET. Ordinamento: specifica il tipo di ordinamento per i dati dei caratteri. Questa proprietà di associazione esegue il mapping all'impostazione di NLS_SORT nel client ODP.NET. Territorio: specifica le convenzioni di data e formato numerico per un territorio. Questa proprietà di associazione esegue il mapping all'impostazione di NLS_TERRITORY nel client ODP.NET. TimeStampFormat: specifica il formato stringa per i tipi di dati TimeStamp. Questa proprietà di associazione esegue il mapping all'impostazione di NLS_TIMESTAMP_FORMAT nel client ODP.NET. TimeStampTZFormat: specifica il formato stringa per i tipi di dati TimeStampTZ. Questa proprietà di associazione esegue il mapping all'impostazione NLS_TIMESTAMP_TZ_FORMAT nel client ODP.NET. Fuso orario: specifica il nome dell'area del fuso orario. Questa proprietà di associazione esegue il mapping all'impostazione di TIME_ZONE nel client ODP.NET. |
enum |
| NotificationPort | Notifica | Specifica il numero di porta che ODP.NET deve essere aperto per ascoltare la notifica di modifica del database dal database Oracle. Il valore predefinito è -1, che indica che ODP.NET usa un numero di porta valido, casuale e inutilizzato. Importante: I client della scheda non riceveranno notifiche di modifica del database se Windows Firewall è attivato. Inoltre, disattivare Windows Firewall per ricevere notifiche non è consigliabile. Quindi, per ricevere notifiche senza compromettere la sicurezza dei computer lato client, è consigliabile specificare un valore intero positivo come numero di porta e quindi aggiungere tale numero di porta all'elenco eccezioni di Windows Firewall. Se si imposta questa proprietà di associazione sul valore predefinito di -1, ODP.NET usa una porta casuale e i client dell'adattatore non sapranno quale porta aggiungere all'elenco eccezioni di Windows Firewall. Per istruzioni su come aggiungere porte all'elenco eccezioni di Windows Firewall, vedere https://go.microsoft.com/fwlink/?LinkID=196959. Attenzione: Se sono presenti più applicazioni in un dominio applicazione che riceve notifiche usando l'adapter Oracle E-Business, la proprietà di associazione NotificationPort per tutte le applicazioni deve essere impostata sullo stesso numero di porta. Questo perché ODP.NET crea un solo listener in ascolto su una porta all'interno di un dominio applicazione. |
int (System.Int32) |
| NotificaStatement | Notifica | Specifica l'istruzione SELECT usata per registrare le notifiche dal database Oracle. Un'istruzione SELECT di esempio potrebbe essere simile alla seguente.SELECT TID,ACCOUNT,PROCESSED FROM SCOTT.ACCOUNTACTIVITY WHERE PROCESSED = ‘n’Nota: È necessario specificare il nome dell'oggetto di database insieme al nome dello schema. Ad esempio: SCOTT.ACCOUNTACTIVITY.L'adapter ottiene un messaggio di notifica dal database Oracle solo quando il set di risultati per l'istruzione SELECT specificato cambia. |
string |
| NotifyOnListenerStart | Notifica | Specifica se l'adapter invia un messaggio di notifica ai client dell'adapter, informando che il percorso di ricezione è in esecuzione, quando viene avviato il listener. L'impostazione predefinita è True. | bool (System.Boolean) |
| ConnectionLifetime | Pool di connessioni Oracle | ODP.NET proprietà. Specifica la durata massima in secondi di una connessione. Il valore predefinito è 0. Questa proprietà viene usata per l'ottimizzazione delle prestazioni. | int (System.Int32) |
| DecrPoolSize | Pool di connessioni Oracle | ODP.NET proprietà. Specifica il numero di connessioni chiuse quando non è in uso una quantità eccessiva di connessioni stabilite. Il valore predefinito è 1. Questa operazione viene usata per l'ottimizzazione delle prestazioni. | int (System.Int32) |
| IncrPoolSize | Pool di connessioni Oracle | ODP.NET proprietà. Specifica il numero di nuove connessioni da creare quando viene richiesta una nuova connessione e non sono disponibili connessioni nel pool di connessioni ODP.NET. Il valore predefinito è 5. Questa proprietà viene usata per l'ottimizzazione delle prestazioni. | int (System.Int32) |
| MaxPoolSize | Pool di connessioni Oracle | ODP.NET proprietà. Specifica il numero massimo di connessioni in un pool di connessioni ODP.NET. Il valore predefinito è 100. Questa proprietà viene usata per l'ottimizzazione delle prestazioni. Importante: È necessario impostare MaxPoolSize in modo judiciso. È possibile esaurire il numero di connessioni disponibili da ODP.NET, se questo valore è impostato troppo grande. |
int (System.Int32) |
| MinPoolSize | Pool di connessioni Oracle | ODP.NET proprietà. Specifica il numero minimo di connessioni in un pool di connessioni ODP.NET. Il valore predefinito è 1. Questa proprietà viene usata per l'ottimizzazione delle prestazioni. | int (System.Int32) |
| UseOracleConnectionPool | Pool di connessioni Oracle | ODP.NET proprietà. Specifica se usare il pool di connessioni ODP.NET. Il valore predefinito è true, che consente il pool di connessioni. La scheda Oracle E-Business implementa il pool di connessioni usando il pool di connessioni ODP.NET. | bool (System.Boolean) |
| ApplicationShortName | OracleEBS | Nome breve per un'applicazione Oracle E-Business Suite. È necessario specificare il nome breve dell'applicazione durante l'impostazione del contesto dell'applicazione per determinate API PL/SQL e tabelle o viste di database. Ma perché è necessario impostare il contesto dell'applicazione solo per determinate API PL/SQL e tabelle o viste di database? - Le API PL/SQL, entrambe associate al database Oracle e alle applicazioni in Oracle E-Business Suite, sono disponibili anche nel nodo "Visualizzazione basata su artefatti" e nella visualizzazione Schema-Based" in fase di progettazione durante l'uso del componente aggiuntivo Del servizio adapter di utilizzo o del plug-in di riferimento del servizio adattatori aggiuntivo. Durante l'esecuzione delle API PL/SQL associate al database Oracle, non è necessario impostare questa proprietà di associazione. Tuttavia, durante l'esecuzione di un'API PL/SQL associata a un'applicazione Oracle E-Business Suite, è necessario impostare il contesto dell'applicazione specificando un valore valido per questa proprietà di associazione. - Per le applicazioni Oracle E-Business Suite personalizzate, gli utenti possono o meno registrare le tabelle di database di base come tabelle di interfaccia. Se una tabella di database non è registrata come tabella di interfaccia, sarà disponibile nel nodo "Database" in fase di progettazione durante l'utilizzo del componente aggiuntivo del servizio adapter o il plug-in Aggiungi riferimento al servizio adapter. Tuttavia, poiché queste tabelle sono associate a un'applicazione Oracle E-Business, per qualsiasi operazione su queste tabelle è necessario impostare il contesto dell'applicazione. Pertanto, per eseguire qualsiasi operazione su un'API PL/SQL e tabelle o viste di database appartenenti a Oracle E-Business Suite, è sempre necessario specificare il nome breve dell'applicazione. Importante: Durante l'esecuzione di un'API PL/SQL o l'esecuzione di qualsiasi operazione su tabelle o viste di database associate a un'applicazione Oracle E-Business Suite, è necessario: - Impostare la proprietà di associazione ClientCredentialType su EBusiness, - Impostare le proprietà di associazione OracleUserName, OraclePassword per specificare le credenziali per la connessione a Oracle E-Business Suite e - Impostare la proprietà di associazione OracleEBSResponsibilityName sul nome di responsabilità appropriato. Se si impostano queste proprietà di associazione, si informa l'adapter che l'API PL/SQL o la tabella o la vista del database sono associate a un'applicazione Oracle E-Business Suite e quindi la proprietà di associazione ApplicationShortName diventa obbligatoria. Al contrario, se si esegue un'API PL/SQL o qualsiasi operazione su tabelle o viste di database, associata a un'applicazione Oracle E-Business Suite e non si impostano le proprietà di associazione ClientCredentialType, OracleUserName, OraclePassword e OracleEBSResponsibilityName in modo appropriato, l'adapter ignora applicationShortName, anche se è impostato e presuppone che l'API PL/SQL o la tabella di database su cui si eseguono operazioni appartengano al database Oracle. |
string |
| OracleEBSOrganizationId | OracleEBS | Specifica l'ID organizzazione a cui appartiene un'applicazione Oracle E-Business Suite. Questa proprietà è facoltativa e viene considerata solo quando: - La proprietà di associazione ClientCredentialType è impostata su EBusiness e - Le proprietà di associazione OracleUserName, OraclePassword e OracleEBSResponsibilityName vengono specificate in modo appropriato. |
string |
| OracleEBSResponsibilityKey | OracleEBS | Chiave di responsabilità associata all'utente di Oracle E-Business Suite. A differenza del nome di responsabilità (proprietà di associazione OracleEBSResponsibilityName ), la chiave di responsabilità non dipende dalla lingua specificata. Implica che non è necessario specificare chiavi di responsabilità in lingue diverse a seconda del valore specificato nella proprietà di associazione di linguaggio durante l'impostazione del contesto MLS. Importante: - Il valore specificato per la proprietà di associazione OracleEBSResponsibilityKey esegue l'override del valore specificato per la proprietà di associazione OracleEBSResponsibilityName . - Se si eseguono operazioni sui dati in più lingue e non si vuole specificare un nome di responsabilità in ogni lingua, è necessario specificare un valore per questa proprietà di associazione durante l'esecuzione di operazioni sulle tabelle di interfaccia, la selezione di valori dalle visualizzazioni dell'interfaccia o l'esecuzione di un programma o un set di richieste simultaneo. Naturalmente, è sempre possibile usare questa proprietà di associazione anche se si usano solo i dati nella lingua inglese. |
string |
| OracleEBSResponsibilityName | OracleEBS | Nome della responsabilità associata all'utente di Oracle E-Business Suite. Il nome della responsabilità dipende dalla lingua specificata. Implica che se si imposta il contesto MLS specificando un valore per la proprietà di associazione Language , il valore per la proprietà di associazione OracleEBSResponsibilityName deve essere specificato nella stessa lingua specificata per la proprietà di associazione Language . Ad esempio, se si imposta la proprietà di associazione Language su Spagnolo, anche il nome della responsabilità specificato per la proprietà di associazione OracleEBSResponsibilityName deve essere in spagnolo. Importante: È necessario specificare un valore per questa proprietà di associazione durante l'esecuzione di operazioni sulle tabelle di interfaccia, la selezione dei valori dalle viste dell'interfaccia o l'esecuzione di un programma simultaneo. |
string |
| OraclePassword | OracleEBS | - Se la proprietà di associazione ClientCredentialType è impostata su Database, questa proprietà specifica la password per un utente del database Oracle. - Se la proprietà di associazione ClientCredentialType è impostata su EBusiness, questa proprietà specifica la password per un utente di Oracle E-Business Suite. L'adattatore Oracle E-Business non mantiene la distinzione tra maiuscole e minuscole del valore immesso per la proprietà di associazione OraclePassword quando si connette a Oracle E-Business Suite. La password viene passata a Oracle E-Business Suite usando le regole standard di SQL*Plus. Tuttavia, se si desidera che la password venga mantenuta o se si desidera immettere una password contenente caratteri speciali, è necessario specificare il valore tra virgolette doppie. Importante: - Durante l'esecuzione di operazioni sulle tabelle di interfaccia, la selezione dei valori dalle visualizzazioni dell'interfaccia, l'esecuzione di un programma simultaneo o l'esecuzione di un'API PL/SQL associata a un'applicazione Oracle E-Business Suite, è necessario impostare la proprietà di associazione ClientCredentialType su EBusiness e quindi specificare una password valida per connettersi a Oracle E-Business Suite. - La proprietà di associazione OraclePassword non è disponibile nel file di associazione (file XML) o nel file di app.config generato in seguito all'uso del componente aggiuntivo Del progetto BizTalk del servizio adapter di utilizzo o del plug-in Add Adapter Service Reference di Visual Studio. |
string |
| OracleUserName | OracleEBS | - Se la proprietà di associazione ClientCredentialType è impostata su Database, questa proprietà specifica il nome utente per l'autenticazione nel database Oracle. - Se la proprietà di associazione ClientCredentialType è impostata su EBusiness, questa proprietà specifica il nome utente per l'autenticazione in Oracle E-Business Suite. L'adattatore Oracle E-Business non mantiene il caso del valore immesso per la proprietà di associazione OracleUserName quando si connette a Oracle E-Business Suite. Il nome utente viene passato a Oracle E-Business Suite usando le regole standard di SQL*Plus. Tuttavia, se si desidera mantenere il caso del nome utente o se si desidera immettere un nome utente contenente caratteri speciali, è necessario specificare il valore tra virgolette doppie. Importante: Durante l'esecuzione di operazioni sulle tabelle di interfaccia, la selezione dei valori dalle visualizzazioni dell'interfaccia, l'esecuzione di un programma simultaneo o l'esecuzione di un'API PL/SQL associata a un'applicazione Oracle E-Business Suite, è necessario impostare la proprietà di associazione ClientCredentialType su EBusiness e quindi specificare un nome utente valido per connettersi a Oracle E-Business Suite. |
string |
| PolledDataAvailableStatement | Polling | Specifica l'istruzione SELECT eseguita per determinare se i dati sono disponibili per il polling per una tabella specifica. L'istruzione specificata deve restituire un set di risultati costituito da righe e colonne. Il valore nella prima cella del set di risultati indica se l'adattatore esegue il valore specificato per la proprietà di associazione PollingInput . Se la prima cella del risultato contiene un valore positivo, l'adapter esegue l'istruzione di polling. Ad esempio, un'istruzione valida per questa proprietà di associazione sarà:Select * from <table_name>Mancia: Se si desidera che l'adattatore continui a eseguire il polling indipendentemente dal fatto che la tabella sottoposta a polling contenga dati, è possibile specificare il valore per questa proprietà di associazione come Select 1 FROM DUAL.Nota: Non è necessario specificare stored procedure per questa proprietà di associazione. Inoltre, questa istruzione non deve modificare il database Oracle sottostante. |
string |
| PollingAction | Polling | Specifica l'azione per l'operazione di polling. You can determine the polling action for a specific operation from the metadata you generate for the operation using the Consume Adapter Service Add-in. | string |
| PollingInput | Polling | Specifica l'istruzione di polling. È possibile specificare una semplice istruzione SELECT o una stored procedure per il polling. Se si desidera eseguire il polling di una tabella o di una vista, è necessario specificare un'istruzione SELECT per questa proprietà di associazione. Se si desidera eseguire il polling usando una stored procedure, è necessario specificare l'intero messaggio di richiesta per questa proprietà di associazione. Il messaggio di richiesta deve essere lo stesso inviato all'adapter per richiamare la stored procedure come operazione in uscita. Nota: L'istruzione SQL o la stored procedure specificata per questa proprietà di associazione vengono eseguite solo se l'istruzione eseguita dalla proprietà di associazione PolledDataAvailableStatement restituisce alcuni dati. Importante: L'adapter Oracle E-Business esegue l'istruzione di polling e l'istruzione post-poll (se specificato) all'interno di una transazione Oracle. Se si usa un'istruzione SELECT nella proprietà di associazione PollingInput , è consigliabile specificare una clausola FOR UPDATE nell'istruzione SELECT. In questo modo si garantisce che i record selezionati siano bloccati durante la transazione e che l'istruzione post-poll possa eseguire eventuali aggiornamenti necessari sui record selezionati. |
string |
| PollingInterval | Polling | Specifica l'intervallo di polling transazionato, ovvero l'intervallo in secondi in cui l'adapter Oracle E-Business esegue l'istruzione specificata per la proprietà di associazione PollingInput sul database Oracle. Il valore predefinito è 30. L'intervallo di polling viene utilizzato dall'adattatore per gli elementi seguenti: - Intervallo di tempo tra i sondaggi successivi. Questo intervallo viene usato per eseguire le query di polling e post-polling. Se queste query vengono eseguite entro l'intervallo specificato, l'adattatore rimane in sospensione per il tempo rimanente nell'intervallo. - Valore del timeout delle transazioni di polling. Questo valore deve essere impostato abbastanza grande per includere l'ora di esecuzione dell'istruzione di polling, l'istruzione post-poll (se specificato) e il tempo di ricezione della risposta dall'applicazione client per eseguire il commit della transazione. Se l'applicazione client invia una risposta prima della scadenza dell'intervallo di polling, l'adapter esegue il commit della transazione e attende fino al raggiungimento dell'intervallo di polling per eseguire il polling successivo. Se l'applicazione client restituisce un errore, l'adapter termina la transazione. Se l'intervallo di polling scade prima che l'applicazione client invii la risposta, la transazione verrà timeout. |
int (System.Int32) |
| PollWhileDataFound | Polling | Specifica se l'adapter Oracle E-Business ignora l'intervallo di polling e esegue continuamente il polling del database Oracle, se i dati sono disponibili nella tabella in cui viene eseguito il polling. Se nella tabella non sono disponibili dati, l'adapter esegue l'istruzione SQL all'intervallo di polling specificato. Il valore predefinito è false. Si consideri uno scenario in cui l'intervallo di polling è impostato su 60 secondi e l'istruzione specificata per PolledDataAvailableStatement restituisce che i dati sono disponibili per il polling. L'adapter esegue quindi l'istruzione specificata per la proprietà di associazione PollingInput . Supponendo che l'adapter richiede solo 10 secondi per eseguire l'istruzione, sarà ora necessario attendere 50 secondi prima di eseguire di nuovo PolledDataAvailableStatement e quindi eseguire successivamente l'istruzione di polling. Per ottimizzare le prestazioni, invece, è possibile impostare la proprietà di associazione PollWhileDataFound su true in modo che l'adapter possa iniziare a eseguire il ciclo di polling successivo non appena termina il ciclo di polling precedente. Nota: Questa proprietà di associazione è applicabile sia per il polling su tabelle e visualizzazioni che per il polling tramite stored procedure. |
string |
| PostPollStatement | Polling | Specifica un blocco di istruzioni eseguito dopo l'istruzione specificata dalla proprietà di associazione PollingInput . Il valore predefinito è Null; non viene eseguita alcuna istruzione post-poll. L'istruzione post-poll viene eseguita all'interno della transazione di polling. Due usi comuni per l'istruzione post-poll sono: - Aggiornare una colonna nelle righe restituite nell'istruzione di polling per indicare che sono state elaborate e devono essere escluse dalle query di polling successive. - Spostare i record elaborati in una tabella diversa. Importante: Se viene specificata un'istruzione post-poll, PollingInterval deve essere impostata su dimensioni sufficienti per il completamento dell'istruzione post-poll prima della scadenza dell'intervallo. Per altre informazioni su come usare le proprietà di associazione in uno scenario di polling, vedere Panoramica delle notifiche modificate sui dati basate sul polling. |
string |
| SkipNilNodes | Comportamento del tempo di esecuzione | Specifica se l'adapter Oracle E-Business ignora l'inserimento o l'aggiornamento dei valori per i nodi contrassegnati come 'nil' nel codice XML della richiesta. Questa proprietà di associazione è applicabile per l'inserimento o l'aggiornamento dei record in una tabella e per i parametri di tipo RECORD nelle stored procedure. Il valore predefinito è true, il che significa che l'adapter ignora il passaggio di valori per i nodi contrassegnati come 'nil'. In questo caso, il valore predefinito in Oracle (se specificato) viene preso in considerazione per i nodi contrassegnati come 'nil'. Se impostato su false, l'adapter passa esplicitamente un valore Null per questi nodi. Nota: - Per i nodi che non sono presenti nel codice XML della richiesta, l'adapter ignora sempre i valori passati, indipendentemente dal valore della proprietà di associazione SkipNilNodes . - Per le tabelle PL/SQL di RECORDS, l'adapter passa sempre un valore Null per i nodi contrassegnati come 'nil' o non presenti nel file XML della richiesta, indipendentemente dal valore della proprietà di associazione SkipNilNodes . Nell'esempio seguente viene illustrata la differenza nella configurazione della scheda in base al valore impostato per questa proprietà di associazione. Si supponga che un XML di richiesta sia simile al seguente: <EMPNO>1000</EMPNO> <ENAME>John</ENAME> <SAL nil=’true’></SAL>Se SkipNilNodes è impostato su true, l'adapter esegue il comando seguente: INSERT INTO EMP (EMPNO, ENAME) VALUES (1000, “John”);Se SkipNilNodes è impostato su false, l'adapter esegue la query seguente: INSERT INTO EMP (EMPNO, ENAME, SAL) VALUES (1000, “John”, null);Si noti che nella seconda istruzione l'adapter inserisce in modo esplicito un valore Null per il parametro "SAL". |
bool (System.Boolean) |
| GeneratedUserTypesAssemblyFilePath | Generazione di tipi .NET UDT - Tempo di progettazione | Specifica il nome e il percorso della DLL generati dall'adattatore, durante la generazione di metadati contenenti tutte le UDT usate nei metadati. È necessario specificare un nome DLL se si generano metadati per i pacchetti, le stored procedure o le funzioni che usano i nomi utente. Se si specifica il nome della DLL, è facoltativo per le tabelle e le visualizzazioni con UDT. La DLL generata viene salvata nella stessa posizione dell'eseguibile. Questa proprietà di associazione è necessaria solo durante la generazione di metadati. Nota: - È necessario specificare un solo nome file. Per tutti gli UDT nei metadati, l'adapter genera un singolo file con il nome specificato. Se non si specifica un nome, l'adapter genera la DLL con un nome GUID. - Questa proprietà di associazione non è disponibile in BizTalk Server durante la configurazione di una porta di ricezione o invio WCF-OracleEBS. |
string |
| GeneratedUserTypesAssemblyKeyFilePath | Generazione di tipi .NET UDT - Tempo di progettazione | Specifica il nome e il percorso del file di chiave usato dall'adattatore per creare un assembly fortemente tipizzato. Questa proprietà di associazione è facoltativa ed è necessaria solo durante la generazione di metadati. Nota: Questa proprietà di associazione non è disponibile in BizTalk Server durante la configurazione di una ricezione o una porta di invio WCF-OracleEBS. |
string |
| UserAssembliesLoadPath | Generazione di tipi .NET UDT - Runtime | Specifica il nome delle DLL, separate da un punto e virgola, che l'adapter crea durante la generazione di metadati. Queste DLL vengono salvate nel percorso specificato per la proprietà di associazione GeneratedUserTypesAssemblyFilePath durante la generazione di metadati. È necessario copiare manualmente queste DLL nei percorsi seguenti: - Per i progetti BizTalk: copiare le DLL nello stesso percorso di BTSNTSvc.exe. Per BizTalk Server, questa operazione è disponibile in genere nell'unità <>di installazione:\Programmi\Microsoft BizTalk Server. - Per progetti .NET: copiare le DLL nella cartella \bin\Development all'interno della cartella del progetto .NET. Questa proprietà di associazione è necessaria solo durante l'invio e la ricezione di messaggi per eseguire operazioni in Oracle E-Business Suite. |
string |
| AcceptCredentialsInUri | Non è stato eseguito il componente aggiuntivo Del servizio adapter di utilizzo o il plug-in Add Adapter Service Reference .Not surfaced by the Consume Adapter Service Add Adapter Service Add-in Plug-in. | Specifica se l'URI di connessione Oracle E-Business Suite può contenere credenziali utente. Il valore predefinito è false, che disabilita le credenziali utente nell'URI di connessione. Se AcceptCredentialsInUri è false e l'URI di connessione Oracle contiene le credenziali utente, l'adapter Oracle E-Business genera un'eccezione. È possibile impostare AcceptCredentialsInUri su true se è necessario specificare le credenziali nell'URI. Per altre informazioni, vedere Creare l'URI di connessione di Oracle E-Business Suite. | bool (System.Boolean) |
Come si impostano le proprietà di associazione?
È possibile impostare le proprietà di associazione quando si specifica una connessione a Oracle E-Business Suite. Per informazioni su come impostare le proprietà di associazione quando si:
Usare il componente aggiuntivo Del progetto BizTalk del servizio adapter o il plug-in Add Adapter Service Reference Visual Studio, vedere immettere la descrizione del collegamento qui.
Configurare una porta di trasmissione o una porta di ricezione (posizione) in una soluzione BizTalk Server, vedere Configurazione manuale di un'associazione di porte fisiche all'adapter Oracle E-Business.
Usare il modello di canale WCF in una soluzione di programmazione, vedere Connettersi a Oracle E-Business Suite in Visual Studio.
Usare il modello di servizio WCF in una soluzione di programmazione, vedere Connettersi a Oracle E-Business Suite in Visual Studio.
Importante
Durante l'uso del componente aggiuntivo Del progetto BizTalk del servizio adapter o del plug-in Add Adapter Service Reference Visual Studio, se non si specifica un valore per una proprietà di associazione di tipo stringa e il cui valore predefinito è Null, tale proprietà di associazione non sarà disponibile rispettivamente nel file di associazione (un file XML) o nel file app.config. È necessario aggiungere manualmente la proprietà di associazione e il relativo valore nel file di associazione o nel file di app.config, se necessario.
Tuttavia, la proprietà di associazione OraclePassword non è disponibile nel file di associazione o nel file di app.config anche se si specifica un valore per questa proprietà di associazione durante l'uso del componente aggiuntivo del progetto BizTalk del servizio adapter o del plug-in del servizio adattatore di Visual Studio.