ERPアプリケーションへの接続の準備

Oracle Cloud ERPアプリケーションに接続するには、次を実行する必要があります:

特定の前提条件を満たす
WSDLまたはイベント・カタログURLの取得
必要なロールをユーザーに割り当てます。
イベント・サブスクリプション用のOracle Cloud ERPの構成
ファイルのアップロード手順の確認

接続を作成するための前提条件

Oracle Cloud ERPアダプタとの接続を作成するには、次の前提条件を満たす必要があります。

前提条件	摘要
Oracle Cloud ERPのサブスクライブ	このアクションにより、適切な権限を持つOracle Cloud ERPユーザー・アカウントを作成できます。このユーザー・アカウントは、「接続」ページでOracle Cloud ERP接続を作成するときに指定します。
必要なOracle Cloud ERPサービス・カタログ・サービスのWSDL URLまたはイベント・カタログURLの取得	必須のOracle Cloud ERPサービス・カタログ・サービスWSDL (ビジネス・オブジェクトにアクセスする場合)およびオプションでイベント・カタログURL (イベントをサブスクライブする場合)を指定する必要があります。
ユーザーへのロールの割当て	Oracle Fusion Cloud Applicationsユーザーに必要なロールがあることを確認します。これらのロールは、イベント・サブスクリプションの有効化またはビジネス・オブジェクトの選択に必要です。
Oracle Cloud ERPでのイベントのサブスクライブ	統合でOracle Cloud ERPイベントをサブスクライブするには、CSFキーを作成する必要があります。Oracle Fusion Cloud Supply Chain & Manufacturing (SCM)ドメインにあるOracle SOA ComposerインスタンスからCSFキーを作成します。
ファイルを一括でアップロードし、データをOracle Cloud ERPアプリケーション表に挿入します	Oracle Cloud ERPアダプタは、Oracle WebCenter Contentとの統合を通じてOracle Cloud ERPへのバルク・データのロードをサポートします。Oracle WebCenter Contentでは、ファイルのバルク・アップロードおよびOracle Cloud ERPアプリケーション表へのデータの挿入を実行できます。
Oracle WebCenter Contentへのファイルのアップロード	Oracle Cloud ERPアダプタは、Oracle WebCenter Contentへのファイルのロードをサポートしています。

Oracle Cloud ERPサービスWSDLの取得

ビジネス・オブジェクトまたはビジネス・サービスのいずれかを使用するようにインバウンドおよびアウトバウンド・アダプタにアクセスして構成するために、Oracle Cloud ERPサービス・カタログWSDLを取得する必要があります。

Oracle Cloud ERPアダプタを構成するには、serviceCatalog WSDLが必要です。serviceCatalog WSDLは、Oracle Cloud ERPインスタンスによって公開されるすべてのサービスのカタログです。カタログには、財務、プロジェクト管理、注文管理、在庫管理など、すべての製品のサービスが公開されています。

Oracle Cloud ERPの場合、サービス・カタログのWSDL URLは次のとおりです:

https://ERP_Host_Name.fs.<data center>.oraclecloud.com/fscmService/ServiceCatalogService?WSDL

統合ユーザーへの必須ロールの割当て

統合でOracle Cloud ERPアダプタを使用するには、統合ユーザーに特定のロールを割り当てる必要があります。

セキュリティ・コンソールを使用して、ロール、ユーザー、証明書、管理タスクなどのアプリケーション・セキュリティを管理します。セキュリティ・コンソールへのアクセスは、事前定義済のセキュリティ・マネージャ・ロールによって提供されます。次のようにセキュリティ・コンソールにアクセスします。

「設定および保守」作業領域の「ジョブ・ロールの管理」または「職務の管理」タスクを使用します。
「ナビゲータ」メニューから、「ツール」を選択します。

「セキュリティ・コンソール」を選択します。

イベント・サブスクリプション用のOracle Cloud ERPの構成

Oracle Cloud ERPのイベントをサブスクライブするには、CSFキーを作成する必要があります。このキーは、イベントハンドラフレームワークがインテグレーションを呼び出すときに必要です。統合の資格証明はCSFキーによって管理されます。Oracle SOA ComposerでCSFキーを作成します。

