共用方式為


閱讀 BizTalk Adapter for Oracle E-Business Suite 系結屬性

Microsoft BizTalk Adapter for Oracle E-Business Suite 會顯示數個系結屬性。 藉由設定這些屬性,您可以控制部分配接器的行為。 本節描述 Oracle E-Business 配接器系結屬性。 它也會示範如何使用 .NET 程式設計,或在實體埠系結上設定 BizTalk Server屬性,來存取它們。

配接器系結屬性

Oracle E-Business Suite 是基礎 Oracle 資料庫上的應用層。 有些系結屬性會在與 Oracle E-Business Suite 互動時設定配接器的行為,而其他屬性則設定與 Oracle 資料庫互動時的行為。 下表顯示依類別分組的所有 Oracle E-Business 配接器系結屬性。 類別是指每個系結屬性出現在不同應用程式所呈現的對話方塊中,以設定配接器 (或系結) 的節點。

Binding 屬性 類別 描述 .NET 類型
ClientCredentialType 一般 指定在建立與 Oracle E-Business Suite 的連線時,所指定的認證集。 可能的值為 DatabaseEBusiness

- 如果設定為 Database,配接器用戶端必須指定資料庫認證,才能建立 OracleUserNameOraclePassword 系結 屬性的連線和 E-Business Suite 認證。

- 如果設定為 EBusiness,配接器用戶端必須指定 E-Business Suite 認證,以建立 OracleUserNameOraclePassword 系結 屬性的連接和資料庫認證。

重要: 如果 ClientCredentialType 系結屬性設定為 EBusiness,則為 OracleUserNameOraclePassword 系結 屬性指定資料庫使用者名稱和密碼是必要的。

預設值為 Database
enum (ClientCredential)
CloseTimeout 一般 WCF 連線關閉逾時。 指定時間範圍值,指出提供給內部 WCF 通道關閉作業完成的時間間隔。 預設值是 1 分鐘。 不支援。 System.TimeSpan
EnableBizTalkCompatibilityMode 一般 指定配接器如何產生 DataSet 的架構。 將此設定為 True ,以正確產生 DataSet 的架構。

從 BizTalk Server 使用配接器時,您必須一律將 屬性設定為True。 從 Visual Studio 使用配接器時,您必須一律將 屬性設定為 False
bool (System.Boolean)
InboundOperationType 一般 指定您要執行 輪詢通知 輸入作業。 預設值為 Polling

如需 輪詢的詳細資訊, 請參閱 支援使用輪詢的輸入呼叫。 如需 通知的詳細資訊,請參閱 使用 Oracle 資料庫配接器接收資料庫變更通知的考慮
列舉
名稱 一般 唯讀值,會傳回新增配接器服務參考 Visual Studio 外掛程式所產生的檔案名,以保存 WCF 用戶端類別。 新增配接器服務參考外掛程式會將 「Client」 附加至 Name 屬性的值,以形成檔案名。 傳回的值是 「OracleEBSBinding」;針對此值,產生的檔案會命名為 「OracleEBSBindingClient」。 字串
OpenTimeout 一般 WCF 連線開啟逾時。 指定時間範圍值,指出提供給內部通道開啟作業完成的時間間隔。 預設值是 1 分鐘。

重要: Oracle E-Business 配接器一律會使用 OpenTimeout ,在開啟與 Oracle 資料庫的連線時設定連線開啟逾時。 配接器會忽略當您開啟通訊物件時所傳遞的任何逾時 (System.TimeSpan) 參數,例如通道。
System.TimeSpan
ReceiveTimeout 一般 WCF 訊息接收逾時。 指定時間範圍值,指出配接器等候輸入訊息的最大時間間隔。 預設值是 10 分鐘。

重要: 針對輪詢之類的輸入作業,我們建議將逾時設定為可能的最大值,也就是 24.20:31:23.6470000 (24 天) 。 搭配BizTalk Server使用配接器時,將逾時設定為大值並不會影響配接器的功能。
System.TimeSpan
SendTimeout 一般 WCF 訊息傳送逾時。 指定時間範圍值,指出提供給內部通道傳送作業完成的時間間隔。 預設值為 5 分鐘。 System.TimeSpan
UseAmbientTransaction 一般 指定 Oracle E-Business 配接器是否使用呼叫端所提供的交易內容來執行作業。 預設值為 true,這表示配接器一律會在交易內容中執行作業,假設用戶端正在提供交易內容。 如果有其他資源參與交易,連線會在 System.Transaction 中建立,並提升為 MSDTC 交易。

不過,在某些情況下,您不希望配接器在交易內容中執行作業。 例如:

- 在傳送埠上執行 Oracle 資料庫 (的簡單 SELECT 作業時)

- 同時指定執行 SELECT 作業的輪詢語句,而且不會透過 DELETE 子句或叫用接收埠上的預存程式 (,來牽涉到資料表的任何變更)

這兩項作業都不會對資料庫資料表進行任何更新,因此,將這些作業提升為使用 MSDTC 交易可能是效能額外負荷。 在這種情況下,您可以將系結屬性設定為 false ,讓 Oracle E-Business 配接器不會在交易內容中執行作業。

注意: 只有在未對資料庫進行變更的作業時,才建議不要在交易內容中執行作業。 對於更新資料庫中資料的作業,建議您將系結屬性設定為 true,否則,視您執行輸入或輸出作業而定,可能會遇到訊息遺失或重複的訊息。
bool (System.Boolean)
DataFetchSize 緩衝區管理 ODP.NET 屬性。 指定以位元組為單位的資料量,ODP.NET 從一個伺服器往返的結果集中擷取。 預設值為 65536。 這個屬性用於效能微調。 long (System.Int64)
InsertBatchSize 緩衝區管理 指定多個記錄插入作業的批次大小。 預設值為 20。 若為 InsertBatchSize 大於一的值,Oracle E-Business 配接器會將指定的記錄數目批次處理成單一 ODP.NET 呼叫。 如果 Insert 作業中的記錄數目不是批次大小的倍數,最終批次將包含少於批次大小值的記錄。 例如,如果插入訊息有 10 筆記錄,且 InsertBatchSize 設定為 1,配接器會讀取個別記錄,並將其寫入 Oracle 資料庫。 因此,配接器會在 Oracle 資料庫上執行 10 個不同的作業。 同樣地,如果插入訊息有 10 筆記錄,且 InsertBatchSize 設定為 5,配接器會一次讀取並寫入 5 筆記錄到 Oracle 資料庫,因此只執行 2 個插入作業。

針對 InsertBatchSize選擇良好的值,可以大幅改善多個記錄 Insert 作業的配接器效能。
int (System.Int32)
LongDatatypeColumnSize 緩衝區管理 指定 Oracle long 資料類型資料行的位元組大小上限。 這個系結屬性的最大值可以是 32512。 預設值是 0。 如果您未對 long 資料類型執行作業,則必須使用預設值。 如果您是下列專案,您必須明確為此系結屬性設定適當的值:

- 執行包含 long 資料類型參數的預存程式。

- 在包含長資料類型之資料行的資料表上執行 Select 作業,而 SELECT 語句不包含主鍵資料行。

如果您想要設定這個系結屬性的最大值,請將值設定為 -1

注意: 這個系結屬性已被取代。
int
MaxOutputAssociativeArrayElements 緩衝區管理 指定配接器在執行在回應中傳回關聯陣列的作業時所建立的關聯陣列大小。 配接器會將陣列的大小傳達給 ODP.NET,接著會根據陣列大小建立緩衝區。 預設值為 32。

執行涉及 PL/SQL 資料表類型的作業時,這個系結屬性很有用。
int (System.Int32)
MetadataPooling 緩衝區管理 ODP.NET 屬性。 指定 ODP.NET 是否快取已執行查詢的中繼資料資訊。 預設值為 true,可啟用元資料共用。 快取這項資訊可改善效能;不過,如果基礎 Oracle 成品的變更發生在 Oracle 系統上,此集區中繼資料將會不同步。這可能會導致在 Oracle 系統上執行的作業傳回非預期的例外狀況。 這個屬性用於效能微調。 bool (System.Boolean)
StatementCachePurge 緩衝區管理 ODP.NET 屬性。 指定當連接傳回至連接集區時,是否清除與連接相關聯的 ODP.NET 語句快取。 預設值為 false,這會停用語句快取清除。 這個屬性用於效能微調。 bool (System.Boolean)
StatementCacheSize 緩衝區管理 ODP.NET 屬性。 指定每個 ODP.NET 連接可以快取的語句數目上限。 將此屬性設定為非零值會啟用連線的語句快取。 預設值為 10。 這個屬性用於效能微調。 int (System.Int32)
OracleConnectionClientId 偵錯 指定用戶端識別碼 (識別碼) ,以供配接器用來連線到 Oracle 的連線。 如果您已啟用 Oracle 伺服器端追蹤,而且想要選擇性地追蹤特定用戶端識別碼的作業,這非常有用。 這也可讓您根據用戶端識別碼來篩選和檢視 Oracle 伺服器追蹤。 字串
EnablePerformanceCounters 診斷 指定是否要啟用 WCF LOB 配接器 SDK 效能計數器和 Oracle E-Business 配接器 LOB 延遲效能計數器。 預設值為 False;效能計數器已停用。 LOB 延遲效能計數器會測量 Oracle E-Business 配接器呼叫 Oracle E-Business Suite 所花費的總時間。 bool (System.Boolean)
EnableSafeTyping 中繼資料 啟用或停用安全輸入。 預設值為 false;安全輸入已停用。 此功能可控制配接器如何呈現特定 Oracle 資料類型。 如需安全輸入的詳細資訊,請參閱 基本 Oracle 資料類型 bool (System.Boolean)
UseSchemaInNameSpace 中繼資料 指定架構名稱 (SCOTT、HR 等) 是否包含在作業的 xml 命名空間中,以及其基礎資料庫成品上的相關聯類型。 預設值為 True;架構名稱包含在 命名空間中。 命名空間中未包含配置名稱的優點是,如果有相同名稱的資料表 (例如,EMP) 兩個不同的架構中,則相同的 XML 可用來在兩個數據表上執行簡單的 SQL 作業, (Insert、Update、Delete、Select) 。

