公開
マニュアル一覧へ

ご契約者向け
マニュアル一覧へ

IIJ IDガバナンス管理サービス Import Agent マニュアル

設定例

【注意】

本ページで示す設定は例であり、お客様環境での正常な動作を保証するものではありません。

お客様環境で設定する際は、本書の内容をご理解の上、お客様の利用状況などに応じて設定してください。

設定シナリオ

IIJ IGA Import Agentを実行させる状況は以下である、というシナリオです。

インポート設定名importType実行タイミング処理内容
Org_Importgroup毎晩 0:00
  • 組織の作成
  • 組織名の変更
  • 組織の移動
  • 削除する予定の組織の移動
OrgTransaction_ImporttransactionGroup毎晩 0:30
  • 組織の削除
Member_Importmember毎晩 1:00
  • 従業員の作成
  • 従業員の更新
  • 従業員の削除（退職日の設定）
【参考】

上記の設定シナリオのように定期的に実行する場合は、タスクスケジューラを設定してください。詳しくは、「タスクスケジューラにタスクを登録する」、及び「タスクスケジューラ設定の引数の追加（オプション）」をご覧ください。その他の設定については、本書では説明しません。

設定ファイルの例

「defaultCompanyEntityId」は管理コンソールの「インポート」メニューで確認できます。設定例では、該当の会社オブジェクトのエンティティIDの値が「282LpYO0Qjet7FaWbULe_A」であったものとしています。

setting.ini
version="1.0"
environment="https://example.igms.iij.jp"
defaultInputDirectory="input"
defaultLogDirectory="logs"
defaultStatusDirectory="status"
defaultArchiveDirectory="archive"

[Org_Import]
importType="group"
importAndApply=true
tierSeparator="/"
mapping="""
organization: 組織
organizationCode: 組織コード
"""
isArchive=true

[OrgTransaction_Import]
importType="transactionGroup"
importAndApply=true
tierSeparator="/"
mapping="""
transactionType: 操作
organization: 組織
"""
isArchive=true

[Member_Import]
importType="transactionGroup"
importAndApply=true
tierSeparator="/“
referenceSeparator="+"
defaultCompanyEntityId="282LpYO0Qjet7FaWbULe_A"
mapping="""
email: メールアドレス
familyNameLocalPreferred: 姓
givenNameLocalPreferred: 名
organizationCode: 組織コード
enrollment: 在籍状況
employmentType: 雇用形態
changeDate: 変更日
enterDate: 入社日
retireDate: 退職日
"""
isArchive=true
タスクスケジューラ設定の引数の追加（オプション）

タスクスケジューラの各タスクの「引数の追加（オプション）」の設定値は、以下のとおりです。

インポート設定名「引数の追加（オプション）」の設定値
Org_Import
import --changeDate="fromFileName" --setting=Org_Import
OrgTransaction_Import
import --changeDate="fromFileName" --setting=OrgTransaction_Import
Member_Import
import --setting=Member_Import
インポート用CSVファイルの例

インポート設定ごとに、以下の形式のCSVファイルを準備します。

なお、以下は2025年4月1日に適用する場合の設定例です。

Org_Import

20250401_org.csv
組織,組織コード
削除対象組織,DELETE_ORG
削除対象組織/××支社,CROSS_ORG
example.jp/営業本部/企画部,PLANNING
example.jp/技術本部/技術一課,ENGINEER_1
example.jp/技術本部/技術二課,ENGINEER_2

OrgTransaction_Import

20250401_orgtransaction.csv
操作,組織
retireEntity,削除対象組織

Member_Import

member.csv
メールアドレス,姓,名,組織コード,在籍状況,雇用形態,変更日,入社日,退職日
user01@example.jp,テスト,ユーザ01,PLANNING+ENGINEER_1,在籍,正社員,2025/04/01,2025/04/01,
user02@example.jp,テスト,ユーザ02,ENGINEER_1,在籍,正社員,2025/04/01,2025/04/01,
user03@example.jp,テスト,ユーザ03,CROSS_ORG,在籍,正社員,2025/04/01,,2025/04/01