CSFキーの作成時に次の情報を正しく指定してください。

CSFキー名を作成します。名前は、Oracle Identity Cloud Service IDと統合インスタンスの名前の組合せである必要があります。
1. Oracle Integrationの右上隅にあるをクリックし、「情報」をクリックします。
2. 「アイデンティティ・ドメイン」の値(idcs-638a2ce020e60c2881など)と「サービス・インスタンス」の値(oic1575など)をコピーします。
3. 最初にアイデンティティ・ドメイン、2番目のサービス・インスタンス(間に空白なし)を使用してCSFキー値を組み立てます: idcs-638a2ce020e60c2881oic1575。
Oracle Cloud ERPをサブスクライブしたときに作成されたユーザー名ではなく、Oracle IntegrationにサインインするOracle Integrationユーザー・アカウントを使用してCSFキーを作成します。
CSFキー・パスワードが失効していないことを確認してください。

Oracle Cloud ERPを構成します:

SOA管理者ロールを持つユーザーでOracle SOA Composerにログインします。管理者からhostnameおよびportを取得します。
たとえば、SOAコンポーザのURLは次のとおりです。
```
 https://ERP_instance_name.fa.data center.oraclecloud.com/soa/composer
```
「セキュリティの管理」をクリックします。
CSFキー名を追加します。
Oracle Integrationにサインインするために入力したユーザー名とパスワードを指定します。
Oracle Cloud ERPにサブスクライブしたときに作成されたユーザー名とパスワードを入力しないでください。Oracle Integrationユーザーは、Oracle Integrationに存在し、ServiceUserロールが割り当てられている必要があります。Oracle Cloud ERPインフラストラクチャのCSFキー・エントリには、Oracle Cloud ERPで使用されるOracle Integration資格証明が格納されます。Oracle Fusion Cloud Applicationsは、アウトバウンド・リクエストを(実行時に)Oracle Integrationに送信すると、認証のためにこのアカウントの資格証明(ユーザー名とパスワード)を送信します。
「登録」をクリックします。

ファイルを一括でアップロードし、データをOracle Cloud ERPアプリケーション表に挿入

次の前提条件のアップロード・ファイルを一括で満たしてから、Oracle Cloud ERPアプリケーション表にデータを挿入する必要があります。

My ServiceページでERP Cloudアダプタ接続ユーザーに類似したユーザーを作成します。このユーザーは、Oracle Integration WebLogicセキュリティ・レルムにリンクされています。ユーザー名は、Oracle Cloud ERPのユーザー名と完全に一致する必要があります。パスワードとEメール・アドレスには、任意のものを指定できます。Oracle Cloud ERPアプリケーションでOracle Cloud ERPユーザーに正しいロールを選択していることを確認します。ユーザーには、SOAOperatorおよび統合ロールが必要です。
必要な証明書をインポートします。ブラウザで、サービス・カタログWSDL URLを入力します。
- WSDL URLは次のとおりです。
```
https://hostname:port/fscmService/ServiceCatalogService?WSDL
```

WSDLで、<dsig:x509Data>要素内にあるX509証明書セクションに移動します。次に例を示します。

