機械翻訳について

Oracle Taleo Business Edition (TBE)とOracle NetSuite間の新規従業員レコードの同期化

「Oracle Taleo Business Edition (TBE)アダプタ」を使用して、Oracle Taleo Business Edition (TBE)とOracle NetSuite間の統合を作成できます。

統合は、Oracle Taleo Business Edition (TBE)で新しい従業員を定期的にチェックし、Oracle NetSuiteで新しい従業員を作成できます。

「図tbe2netsuite.pngの説明」

統合へのOracle Taleo Business Edition (TBE)接続の追加

これでOracle Taleo Business Edition (TBE)への接続が作成され、統合に追加できます。

必要なもの:

まだ実行していない場合は、Oracle Taleo Business Edition (TBE)への新しい接続を作成します。 「Oracle Taleo Business Edition (TBE)アダプタ接続の作成」を参照してください。

1. Oracle Integrationのナビゲーション・ペインで、「統合」、「統合」の順にクリックします。
2. 統合の作成
   1. 「作成」をクリックします。
   2. 「統合の作成 - スタイルを選択」で、「予定されているオーケストレーション」を選択します。
      Oracle Taleo Business Edition (TBE)接続はtarget(invoke)接続に限定されるため、トリガーする内容が必要です。 スケジュールされたオーケストレーションを使用すると、Oracle Taleo Business Edition (TBE)から別のアプリケーションへの日次データ転送をトリガーできます。
   3. 「新しい統合を作成」で、必要に応じて統合の名前を説明とともに指定し、「作成」をクリックします。
3. 統合にOracle Taleo Business Edition (TBE)接続を追加します。
   1. インテグレーション・デザイナで、右側の「起動」を選択し、Oracle Taleo Business Edition (TBE)用に作成した接続を検索し、「スケジュール」の行をドラッグします。
   2. 「基本情報」ページで、この名前が統合に表示されており、その後は変更できないため、意味のある名前を指定します。
   3. 「操作」ページで、ビジネス・オブジェクトと実行する対応する操作を選択し、「次」をクリックします。

      たとえば、Oracle Taleo Business Edition (TBE)から新しい従業員レコードを取得するには、「従業員」オブジェクトおよび操作「従業員の検索」を選択します。

   4. 「サマリー」ページで、「完了」をクリックします。

      統合には、追加および構成したOracle Taleo Business Edition (TBE)接続が含まれるようになりました。

4. この例では、Oracle Taleo Business Edition (TBE)から返されるレコードを、最近システムに追加された従業員に制限する必要があります。 これはマッパーで実行できます。
   1. スケジュール・アイコンとOracle Taleo Business Edition (TBE)接続の間に「マップ先」アイコンを選択し、「編集」をクリックします。
   2. 「ターゲット」ペインで、SearchEmployee要素とQueryParameters要素を開きます。
   3. addedWithin属性の値を1に設定します。

      これにより、過去1日以内に追加された従業員にレスポンスが制限されます。

Oracle Taleo Business Edition (TBE)データの別のアプリケーションへのマップ

統合にOracle Taleo Business Edition (TBE)接続を追加したら、他のアプリケーションへの接続を統合に追加し、アプリケーション間のデータをマッピングする必要があります。

たとえば、Oracle Taleo Business Edition (TBE)から新しい従業員レコードを取得し、Oracle NetSuiteで新しい従業員レコードを作成する統合を構成します。 1日の深夜に新しい従業員レコードがないかどうかを統合で確認します。 Oracle Taleo Business Edition (TBE)データをOracle NetSuiteにマップする必要があります。

Oracle Taleo Business Edition (TBE)からデータをマップするアプリケーションへの新しい接続を作成するには

1. Oracle Integrationのナビゲーション・ペインで、「統合」、「統合」の順にクリックします。
2. Oracle Taleo Business Edition (TBE)を含む作成した統合を検索し、「編集」をクリックします。
3. 他のアプリケーションへの接続を統合に追加します。
   1. 統合デザイナで、右側の「起動」を選択し、作成した接続を検索して、NewEmployeesfromと「停止」のスパン・スパン間の線にドラッグします。
   2. 「基本情報」ページで、統合にこの名前が表示されているため、意味のある名前を指定します。
   3. 「操作」ページで、ビジネス・オブジェクトと実行する対応する操作を選択し、「処理オプション」をクリックします。 「存在しない場合は更新時にレコードを挿入」オプションを選択します。

      たとえば、新しい従業員レコードをOracle NetSuiteに追加するには、「基本」、「追加」操作、およびオブジェクト「従業員」を選択します。

   4. 「サマリー」ページで、「完了」をクリックします。

      統合には、追加および構成した接続が含まれます。

