読み取りデータ書式 | シンボル情報取得書式 | 配信先取得書式 | 処理結果取得書式 | ユーザデータ書式 |
グローバルデータ書式 | プラグインデータ書式 | 日付書式 | ファイル名書式 | 文字列書式 |
数学書式 | 制御書式 | 実行書式 | データベース書式 | DocuWorksAPI書式 | ブラウザフォーム書式

マクロで使用可能な、データ領域(変数)に記憶された文字情報を、番号指定で取得します。キーを指定して設定したユーザーデータでも設定順の番号で指定可能です。

{%SET_USER_DATA(用紙枚数,A4,3枚)}
{%SET_USER_DATA(用紙枚数,B4,5枚)}

{%GET_USER_DATA_BY_NUMBER(用紙枚数,2)}
↓
「5枚」が返却されます。

マクロで使用可能な、データ領域(変数)に記憶されたキーを、番号指定で取得します。キーを指定して設定したユーザーデータでも設定順の番号で指定可能です。

{%SET_USER_DATA(用紙枚数,A4,3枚)}
{%SET_USER_DATA(用紙枚数,B4,5枚)}

{%GET_USER_DATA_KEY_BY_NUMBER(用紙枚数,2)}
↓
「B4」が返却されます。

ユーザデータに記憶されたデータの個数を返却します。データ名を指定します。

{%GET_USER_DATA_COUNT(商品データ)}

ユーザデータに記憶されているデータのキーが存在するかチェックします。データが存在する場合、「True」を返却します。存在しない場合は、「Flase」を返却します。

{%IF({%GET_USER_DATA_EXISTS(商品データ,A001-00123)}=True,{%MSGBOX(データあり)},{%MSGBOX(データなし)})}

ユーザデータを削除します。キーは省略可能で、キーを省略した場合は、データ名で定義された全てのキーと値が削除されます。データ名とキーを指定した場合は、該当のキーと値のみが削除されます。

{%DELETE_USER_DATA(商品データ,A001)}

{%DELETE_USER_DATA(商品データ)}

SAVE_USER_DATAマクロによって、出力されたユーザデータをファイルから読み込みます。

値に独自の形式の識別文字（改行や、タブ）が含まれる場合は、マッチした制御文字に置き換え、読み込みます。

ファイル削除指定には、「Delete」または、「Leave」を指定できます。「Delete」を指定した場合は、データ読込後に、ファイルを削除します。「Leave」を指定した場合は、ファイルを削除せず、そのまま残します。

{%LOAD_USER_DATA(D:\Test\UserData.txt,商品データ,Delete)}

ユーザデータの内容をファイルに出力します。出力するファイルはテキスト形式で、キーと値がタブで区切られたTAB区切りデータになります。複数のデータがある場合は、1データ1行で改行されて出力されます。

また、値に、改行や、タブが含まれる場合は、独自の形式で識別文字に置き換え保存します。

{%SAVE_USER_DATA(D:\Test\UserData.txt,商品データ)}

カンマ区切りやタブ区切りのテキストファイルをFILE_READマクロで読み込んだユーザデータを対象に、区切り文字で項目を分割し、結果を指定したユーザデータに格納します。

分割されるデータには、ユニークキーが存在することが前提で、引数にユニークキーの項目番号(1～n)を指定します。

結果として格納されるユーザデータは、「引数で指定した出力ユーザデータ名 + "_" + ユニークキー」という名前で設定します。したがって、データの件数分、ユーザデータが作成されることになります。

分割されたデータにユニークキーとして指定した項目が存在しない場合（0を指定した場合等）は、ユーザデータ名の末尾に付加する文字を行番号にします。（「引数で指定した出力ユーザデータ + "_" + 行番号」）

ユニークであるはずのキーが複数存在した場合には、後から読み込んだデータ(キー)で上書きします。

ユーザデータの中身は、項目番号をキーとして、項目の内容を値としてセットします。

区切り文字にタブを指定する場合は、「vbTab」を指定します。また、カンマを指定する場合は、「\,」を指定します。

                
                  [マスタ.txtの内容(タブ区切りで1番目の項目がユニークキー)]
                
              

                001  山田商事  03-5555-1112
002  大橋運輸  03-5555-1234
003  伊藤商店  03-5555-6655


                  [マクロ]
                
{%FILE_READ(C:\Test\Data\マスタ.txt,マスタ)}
{%SPLIT_USER_DATA(マスタ,取引先,vbTab,1)}
{%MSGBOX({%GET_USER_DATA(取引先_003,2)} {%GET_USER_DATA(取引先_003,3)})}
              
            
            
              
                
                  [結果]
                
伊藤商店 03-5555-6655
              

ユーザデータの内容を並び換えます。

対象ユーザデータには、並び換えを行うユーザデータの名前を指定します。

並び順には、「ASC」又は「DESC」を指定します。「ASC」を指定した場合、昇順に並び換えられます。「DESC」を指定した場合、降順に並び換えられます。

対象には、「KEY」又は「VALUE」を指定します。「KEY」を指定した場合、キーを対象に並び換えを行います。「VALUE」を指定した場合、値を対象に並び換えを行います。

データタイプには、「STRING」又は「INTEGER」を指定します。「STRING」を指定した場合、文字列として並び換えを行います。「INTEGER」を指定した場合、数値として並び換えを行います。「INTEGER」を指定した場合に、データに文字があると、エラー「型が一致しません」が発生します。

ユーザデータを並び替えたあとは、「GET_USER_DATA_BY_NUMBER」又は、「GET_USER_DATA_KEY_BY_NUMBER」で値を取得すると、並び順でデータが取得できます。

{%SET_USER_DATA(wk,1,100)}
{%SET_USER_DATA(wk,2,300)}
{%SET_USER_DATA(wk,3,200)}
{%SORT_USER_DATA(wk,ASC,VALUE,INTEGER)}

#--

{%LOOP L1 {%GET_USER_DATA_COUNT(wk)}(
  {%MSGBOX({%GET_USER_DATA_KEY_BY_NUMBER(wk,[L_IDX(L1)])})}
)}

{%SET_USER_DATA(wk,きとう,1)}
{%SET_USER_DATA(wk,やまもと,2)}
{%SET_USER_DATA(wk,にしだ,3)}
{%SORT_USER_DATA(wk,DESC,KEY,STRING)}

#--

{%LOOP L1 {%GET_USER_DATA_COUNT(wk)}(
  {%MSGBOX({%GET_USER_DATA_KEY_BY_NUMBER(wk,[L_IDX(L1)])})}
)}

プラグインデータ設定で設定された文字列を、引数の名前により返却します。プラグインから実行された場合のみ取得可能です。それ以外は空文字が返却されます。

{%GET_PLUGIN_DATA(氏名}