例如,如果 UseSchemaInNamespace 屬性為 true,則 SCOTT 上這些作業的命名空間。EMP 資料表為 http://schemas.microsoft.com/OracleEBS/Tables/SCOTT/EMP ,如果為 false,則命名空間為 http://schemas.microsoft.com/OracleEBS/Tables/EMP

重要: 訊息動作不受 UseSchemaInNamesapce 系結屬性影響;它一律包含架構名稱。

重要: 我們強烈建議在產生中繼資料時,將此系結屬性設定為 True 。 如果您將此屬性設定為 false,Oracle 架構名稱 (例如,SCOTT) 將無法在所產生架構的 XML 命名空間中使用。 因此,如果兩個不同的 Oracle 架構中有兩個具有相同名稱的資料表,而且它們會新增至相同的 BizTalk 專案,BizTalk 專案將無法建置和部署。 如果您想要將這類架構包含在相同的 BizTalk 專案中,您必須手動編輯這些架構,以在 XML 命名空間中包含 Oracle 架構名稱。
bool (System.Boolean)
MlsSettings 多語言支援 Oracle E-Business Suite 實例可以安裝多個語言套件。 因此,如果配接器是從具有多語言支援的 Oracle E-Business Suite 實例擷取中繼資料, (MLS) ,配接器必須以與登入的使用者偏好相同的語言設定來呈現資訊。

MlsSettings系結屬性可讓配接器用戶端指定 MLS 特定的選項。 這個系結屬性可以在設計階段和執行時間同時指定。 MlsSettings系結屬性是複雜的系結屬性,接著會包含更多系結屬性。 所有這些系結屬性都是選擇性的。 配接器會以下列方式使用系結屬性來設定 MLS 內容:

- 對於具有指定值的系結屬性,配接器會使用這些值來設定 MLS 內容。

- 對於未指定值的系結屬性,配接器會在安裝介面卡的同一部電腦上,使用 ODP.NET 用戶端的 MLS 設定。

下表列出屬於 MlsSettings 系結屬性一部分的系結屬性。 所有這些屬性都是選擇性的。

行事曆:指定行事曆系統。 這個系結屬性會對應至 ODP.NET 用戶端中的NLS_CALENDAR設定。

比較:指定 PL/SQL 區塊中 WHERE 子句和比較的比較方法。 這個系結屬性會對應至 ODP.NET 用戶端中的NLS_COMP設定。

貨幣:指定要當做 L 數位格式專案之當地貨幣符號使用的字串。 如需 Oracle 中各種數位格式專案和格式模型的相關資訊,請參閱 https://go.microsoft.com/fwlink/?LinkId=135807 。 這個系結屬性會對應至 ODP.NET 用戶端中的NLS_CURRENCY設定。

DateFormat:指定顯示日期的格式。 這個系結屬性會對應至 ODP.NET 用戶端中的NLS_DATE_FORMAT設定。

DateLanguage:指定日和月名稱的語言。 這個系結屬性會對應至 ODP.NET 用戶端中的NLS_DATE_LANGUAGE設定

DualCurrency:指定 U 數位格式元素的雙重貨幣符號,例如 Euro。 如需 Oracle 中各種數位格式專案和格式模型的資訊,請參閱 https://go.microsoft.com/fwlink/?LinkId=135807 。 這個系結屬性會對應至 ODP.NET 用戶端中的NLS_DUAL_CURRENCY設定。

