intra-mart Accel Platform ロール インポート・エクスポート仕様書 第4版 2014-08-01

ファイルフォーマット

この章では、インポート・エクスポート機能で利用するファイルのフォーマットについて説明します。

XMLファイルフォーマット

<role-data> タグ内に1つのロールに関連する情報をすべてを記述します。

ロール情報<role-data> タグに記述します。
id 属性にロールIDを、name 属性にロール名を記述します。
タグ内には、カテゴリ、備考を記述します。

ロール表示名情報<display-names> タグに記述します。
設定数の数だけ <display-name> タグを記述します。
locale 属性にロケールIDを、タグ内には、ロケールIDに応じたロールの表示名を記述します。

ロール親子関係 の親ロール情報を <parent-roles> タグに記述します。
設定数の数だけ <parent-role> タグを記述します。
id 属性に親ロールIDを記述します。

ロール親子関係 の子ロール情報を <sub-roles> タグに記述します。
設定数の数だけ <sub-role> タグを記述します。
id 属性に子ロールIDを記述します。

ファイルフォーマットの詳細については「ロールインポートデータ定義書」を参照してください。

以下はXMLファイルの例です。
<root xmlns="http://intra-mart.co.jp/system/admin/role/role-data">
    <role-data name="role-1" id="role-1">
        <description>Top role.</description>
        <display-names>
            <display-name locale="ja">ロール1</display-name>
            <display-name locale="en">role 1</display-name>
        </display-names>
        <parent-roles />
        <sub-roles>
            <sub-role id="role-2" />
        </sub-roles>
    </role-data>
    <role-data name="role-2" id="role-2">
        <description>Sub role.</description>
        <display-names>
            <display-name locale="ja">ロール2</display-name>
            <display-name locale="en">role 2</display-name>
        </display-names>
        <parent-roles>
            <parent-role id="role-1" />
        </parent-roles>
        <sub-roles>
            <sub-role id="role-3" />
        </sub-roles>
    </role-data>
    <role-data name="role-3" id="role-3">
        <description>Sub role.</description>
        <display-names>
            <display-name locale="ja">ロール3</display-name>
            <display-name locale="en">role 3</display-name>
        </display-names>
        <parent-roles>
            <parent-role id="role-2" />
        </parent-roles>
        <sub-roles />
    </role-data>
</root>

コラム

parent-roles タグと sub-roles タグの記述について

どちらか一方のみ指定することで親子関係が構築されます。
上記の例ではロールID role-2sub-roles タグにロールID role-3 を指定し、
ロールID role-3parent-roles タグにロールID role-2 を指定していますが、
親となるロールと子となるロールの両方に親子関係を指定する必要はありません。

互換性

intra-mart Accel Platform で利用するインポートファイルは、 intra-mart WebPlatform/AppFramework で利用するインポートファイルとは互換性はありません。
intra-mart WebPlatform/AppFramework で利用していたインポートファイルをそのまま利用したい場合、互換機能を利用してください。
互換機能を利用するためには、「互換ガイド」を参照してください。