比較バージョン

キー

  • この行は追加されました。
  • この行は削除されました。
  • 書式設定が変更されました。

...

基本情報、記述形式、定義内容、記述例などについて説明します。

<目次>

目次

ファイルの基本情報

...

項目

内容

ファイル名

任意

既定の設定を以下に示します。

  • イベント管理登録:config-entry-Event.xml

  • ハードウェア登録:config-entry-Hardware.xml

  • ソフトウェア登録:config-entry-Software.xml

  • 取引先登録:config-entry-Account.xml

  • 取引先責任者登録:config-entry-Contact.xml

ファイル保管先

任意(既定はconfigフォルダ)

フォーマット

XML形式ファイル

文字コード

UTF-8(BOMなし)

改行コード

CR+LF, CR, LF

ファイル反映のタイミング

データ登録ユーティリティ起動時

記述形式

...

コード ブロック
<config>
       <register-setting />
       <path-setting />
       <mapping-info />
       <escapeInput />
</config>

...

<register-setting>タグ内に以下の属性を記述します。

属性

説明

省略可否

省略値

batchSize

まとめて処理するCSVデータのレコード数を指定します。1 ~ 200 までが指定できます。

例:batchSize='10'

200 

nameSpace

登録先の名前空間を指定します。

この値は変更せず、そのまま使用します。

例:nameSpace='SMOC__'

×


objectName

登録先の対象オブジェクトを指定します。

  • イベント:SMOC__ox_obj_event__c

  • ハードウェア:SMOC__ox_obj_hardware__c

  • ソフトウェア:SMOC__ox_obj_software__c

  • 取引先:Account

  • 取引先責任者:Contact

例:objectName='SMOC__ox_obj_event__c'

×


useTrigger

データ登録時にApexトリガを起動するかを指定します。

  • true:Apexトリガを起動します。

  • false:Apexトリガを起動しません。

登録後にワークフローを使用したい場合には、trueを指定します。

例:useTrigger='true'

情報

trueを指定した場合、使用するプロファイルの[既存ワークフロー制御フラグ]について、項目レベルセキュリティの設定を[参照可能]に設定する必要があります。設定については、この表したの設定例を参照してください。

true 

register-mode

データ登録で、新規登録と更新処理のどちらを行うかを指定します。

  • insert:キー項目に該当するデータが存在しない場合、新規登録します。

  • update:キー項目に該当するデータが存在する場合、更新します。

  • insert,update:キー項目に該当するデータが存在する場合、更新します。存在しない場合、新規登録します。

例:register-mode='insert'

update実行時、キー項目に該当するデータが複数存在する場合、最初の1件のみupdateされます。

×


csvTotalCols

CSVの1レコードあたりの総項目数を指定します。

例:csvTotalCols='5'

×


csvKeyCols

キー項目となるCSV ファイルの列番号を指定します。

複数キーが存在する場合は、カンマ区切りで指定します。最大5項目指定できます。

省略した場合は無視します。

例:csvKeyCols='1'

Update実行時に、キー項目に、シングルクオート(‘)、¥マークを含むデータを使用することはできません。


sfKeyCols

キー項目のAPI参照名を指定します。

複数キーが存在する場合は、カンマ区切りで指定します。最大5項目指定できます。

省略した場合は無視します。

通常は以下のように指定します。

  • イベント:
    (キー項目の設定なし)

  • ソフトウェア:
    SMOC__ox_txt_name__c,SMOC__ox_txt_version__c, SMOC__ox_txt_edition__c

  • ハードウェア:
    SMOC__ox_txt_name__c

  • 取引先:
    SMOC__ox_txt_discernmentCode__c

  • 取引先責任者:
    SMOC__ox_txt_discernmentCode__c

例:sfKeyCols='SMOC__ox_txt_ name __c'


useHeader

CSVファイルのヘッダーの有無を指定します。

  • true:CSVファイルのヘッダーが登録されません。

  • false:CSVファイルのヘッダーが登録されます。

例:useHeader=’true’

 ’true’

file-encoding

CSVファイルの文字コードを指定します。

通常は以下のように指定します。

  • MS932:
    file-encoding=’MS932’

  • Shift-JIS:
    file-encoding=’Shift-JIS’

  • UTF-8:
    file-encoding=’UTF-8’

  • Windows-31J:
    file-encoding=’Windows-31J’

例:file-encoding=’MS932’

 ’MS932’

newline-code

CSVファイルの改行コードを指定します。省略値は’¥r¥n’です。

通常は以下のように指定します。

  • CR:
    newline-code=’¥r’

  • LF:
    newline-code=’¥n’

  • CR+LF:
    newline-code=’¥r¥n’

例:newline-code=’¥r¥n’


情報

