Oracle Fusion Cloudをデータパイプラインのソースとして設定する
Oracle Fusion Cloudをデータパイプラインのソースとして設定し、レコードを宛先に抽出して同期します。 このガイドでは、Oracle Fusion Cloudをソースとして使用する場合のコネクションの設定、パイプライン設定、主な動作について説明します。
前提条件
コネクションを作成する前に、次の設定が完了していることを確認してください:
- Oracle Fusion Cloudインスタンスへのアクセス権
- 有効なOracle Fusion Cloudユーザー認証情報
- パイプラインで使用するオブジェクトにアクセスするために必要な権限
同期の概要
Oracle Fusion Cloudコネクターは、Oracle Business Intelligence Cloud Connector（BICC）を使用して、Oracle Fusion Cloudアプリケーションからデータを一括抽出します。 BICCにより、コネクターはOracle Fusion Cloudインスタンスからビジネスインテリジェンスやその他のデータを取得し、指定した宛先にロードできます。
サポートされている機能
Oracle Fusion Cloudをデータパイプラインのソースとして使用する場合、次の機能がサポートされます:
- Oracle Fusion Cloudモジュールからデータを抽出
- 完全同期および増分同期のサポート（サポートされている場合）
- オブジェクト抽出のためのフィールドレベルの選択
- スキーマドリフトの検出と処理
- フィールドレベルのデータマスキング
APIバージョン
Oracle Fusion Cloudコネクターは、DTU（Data Transfer Utility）のダウンロードにERP Integrations REST API v11.13.18.05およびOracle UCM Web Services（SOAP）を使用します。
接続方法
Oracle Fusion Cloudコネクションを作成するには、次の手順を実行します:
Oracle Fusion Cloudに接続
Oracle Fusion Cloudコネクターでは、次の認証方法がサポートされています。
Basic
Basic認証を使用してOracle Fusion Cloudに接続するには、次の手順を実行します。
Workatoにサインインします。
コネクションを保存するプロジェクトを選択します。
作成 > コネクションをクリックします。
Oracle Fusion Cloudを検索し、アプリとして選択します。
コネクション名フィールドにコネクションの名前を入力します。
Oracle Fusion Cloudに接続する（Basic認証）
コネクションを保存する予定のプロジェクトまたはフォルダを選択するには、ロケーションドロップダウンメニューを使用します。
Auth typeドロップダウンメニューを使用してBasicを選択します。
UsernameフィールドにOracle Fusion Cloudアカウントのユーザー名を入力します。
PasswordフィールドにOracle Fusion Cloudアカウントのパスワードを入力します。
Subdomainフィールドに、使用する特定のOracle Fusion Cloudインスタンスのサブドメインを入力します。 例: servername.fa.us2.oraclecloud.com。
接続をクリックします。
JWTトークン
JWTトークン認証を使用してOracle Fusion Cloudに接続するには、次の項目が必要です:
このプロセスの詳細については、OracleのConfigure JWT Authentication Providerチュートリアルも参照できます。
X.509キーペアを生成する
X.509キーペアは、公開証明書の真正性を検証して安全な通信を確立するために使用されます。
X.509キーペアを生成するには、次の手順を実行します。
Environment要件
これらの手順ではopensslを使用します。
- macOSおよびLinuxには、OpenSSLがデフォルトで含まれています
- Windowsには、OpenSSLがデフォルトで含まれていません。 OpenSSLをインストールするか、Git BashやWSL（Windows Subsystem for Linux）などのツールを使用してこれらのコマンドを実行します。
新しいターミナルウィンドウを開きます。
次のコマンドを実行して秘密鍵を生成します。
openssl genrsa -out private.key 2048このコマンドは2048ビットのRSA秘密鍵を作成し、private.keyに保存します。
次のコマンドを実行して、公開鍵を含むX.509証明書を生成します。
openssl req -new -x509 -key private.key -out publickey.cer -days 365このコマンドは、365日間有効な自己署名X.509証明書（publickey.cer）を生成します。
テキストエディターでprivate.keyファイルを開き、-----BEGIN RSA PRIVATE KEY-----で始まり-----END RSA PRIVATE KEY-----で終わる内容をコピーします。
後でWorkatoで設定を完了する際に使用できるよう、このキーを安全に保管します。
証明書フィンガープリントを取得する
証明書フィンガープリントは、証明書の真正性を検証するために使用される一意の識別子です。
証明書フィンガープリントを取得するには、次の手順を実行します。
Environment要件
これらの手順ではopensslを使用します。
- macOSおよびLinuxには、OpenSSLがデフォルトで含まれています
- Windowsには、OpenSSLがデフォルトで含まれていません。 OpenSSLをインストールするか、Git BashやWSL（Windows Subsystem for Linux）などのツールを使用してこれらのコマンドを実行します。
次のopensslコマンドを実行して、publickey.cerファイルからx5t値を生成します。
openssl x509 -sha1 -in publickey.cer -noout -fingerprintフィンガープリント出力は16進数形式です。
Fingerprint=00:6D:6F:4A:5F:36:71:10:24:F8:F0:FD:33:89:6D:C5:EB:92:00:0Fフィンガープリントをbase64形式に変換します。 文字列を実際の証明書フィンガープリントに置き換えます。
echo "00:6D:6F:4A:5F:36:71:10:24:F8:F0:FD:33:89:6D:C5:EB:92:00:0F" | xxd -r -p | base64フィンガープリント出力はbase64形式です。
AG1vSl82cRAk+PD9M4ltxeuSAA8=base64エンコード済みの証明書フィンガープリントをコピーし、安全に保管します。 この値はWorkatoでセットアップを完了するために必要です。
フィンガープリントを保存するときは、末尾の=をすべて削除します。
Oracle Fusion Cloudでトークンベース認証を設定する
Oracle Fusion Cloudでトークンベース認証を設定するには、次の手順を実行します。
Oracle Fusion Cloudにサインインします。
☰ Navigatorアイコンをクリックしてサイドバーを展開し、ツール > Securityに移動します。
API Authenticationをクリックします。
+ Create Oracle API Authentication Providerをクリックします。
編集をクリックします。
Trusted Issuerフィールドに呼び出し元プロバイダーの名前を入力します。 例: Workato。
Token TypeとしてJWTチェックボックスを選択します。
Oracle Fusion Cloudでトークンベース認証を設定する
Save and Closeをクリックします。
Inbound API Authentication Public Certificatesをクリックします。
+ Add New Certificateをクリックします。
Certificate Aliasフィールドに名前を入力します。
Choose Fileをクリックし、X.509キーペアを生成する手順で生成した公開証明書（publickey.cer）を選択します。
保存をクリックします。
Workatoでセットアップを完了する
JWTトークン認証を使用してOracle Fusion Cloudに接続するには、次の手順を実行します。
Workatoにサインインします。
コネクションを保存するプロジェクトを選択します。
作成 > コネクションをクリックします。
Oracle Fusion Cloudを検索し、アプリとして選択します。
コネクション名フィールドにコネクションの名前を入力します。
Oracle Fusion Cloudに接続する（JWTトークン認証）
コネクションを保存する予定のプロジェクトまたはフォルダを選択するには、ロケーションドロップダウンメニューを使用します。
Auth typeドロップダウンメニューを使用してJWT tokenを選択します。
Oracle API認証の信頼できる発行者名をIssuerフィールドに入力します。
UsernameフィールドにOracle Fusion Cloudアカウントのユーザー名を入力します。
公開証明書に関連付けられた秘密鍵をPrivate keyフィールドに入力します。
base64エンコード済み証明書フィンガープリントをCertificate fingerprintフィールドに入力します。
Oracle Fusion CloudインスタンスのサブドメインをSubdomainフィールドに入力します。 例: servername.fa.us2.oraclecloud.com。
接続をクリックします。
パイプラインの設定
WorkatoでOracle Fusion Cloudをデータパイプラインのソースとして設定するには、次の手順を実行します:
Workatoアカウントに戻ります。
作成 > データパイプラインを選択します。
データパイプラインの名前を指定します。
データパイプライン設定
ロケーションドロップダウンメニューを使用して、データパイプラインを保存するプロジェクトを選択します。
ビルドを開始をクリックします。
ソースアプリから新規/更新済みレコードを抽出トリガーをクリックします。 このトリガーは、パイプラインがソースアプリケーションからデータを取得する方法を定義します。
Extract new/updated records from source appトリガーを設定
Your Connected Source Appsドロップダウンメニューを使用して、Oracle Fusion Cloudを選択します。
このパイプラインで使用するOracle Fusion Cloudコネクションを選択します。 または、+ 新規コネクションをクリックして新しいコネクションを作成します。
Oracle Fusion Cloudコネクションを選択
オブジェクトを追加をクリックして、オブジェクトモーダルを開きます。
オブジェクトを追加
使用可能なOracle Fusion Cloudテーブルのリストを検索または参照し、同期するテーブルを選択します。
Addをクリックします。
選択した各テーブルのスキーマを確認してカスタマイズします。 パイプラインは各テーブルのスキーマを自動的に取得し、宛先がソースと一致するようにします。
オブジェクトを展開
テーブルを展開して、そのフィールドを表示できます。 使用可能なすべてのデータを抽出するには、すべてのフィールドを選択したままにします。特定のフィールドを抽出およびスキーマレプリケーションから除外するには、そのフィールドの選択を解除します。
各テーブルの同期設定を構成します。
テーブルの横にある設定（歯車）アイコンをクリックします。
同期設定を構成
同期モードを選択します:
同期設定を構成
同期設定を構成同期設定の変更による影響を確認します。
完全な再同期の動作
同期モードまたは変更追跡列を変更すると、次回のパイプライン実行時に影響を受けるテーブルの完全な再同期がトリガーされます。
完全な再同期中、パイプラインはそのテーブルのすべてのレコードを再読み込みします。 このプロセスにより、実行時間が長くなり、宛先にある既存のデータが再処理される可能性があります。
同じフローを使用して追加のテーブルを追加するには、もう一度オブジェクトを追加をクリックします。
スキーマ変更の処理方法を選択:
- スキーマ変更を自動的に検出して適用するには、新しいフィールドを自動同期を選択します。
- スキーマ変更を手動で管理するには、新しいフィールドをブロックを選択します。 このオプションを使用すると、ソーススキーマが更新された場合に宛先が同期されなくなる可能性があります。
同期されていないスキーマ変更は、スキーマドリフトとも呼ばれ、管理しないと問題が発生する可能性があります。 詳細については、スキーマドリフトセクションを参照してください。
頻度フィールドで、パイプラインがソースから宛先にデータを同期する頻度を設定します。 標準の時間ベースのスケジュールを選択するか、カスタムcron式を定義します。
同期頻度を構成
同期頻度を設定サポートされるOracle Fusion Cloudオブジェクト
Oracle Fusion Cloudコネクターは、次のような複数のモジュールにわたる幅広いビジネスオブジェクトをサポートしています:
- 財務
- 調達
- サプライチェーン
- Order management
- 人的資本管理
使用可能なオブジェクトは、次によって異なります:
- 有効化されているOracle Fusion Cloudモジュール
- ユーザーの権限およびロール
Last updated: