1. Digital Customer Serviceの実装
  2. セルフサービス・ユーザーのインポート方法
機械翻訳について

セルフサービス・ユーザーのインポート方法

このトピックでは、Digital Customer Serviceアプリケーションで使用するためのセルフサービス・ユーザーのインポート方法について説明します。

インポートのユース・ケースとして、あるサービス実装ソリューションからDigital Customer Serviceに移行する場合、または新しい顧客アカウントがあり、認可ユーザーのリストが提供されている場合などがあります。

別のサービス実装からDigital Customer Serviceに移行する場合、元のサービス実装から保持する既存の参照識別子がいくつか存在する場合があります。 このような場合は、アカウントからのAccountPartyNumber、担当者からのContactPartyNumberといったフィールドが役立ちます。

最初に担当者を作成する必要があります。 担当者を作成すると、2つの選択肢があります: 担当者パーティIDまたは担当者パーティ番号を使用できます。 担当者が作成またはインポートされると、担当者パーティIDが自動的に割り当てられます。 担当者パーティ番号は明示的に指定できます。 担当者パーティ番号を指定しない場合は、番号が自動的に割り当てられます。

アカウントはほぼ同じ方法で処理されます。 アカウント・パーティIDが自動的に割り当てられ、アカウント・パーティ番号の指定または自動割当てを選択できます。

最後に、インポートされたデータ・セットには主キーがあります。 主キー列の値は、Oracle Fusion Applicationsデータ・モデルで自動的に生成されます。

セルフサービス・ユーザーのインポート時に実行する処理の概要を次に示します:

  • 担当者の作成

  • セルフサービス・ロール・テンプレートのダウンロード。

  • インポート・ファイルを準備し、ユーザーをインポート。

  • 待ち状態のLDAP要求の送信。

ノート: セルフサービス・ユーザーを作成するためにインポート・プロセスを使用する場合、他の承認ステップは必要ありません。

担当者の作成

最初のステップでは、担当者を作成します。 担当者にはEメールアドレスが必要です。 担当者を作成するには、関連トピックリストの「担当者データのインポート」タスクの手順に従います。 また、まだ実行していない場合は、「関連トピック」リストにある「アカウント・データのインポート」タスクも必要になる場合があります。

セルフサービス・ロール・テンプレートのダウンロード

この項では、セルフサービス・ロール・テンプレートをダウンロードする方法について説明します。

セルフサービス・ロール・テンプレートには、次のフィールドがあります。

フィールド

使用方法

AccountPartyId

AccountPartyNumber値を指定しない場合の必須フィールド。 B2Cではこの値を指定しないでください。

AccountPartyNumber

AccountPartyId値を指定しない場合の必須フィールド。 B2Cではこの値を指定しないでください。

ContactPartyId

ContactPartyNumber値を指定しない場合の必須フィールド。

ContactPartyNumber

ContactPartyId値を指定しない場合の必須フィールド。

LoginId

オプション・フィールド。 値が指定されていない場合は、SVC_CSS_IMP_SIGN_IN_ATTR_NAMEプロファイル・オプションで指定された担当者属性の値が割り当てられます。 このプロファイル・オプションのデフォルト値は「Eメール・アドレス」です。

RelationshipTypeCd

必須フィールド。 次の値を割り当てることができます。

  • ORA_CSS_USER これは、Digital Customer Service User roleに対応しています。

  • ORA_CSS_ACC_MGR これは、Digital Customer Service Account Manager roleに対応しています。

  • ORA_CSS_ACC_ADMIN これは、Digital Customer Service Account Administrator roleに対応しています。

RequestTypeCd

B2Cの必須フィールド。 Fusionのオプション・フィールド。 次の値を割り当てることができます。

  • ORA_CSS_REQ_TYPE_CONTACT。 このFusionサービス値は、Fusion担当者に対応します。

  • ORA_CSS_REQ_TYPE_CONSUMER。 このB2Cサービス値は、B2Cコンシューマに対応します。

RoleId

オプション・フィールド。 ファイルの最初の行から削除できます。

