カスタムレポートを使用したインポート

レガシーテナントでは、カスタムレポートエンドポイントを使用してカスタム属性をインポートできます。属性のリストを含むカスタムWorkdayレポートを作成します。Oktaでこれらの属性をインポートすると、Universal Directory（UD）によってユーザープロファイルとダウンストリームのアプリのユーザープロファイルにマッピングされます。

カスタムレポートを使用してカスタム属性をインポートすると、インポートが複雑になります。これは、コネクターがユーザープロファイルを完成させるために、2つの別々のエンドポイントと連携して両方からのデータをマージする必要があるからです。Workdayでは、カスタムレポートの使用は、特に大量のデータを扱う場合には推奨されません。

Workdayでのカスタムレポートの作成

  1. Workdayにサインインします。
  2. Create Custom Reportタスクを検索して選択します。
  3. 以下のフィールドに入力します。
    • レポート名（Report Name）を入力します。
    • レポートタイプ（Report Type）（Advanced）として詳細（Advanced）（Report Type）を選択します。
    • Webサービスとして有効化（Enable As Web Service）を選択します。
    • データソース（Data Source）を選択します。
    • OKをクリックします。
  4. 必要な属性をカスタムレポートに追加します。
  5. インポートされた属性の名前を変更する場合は、列見出しがXMLエイリアスをオーバーライド（Column Heading Override XML Alias）列で変更します。

  6. カスタムレポートにWorkday ID属性を追加します。列見出しXMLエイリアスの上書き（Column Heading Override XML Alias）の値をWorkday_IDに変更します。Oktaは、Workday IDのないカスタム属性をインポートできません。

  7. OKをクリックしてカスタムレポートを作成します。

  8. レポート名の横の省略記号をクリックしてWebサービス（Web Service） > URLの表示（View URLs）に移動します。
  9. リンクを右クリックし、URLをコピー（Copy URL）を選択して次のURLを取得します。
    • XSD（Simple XMLの下）
    • JSON（JSONの下）
  10. カスタムレポートを統合ユーザーと共有します。
    1. Edit Custom Reportを検索します。
    2. カスタムレポートを見つけて選択します。OKをクリックします。
    3. 共有（Share）タブに移動します。特定の認可されたグループおよびユーザーと共有する（Share with specific authorized groups and users）を選択します。
    4. 統合ユーザーを選択します。
    5. OKをクリックします。

カスタムレポートに要するインポート時間の最適化

多数のユーザーが多数のカスタム属性（特に計算フィールド）を持つ場合、Oktaへのインポートに時間がかかる可能性があります。数時間かかることもあります。また、カスタムレポートが正しくフォーマットされていることを検証するためにOktaがインポートするため、プロビジョニング設定の保存に時間がかかる場合があります。

Oktaで完全な統合の設定なしでインポートにどれくらいの時間がかかるかを推定できます。これを行うには、Webブラウザーで、またはPostmanなどのツールを使用してレポートリンクを開き、WorkdayカスタムレポートJSON URLにアクセスします。プロンプトが表示されたら、Workday管理者の資格情報を入力します。

インポートの実行に2時間以上かかると、Oktaサービスによって開いている接続がタイムアウトになります。これが発生したときは、Oktaサポートに連絡し、接続タイムアウト時間を増やすよう依頼してください。

ページネーションされたカスタムレポートを使用する

まれに、ページネーションされたカスタムレポートの設定が役立つ場合があります。ページネーションとは、すべてのユーザーに対して1回の呼び出しを行うのではなく、ユーザーごとの呼び出しを行って特定のユーザーのカスタムレポートをプルすることを意味します。Okta

ページネーションはユーザーごとに個別に呼び出しを行います。これにより、接続タイムアウト制限よりも長い時間かかるインポートに対応するために接続タイムアウト制限を延長できない場合でもインポートを実行できます。ただし、全体のインポート時間は大幅に増加します。

ページネーションされたカスタムレポートを使用すると、検証で1人のユーザーのカスタムレポートをチェックするだけなので、プロビジョニング設定を保存した後の遅延時間を短縮できます。ただし、これはインポート時間が長くなるため、設定を頻繁に変更しない場合にのみ役立ちます。

ほとんどの場合、ページネーションされていないレポートを使用することをお勧めします。

ページネーションされたWorkdayカスタムレポートの作成

カスタムレポートを使用したインポートは、Workdayインスタンスのユーザー数が5000以上の場合にはタイムアウトすることがあります。これを解決するには、Oktaがタイムアウトすることなく一連のWorkerデータをインポートできるように、ページネーションされたカスタムレポートを作成します。このオプションを使用するには、次の手順を実行します。

  1. フィルター（Filter）タブで、フィルターを設定します。
    Image of the custom report filter tab.
  2. プロンプト（Prompts）タブで、プロンプトのデフォルト値を指定します。
    Image of the custom report prompts tab.
  3. OKをクリックします。
  4. 統合ユーザー（推奨）またはレポートの所有者である管理者のWorkday IDを検索します。なお、レポートの所有者が統合ユーザー以外の場合は、統合ユーザーと共有する必要があります。
  5. アクション（Actions） > Webサービス（Web Service） > URLを表示（View URLs）をクリックして、生成されたURLを表示します。
  6. Employee_ID_Promptフィールドに、上記のステップ4で確認したWorkday IDを入力します。
  7. 次のリンクを右クリックしてURLをコピー（Copy URL）を選択し、新しくページネーションされたURLを取得します。
    • XSD（Simple XMLの下）
    • JSON（JSONの下）
  8. 新しいURLを追加して、以前と同じようにレポートを生成します。
  9. Oktaで、Workdayアプリ統合を開き、プロビジョニング（Provisioning）タブを選択します。
  10. 任意。XSD URLをカスタムレポートシンプルXML XSD URL（Custom Report Simple XML XSD URL）（Custom Report Simple XML XSD URL (optional)）に貼り付けます（任意）。OktaはXSD URLを使用してカスタムレポートのスキーマを取得します。
  11. URLをカスタムレポートJSON URL（Custom Report JSON URL）（Custom Report JSON URL (optional)）に貼り付けます（任意）。OktaはJSON URLを使用してカスタムレポートのデータを取得します。

Oktaでは、カスタムレポートWebサービスエンドポイントを使用してWorkdayから任意の属性をインポートできるようになりました。Workdayアプリユーザープロファイル、Oktaアプリユーザープロファイル、そして必要に応じてADユーザープロファイルを新しい属性で拡張することで、カスタム属性をOktaに組み込みます。プロファイル間で属性をマッピングし、変換を適用することが必要になる場合もあります。「Okta Universal Directoryユーザータイプを使用した操作」を参照してください。

関連項目

増分インポート

Workday Real Time Sync

Workdayのメールと電話のライトバック

Workdayライトバックの機能強化

ベストプラクティスとよくある質問