管理者向け機能：機能説明と使い方
帳票出力管理機能
帳票の出力は、BTP上のConnectorアプリにログインし、帳票テンプレートや出力対象従業員を選択して出力ボタンを押すことで実行されます。
帳票出力のための各種設定や出力ログを確認するためには、こちらの管理者向け機能を使います。
１．ログイン
お使いのSuccessFactorsのホーム画面から、帳票DXのメニューをクリックします。
クリックすると、BTPで動作するConnectorアプリが起動します。
注）この一覧で表示されるタイルは、「SuccessFactorsのトップ画面にリンクを作成」で設定したタイルが表示されます。BTPで動作する帳票DXのConnectorアプリの画面が開きます。
帳票出力設定を行うメニューのタイルをクリックします。
注）この一覧で表示されるメニューは、IASで設定した「オプロ 帳票DX 管理者用グループ」に所属するユーザに表示されます。
２．環境設定
Connector for SuccessFactorsと、帳票DXエンジンを接続するための設定です。
オプロもしくは代理店から発行されるCID、UID、UPW、（必要に応じてD3Worker URL）を入力して保存してください。
① 環境設定を開く
② 帳票DXエンジンと接続するための情報を入力
以下の情報を入力する。
入力後に[保存] ボタンをクリックしてください。
| CID | オプロもしくは代理店から発行されるCIDを入力する |
| UID | オプロもしくは代理店から発行されるUIDを入力する |
| UPW | オプロもしくは代理店から発行されるUPWを入力する |
| バケット名 | 検証環境は「開発」、本番環境は「本番」を入力する |
| D3WorkerURL | 必要に応じてD3Worker URLを入力する |
３．帳票定義
XAデザイナーもしくは、オプロが開発した帳票テンプレートを追加したり、テンプレート定義の設定変更ができます。
追加したテンプレートは、XAデザイナーで編集できます。
① 帳票定義を開く
② 帳票定義の追加、更新、削除を行う
(1) 新規追加
[新規登録] ボタンをクリックし、画面下部の編集エリアに帳票定義を入力する。
入力後に[保存] ボタンをクリックします。
(2) 更新
一覧より対象の定義をクリックし、編集エリアの内容を更新します。
更新後に[保存] ボタンをクリックします。
(3) 削除
一覧より対象の定義をクリックし、［削除］ボタンをクリックします。
(4) インポート／エクスポート
［エクスポート］ボタンで定義情報をダウンロードできます。
［インポート］ボタンから、エクスポートした定義情報を指定して取り込みます。
＜入力項目の詳細＞
| 編集状態 | 新規登録／編集 状態を確認する |
| 帳票名 | 分かりやすい帳票名を指定する |
| 帳票テンプレート名 | XAデザイナー側のテンプレート名を指定する |
| 出力フォーマット | 作成するフォーマットを指定する（PDF／Excel／Word／PowerPoint） |
| 出力タイプ | 作成する出力タイプを指定する（ヘッダ明細型／一覧型） |
| 出力方法 | 出力方法を指定する（ダウンロード／D³Worker連携） |
４．エンティティ定義
エンティティとはSuccessFactorsのデータ項目です。
帳票DXで帳票を出力する場合、テンプレートとエンティティのデータを組み合わせて帳票を生成します。
エンティティ設定は、XAデザイナーでテンプレートとデータ項目をマッピングする際に使用されます。
① エンティティ定義を開く
② エンティティ定義の追加、更新、削除を行う
(1) 新規追加
[新規登録] ボタンをクリックし、画面下部の編集エリアにエンティティ定義を入力します。
入力後に[保存] ボタンをクリックします。
(2) 更新
一覧より対象を選択し、編集エリアで内容を更新します。
更新後に［保存］をクリックします。
(3) 削除
一覧より対象の定義を選択し、［削除］ボタンをクリックします。
(4) インポート／エクスポート
［エクスポート］ボタンで登録されているエンティティ定義をすべてダウンロードできます。
［インポート］ボタンから定義情報を取り込みます。
＜入力項目の詳細＞
| 編集状態 | 新規登録／編集 状態を確認する |
| エンティティ名 | SuccessFactorsのエンティティ名を指定する |
| エンティティ説明 | 分かりやすいエンティティ説明を指定する |
| 紐づけカラム | エンティティ名の UserId と紐づける項目名を指定する |
５．ドロップダウン定義
帳票出力指示画面（詳細検索）の検索条件で、Picklist・マスタ（Foundation Object）項目を選択ダイアログに表示するための設定を行う画面です。
あらかじめSuccessFactorsからPicklist・マスタのコード値・ラベル情報を取得し、オプロ側のサーバーに保存しておくことで、検索画面の選択ダイアログに表示します。
① ドロップダウン定義を開く
② ドロップダウン定義の追加、更新、削除を行う
(1) 新規追加
[新規登録] ボタンをクリックし、画面下部の編集エリアにドロップダウン定義を入力します。
タイプ（「ピックリスト」または「マスタエンティティ」）に応じて入力項目が変わります（詳細は下記＜入力項目の詳細＞を参照）。
※ 登録するPicklist・マスタの選択肢データ（コード値・ラベル）は、オプロ側のサーバーに保存されます。
氏名など個人情報に相当する内容を含む項目は登録しないでください。
入力後に[保存] ボタンをクリックします。
保存すると、SuccessFactorsからPicklist・マスタのデータ（コード値・ラベル）を取得し、ドロップダウンの中身を作成します。
(2) 更新
一覧より対象の定義を選択し、編集エリアの内容を更新します。
既存のドロップダウン定義は、「ドロップダウン名」のみ変更可能です。
タイプ・エンティティ名・紐づけカラム・ラベル項目などは変更できません（すでに検索画面等で使用されている場合、これらの項目を変更すると参照先の設定に影響が出るためです）。
ドロップダウン名以外の項目を変更したい場合は、対象の定義を削除し、新規登録からやり直してください。
※ 既に検索／一覧項目の設定で使用中のドロップダウン定義は削除できません。削除する場合は、先に該当の検索／一覧項目の設定側の参照を外したうえで、削除を行ってください。
なお、[保存] ボタンをクリックすると、その時点でSuccessFactorsから最新のPicklist・マスタのデータを取得し、ドロップダウンの中身を最新化します。
(3) 削除
一覧より対象の定義を選択し、［削除］ボタンをクリックします。
既存の検索設定等で使用中の場合、削除できません。
(4) インポート／エクスポート
［エクスポート］ボタンで登録されているドロップダウン定義をすべてダウンロードできます。
［インポート］ボタンから定義情報を取り込みます。
(5) ドロップダウンの最新化
ドロップダウン定義に登録した項目のコード値・ラベルは、SuccessFactors側でPicklist・マスタの内容が更新されても自動的には反映されません。
以下いずれかの方法で、最新データを取得（再同期）してください。
・ 一覧のアクション列にある [同期] アイコン：対象の1件のみデータを再取得します。
・ 画面上部の［一括更新］ボタン：登録されている全件のデータを一括で再取得します。
(6) データ内容の確認
一覧のアクション列にある [データ確認] アイコンをクリックすると、「データ内容」ダイアログが開き、その定義に紐づく実際のコード・日本語ラベル・英語ラベルの一覧を確認できます。
＜入力項目の詳細（共通）＞
| 編集状態 | 新規登録／編集 状態を確認する |
| ドロップダウン名 | 分かりやすいドロップダウン名を指定する |
| タイプ | 「ピックリスト」または「マスタエンティティ」を選択する |
＜入力項目の詳細（タイプ：ピックリストの場合）＞
| ピックリストコード | SuccessFactorsのPicklist ID（コード）を指定する |
＜入力項目の詳細（タイプ：マスタエンティティの場合）＞
| エンティティ名 | 対象のマスタ（Foundation Object）のエンティティ名を指定する （例：FOLocation、FODivision等） |
| 紐づけカラム | コード値として使用するフィールド名を指定する（例：externalCode） |
| 日本語ラベル | 日本語ラベルとして使用するフィールド名を指定する |
| 英語ラベル | 英語ラベルとして使用するフィールド名を指定する |
| カスタムクエリ | 対象データを絞り込むためのクエリを必要に応じて指定する |
※ 一覧画面の「ピックリストコード／紐付けカラム」列には、タイプが「ピックリスト」の場合はピックリストコード、「マスタエンティティ」の場合は紐づけカラムが表示されます。
６．出力設定
帳票テンプレートに出力する項目を設定・確認する画面です。
帳票名を選択すると、テンプレートがどのエンティティのデータと紐づいているかが表示されます。
① 出力設定を開く
② 帳票名を選択する
③ 帳票テンプレートに出力する項目を設定・確認する
７．操作履歴
操作履歴画面では、帳票出力および各種設定のログを確認できます。
Connector for SuccessFactors 上ではログは6ヶ月間保管されます。
① 操作履歴を開く
② ログを確認する
以下の項目で絞り込みが可能です。
| 期間 | 操作日時で絞り込む |
| ユーザID | 操作したユーザID（完全一致） |
| 操作種別 | 機能ごとに絞り込む |
| 処理結果 | 成功／失敗 |
［エクスポート］ボタンで、条件に合致したログをCSV形式でダウンロードできます。
＜帳票出力ログの確認＞
(1) 絞り込み例
| 期間 | 任意 |
| ユーザID | 任意 |
| 操作種別 | 帳票作成 |
| 処理結果 | 成功 |
(2) 操作詳細欄の項目説明
| GeneratedBy | 帳票を出力したユーザID（操作者） |
| GenerateTarget | 出力対象ユーザID（複数の場合はカンマ区切り） |
| FormName | 出力した帳票名 |
| FormTemplateName | 出力した帳票テンプレート名 |
| FileType |
出力ファイル形式 ※ PDF／Excel／Word／PowerPoint |
| HeaderDetail |
出力した帳票がヘッダ明細型かどうか ※ true：ヘッダ明細型 false：一覧型 |
| OutputDetail |
出力方法 ※ ダウンロード／D³Worker連携 |
| ReadOnlyFlag |
出力した帳票が読み取り専用帳票かどうか ※ true：読み取り専用 false：読み取り専用以外（編集可能帳票） |
| EffectiveDate |
帳票作成時に指定した基準日 ※「帳票作成」機能の画面下部で指定する基準日 |
| totalQueryTime | 帳票作成に要した時間（ミリ秒） |
改訂履歴
2025年3月21日：初版
2026年1月27日：２版（最新バージョンに合わせて修正）
2026年9月13日：３版（ドロップダウン定義（V2.2）を追加）