4. Oracle Taleo Business Edition (TBE)から別のアプリケーションにデータをマップします。
   1. Oracle Taleo Business Edition (TBE)接続と他のアプリケーション接続の間に「マップ先」アイコンを選択し、「編集」をクリックします。
   2. 「マップ」ページで、ソースおよびターゲット・フィールドをクリックし、Map+をクリックします。
      たとえば、Oracle Taleo Business Edition (TBE)からOracle NetSuiteに従業員データを送信するには、次のフィールドをマップします:

      • 従業員の氏名、住所、部門、採用日、住所。

      • IDsは各アプリケーションによって割り当てられるため、従業員IDはマップしません。

5. マッピングをテストします。
   1. マッパー・ツールバーで、「Test」をクリックします。
   2. 「入力」パネルで、「入力の生成」をクリックしてペイロードを自動的に生成します。
   3. 「Execute」をクリックして、「Output」パネルに結果を生成します。
   4. 「出力」パネルの結果を確認して、入力が正しく処理されたことを確認します。

      マッパーに戻ってマッピングの変更を行い、目的の結果が得られるまでテストを続けます。

ビジネス識別子の割当て

ビジネス識別子を使用すると、実行時にメッセージ内のペイロード・フィールドを追跡できます。 追跡のために最大3個のビジネス識別子フィールドを設計時に指定できます。 これらのフィールドの1つをプライマリ・ビジネス識別子フィールドとして選択する必要があります。 プライマリ・ビジネス識別子フィールドを使用して、実行時に統合フロー間でフィールドを追跡できます。このフィールドは常に使用可能です。 実行時には、ビジネス識別子のステータスが「インスタンスのトラッキング」ページおよび(統合エラーが発生した場合は)エラー・ページに表示されます。 スケジュール済パラメータを作成した場合、それらをビジネス識別子として割当に使用できます。

統合で少なくとも1つのビジネス識別子トラッキング・フィールドを構成していない場合は、デザイン・キャンバスにエラー・アイコンが表示されます。 「ビジネス識別子の割当て」を参照してください。

ビジネス識別子を割り当てるには:

1. Oracle Integrationのナビゲーション・ペインで、「統合」、「統合」の順にクリックします。
2. ビジネス識別子を追加する特定の統合をクリックします。 ビジネス識別子を追加できるのはアクティブでない統合のみです。 統合がアクティブな場合は、既存のビジネス識別子の表示のみ行うことができます。
3. 「アクション」のメニューから、「トラッキング」を選択します。
   「Business Identifiers For Tracking」ダイアログが表示されます。 選択した統合のソース・ペイロードが左側に表示されます。 ビジネス識別子を割り当てられるのはソース・ペイロードのフィールドのみです。 ビジネス識別子をターゲット・ペイロードのフィールドに割り当てることはできません。
4. 「ソース」セクションから、トラッキングするペイロード・フィールドを「トリガー・フィールドをここにドラッグ」セクションにドラッグします。 緑のチェックマークは、これがプライマリ・ビジネス識別子であることを示します。 少なくとも1つの識別子が必要です。 1つのみ追加した場合、自動的にプライマリ・キーとして選択されます。 作成したスケジュール済パラメータは、プライマリまたはセカンダリ・ビジネス識別子として割当に使用できます。
   
   
   「図business_identifiers.pngの説明」
   
   「Filter」リンクをクリックすることで、ソース構造の表示をフィルタ処理できます。 これにより、フィールドが使用されるかどうか、およびフィールドのタイプ(必須フィールド、カスタム・フィールドまたはすべてのフィールド)について、フィルタ処理できるようになります。
5. 「Tracking Name」フィールドに、実行時の追跡に使用するわかりやすい名前を入力することもできます(たとえば、OrgId)。 この名前は、このフィールドを使用して「インスタンスのトラッキング」ページまたは実行時にErrorsページ(統合エラーが発生した場合)でメッセージをフィルタ処理する場合に表示されます。
6. 「Help Text」フィールドには、実行時にフィールドに入力する内容をユーザーが理解できるように指示を入力することもできます(たとえば、Enter a valid organization number)。 これらの指示は、メッセージをフィルタ処理するためにランタイム「インスタンスのトラッキング」ページで使用されるときに、空のフィールド内に表示されます。
7. 「完了」をクリックします。

統合のアクティブ化