セルフサービス・ロール・テンプレート・ファイルをダウンロードするには:

  1. Oracle Fusion Serviceに管理者または設定ユーザーとしてサインインします。

  2. 「ナビゲータ」メニューから「ツール」を展開し、「インポート管理」を選択します。

  3. 「インポートの管理」作業領域で、「インポート・オブジェクト」タブをクリックし、「検索」を選択します。

  4. 「インポート・オブジェクト詳細」ページで、「表示名」検索ボックスに「Self-Service Role」と入力します。

  5. 「ダウンロード」をクリックして、.zipファイルを使いやすいディレクトリに保存します。

インポート・ファイルの準備

この項では、セルフサービス・ユーザーをインポートするためのインポート・ファイルを準備する方法について説明します。
ノート: ユーザーが複数のアカウントにインポートされる場合は、データをアカウント・パーティIDでソートする必要があります。 これにより、1つのスレッドが同じアカウントのユーザーを処理する可能性が最大になり、同じアカウントを変更するスレッドが異なるためにデッドロックが発生する可能性が最小限に抑えられます。 すべてのユーザーが同じアカウントに属している場合は、Oracle Integration Cloud統合を使用して、アカウント行ロック例外を処理するロジックを再試行することをお薦めします。

インポート・ファイルを準備するには:

  1. 「セルフサービス・ロール・テンプレートのダウンロード」トピックで保存したSelf-Service Role_Templates<date>.zipファイルを見つけて開きます。

  2. 展開して、SelfServiceRole.csvファイルを開きます。

  3. インポートする予定の各セルフサービス・ユーザーについて、次のデータを専用の行に入力します。

    1. セルフサービス・ユーザーに関連するアカウント情報をAccountPartyIdまたはAccountPartyNumber列に入力します。

      ノート: B2Cサービス・リクエストでは、アカウントID値は不要です。
      ヒント: REST APIを使用してAccountPartyIdまたはAccountPartyNumberの値をすばやく検索するには、管理者として次のコマンドを実行します:
      GET <Oracle-Fusion-Application-Host>/crmRestApi/resources/11.13.18.05/accounts/

    2. セルフサービス・ユーザーに関連する担当者情報をContactPartyIdまたはContactPartyNumber列に入力します。

      ノート: 担当者をインポートするときには、ContactPartyNumberの形式で各担当者に一意の識別子を指定できます。 これは、ユーザーごとに一意である必要があります。 そのため、担当者インポート・ファイルとセルフサービス・ロール・インポート・ファイルで一致するように、ユーザーのContactPartyNumberに対して同じ一意の番号を指定する必要があります。

    3. セルフサービス・ユーザーに関連するIDをLoginId列に入力します。

      ノート: SVC_CSS_IMP_SIGN_IN_ATTR_NAMEプロファイル・オプションが設定されている場合、LoginIdはオプションです。

    4. RelationshipTypeCd列に、セルフサービス・ユーザーに割り当てるデジタル・カスタマ・サービス・ロールを入力します。 次の値を割り当てることができます。

      • ORA_CSS_USER これは、Digital Customer Service User roleに対応しています。

      • ORA_CSS_ACC_MGR これは、Digital Customer Service Account Manager roleに対応しています。

      • ORA_CSS_ACC_ADMIN これは、Digital Customer Service Account Administrator roleに対応しています。

      ノート: ORA_CSS_ACC_MGRロールとORA_CSS_ACC_ADMINロールを単独で使用できるのは、セルフサービス・ユーザーがすでに存在する場合のみです。 インポートで新しいセルフサービス・ユーザーを作成する場合は、ORA_CSS_ACC_MGRロールとORA_CSS_ACC_ADMINロールをORA_CSS_USEロールと組み合せる必要があります。 ユーザーに複数のロールを割り当てるには、&文字を使用してそれらを連結します。 たとえば、ORA_CSS_USER&ORA_CSS_ACC_ADMINのようにします。

    5. RequestTypeCd列に、セルフサービス・ユーザーに割り当てるDigital Customer Serviceのロールを入力します。 値が指定されていない場合、デフォルトはORA_CSS_REQ_TYPE_CONTACTです。

      次の値を割り当てることができます。

      • ORA_CSS_REQ_TYPE_CONTACT。 この値はFusionサービス・インスタンス用で、Fusion担当者に対応します。

      • ORA_CSS_REQ_TYPE_CONSUMER。 この値はB2Cサービス・インスタンス用で、B2Cコンシューマに対応します。 B2Cは一般大衆です。

  4. インポートするセルフサービス・ユーザーごとに、専用行でステップ4を繰り返します。

    ノート: AccountPartyIdまたはAccountPartyNumberごとに、インポート・ファイル内の少なくとも1人のユーザーにORA_CSS_ACC_ADMINロールが割り当てられている必要があります。

  5. SelfServiceRole.csvファイルを保存します。

  6. SelfServiceRole.csvを新しいSelf-Service Role_Templates<date>.zipアーカイブに含めて、保存します。

    ヒント: Macを使用する場合、Self-Service Role_Templates<date>.zipファイルを作成するには、端末でzipユーティリティを使用する必要があります。