ISOCurrency:指定要作為 C number 格式元素之國際貨幣符號的字串。 如需 Oracle 中各種數位格式專案和格式模型的資訊,請參閱 https://go.microsoft.com/fwlink/?LinkId=135807 。 這個系結屬性會對應至 ODP.NET 用戶端中的NLS_ISO_CURRENCY設定。

語言:指定要設定為 MLS 內容的一部分的語言。 這個系結屬性會對應至 ODP.NET 用戶端中的NLS_LANGUAGE設定。

重要:OracleEBSResponsibilityName系結屬性的值必須以與Language系結屬性指定的相同語言指定。 例如,如果您將 Language 系結屬性設定為西班牙文,您為 OracleEBSResponsibilityName 系結屬性指定的責任名稱也必須是西班牙文。

LengthSemantics:啟用使用位元組或字元 (預設) 長度語意建立 CHAR 和 VARCHAR2 資料行。 這個系結屬性會對應至 ODP.NET 用戶端中的NLS_LENGTH_SEMANTICS設定。

NCharConversionException:指定隱含或明確字元類型轉換期間的資料是否會報告錯誤。 預設值為 True。 這個系結屬性會對應至 ODP.NET 用戶端中的NLS_NCHAR_CONV_EXCP設定。

NumericCharacters:指定小數位符和群組分隔符號。 這個系結屬性會對應至 ODP.NET 用戶端中的NLS_NUMERIC_CHARACTERS設定。

排序:指定字元資料的排序類型。 這個系結屬性會對應至 ODP.NET 用戶端中的NLS_SORT設定。

領域:指定領域之日期和數值格式的慣例。 這個系結屬性會對應至 ODP.NET 用戶端中的NLS_TERRITORY設定。

TimeStampFormat:指定 TimeStamp 資料類型的字串格式。 這個系結屬性會對應至 ODP.NET 用戶端中的NLS_TIMESTAMP_FORMAT設定。

TimeStampTZFormat:指定 TimeStampTZ 資料類型的字串格式。 這個系結屬性會對應至 ODP.NET 用戶端中的NLS_TIMESTAMP_TZ_FORMAT設定。

TimeZone:指定時區區功能變數名稱稱。 這個系結屬性會對應至 ODP.NET 用戶端中的TIME_ZONE設定。
列舉
NotificationPort 通知 指定 ODP.NET 必須開啟的埠號碼,以接聽 Oracle 資料庫中的資料庫變更通知。 預設值為 -1,表示 ODP.NET 使用有效、隨機、未使用的埠號碼。

重要: 如果開啟 Windows 防火牆,配接器用戶端將不會收到資料庫變更通知。 此外,不建議關閉 Windows 防火牆以接收通知。 因此,若要接收通知而不危害用戶端電腦的安全性,建議您將正整數值指定為埠號碼,然後將該埠號碼新增至 Windows 防火牆例外狀況清單。 如果您將此系結屬性設定為 -1 的預設值,ODP.NET 會使用隨機埠,而配接器用戶端將不知道要新增至 Windows 防火牆例外狀況清單的埠。 如需如何將埠新增至 Windows 防火牆例外狀況清單的指示,請參閱 https://go.microsoft.com/fwlink/?LinkID=196959

謹慎: 如果應用程式域中有多個應用程式使用 Oracle E-Business 配接器接收通知,則所有應用程式的 NotificationPort 系結屬性都必須設定為相同的埠號碼。 這是因為 ODP.NET 只會建立一個接聽程式,在應用程式域內的一個埠上接聽。
int (System.Int32)
NotificationStatement 通知 指定用來註冊以從 Oracle 資料庫取得通知的 SELECT 語句。 SELECT 語句範例可能如下所示。

SELECT TID,ACCOUNT,PROCESSED FROM SCOTT.ACCOUNTACTIVITY WHERE PROCESSED = ‘n’

注意: 您必須指定資料庫物件名稱以及架構名稱。 例如: SCOTT.ACCOUNTACTIVITY