統合の作成が完了し、進捗インジケータの表示が100パーセントになると、その統合をランタイム環境に対してアクティブ化することができます。 統合が100%として表示され、アクティブ化の対象となるのは、ソース接続、ターゲット接続、データ・マッピングおよび追跡フィールドを指定した後です。

統合をアクティブ化するには:

ノート:

既存の統合の新しいバージョンをアクティブ化しても、古いバージョンのインスタンスまたはログの追跡は削除されません。 ただし、関連するアーティファクトは削除され、再デプロイはバック・エンドで実行されます。 監視データも削除されます。

1. 左側のナビゲーション・ペインで、「ホーム」→「統合」→「統合」をクリックします。
2. アクティブ化する統合の行に移動します。
3. アイコンをクリックして、統合をアクティブ化します。
   「Confirmation」ダイアログが表示されます。
4. 統合に適したオプションを選択します。

   要素	説明
   Oracle Recommendationsへの統合マッピングの提供	クリックすると、Oracle Recommendations Engineが有効になります。 集合インテリジェンスを使用して、統合を開発する際にマップするフィールドを推奨します。 これらの推奨事項は、匿名でOracle Recommendations Engineに提供されたマッピングに基づいて作成されています。 これは、ナビゲーション・ペインで「設定」> 「推奨」を選択して、Recommendationsページで変更できます。
   アサータ記録の有効化	クリックすると、再生およびテストのためのペイロードおよびレコード・インスタンスが取得されます。
   トレースを有効にします	アクティビティ・ストリームの詳細なトレース情報を有効にする場合にクリックします。 このチェックボックスを選択すると、実行時にこの統合フローによって処理されるメッセージに関する詳細なロギング情報が収集されます。 これは問題のトラブルシューティングに役立ちます。 ただし、詳細なトレースは、パフォーマンスに影響を与えることもあります。 トレースを非アクティブにするには、統合を非アクティブにしてから、「トレースを有効にします」チェックボックスを選択せずに再アクティブ化する必要があります。 トレースを有効にしないと、最小限のロギングの詳細がics-flow.logに作成され、アクティブ化された統合がいつ開始され、実行が完了するかを示します(実行の成功または失敗に関係なく)。 ダッシュボード・ページでログをダウンロードできます。 ペイロード・トレースを有効にして、入力および出力ペイロードをアクティビティ・ストリームに記録する場合は、「ペイロードを含める」チェック・ボックスを選択します。 このチェックボックスをオンにすると、ペイロードの情報もログ・ファイルに書き込まれます。ログ・ファイルは、ダウンロードして表示できます。 たとえば、統合フローの複数の場所でペイロード・アクティビティに関する詳細なロギング情報(データ・マッピング前のペイロードやデータ・マッピング後のペイロードなど)を参照できます。 このアクションはセキュリティ上のリスクをもたらし、システムのパフォーマンスにも影響します。 この設定は運用環境にはお勧めできません。

5. アクティベーション・オプションを選択してください。 使用可能なオプションは、アクティブ化する統合のタイプに基づいています。
   1. 「アクティブ化」をクリックします(スケジュールされていない統合を活動化する場合)。
   2. 「アクティブ化とスケジュール設定」をクリックします(スケジュールされた統合を活動化する場合)。
      Run integration_nameページが表示されます。 この統合を実行するスケジュールを作成し、「保存」をクリックします。 「統合スケジュールの定義」を参照してください。
   ステータス・メッセージは、ページ上部のバナーに表示されます。 たとえば:
   
   図integration_activation.pngの説明
   
6. 統合に失敗すると、バナーに「アクティブ化失敗」警告アイコンが表示されます。 このアイコンをクリックすると、アクティベーション失敗事象の詳細をダウンロードするためのダイアログが表示されます。
   
   図integration_active_fail.pngの説明
   
   1. 統合が完全に構成されていない機能を含む場合、バナーにエラー・メッセージが表示されます。 統合を活動化する前に、この機能の構成を完了する必要があります。 統合の内部をクリックし、次のエラー/警告に注意してください。

      • 不完全な関数を使用する関数呼び出しアクションにエラー・アイコンが表示されます。 統合キャンバスの右側にある「エラー」パネルには、不完全な関数の詳細が表示されます。

      • この機能の入力と出力を使用する警告アイコンがマッパー上に表示されます。 関数の構成が完了したら、統合をアクティブにする前に入力と出力のマッピングを確認する必要があります。

   アクティブ化に成功すると、統合のステータスが行のACTIVEに変わります。