SelfServiceRole.csvファイルの次のサンプル・データを参照してください。

例1: インポートでのパーティIDの使用 

AccountPartyId,ContactPartyId,RelationshipTypeCd
300100110957452,300100156316610,ORA_CSS_User & ORA_CSS_ACC_ADMIN

例2:インポートでのパーティ番号の使用

AccountPartyNumber,ContactPartyNumber,RelationshipTypeCd 
CDRM_67617,CDRM_743628,ORA_CSS_USER 
CDRM_67617,CDRM_743711,ORA_CSS_USER&ORA_CSS_ACC_ADMIN 
CDRM_67617,CDRM_743651,ORA_CSS_USER&ORA_CSS_ACC_MGR

例3: 明示的に使用されるログインID 

AccountPartyNum,ContactPartyNum,LoginId,RelationshipTypeCd 
CDRM_67617,CDRM_743628,Mary.Smith,ORA_CSS_USER 
CDRM_67617,CDRM_743711,John.Rogers,ORA_CSS_USER&ORA_CSS_ACC_ADMIN 
CDRM_67617,CDRM_743651,Pat.Williams,ORA_CSS_USER&ORA_CSS_ACC_MGR

例4: B2C 

ContactPartyNum,RelationshipTypeCd, RequestTypeCd
CDRM_943831,ORA_CSS_USER, ORA_CSS_REQ_TYPE_CONSUMER
CDRM_943832,ORA_CSS_USER, ORA_CSS_REQ_TYPE_CONSUMER

セルフサービス・ユーザーのインポート

この項のステップを進める前に、前の項のステップを完了しておく必要があります。

  • セルフサービス・ロール・テンプレートのダウンロード

  • インポート・ファイルの準備

ノート: 最適なパフォーマンスを得るには、プロファイル・オプションZCA_STANDARD_IMPORT_COMMIT_SIZEの値を1に設定します。 SVC_CSS_USE_FA_AS_IDPが有効な場合(TRUEに設定)、 ZCA_STANDARD_IMPORT_COMMIT_SIZE値を1に設定する必要があります。 これは、次の理由で行う必要があります。 コミット・サイズのデフォルト値は100です。 この値は、インポート・フレームワークに組み込まれたretryロジックにも影響します。 1つのインポート行でエラーが発生すると、バッチ全体がロールバックされます。 IDCSがIDPである場合のセルフサービス・インポートでは、コミット・サイズによって決定された多くのユーザーが作成され、ロールバックする必要があるため、ロールバックの影響は深刻です。 retryを指定すると、同じバッチに対して複数のロールバックが発生し、インポート・プロセスの速度が大幅に低下する可能性があるため、影響はさらに深刻になります。