只有在指定 SELECT 語句的結果集變更時,配接器才會從 Oracle 資料庫取得通知訊息。
字串
NotifyOnListenerStart 通知 指定介面卡是否會在接聽程式啟動時,將通知訊息傳送給配接器用戶端,通知接收位置正在執行。 預設值為 True bool (System.Boolean)
ConnectionLifetime Oracle 連線集區 ODP.NET 屬性。 指定連線的持續時間上限,以秒為單位。 預設值是 0。 此屬性用於效能微調。 int (System.Int32)
DecrPoolSize Oracle 連線集區 ODP.NET 屬性。 指定在未使用過多已建立連線時關閉的連線數目。 預設值是 1。 這是用於效能微調。 int (System.Int32)
IncrPoolSize Oracle 連線集區 ODP.NET 屬性。 指定要求新連線時所要建立的新連線數目,而且 ODP.NET 連線集區中沒有可用的連線。 預設值為 5。 此屬性用於效能微調。 int (System.Int32)
MaxPoolSize Oracle 連線集區 ODP.NET 屬性。 指定 ODP.NET 連線集區中的連線數目上限。 預設值為 100。 此屬性用於效能微調。

重要: 您必須以謹慎方式設定 MaxPoolSize 。 如果此值設定過大,可能會耗盡 ODP.NET 可用的連線數目。
int (System.Int32)
MinPoolSize Oracle 連線集區 ODP.NET 屬性。 指定 ODP.NET 連線集區中的最小連線數目。 預設值是 1。 此屬性用於效能微調。 int (System.Int32)
UseOracleConnectionPool Oracle 連線集區 ODP.NET 屬性。 指定是否要使用 ODP.NET 連線集區。 預設值為 true,可啟用連線共用。 Oracle E-Business 配接器會使用 ODP.NET 連線集區來實作連線共用。 bool (System.Boolean)
ApplicationShortName OracleEBS Oracle E-Business Suite 應用程式的簡短名稱。 您必須提供應用程式簡短名稱,同時設定特定 PL/SQL API 的應用程式內容,以及資料庫資料表或檢視表。 但是,為什麼我們只需要針對特定 PL/SQL API 和資料庫資料表或檢視設定應用程式內容?

- 與 Oracle E-Business Suite 中的 Oracle 資料庫和應用程式相關聯的 PL/SQL API,也可以在設計階段的「成品型檢視」和「Schema-Based 檢視」節點下使用「取用配接器服務增益集」或「新增配接器服務參考外掛程式」。 在執行與 Oracle 資料庫相關聯的 PL/SQL API 時,您不需要設定這個系結屬性。 不過,在執行與 Oracle E-Business Suite 應用程式相關聯的 PL/SQL API 時,您必須為此系結屬性指定有效的值來設定應用程式內容。

- 針對自訂 Oracle E-Business Suite 應用程式,使用者不一定會將基底資料庫資料表註冊為介面資料表。 如果資料庫資料表未註冊為介面資料表,則在設計階段使用「取用配接器服務增益集」或「新增配接器服務參考外掛程式」時,將會在「資料庫」節點下取得。 不過,由於這些資料表與 Oracle E-Business 應用程式相關聯,因此對於這些資料表上的任何作業,您必須設定應用程式內容。

因此,若要在 PL/SQL API 上執行任何作業,以及屬於 Oracle E-Business Suite 的資料庫資料表或檢視表,您必須一律指定應用程式簡短名稱。

重要: 在執行 PL/SQL API 或在與 Oracle E-Business Suite 應用程式相關聯的資料庫資料表或檢視表上執行任何作業時,您也必須:

- 將 ClientCredentialType 系結屬性設定為 EBusiness

- 設定 OracleUserNameOraclePassword 系結 屬性,以指定要連線到 Oracle E-Business Suite 的認證,以及

- 將 OracleEBSResponsibilityName 系結屬性設定為適當的責任名稱。

藉由設定這些系結屬性,您會通知配接器 PL/SQL API 或資料庫資料表或檢視表,您正在操作時會與 Oracle E-Business Suite 應用程式相關聯,因此 ApplicationShortName 系結屬性會變成必要。 相反地,如果您要在與 Oracle E-Business Suite 應用程式相關聯的資料庫資料表或檢視表上執行 PL/SQL API 或任何作業,而且您未適當地設定 ClientCredentialTypeOracleUserNameOraclePasswordOracleEBSResponsibilityName 系結屬性,配接器會忽略 ApplicationShortName,即使已設定,並假設您執行作業的 PL/SQL API 或資料庫資料表屬於 Oracle 資料庫。
字串
OracleEBSOrganizationId OracleEBS 指定 Oracle E-Business Suite 應用程式所屬的組織識別碼。 此屬性是選擇性的,只有在下列情況下才會考慮:

- ClientCredentialType 系結屬性設定為 EBusiness,且

- 適當地指定 OracleUserNameOraclePasswordOracleEBSResponsibilityName 系結屬性。
字串
OracleEBSResponsibilityKey OracleEBS 與 Oracle E-Business Suite 使用者相關聯的責任金鑰。

