設定應用程式內容

在 Microsoft BizTalk Adapter for Oracle E-Business Suite 中，某些 Oracle E-Business Suite 成品的設定應用程式內容是必要的， (介面資料表、介面檢視、並行程式和要求集) ，才能對它們執行作業。 除非您已設定應用程式內容，Oracle E-Business 配接器才允許您在這些成品上執行作業。 不過，對於基礎 Oracle 資料庫中的成品，無論使用者是否要設定應用程式內容，都是由使用者決定。

什麼是應用程式內容

應用程式內容是一組與 Oracle E-Business Suite 中的成品相關聯的元素，可在成品上實作使用者喜好設定和存取控制。 應用程式內容包含下列元素：

• 使用者名稱：可連線到 Oracle E-Business Suite 的使用者。

• 責任：責任是 Oracle E-Business Suite 中的存取層級，可讓使用者只存取適合組織角色的資料和功能。 責任可以允許存取特定應用程式、作業單位、書籍集，以及受限的視窗、函式和其他責任清單。 藉由將責任指派給使用者，您可以在 Oracle E-Business Suite 中授與/限制使用者的存取權。

• 組織識別碼：Oracle E-Business Suite 支援設定多個組織。 這些不同的組織會以值、組織識別碼、Oracle E-Business Suite 中資料表的Org_ID資料行中唯一識別，以儲存這些組織的相關資訊。 藉由將責任指派給組織或明確選取組織，您可以授與/限制使用者對組織的存取權。

  如需有關 Oracle E-Business Suite 中責任、多個組織和組織識別碼的詳細資訊，請搜尋 Oracle 說明中心。

設定應用程式內容

當 Oracle E-Business 配接器連接到 Oracle E-Business Suite 中的基礎資料庫時，不會在配接器中建立或初始化 Oracle E-Business Suite 成品的應用程式內容。 您可以使用下列其中一項，在 Oracle E-Business 配接器中初始化或設定這些成品的應用程式內容：

• 系結屬性：Oracle E-Business 配接器會公開下列系結屬性來設定應用程式內容：OracleEBSOrganizationId、OracleUserName、OraclePassword、OracleEBSResponsibilityKey、OracleEBSResponsibilityName和ApplicationShortName。 您不需要為所有這些系結屬性指定值，即可設定各種成品的應用程式內容。 如需為成品設定應用程式內容所需的系結屬性相關資訊，請參閱本主題稍後 針對各種成品設定應用程式內容的系結屬性 。

• 訊息內容屬性：Oracle E-Business 配接器會公開下列訊息內容屬性來設定應用程式內容： ApplicationShortName、 OrganizationID、 ResponsibilityKey和 ResponsibilityName。 若要指定使用者名稱和密碼，您必須使用系結屬性。 如需如何使用訊息內容屬性設定應用程式內容的詳細資訊，請參閱 使用訊息內容屬性設定應用程式內容。

重要

針對 OracleEBSResponsibilityKey 系結屬性指定的值會覆寫 OracleEBSResponsibilityName 系結屬性的值。 同樣地，為 ResponsibilityKey 訊息內容屬性指定的值會覆寫 針對 ResponsibilityName 訊息內容屬性指定的值。

系結屬性與訊息內容屬性 (優先順序)

如果您使用系結屬性和訊息內容屬性來設定應用程式內容，則訊息內容屬性所指定的值會優先，並覆寫系結屬性所指定的值。 但是，例如，如果您將應用程式簡短名稱指定為訊息內容屬性，而其他名稱則指定為系結屬性，則只有應用程式簡短名稱的值會取自訊息內容屬性，而其餘則取自相關的系結屬性。

應用程式簡短名稱的優先順序

設定應用程式內容時，應用程式簡短名稱會以下列優先順序使用， (最高至最低) ：

• ApplicationShortName訊息內容屬性中指定的應用程式簡短名稱。

• SOAP 動作中指定的應用程式簡短名稱， (介面資料表、介面檢視、並行程式和要求集只會) 。

• ApplicationShortName系結屬性中指定的應用程式簡短名稱。

  不過，對於介面資料表、介面檢視、並行程式和要求集，此優先順序僅適用于設定應用程式內容時。 若要識別介面資料表、介面檢視、並行程式和要求集，則會使用 SOAP 動作中的應用程式簡短名稱。

  責任索引鍵和責任名稱的優先順序

  設定應用程式內容時，責任索引鍵和責任名稱會以下列優先順序使用， (最高至最低) ：

• ResponsibilityKey訊息內容屬性中指定的責任金鑰。

• ResponsibilityName訊息內容屬性中指定的責任名稱。

• OracleEBSResponsibilityKey系結屬性中指定的責任索引鍵。

• OracleEBSResponsibilityName系結屬性中指定的責任名稱。

提示

為何在系結屬性上使用訊息內容屬性來設定應用程式內容？ 如果您使用系結屬性設定應用程式內容，WCF-Custom Oracle E-Business 配接器的傳送埠只能用於您為系結屬性指定的特定組織識別碼、責任和應用程式。 相反地，如果您使用訊息內容屬性，您可以設定「泛型」WCF-Custom 傳送埠，並在訊息層級設定應用程式內容。

設定介面資料表、介面檢視、並行程式和要求集的應用程式內容， (強制)