セルフサービス・ユーザーをインポートするには:

  1. Oracle Fusion Serviceに管理者または設定ユーザーとしてサインインします。

  2. 「ナビゲータ」メニューから「ツール」を展開し、「インポート管理」を選択します。

  3. 「インポートの管理」作業領域で、「インポート・アクティビティの作成」ボタンをクリックします。

  4. 「インポート・アクティビティの作成」ワークスペースで、次のインポート・オプションを入力します。

    1. 必要な「名前」フィールドにインポート・アクティビティの名前を入力します。

    2. オプションの「摘要」フィールドにインポート・アクティビティの摘要を入力します。

    3. 「オブジェクト」ドロップダウン・リストをクリックし、「セルフサービス・ロール」を検索します。

    4. 「ファイル名」「参照」ボタンをクリックして、ダウンロードしたSelfServiceRole.csvファイルを見つけます。

  5. 「次」をクリックします。

  6. マッピングが予期したとおりであることを確認します。 必要に応じて修正します。

  7. 「データの検証」をクリックします。

  8. 「次」をクリックします。

    「インポート・アクティビティの作成: レビューおよび発行」画面が表示されます。

  9. 「発行」ボタンをクリックします。

    インポート・ジョブが「インポート・アクティビティの管理」リストに表示されます。 ジョブの「ステータス」値は、「完了」または「エラーありで完了」になるまで、処理中に複数回変わります。

  10. 「インポートの管理」ワークスペースで、「自分の完了済インポート」タイルをクリックし、リストからインポートのリンクを選択して、インポートの詳細を確認します。

  11. (オプション)エラーをレビューします。 「ステータス」値が「エラーありで完了」である場合、一部のユーザーがインポートされていない可能性があります。 エラーをレビューするには、次のステップに従います。

    1. 「インポート・ステータス」ワークスペースで、「処理」メニューをクリックし、「診断の生成」を選択します。

    2. 生成されたzipファイルをダウンロードし、診断メッセージをレビューします。

待ち状態のLDAP要求の送信

セルフサービス・ユーザー・ロールを正常にインポートした後で、このタスクを実行します。

ノート: このトピックは、SVC_CSS_USE_FA_AS_IDPプロファイル・オプションがTRUEに設定されている場合のみ必要です。

担当者レコードに関連付けるセルフサービス・ロールのインポートでは、セルフサービス・ユーザー・アカウントを使用可能にする最終ステップは、Oracle Fusion Serviceアイデンティティ管理システムでユーザー・アカウントを作成することです。 これはOracle Identity Cloud Serviceと同期され、ユーザーがサインインできるようになります。 Oracle Fusion Serviceアイデンティティ管理システムにユーザー・アカウントを作成するには、「待ち状態のLDAP要求の送信」ジョブを実行する必要があります。

待ち状態のLDAP要求を送信するには:

  1. Oracle Fusion Serviceに管理者または設定ユーザーとしてサインインします。

  2. 「予定済プロセス」作業領域に移動します。

  3. 「新規プロセスのスケジュール」をクリックします。

    「新規プロセスのスケジュール」ダイアログ・ボックスが表示されます。

  4. 「ジョブ」オプションを選択します。

  5. 「名前」メニューをクリックし、「検索」を選択します。

  6. 「名前」テキスト・ボックスに次の文字列を入力し、「検索」をクリックします。

    Send Pending LDAP Requests

  7. 「待ち状態のLDAP要求の送信」をクリックし、「OK」をクリックします。

  8. 「新規プロセスのスケジュール」ダイアログ・ボックスで「OK」をクリックします。

    「プロセス詳細」ダイアログ・ボックスが表示されます。

  9. 「発行」をクリックします。

    「確認」ダイアログが表示されます。

  10. 「OK」をクリックします。

    ジョブをモニターします。 完了すると、新しくインポートされたセルフサービス・ユーザーがLDAPで作成されます。

インポートによるセルフサービス・ユーザーの削除

セルフサービス・ロール・インポートを使用して、セルフサービス・ユーザー・データを削除できます。

セルフサービス・ユーザー・データを削除しても、次のデータは削除されません:
  • セルフサービス・ユーザーに関連付けられているすべての担当者。
  • アイデンティティ管理システムのユーザー・アカウント。

最初に、インポート・プロセス用のデータ・ファイルを準備します。

  1. selfServiceUsers REST APIまたはselfServiceRoles REST APIを使用してロールIDを取得します。

    selfServiceRoles REST APIを使用してユーザーのロールIDを取得するには、ContactPartyIdおよびRelationshipTypeCdをORA_CSS_USERに設定して問い合せることができます。

  2. インポートを開始する場合は、次の例に示すように、「インポート・モード」が「レコードの削除」に設定されていることを確認します:

    インポート作業領域のスクリーンショット。