不同于 oracleEBSResponsibilityName 系結屬性 (責任名稱) ,責任索引鍵不依存于指定的語言。 這表示您不需要根據 語言 系結屬性中指定的值,以不同的語言指定責任索引鍵,同時設定 MLS 內容。

重要:

- 針對 OracleEBSResponsibilityKey 系結屬性指定的值會覆寫 OracleEBSResponsibilityName 系結屬性所指定的值。

- 如果您要對多種語言的資料執行作業,而且不想在每個語言中指定責任名稱,您應該在介面資料表上執行作業、從介面檢視中選取值,或執行並行程式或要求集時,指定這個系結屬性的值。 當然,即使您只使用英文的資料,您仍可以使用這個系結屬性。
字串
OracleEBSResponsibilityName OracleEBS 與 Oracle E-Business Suite 使用者相關聯的責任名稱。

責任名稱取決於指定的語言。 這表示如果您要藉由指定Language系結屬性的值來設定 MLS 內容,則必須以與Language系結屬性指定的相同語言來指定OracleEBSResponsibilityName系結屬性的值。 例如,如果您將 Language 系結屬性設定為西班牙文,您為 OracleEBSResponsibilityName 系結屬性指定的責任名稱也必須是西班牙文。

重要: 您必須指定這個系結屬性的值,同時在介面資料表上執行作業、從介面檢視中選取值,或執行並行程式。
字串
OraclePassword OracleEBS - 如果 ClientCredentialType 系結屬性設定為 Database,此屬性會指定 Oracle 資料庫使用者的密碼。

- 如果 ClientCredentialType 系結屬性設定為 EBusiness,則此屬性會指定 Oracle E-Business Suite 使用者的密碼。

當 Oracle E-Business 配接器連接到 Oracle E-Business Suite 時,不會保留您為 OraclePassword 系結 屬性輸入的值大小寫。 密碼會使用 SQL*Plus 的標準規則傳遞至 Oracle E-Business Suite。 不過,如果您想要保留密碼的大小寫,或想要輸入包含特殊字元的密碼,則必須在雙引號內指定值。

重要:

- 在介面資料表上執行作業時,從介面檢視選取值、執行並行程式,或執行與 Oracle E-Business Suite 應用程式相關聯的 PL/SQL API,您必須將 ClientCredentialType 系結屬性設定為 EBusiness ,然後指定有效的密碼以連線到 Oracle E-Business Suite。

- 系結檔案中無法使用 OraclePassword 系結 屬性, (XML 檔案) 或使用取用配接器服務 BizTalk 專案增益集或新增配接器服務參考 Visual Studio 外掛程式所產生的 app.config 檔案。
字串
OracleUserName OracleEBS - 如果 ClientCredentialType 系結屬性設定為 Database,此屬性會指定 Oracle 資料庫上驗證的使用者名稱。

- 如果 ClientCredentialType 系結屬性設定為 EBusiness,此屬性會指定 Oracle E-Business Suite 上的驗證使用者名稱。

當 Oracle E-Business 配接器連接到 Oracle E-Business Suite 時,不會保留您為 OracleUserName 系結屬性輸入的值大小寫。 使用者名稱會使用 SQL*Plus 的標準規則傳遞至 Oracle E-Business Suite。 不過,如果您想要保留使用者名稱的大小寫,或想要輸入包含特殊字元的使用者名稱,則必須在雙引號內指定值。

重要: 在介面資料表上執行作業時,請從介面檢視選取值、執行並行程式,或執行與 Oracle E-Business Suite 應用程式相關聯的 PL/SQL API,您必須將 ClientCredentialType 系結屬性設定為 EBusiness ,然後指定有效的使用者名稱以連線到 Oracle E-Business Suite。
字串
PolledDataAvailableStatement 輪詢 指定執行的 SELECT 語句,以判斷是否有任何資料可用於輪詢特定資料表。 指定的語句必須傳回包含資料列和資料行的結果集。 結果集第一個儲存格中的值會指出配接器是否執行 PollingInput 系結屬性所指定的值。 如果結果的第一個儲存格包含正值,配接器會執行輪詢語句。 例如,這個系結屬性的有效語句會是:

Select * from <table_name>

提示: 如果您想要讓配接器繼續輪詢,不論所輪詢的資料表是否有資料,您可以將這個系結屬性的值指定為 Select 1 FROM DUAL