「useTrigger=true」としている場合、使用するプロファイルの[既存ワークフロー制御フラグ]について、項目レベルセキュリティの設定を[参照可能]に設定する必要があります。
以下に、プロファイルが「システム管理者」、対象オブジェクトが「イベント管理」の場合の操作方法を示します。

...

管理メニューを表示します。 管理メニューを表示する操作については、「コンフィグレーションに使用するメニュー(Classic)」を参照してください。

管理メニューで、[ユーザの管理]‐[プロファイル]をクリックします。

...

1.設定画面を表示します。 設定画面を表示する操作については、「コンフィグレーションに使用するメニュー」を参照してください。

2.クイック検索より「プロファイル」と検索します。検索結果から「プロファイル」をクリックします。

...

3.[システム管理者]をクリックします。

...

4.[項目レベルセキュリティ]-[カスタム項目レベルセキュリティ]で、[イベント管理]の[参照]をクリックします。

...

5.[編集]ボタンをクリックします。

...

6.[既存ワークフロー制御フラグ]の[参照アクセス権]チェックボックスをチェックします。

...

7.[保存]ボタンをクリックします。

...

<path-setting>タグ

<path-setting>タグ内に以下の属性を記述します。

属性

説明

省略可否

省略値

log

実行ログファイルの出力フォルダをフルパスで指定します。

例:log='log/event'

×


registeredCsv

登録済みフォルダ(登録済みデータCSVファイルの出力フォルダ)をフルパスで指定します。

省略した場合、CSVファイルは出力しません。

例:registeredCsv='monitor/event/result/success'


unRegisteredCsv

未登録フォルダ(未登録データCSVファイルの出力フォルダ)をフルパスで指定します。

省略した場合、CSVファイルは出力しません。

例:unRegisteredCsv='monitor/event/result/error'


<mapping-info>タグ

<mapping-info>タグ内に、必要な数だけ<column>タグを記述します。

CSVの列データごとに<column>タグ内に以下の属性を記述します。<column>タグは、必要な数だけ繰り返し記述できます。

属性

説明

省略可否

省略値

no

登録するデータのCSVでの列番号を指定します。

noに’A’を指定した場合、CSVに含まれていない内容も固定値として登録できます。

例1:no='1'

例2:no=’A’ data=’1’

×


name

登録先項目のAPI参照名を指定します。

例:name='SMOC__ox_sel_ntfFrom__c'

×


type

Salesforceのデータ型を指定します。

例:type='picklist'

×


key

入力データのフォーマットを指定します。

例1:key='0,1,2'

上記は、typeに'picklist'を指定した場合の指定例です。

例2:key=”yyyy-MM-dd HH:mm:ss”

上記は、typeに'datetime'を指定した場合の指定例です。

例3:key=”yyyy-MM-dd”

上記は、typeに'date'を指定した場合の指定例です。

×


value

keyで指定した値を、valueで指定した値に置換します。

例1:value='ユーザ,システム,ツール'

上記は、typeに'picklist'を指定した場合の指定例です。

例2:value=’ yyyy-MM-dd HH:mm:ss’

上記は、typeに'datetime'を指定した場合の指定例です。

例3:key=”yyyy-MM-dd”

上記は、typeに'date'を指定した場合の指定例です。

×


lookup

入力されたデータを基にLMIS上のデータを検索します。

検索対象のオブジェクト、取得する値、検索対象項目を以下の形式で指定します。

指定形式:

lookup=’検索対象オブジェクト名, 取得する値, 検索対象項目’

例:

lookup=’SMOC__ox_obj_software__c,id,SMOC__ox_txt_name__c’

上記の場合、入力されたデータとソフトウェア名の一致するレコードのIDを取得します。
ロングテキストエリア、テキストエリア(リッチ)、テキスト(暗号化)、日時、日付、時間、地理位置情報の項目を使用した検索はできません。


nullupdate

入力データのカラム値がNULLの場合、NULLでUPDATEをするかを指定します。

  • true:NULLの場合、UPDATEを行います。

  • false:NULLの場合、UPDATEは行いません。

例:nullupdate=’false’

 ’true’

readonly

データを読み込む際、登録を実行するかを指定します。

  • true:データの登録を行いません。

  • false:データの登録を行います。

例:readonly=’true’

 ’false’

情報

オブジェクトの各項目のAPI参照名とデータ型については、「API参照名一覧」を参照してください。

...

エスケープ文字ごとにエスケープルールを指定できます。必要な数だけ繰り返し記述できます。

属性

説明

省略可否

省略値

key

エスケープを実施する文字を指定します。

例:key=’¥¥¥¥n’


value

keyで指定した値を、valueで指定した値に置換します。

例:value=’¥n’


定義例

...

イベント管理の場合とハードウェアの場合の定義例を示します。

...