7. アイコンをクリックすると、この統合のインスタンスの実行、テストおよび追跡方法の詳細が表示されます。
   たとえば:

   トレースを有効にすることを選択した場合は、クリックしたアイコンの下にTRACE ENABLEDという単語が表示され、統合をアクティブにします。 「インスタンスのトラッキング」ページで統合インスタンスをクリックすると、メニューに、ペイロードの詳細を表示するための「アクティビティ・ストリームの表示」というオプションが表示されます。

   詳細なトレース・ログ情報にアクセスするには:

   1. 左側のナビゲーション・ペインで、「ホーム」→「モニタリング」→「統合」→「ダッシュボード」をクリックします。

   2. Oracle Integrationログと診断ログをダウンロードするには、「診断ログをダウンロード」をクリックします。

8. 統合名をクリックするか、メニューから「表示」を選択して、アクティブな統合を表示します。 アクティブな統合が、上部のバナーに「表示のみ」というメッセージとともに表示されます。

読取り専用モードでは次の点に注意してください。

• 「保存」ボタンは表示されません。

• 「起動」、「アクション」または「エラー」のアイコンはありません。

スケジュール済統合の実行およびモニター

スケジュールされた統合の実行は、「実行の追跡」ページで監視できます。 処理されたメッセージの合計数、正常に処理されたメッセージの数および失敗したメッセージの数を表示できます。 スケジュール済統合は、定義済のスケジュールの統合か、「すぐに送信」オプションを介して非定型で発行された統合です。

スケジュールされた統合を実行するには:

1. ナビゲーション・ペインで、「統合」、「統合」の順にクリックします。
2. 統合の上にマウスを置き、「アクション」 をクリックして「スケジュール」を選択します。
   「Schedule and Future Runs」ページが表示されます。
3. メニューから「すぐに送信」を選択します。
   送信が成功した場合、ID番号を含むメッセージが表示されます。
4. ID番号をクリックします。

   「トラック・ラン」ページが表示されます。 送信された統合が表示されない場合は、「リフレッシュ」アイコンをクリックします。 実行の詳細が表示されます。

統合スケジュールの定義

統合を実行する頻度、iCal式に基づいてスケジュールを実行するかどうか、スケジュール実行が失効しないかどうか、スケジュールに固定失効日を設定するかどうかなど、調整された統合を実行するスケジュールを定義できます。

統合スケジュールを定義するには:

ノート:

• 統合のスケジュールは個別にエクスポートできません。
• 作成して統合をスケジュールしたユーザーがロックまたは削除されても、スケジュールは実行されません。 このユーザーがロックまたは削除されていないことを確認してください。

1. 「Integrations」ページに移動します。
2. スケジュール済統合を検索します。
   これらの統合は、左端の列のスケジュール・トリガー・アイコンによって識別されます。 統合でスケジュールを作成するには、いくつかの方法があります。
3. 最初に統合を設計してアクティブ化してから、スケジュールを作成する場合:
   1. アイコンをクリックします。 「Activate統合」ダイアログ・ボックスが表示されます。
   2. 「Activate and Schedule」をクリックします。
4. 設計して後でアクティブ化する統合のスケジュールを最初に作成する場合:
   1. メニューから、「スケジュールの追加」を選択します。

      ノート:

      スケジュールが定義されていない統合の場合、メニューには「スケジュールの追加」が表示されます。 スケジュールが定義されている統合の場合、メニューは「スケジュール」に切り替えられます。

   スケジュール実行の詳細を定義するページが表示されます。

5. 基本的な統合実行をスケジュールする場合は、「簡易」をクリックします。 このタイプの場合、最小限の頻度制限は10分です。 10分未満のスケジュール頻度を定義しようとすると、検証エラーが発生します。
   1. 「簡易」スケジュールの「頻度」セクションで、アイコンをクリックして、統合を実行する頻度を選択するためのドロップダウン・リストを表示します。 1つの頻度を定義するときに、「Frequency」セクションの右側にあるアイコンをクリックして追加値を指定できます。

      • Only Once: これがデフォルトの選択内容です。 この選択により、「From」フィールド以外のすべての設定がクリアされます。

      • Hours and Minutes: 統合を実行する時間数と分数を指定します。

      • Days: 統合を実行する日数を指定します。

      • Weeks: 統合を実行する週数を指定します。

      • Months: 統合を実行する月数を指定します。

