intra-mart Accel Platform 国際化支援機能仕様書 初版 2014-12-01

IM-共通マスタ/ロール国際化情報補完ジョブ

IM-共通マスタ/ロール国際化登録支援機能 には、 IM-共通マスタ/ロール国際化情報補完ジョブ というジョブが含まれています。
本項では、 IM-共通マスタ/ロール国際化情報補完ジョブ について説明します。

概要

intra-mart Accel Platform では、 IM-共通マスタ で登録可能な会社名やユーザ名、テナント管理機能で登録可能なロール表示名などが国際化情報として管理されています。
IM-共通マスタ/ロール国際化登録支援機能 の IM-共通マスタ/ロール国際化情報補完ジョブ は、これらの国際化情報に入力漏れがあった場合に補完するためのジョブです。
ここで言う補完とは、テナントロケールのデータをコピーすることを意味します。つまり、テナントロケールとして日本語が選択されていて英語や中国語に入力漏れがあった場合、日本語のデータを英語や中国語のデータとしてコピーすることを意味します。
このジョブは、国際化情報を補完すると、パブリックストレージ上にCSV形式のログファイルを出力します。
IM-共通マスタ/ロール国際化情報補完ジョブ では、以下の機能の国際化情報を補完することができます。
  • 会社/組織
  • 会社役職
  • パブリックグループ
  • パブリックグループ役割
  • ユーザプロファイル
  • ロール

ジョブの種類

IM-共通マスタ/ロール国際化登録支援機能 では、 IM-共通マスタ/ロール国際化情報補完ジョブ としてテナント環境セットアップで以下のジョブが登録されます。
名前 説明
会社組織補完ジョブ 会社/組織の国際化情報の入力漏れを補完するためのジョブです。
会社役職補完ジョブ 会社役職の国際化情報の入力漏れを補完するためのジョブです。
パブリックグループ補完ジョブ パブリックグループの国際化情報の入力漏れを補完するためのジョブです。
パブリックグループ役割補完ジョブ パブリックグループ役割の国際化情報の入力漏れを補完するためのジョブです。
ユーザプロファイル補完ジョブ ユーザプロファイルの国際化情報の入力漏れを補完するためのジョブです。
ユーザメールアドレス補完ジョブ ユーザプロファイルのメールアドレス1の入力漏れを補完するためのジョブです。
ロール補完ジョブ ロールの国際化情報の入力漏れを補完するためのジョブです。

これらのジョブを用いて、新たなジョブネットを作成することで、補完する範囲を柔軟に設定することができます。

コラム

ジョブネットの作成方法は、「 テナント管理者操作ガイド 」の「 ジョブを設定する 」を確認してください。

実行プログラム

上記のジョブには、以下の実行プログラムが設定されています。
実行プログラム 利用しているジョブ
jp.co.intra_mart.system.master.company.job_scheduler
.StandardCompanyLocalizedDataComplementJobScheduler
会社組織補完ジョブ
jp.co.intra_mart.system.master.company.job_scheduler
.StandardCompanyPostLocalizedDataComplementJobScheduler
会社役職補完ジョブ
jp.co.intra_mart.system.master.public_group.job_scheduler
.StandardPublicGroupLocalizedDataComplementJobScheduler
パブリックグループ補完ジョブ
jp.co.intra_mart.system.master.public_group.job_scheduler
.StandardPublicGroupRoleLocalizedDataComplementJobScheduler
パブリックグループ役割補完ジョブ
jp.co.intra_mart.system.master.user.job_scheduler
.StandardUserLocalizedDataComplementJobScheduler
ユーザプロファイル補完ジョブ
ユーザメールアドレス補完ジョブ
jp.co.intra_mart.system.admin.role.job_scheduler
.StandardRoleLocalizedDataComplementJobScheduler
ロール補完ジョブ

これらの実行プログラムには、補完したい国際化情報をパラメータとして個別に指定することができます。
このため、 ユーザメールアドレス補完ジョブ のようにユーザプロファイルのメールアドレス1のみを補完するといったことが、ジョブの設定のみで実現できます。

