カスタムレポートを使用してインポートする

この機能は廃止されました。既存のカスタムレポート構成は影響を受けませんが、新しいアプリインスタンスではこのオプションを使用できません。代わりに、Workdayフィールドの上書きサービスを使用してカスタム属性をインポートしてください。

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

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

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

  1. Workdayにサインインします。
  2. カスタムレポートの作成タスクを検索して選択します。
  3. 次のフィールドに情報を入力します。
    • [Report Name(レポート名)]を入力します。
    • [Report Type(レポートタイプ)]として[Advanced(詳細)]を選択します。
    • [Enable As Web Service(Webサービスとして有効化)]を選択します。
    • [Data Source(データソース)]を選択します。
    • [OK]をクリックします。
  4. 必要な属性をカスタムレポートに追加します。
  5. インポートされた属性の名前を変更する場合は、[Column Heading Override XML Alias(列見出しがXMLエイリアスをオーバーライド)]列で変更します。
  6. カスタムレポートにWorkday ID属性を追加します。[Column Heading Override XML Alias(列見出しXMLエイリアスの上書き)]の値をWorkday_IDに変更します。Oktaは、Workday IDのないカスタム属性をインポートできません。

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

  8. レポート名の横の省略記号をクリックして[Web Service(Webサービス)][View URLs(URLの表示)]に移動します。
  9. リンクを右クリックし、[Copy URL(URLをコピー)]を選択して次のURLを取得します。
    • [XSD]Simple XMLの下)
    • [JSON]JSONの下)
  10. カスタムレポートを統合ユーザーと共有します。
    1. カスタムレポートを編集を検索します。
    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回の呼び出しを行うのではなく、ユーザーごとの呼び出しを行って特定のユーザーのカスタムレポートをプルすることを意味します。

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

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

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

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

Workdayインスタンスのユーザー数が5000より少ない場合、これは使用できません。

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

  1. [フィルター]タブで、フィルターを設定します。
  2. カスタムレポートの[フィルター]タブの画像。

  3. [プロンプト]タブで、プロンプトのデフォルト値を指定します。
  4. カスタムレポートの[プロンプト]タブの画像。

  5. [OK]をクリックします。
  6. 統合ユーザー(推奨)またはレポートの所有者である管理者のWorkday IDを検索します。なお、レポートの所有者が統合ユーザー以外の場合は、統合ユーザーと共有する必要があります。
  7. [Actions(アクション)][Web Service(Webサービス)][View URLs(URLを表示)]をクリックして、生成されたURLを表示します。
  8. [Employee_ID_Prompt]フィールドに、上記のステップ4で確認したWorkday IDを入力します。
  9. アクティブな管理者をデプロビジョニングしたり削除したりしないでください。その場合、別の管理者のWorkday IDを入力してURLを再生成する必要があります。

  10. 次のリンクを右クリックして[Copy URL(URLをコピー)]を選択し、新しくページネーションされたURLを取得します。
    • [XSD]Simple XMLの下)
    • [JSON]JSONの下)
  11. 新しいURLを追加して、以前と同じようにレポートを生成します。
  12. Oktaで、Workdayアプリ統合を開き、[Provisioning(プロビジョニング)]タブを選択します。
  13. 任意。XSD URLを[Custom Report Simple XML XSD URL(カスタムレポートシンプルXML XSD URL)]に貼り付けます(任意)。OktaはXSD URLを使用してカスタムレポートのスキーマを取得します。
  14. URLを[Custom Report JSON URL(カスタムレポートJSON URL)]に貼り付けます(任意)。OktaはJSON URLを使用してカスタムレポートのデータを取得します。

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

関連項目

増分インポート

Workday Real-Time Sync

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

Workdayの家庭と仕事の連絡先のライトバックを構成する

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