</wsdl:binding>
    <wsdl:service name="ErpIntegrationService"
        <wsdl:port name="ErpIntegrationServiceSoapHttpPort" binding="tns:ErpIntegrationServiceSoapHttpPort"/>
            <soap:address location="https://hostname:port/fscmService/ErpIntegrationService"/>
            <wsa:EndpointReference xmlns:wsa="http://www.w3.org/2005/08/addressing">
            <wsa:Address xmlna:wsa="http://www.w3.org/2005/08/addressing">
                https://hostname:port/fscmService/ErpIntegrationService
            <wsa:Address>
            <wsid:Identity xmlns:wsis="http://schemas.xmlsoap.org/ws/2006/02/addressingidentity">
                <dsig:KeyInfo xmlns:dsig="http://www.w3.org/2000/09/xmldsig#">
                    <dsig:X509Data>
                        <dsig:X509Certificate>
                        //Copy certificate 1
                        djfhisjfjkjs4637rYiucy4r84378495847ydfiu678ww7789474re873477HSsfyGkwe3847qdi378TY
                        </dsig:X509Certificate>
                        <dsig:X509IssuerSerial>
                            <dsig:X509IssuerName>CN=Cloud9CA-2, DC=cloud, DC=oracle, DC=com</dsig:X509IssuerName>
                            <dsig:X509IssuerSerialNumber>45631179900002566</dsig:X509IssuerSerialNumber>
                        </dsig:X509IssuerSerial>
                        <dsig:X509SubjectName>CN=FAEncryption, DC=cloud, DC=oracle, DC=com</dsig:X509SubjectName>
                        <dsig:X509SKI>aKdfjjkrueTY46372NeiHJ</dsig:X509SKI>
                        <dsig:X509Certificate>
                        //Copy certificate 2
                        jhKIp9845eiseroi4d9Jl094osie9r9w309cw0890w4809589348f958985e098siHDD985983558KJj9
                        </dsig:X509Certificate>
                  </dsig:X509Data>
               </dsig:KeyInfo>
             </wsid:Identity>
           </wsa:EndpointReference>
         </wsdl:port>
       </wsdl:service>
    </wsdl:definitions>

1番目と2番目の証明書文字列を2つの個別のファイルにコピーします。たとえば、erp_cert1.cerおよびerp_cert2.cerです。
「証明書のアップロード」ダイアログのOracle Integrationで、両方の証明書を「メッセージ保護証明書」タイプとしてインポートし、一意の別名を入力します。
Satisfy the following manifest file recommendations (that is, the properties file in the ZIP file that must be uploaded to Oracle WebCenter Content for the bulk upload of files and the insertion of data into Oracle Cloud ERP application tables.このステップは、ジョブの完了時にERP Cloudコールバックに対してのみ必要です。
- マニフェスト・ファイルでは、次の形式でインポート・プロセス詳細が必要です:
```
job package name,job def name,manifest file name,job parameters (comma separated)
```
  例:
```
oracle/apps/ess/financials/payables/invoices/transactions,APXIIMPT,AP,#NULL,#NULL,#NULL,#NULL,#NULL,#NULL,#NULL,INVOICE
```
- _が含まれている場合、マニフェスト・ファイル名は実際のZIPファイル名の接頭辞である必要があります。それ以外の場合は、名前にしてください。たとえば、ZIPファイル名が AP_301.ZIPの場合、マニフェストファイル名は AP.propertiesであり、マニフェスト内の3番目の値はマニフェストファイル名である必要があります。ZIPファイル名が AP.ZIPの場合、マニフェストファイル名は AP.propertiesにし、マニフェスト内の3番目の値はマニフェストファイル名にするべきです。
- 起動アクションごとにサポートされるジョブは1つのみです。マニフェスト・プロパティ・ファイルに複数のエントリを設定して、インタフェース表からアプリケーション表に、順次処理用に最大10個、パラレル処理用に最大5個までのバッチでデータをインポートできます。たとえば、仕訳インポート・データ・ファイルには10個の元帳のレコードがあります。プロパティファイルには、パラメータとして一意の元帳名を持つ10のエントリがあります。データ・ファイルがインタフェース表にロードされた後、インポート・プロセスには元帳ごとに10個のサブプロセスがあります。
一括インポート機能を使用する統合を構成するには、次の前提条件を満たします。
Oracle Cloud ERPアダプタに次のパラメータをマップします:
- パラメータICSFileReferenceを他のアダプタ(たとえば、FTPアダプタ、RESTアダプタ、またはICSFileReferenceパラメータを持つ使用したアダプタ)のFile Referenceパラメータにマップします。
- ソース・スキーマからターゲット・スキーマにFileNameパラメータをマップします(ターゲット・スキーマはOracle Cloud ERP一括インポート・スキーマです)。FileNameは、リクエストごとに一意である必要があります。