您必須在 Oracle E-Business 配接器中對介面資料表、介面檢視、並行程式和要求集執行作業之前，先設定應用程式內容。 若要這樣做，您必須為系結屬性或稍早指定的訊息內容屬性提供適當的值。

重要

除非您已為必要的系結屬性或訊息內容屬性設定適當的值，否則您無法對介面資料表、介面檢視、並行程式和要求集執行作業。

設定 PL/SQL API、程式、函式、資料表和檢視的應用程式內容

• PL/SQL API：Oracle E-Business 配接器會公開與 Oracle 資料庫以及 Oracle E-Business Suite 應用程式相關聯的 PL/SQL API。 雖然選擇性地為與 Oracle 資料庫相關聯的 PL/SQL API 設定應用程式內容，但必須為與 Oracle E-Business Suite 應用程式相關聯的 PL/SQL API 設定應用程式內容。

• 程式和函式：不一定要設定應用程式內容，以在 Oracle 資料庫中的程式和函式上執行作業。

• 資料表和檢視表：不一定要設定應用程式內容，以對 Oracle 資料庫中的資料表和檢視執行作業。 不過，針對自訂 Oracle E-Business Suite 應用程式，使用者可能無法將基底資料庫資料表註冊為介面資料表。 如果資料庫資料表未註冊為介面資料表，則會與 Oracle E-Business 配接器中的資料庫資料表一起顯示。 由於這些資料表與 Oracle E-Business 應用程式相關聯，因此對於這些資料表上的任何作業，您必須設定應用程式內容。

  若要設定這些成品的應用程式內容，您必須為系結屬性或稍早指定的訊息內容屬性提供適當的值。

設定 Poll、ExecuteNonQuery、ExecuteReader、ExecuteScalar 和複合作業的應用程式內容

除了成品之外，您也可以針對在這些成品上執行的各種作業設定應用程式內容。

• 若要設定輪詢作業的應用程式內容，您只能使用稍早指定的系結屬性。 若要設定應用程式內容，您必須為執行輪詢作業的成品提供適當的系結屬性值。 例如，如果在介面資料表上執行 Poll 作業，則必須為介面資料表的系結屬性指定值。

• 若要設定 ExecuteNonQuery、ExecuteReader 和 ExecuteScalar 作業的應用程式內容，您必須針對先前指定的系結屬性或訊息內容屬性提供適當的值。 若要設定這些作業的應用程式內容，您必須為系結屬性或適用于執行作業之成品的訊息內容屬性提供適當的值。

• 若要設定複合作業的應用程式內容，您必須為系結屬性或稍早指定的訊息內容屬性提供適當的值。 若要設定複合作業的應用程式內容，您必須為系結屬性或適用于個別作業的訊息內容屬性提供適當的值。 例如，如果複合作業包含兩個作業：一個在介面資料表上，另一個在資料庫資料表上，則您必須指定系結屬性的值或介面資料表的訊息內容屬性，以及資料庫資料表的系結屬性或訊息內容屬性。

  重要

  對於所有這些作業，如果作業是在 Oracle E-Business Suite 中的成品上執行， (介面資料表、介面檢視、並行程式或要求集) ，則必須設定應用程式內容。 如果作業是在基礎資料庫中的成品上執行，則不需要設定應用程式內容。 例如，如果您在介面資料表上執行 Poll 作業，則必須設定應用程式內容，而輪詢作業是在資料表上執行，則不需要設定應用程式內容。

設定執行作業的語言

Oracle E-Business 配接器支援 Oracle E-Business Suite 的多重語言支援 (MLS) 功能，並可讓您在執行作業時指定語言。 配接器會在MlsSettings系結屬性和Language訊息內容屬性下公開Language系結屬性，以指定執行作業的語言。

為Language訊息內容屬性指定的值會覆寫MlsSettings系結屬性下Language系結屬性的值。 如需 MlsSettings 系結屬性的詳細資訊，請參閱 閱讀 BizTalk Adapter for Oracle E-Business Suite 系結屬性。

設定各種成品之應用程式內容的系結屬性

下表提供系結屬性的相關資訊，您必須指定適當的值，才能設定各種成品的應用程式內容：

Artifacts	OracleEBSOrganizationId	OracleUserName	OraclePassword	OracleEBSResponsibilityKey 或 OracleEBSResponsibilityName	ApplicationShortName
介面資料表和介面檢視	√*	√	√	√
並行程式	√*	√	√	√
要求集	√*	√	√	√
PL/SQL API	√*	√	√	√	√
程序及函數	√*	√	√	√	√
資料表和檢視表	√*	√	√	√	√

√* = 選擇性

重要

• OracleEBSOrganizationId系結屬性的預設值 (選擇性) 為 null。 如果您指定 OracleEBSOrganizationId 系結屬性的值，Oracle E-Business 配接器會在設定應用程式內容時，將會話的ORG_ID設定為此值。
  • 針對 OracleEBSResponsibilityKey 系結屬性指定的值會覆寫 OracleEBSResponsibilityName 系結屬性所指定的值。

如需這些系結屬性的詳細資訊，請參閱 閱讀 BizTalk Adapter for Oracle E-Business Suite 系結屬性。

另請參閱

可以使用配接器執行哪些作業？