6. iCal式を使用して統合実行をスケジュールする場合は、iCalをクリックします。

   ノート:

   • スケジュールされた統合をiCal式で実行できる頻度には1分の制限があります。 この制限を下回るものはサポートされていません。
   • iCal式ではルックアップを使用できません。
   1. iCal式を入力して、「Validate Expression」をクリックします。 たとえば:

      • 次の式は、この統合が、午前5時15分、午前10時15分、午後3時15分、午後8時15分に各月の1日、10日、15日に実行されることを示しています。

        
        
        
        「図ical_expression1.pngの説明」
        
        
      • 複数のスケジュール頻度を定義することもできます。 次のスケジュールは、毎日午後5時30分に実行されます。 - 午後7時30分、この時間帯には10分ごとに実行されます。 この構成では、&記号で区切られた3つのスケジュールが必要です:

        FREQ=DAILY;BYHOUR=17;BYMINUTE=30,40,50;BYSECOND=0;
        &FREQ=DAILY;BYHOUR=18;BYMINUTE=0,10,20,30,40,50;BYSECOND=0;
        &FREQ=DAILY;BYHOUR=19;BYMINUTE=0,10,20,30;BYSECOND=0;

        
        「図ical_expression2.pngの説明」

      • 次のスケジュールは毎日午前8時に実行され、毎月午後12時の日付1および日付2にも実行されます。

        FREQ=DAILY;BYHOUR=8;&FREQ=MONTHLY;BYMONTHDAY=1,2;BYHOUR=12;

        
        
        
        
        

      検証が成功すると、次のメッセージが最上部に表示されます。

      iCal expression is valid.
7. 「This schedule is effective」セクションで、「From」の右側のリンクをクリックします。
   スケジュールの開始日を定義するためのメニューが表示されます。
8. スケジュールがアクティブ化されているときに統合実行を開始するには、次のようにします。
   1. 「When schedule starts」をクリックします。
9. 統合実行の開始日を明示的に設定するには、次のようにします。
   1. 「Modify start date」を選択します。
   2. 「Calendar」アイコンをクリックし、統合実行を開始する月、年、日、時、分および秒を選択します。
   3. 「OK」をクリックします。
10. スケジュール実行が失効しないようにする場合:
    1. 「Never (repeat indefinitely)」を選択します。
11. 統合実行の失効日を固定する場合:
    1. 「Choose expiry date」を選択します。
    2. 「Calendar」アイコンをクリックし、統合実行を終了する月、年、日、時、分および秒を選択します。
    3. 「OK」をクリックします。
12. 「タイムゾーン」リストから値を選択します。 デフォルトでは、このフィールドにはプリファレンス・ページで選択した値が表示されます。
    　
13. 「保存」をクリックし、プロンプトが表示されたら「&保存の更新」をクリックします。
    成功すると、右上隅にメッセージが表示されます。

    Schedule Run name saved successfully

    エラーがある場合は、エラーの解決方法を説明する検証メッセージが右上隅に表示されます。
14. クリック
    「Schedule and Future Runs」ページが表示されます。

    「将来に実行」ページには次の2つのセクションがあります:

    • スケジュール・セクション: このセクションはデフォルトで縮小されています。 上部のバー(スケジュール名とボタンを表示)をクリックすると、セクションが展開され、スケジュールが表示されます。
    • 先日付実行表: これは、スケジュールが開始されるまで空のままです。 スケジュールを開始すると、データを表示できます。
15. すでに統合をアクティブ化している場合、統合を実行するオプションを選択します:
    1. メニューから、「すぐに送信」を選択します。
    2. ServiceAdministratorロールを持つユーザーは、スケジュールの発行に使用するユーザーを変更できます。
       「すぐに送信」をクリックすると、統合がすぐにトリガーされます。 「開始スケジュール」をクリックすると、定義済のスケジュールを使用して統合がトリガーされます(頻度およびその他の定義を含む)。
    3. プロンプトが表示されたら統合のインスタンスを開始する方法を選択します。 それ以外の場合は、「取消」をクリックします。
       • アドホック・リクエスト: インスタンスは、統合のスケジュールされた実行(存在する場合)とは別に実行されます。
       • スケジュールの一部として: インスタンスは、スケジュールされた実行とスケジュール・パラメータ(ある場合)を順番に実行します。
    4. 「すぐに送信」をクリックします。
    or
    1. スケジュールおよび「将来に実行」ページで「開始スケジュール」を選択し、統合スケジュールをアクティブ化します。
    2. ServiceAdministratorロールを持つユーザーは、スケジュールの発行に使用するユーザーを変更できます。
    3. プロンプトが表示されたら、「開始」をクリックします。 それ以外の場合は、「取消」をクリックします。
16. 統合をまだアクティブ化していない場合は、Integrationsページに戻り、をクリックします。
17. 前のステップの説明に従って、スケジュール済統合を実行します。