コラム

ジョブの設定方法は、「 テナント管理者操作ガイド 」の「 ジョブを設定する 」を確認してください。
実行パラメータについては、 IM-共通マスタ/ロール国際化情報補完ジョブ のパラメータ を確認してください。

国際化情報の状態

各言語の国際化情報の入力漏れは、以下の2つのタイプに分けることができます。
  • すべての国際化情報がない
    特定の言語の国際化情報が全く存在しなければ、このタイプです。
    例えば、 IM-共通マスタ で日本語のみを入力し、「他ロケール設定」から英語や中国語を入力せずに登録した場合が挙げられます。
    IM-共通マスタ/ロール国際化情報補完ジョブ ではこのようなデータを検知すると、下図のようにテナントロケールからコピーします。
    ../../_images/complement_type_no_record.png

    コラム

    このタイプでは、テナントロケールの全ての国際化情報がコピーされます。

  • 一部の国際化情報が欠けている
    特定の言語の国際化情報が一部欠けている場合は、このタイプです。
    例えば、 IM-共通マスタ で英語の国際化情報として名称のみを入力した場合などが挙げられます。
    IM-共通マスタ/ロール国際化情報補完ジョブ ではこのようなデータを検知すると、下図のようにテナントロケールからコピーします。
    ../../_images/complement_type_missing_item.png

    コラム

    このタイプでは、補完対象として指定されている国際化情報のみがコピーされます。

ジョブの実行結果

ジョブネットモニタ詳細画面から、各ジョブの実行結果を確認することができます。
../../_images/i18n_complement_job_result.png

コラム

ジョブネットモニタ詳細画面は、 「サイトマップ」 → 「テナント管理 - ジョブ管理 - ジョブネットモニタ」 とクリックして、ジョブネットモニタ一覧画面で実行結果の行をクリックすると表示できます。

コラム

補完内容は、CSV形式でログファイルとしてパブリックストレージ上に出力されます。

ログファイルについて

IM-共通マスタ/ロール国際化情報補完ジョブ で入力漏れを補完すると、パブリックストレージ上にCSV形式で以下のような内容を書き込みます。
名前 説明
キー
どの国際化情報かを特定するためのキーです。
例えば、 ユーザプロファイル補完ジョブ ではユーザコード、開始日、終了日、ロケールIDが書き込まれます。
タイプ
国際化情報の状態を表します。
すべての国際化情報がないデータを補完した場合には、タイプとして「[ALL]」を書き込みます。
一部の国際化情報が欠けているデータを補完した場合には、何も書き込みません。
メッセージ
補完した内容の説明です。

コラム

補完は、テナントロケール以外のすべての言語が対象です。ユーザプロファイルや会社/組織などの期間化されている情報は、すべての期間、テナントロケール以外のすべての言語が対象になります。 入力漏れを補完すると、期間・言語毎に書き込みます。
例えば、ユーザ01のプロファイルが「2000-04-01」で分割されていて、日本語の名前のみ登録されていた場合、以下のような内容が書き込まれます。
例).
user01,1900-01-01,2000-04-01,en,[ALL],ユーザ(ユーザ01)の(英語)のプロファイルが登録されていなかったため、(日本語)のデータをコピーしました。
user01,1900-01-01,2000-04-01,zh,[ALL],ユーザ(ユーザ01)の(中国語 (中華人民共和国))のプロファイルが登録されていなかったため、(日本語)のデータをコピーしました。
user01,2000-04-01,3000-01-01,en,[ALL],ユーザ(ユーザ01)の(英語)のプロファイルが登録されていなかったため、(日本語)のデータをコピーしました。
user01,2000-04-01,3000-01-01,zh,[ALL],ユーザ(ユーザ01)の(中国語 (中華人民共和国))のプロファイルが登録されていなかったため、(日本語)のデータをコピーしました。