注意: 您不得指定這個系結屬性的預存程式。 此外,此語句不得修改基礎 Oracle 資料庫。
字串
PollingAction 輪詢 指定輪詢作業的動作。 您可以使用取用配接器服務增益集,從為作業產生的中繼資料,判斷特定作業的輪詢動作。 字串
PollingInput 輪詢 指定輪詢語句。 您可以指定簡單的 SELECT 語句或預存程式來進行輪詢。 如果您想要輪詢資料表或檢視表,您必須為此系結屬性指定 SELECT 語句。 如果您想要使用預存程式輪詢,您必須指定這個系結屬性的整個要求訊息。 要求訊息必須與您傳送至配接器相同,才能將預存程式叫用為輸出作業。

注意: 只有在 PolledDataAvailableStatement 系結屬性所執行的語句傳回某些資料時,才會執行為此系結屬性指定的 SQL 語句或預存程式。

重要: Oracle E-Business 配接器會在 Oracle 交易內指定) 時執行輪詢語句和輪詢後語句 (。 如果您在 PollingInput 系結屬性中使用 SELECT 語句,建議您在 SELECT 語句中指定 FOR UPDATE 子句。 這可確保在交易期間鎖定選取的記錄,而且輪詢後語句可以在選取的記錄上執行任何必要的更新。
字串
PollingInterval 輪詢 指定交易輪詢間隔,也就是 Oracle E-Business 配接器針對 Oracle 資料庫執行針對 PollingInput 系結屬性指定的語句,以秒為單位的間隔。 預設值是 30。 配接器會使用輪詢間隔來進行下列動作:

- 連續輪詢之間的時間間隔。 此間隔是用來執行輪詢和輪詢後查詢。 如果這些查詢是在指定的間隔內執行,配接器會睡眠間隔中的剩餘時間。

- 輪詢交易逾時值。 此值必須設定夠大,以包含輪詢語句執行時間、如果指定) 執行時間,以及從用戶端應用程式接收回複的時間來認可交易,則輪詢後語句 (。

如果用戶端應用程式在輪詢間隔到期之前傳送回復,配接器會認可交易,並等到輪詢間隔達到執行下一個輪詢為止。

如果用戶端應用程式傳回錯誤,配接器就會終止交易。

如果輪詢間隔在用戶端應用程式傳送回復之前到期,交易將會逾時。
int (System.Int32)
PollWhileDataFound 輪詢 指定如果輪詢資料表中有資料可用,Oracle E-Business 配接器是否忽略輪詢間隔,並持續輪詢 Oracle 資料庫。 如果資料表中沒有可用的資料,配接器會還原為在指定的輪詢間隔執行 SQL 語句。 預設值為 false

假設輪詢間隔設定為 60 秒,而 針對 PolledDataAvailableStatement 指定的語句會傳回可供輪詢的資料。 接著,配接器會執行 針對 PollingInput 系結屬性指定的語句。 假設配接器只需要 10 秒才能執行 語句,現在必須等候 50 秒,再再次執行 PolledDataAvailableStatement ,然後接著執行輪詢語句。 相反地,若要優化效能,您可以將 PollWhileDataFound 系結屬性設定為 true ,讓配接器可以在前一個輪詢週期結束時立即開始執行下一個輪詢迴圈。

注意: 這個系結屬性適用于在資料表和檢視上輪詢,以及使用預存程式輪詢。
字串
PostPollStatement 輪詢 指定執行 PollingInput 系結屬性所指定語句之後所執行的語句區塊。 預設值為 null;不會執行輪詢後語句。 輪詢後語句會在輪詢交易內執行。 輪詢後語句的兩個常見用法是:

- 更新輪詢語句中傳回的資料列資料行,以指出它們已處理過,而且應該從後續輪詢查詢中排除。

- 將已處理的記錄移至不同的資料表。

重要: 如果指定輪詢後語句, PollingInterval 應該設定夠大,讓輪詢後語句在間隔到期之前完成。

如需如何在輪詢案例中使用系結屬性的詳細資訊,請參閱輪詢型資料變更通知的概觀。
字串
SkipNilNodes 執行時間行為 指定 Oracle E-Business 配接器是否會略過在要求 XML 中標示為 'nil' 的節點插入或更新值。 這個系結屬性適用于在資料表中插入或更新記錄,以及預存程式中的 RECORD 類型參數。 預設值為 true,這表示配接器會略過標示為 'nil' 的節點傳遞值。 在此情況下,如果指定的) 會考慮標示為 'nil' 的節點,Oracle (中的預設值。 如果設定為 false,配接器會明確傳遞這些節點的 Null 值。

注意:

- 對於要求 XML 中不存在的節點,配接器一律會略過傳遞值,而不論 SkipNilNodes 系結屬性的值為何。

- 針對 RECORDS 的 PL/SQL 資料表,配接器一律會針對要求 XML 中標示為 'nil' 或不存在的節點傳遞 Null 值,而不論 SkipNilNodes 系結屬性的值為何。

下列範例會根據您為此系結屬性設定的值,說明介面卡組態的差異。 假設要求 XML 如下所示:

<EMPNO>1000</EMPNO> <ENAME>John</ENAME> <SAL nil=’true’></SAL>

如果 SkipNilNodes 設定為 true,配接器會執行下列命令:

INSERT INTO EMP (EMPNO, ENAME) VALUES (1000, “John”);

如果 SkipNilNodes 設定為 false,配接器會執行下列查詢:

INSERT INTO EMP (EMPNO, ENAME, SAL) VALUES (1000, “John”, null);

請注意,在第二個語句中,配接器會明確插入參數 「SAL」 的 Null 值。
bool (System.Boolean)
GeneratedUserTypesAssemblyFilePath UDT .NET 類型產生 – 設計階段 指定配接器產生之 DLL 的名稱和路徑,同時產生中繼資料,其中包含中繼資料中使用的所有 UDT。 如果您要為使用 UDT 的封裝、預存程式或函式產生中繼資料,則必須指定 DLL 名稱。 針對具有 UDT 的資料表和檢視表,指定 DLL 名稱是選擇性的。 產生的 DLL 會儲存到與可執行檔相同的位置。

只有在產生中繼資料時,才需要此系結屬性。

注意:

- 您只能指定一個檔案名。 針對中繼資料中的所有 UDT,配接器會產生具有指定名稱的單一檔案。 如果您未指定名稱,配接器會產生具有 GUID 名稱的 DLL。

- 設定WCF-OracleEBS接收或傳送埠時,BizTalk Server無法使用這個系結屬性。
字串
GeneratedUserTypesAssemblyKeyFilePath UDT .NET 類型產生 – 設計階段 指定配接器用來建立強型別元件之金鑰檔的名稱和路徑。

這個系結屬性是選擇性的,而且只有在產生中繼資料時才需要。

注意:設定WCF-OracleEBS接收或傳送埠時,BizTalk Server無法使用這個系結屬性。
字串
UserAssembliesLoadPath UDT .NET 類型產生 – 執行時間 指定 DLL 的名稱,並以分號分隔,配接器會在產生中繼資料時建立。 這些 DLL 會儲存在您為 GeneratedUserTypesAssemblyFilePath 系結屬性指定的位置,同時產生中繼資料。 您必須手動將這些 DLL 複製到下列位置:

- 對於 BizTalk 專案:將 DLL 複製到與 BTSNTSvc.exe 相同的位置。 針對 BizTalk Server,這通常位於安裝磁片磁碟機 > :\Program Files\Microsoft BizTalk Server下 < 。

- 針對 .NET 專案:將 DLL 複製到 .NET 專案資料夾內的 \bin\Development 資料夾。

只有在傳送和接收訊息以在 Oracle E-Business Suite 上執行作業時,才需要此系結屬性。
字串
AcceptCredentialsInUri [取用配接器服務增益集] 或 [新增配接器服務參考外掛程式] 未顯示。 指定 Oracle E-Business Suite 連線 URI 是否可以包含使用者認證。 預設值為 false,這會停用連線 URI 中的使用者認證。 如果 AcceptCredentialsInUrifalse ,且 Oracle 連線 URI 包含使用者認證,則 Oracle E-Business 配接器會擲回例外狀況。 如果您必須在 URI 中指定認證,您可以將 AcceptCredentialsInUri 設定為 true 。 如需詳細資訊,請參閱 建立 Oracle E-Business Suite 連線 URI bool (System.Boolean)

如何設定系結屬性?

當您指定與 Oracle E-Business Suite 的連線時,可以設定系結屬性。 如需如何在下列情況下設定系結屬性的相關資訊:

重要

使用取用配接器服務 BizTalk 專案增益集或新增配接器服務參考 Visual Studio 外掛程式時,如果您未針對字串類型的系結屬性指定值,且其預設值為 null,則系結檔案中將無法使用該系結屬性, (XML 檔案) 或 app.config 檔案。 如有必要,您必須在系結檔或 app.config 檔案中手動新增系結屬性及其值。

不過,即使您在使用取用配接器服務 BizTalk 專案增益集或新增配接器服務參考 Visual Studio 外掛程式時指定這個系結屬性的值,在系結檔案或 app.config 檔案中仍無法使用 OraclePassword 系結屬性。

另請參閱

開發活動