処理中ファイル書式 | 状態取得書式 | ユーザーデータ書式 | グローバルデータ書式 | 日付書式 | 文字列書式 | 数学書式 | 制御書式 | ファイルシステム書式 | CSVファイル書式 | DocuWorks書式 | DocuWorks書式 (アノテーション関連) | その他の書式
日付書式には、日付を表す日付記号を記述します。日付記号は下記を参照してください。
| 日付記号 | 内容 |
|---|---|
| yy | 西暦の年を下 2 桁の数値で返します (00 ~ 99)。 |
| yyyy | 西暦の年を 4 桁の数値で返します (100 ~ 9999)。 |
| M | 月を表す数値を返します。1 桁の場合、先頭に 0 が付きません (1 ~ 12)。1文字だけ単独で使用する場合は、%Mと記述します。 |
| MM | 月を表す数値を返します。1 桁の場合、先頭に 0 が付きます (01 ~ 12)。 |
| d | 日付を返します。1 桁の場合、先頭に 0 が付きません (1 ~ 31)。1文字だけ単独で使用する場合は、%dと記述します。 |
| dd | 日付を返します。1 桁の場合、先頭に 0 が付きます (01 ~ 31)。 |
| ddd | 曜日を英語 (省略形) で返します (Sun ~ Sat)。 |
| aaa | 曜日を日本語 (省略形) で返します (日~土)。 |
| aaaa | 曜日を日本語で返します (日曜日~土曜日)。 |
| g | 年号の頭文字を返します (M、T、S、H)。1文字だけ単独で使用する場合は、%gと記述します。 |
| gg | 年号の先頭の 1 文字を漢字で返します (明、大、昭、平、令)。 |
| ggg | 年号を返します (明治、大正、昭和、平成、令和)。 |
| e | 年号に基づく和暦の年を返します。1 桁の場合、先頭に 0 が付きません。1文字だけ単独で使用する場合は、%eと記述します。 |
| ee | 年号に基づく和暦の年を 2 桁の数値を使って返します。1 桁の場合、先頭に 0 が付きます。 |
| H | 時間を返します。1 桁の場合、先頭に 0 が付きません (0 ~ 23)。1文字だけ単独で使用する場合は、%Hと記述します。 |
| HH | 時間を返します。1 桁の場合、先頭に 0 が付きます (00 ~ 23)。 |
| m | 分を返します。1 桁の場合、先頭に 0 が付きません (0 ~ 59)。1文字だけ単独で使用する場合は、%mと記述します。 |
| mm | 分を返します。1 桁の場合、先頭に 0 が付きます (00 ~ 59)。 |
| s | 秒を返します。1 桁の場合、先頭に 0 が付きません (0 ~ 59)。1文字だけ単独で使用する場合は、%sと記述します。 |
| ss | 秒を返します。1 桁の場合、先頭に 0 が付きます (00 ~ 59)。 |
| fff | ミリ秒を返します。先頭に 0 が付きません。 |
| / | 日付の区切り記号 |
日時加減算式は省略可能です。記述すると日付の加減算が行えます。日時加減算式はXYZの3つのデータで構成されます。
Xの部分には、「-」又は「+」が記述できます。日時を減算する場合は「-」、加算する場合は「+」を記述します。
Yの部分には、数字を記述できます。Zで示される単位についての値になります。
Zの部分には、単位を表す記号を記述できます。
| 単位記号 | 内容 |
|---|---|
| q | 四半期 |
| y | 年 |
| M | 月 |
| d | 日 |
| w | 週 |
| h | 時 |
| m | 分 |
| s | 秒 |
以下、実行した日時が 2019年5月1日 12時5分10秒351ミリ秒の場合
{%DATE(yyyy/MM/dd)}
{%DATE(yyyy/M/d)}
{%DATE(ggge年M月d日)}
{%DATE(yyMMdd)}
{%DATE(yyyy/MM/dd HH:mm)}
{%DATE(yyyy/MM/dd HH:mm:ss fff)}
{%DATE(yyyy/MM/dd,+1d)}
{%DATE(yyyy/MM/dd HH:mm,-10h)}
{%IF({%START_DATE(ファイルの繰り返し1,%M)}<4,{%START_DATE(ファイルの繰り返し1,yyyy,-1y)},{%START_DATE(ファイルの繰り返し1,yyyy)})}
※Mを単独で使用する場合は%Mと記述します。
また、DATEマクロはマクロ毎にシステム日付を取得するので、0時付近に処理をすると日付が変わるので、上記のようにファイルの繰り返しが始まった時間を取得するSTART_DATEマクロを使ってください。
日時には、日付(yyyy/MM/dd)又は、日時(yyyy/MM/dd HH:mm:ss)の形式で日付又は日時を指定します。指定された日時が日時として認識できる場合はTrueを、認識できない場合はFalseを返却します。
{%IF({%IS_DATE(2020/12/32)}=True,
{%WRITE_LOG(日付正常)}
,
{%WRITE_LOG(日付不正)}
)}
結果
日付不正
引数の日時を対象に日時加減算式で計算を行い、日付書式にしたがってフォーマットした日時を返却します。
日付書式、日時加減算式はDATEマクロと同じです。
以下、設定例です。
{%WRITE_LOG({%DATE_ADD(2021/01/01,yyyy/MM/dd,+1d)})}
結果
2021/01/02
{%WRITE_LOG({%DATE_ADD(2021/01/01 01:00:00,yyyy/MM/dd HH:mm:ss,-2h)})}
結果
2020/12/31 23:00:00
{%WRITE_LOG({%DATE_ADD(2020/12/31 23:00:00,yyyy/MM/dd HH:mm:ss,+2h)})}
結果
2021/01/01 01:00:00
引数の日時1から日付2を減算して、日時単位で指定された単位で返却します。
日時単位には以下の記号を指定します。
| 単位記号 | 内容 |
|---|---|
| d | 日 |
| h | 時 |
| m | 分 |
| s | 秒 |
以下、設定例です。
{%WRITE_LOG({%DATE_DIFF(2017/9/13,1899/12/30,d)})}
結果
42991
Excelで扱う日付のシリアル値は、1900/1/1を1とした経過日数ですが、Excelが1900/2/29という存在しない日をカウントする仕様のため、この仕様に合わせた数値を取得するためには、1899/12/30からの経過日数を取得します。
{%WRITE_LOG({%DATE_DIFF(2022/8/30 19:46:00,1970/01/01 09:00:00,s)})}
結果
1661856360
UNIX時間は協定世界時 (UTC) での1970年1月1日午前0時0分0秒からの経過秒数ですが、日本時間はUTC時間+9時間ですので、1970/01/01 09:00:00としています。
和暦はDATEマクロでも取得できますが、元号が変わった場合の対応を考慮して、定義ファイル(CSV形式)から情報を取得して、変換する処理を提供します。定義ファイルに元号と開始年月日を記述することで将来の元号にも対応できます。
年月日には、和暦に変換したい日付(yyyyMMdd)を指定します。
結果格納先ユーザーデータ名には結果を格納するユーザーデータの名前を指定します。和暦の情報は以下のキーで取得できます。
| キー | 内容 |
|---|---|
| 元号 | 指定した年月日の元号(令和,平成,昭和,大正,明治) |
| 元号記号 | 指定した年月日の元号記号(R,H,S,T,M) |
| 年 | 指定した年月日の和暦の年 |
| 月 | 指定した年月日の和暦の月 |
| 日 | 指定した年月日の和暦の日 |
本マクロは和暦定義ファイルを参照して処理しています。和暦定義ファイルは省略可能です。省略した場合は、eDocArrangementのインストールフォルダにある「Wareki.ini」を参照します。指定した場合は指定したファイルを読み込みます。和暦定義ファイルは以下のフォーマットでデータを作成してください。(「Wareki.ini」も参考にしてください。)
| 項目1 | 項目2 | 項目3 |
|---|---|---|
| 開始年月日 | 元号 | 元号記号 |
和暦定義ファイルはカンマ区切りとします。ヘッダ行は記述せず1行目から定義してください。また、日付は降順(新しい日付が上)に定義してください。
以下、設定例です。
{%CALENDAR_JP(20160303,和暦)}
{%WRITE_LOG({%GET_USER_DATA(和暦,元号)}{%GET_USER_DATA(和暦,年)}年)}
{%CALENDAR_JP({%DATE(yyyyMMdd)},和暦)}
{%WRITE_LOG({%GET_USER_DATA(和暦,元号記号)}{%GET_USER_DATA(和暦,年)}年{%GET_USER_DATA(和暦,月)}月{%GET_USER_DATA(和暦,日)}日)}
引数文字列の先頭と末尾の連続するスペースを削除します。
{%TRIM( abc )} -> "abc"
引数文字列の左から指定文字数分抽出します。
{%LEFT(abc,2)} -> "ab"
SJISに置き換えてバイト数指定で抽出を行う場合は、{%LEFTB(文字列,文字数)}を使用します。
引数文字列の右から指定文字数分抽出します。
{%RIGHT(abc,2)} -> "bc"
SJISに置き換えてバイト数指定で抽出を行う場合は、{%RIGHTB(文字列,文字数)}を使用します。
引数文字列の開始位置から文字数分抽出します。文字数は省略可能。省略した場合は、文字数指定無し、つまり開始位置以降、全てとなります。
{%MID(abc,2,1)} -> "b"
{%MID(abc,2)} -> "bc"
SJISに置き換えてバイト数指定で抽出を行う場合は、{%MIDB(文字列,開始位置,文字数)}を使用します。
マクロ書式の説明
{%LEN(abc)} -> "3"
SJISに置き換えてバイト数で文字数取得を行う場合は、{%LENB(文字列)} を使用します。
引数文字列を大文字に変換します。
{%TO_UPPER(abc)} -> "ABC"
引数文字列を小文字に変換します。
{%TO_LOWER(ABC)} -> "abc"
引数文字列から検索文字を検索し、置換文字に置換します。検索文字が複数見つかった場合も全て置換します。
{%REPLACE(abcde,c,x)} -> "abxde"
{%REPLACE(abcabc,bc,x)} -> "axax"
引数文字列から検索文字(正規表現)を検索し、置換文字に置換します。検索文字が複数見つかった場合も全て置換します。
{%REGEX_REPLACE(ab123de,\d+,c)} -> "abcde"
正規表現で文字列の一部分を取得します。正規表現には必ず一組の()を記述してください。()の中の正規表現にマッチする文字が返却されます。複数の検索やキャプチャを行いたい場合は REGEX_MATCHマクロ を使用してください。
オプション文字の意味は以下の通りです。
| オプション | 内容 |
|---|---|
| i | 大文字、小文字を区別しない。 |
| m | 文字列を複数行として扱う。^と$が行頭と行末にマッチするようになります。 |
正規表現の詳細については参考書等を参照願います。(.NETの正規表現ライブラリを使用しています。)
{%MSGBOX({%REGEX_CAPTURE((\d+)$,{%GET(FileNameWithoutExtension)})})}
「Test001」の場合は、「001」が取得されます。
{%MSGBOX({%REGEX_CAPTURE(([^\\]+)\\[^\\]+$,{%GET(FullPathFileName)})})}
「D:\東京支店\第一営業部\請求書001.xdw」の場合、「第一営業部」が取得されます。
{%MSGBOX({%REGEX_CAPTURE(NO(\d+),{%GET(FileNameWithoutExtension)},i)})}
ファイル名の中の「NO」の後ろの数字を取得します。iオプションを指定していますので、大文字小文字を区別せず、「no」や「No」でも対象となります。
「No001_Test」の場合、「001」が取得されます。
正規表現で文字列の一部分を取得します。複数の文字列取得が可能です。()を記述すればキャプチャが可能です。1つのキャプチャのみを行いたい場合は REGEX_CAPTUREマクロ を使用してください。
正規表現にマッチした文字列は、「格納先ユーザーデータ(マッチ)」で指定されたユーザーデータに結果が格納されます。キーは1から始まる番号となります。例えば「格納先ユーザーデータ(マッチ)」に「MATCH」を指定して、1番目に見つかった文字列は「{%GET_USER_DATA(MATCH,1)}」で参照できます。
「()」を使用して文字列をキャプチャした場合は、「格納先ユーザーデータ(キャプチャ) + マッチ番号」で指定されたユーザーデータに結果が格納されます。キーは1から始まる番号となります。例えば「格納先ユーザーデータ(キャプチャ)」に「GROUP」を指定して、1番目に見つかった文字の一番目のキャプチャ文字列は「{%GET_USER_DATA(GROUP1,1)}」で参照できます。
オプション文字の意味は以下の通りです。
| オプション | 内容 |
|---|---|
| i | 大文字、小文字を区別しない。 |
| m | 文字列を複数行として扱う。^と$が行頭と行末にマッチするようになります。 |
正規表現の詳細については参考書等を参照願います。(.NETの正規表現ライブラリを使用しています。)
{%REGEX_MATCH(\d,x1y2z3,GROUP,MATCH)}
{%LOOP L1 {%GET_USER_DATA_COUNT(MATCH)}(
{%WRITE_LOG(MATCH={%GET_USER_DATA(MATCH,[L_IDX(L1)])})}
)}
上記のマクロを実行するとログの内容に以下の文字列が出力されます。
MATCH=1
MATCH=2
MATCH=3
{%REGEX_MATCH(x(\d+).*z(\d+),x1y2z3,GROUP,MATCH)}
{%LOOP L1 {%GET_USER_DATA_COUNT(MATCH)}(
{%WRITE_LOG(MATCH={%GET_USER_DATA(MATCH,[L_IDX(L1)])})}
{%LOOP L2 {%GET_USER_DATA_COUNT(GROUP[L_IDX(L1)])}(
{%WRITE_LOG(GROUP[L_IDX(L1)]={%GET_USER_DATA(GROUP[L_IDX(L1)],[L_IDX(L2)])})}
)}
)}
上記のマクロを実行するとログの内容に以下の文字列が出力されます。
MATCH=x1y2z3
GROUP1=1
GROUP1=3
{%REGEX_MATCH(x(\d+)y(\d+),x1y2z3x1y2z3,GROUP,MATCH)}
{%LOOP L1 {%GET_USER_DATA_COUNT(MATCH)}(
{%WRITE_LOG(MATCH={%GET_USER_DATA(MATCH,[L_IDX(L1)])})}
{%LOOP L2 {%GET_USER_DATA_COUNT(GROUP[L_IDX(L1)])}(
{%WRITE_LOG(GROUP[L_IDX(L1)]={%GET_USER_DATA(GROUP[L_IDX(L1)],[L_IDX(L2)])})}
)}
)}
上記のマクロを実行するとログの内容に以下の文字列が出力されます。
MATCH=x1y2
GROUP1=1
GROUP1=2
MATCH=x1y2
GROUP2=1
GROUP2=2
以下のような改行を含んだ文字列の場合
{%REGEX_MATCH((^x\d+),x1y2z3
x1y2z3,GROUP,MATCH)}
{%LOOP L1 {%GET_USER_DATA_COUNT(MATCH)}(
{%WRITE_LOG(MATCH={%GET_USER_DATA(MATCH,[L_IDX(L1)])})}
)}
上記のマクロを実行するとログの内容に以下の文字列が出力されます。
^が文字列全体の先頭にマッチします。
MATCH=x1
オプションmを指定すると、
{%REGEX_MATCH((^x\d+),x1y2z3
x1y2z3,GROUP,MATCH,m)}
{%LOOP L1 {%GET_USER_DATA_COUNT(MATCH)}(
{%WRITE_LOG(MATCH={%GET_USER_DATA(MATCH,[L_IDX(L1)])})}
)}
上記のマクロを実行するとログの内容に以下の文字列が出力されます。
^が行の先頭にマッチするため2回出力されます。
MATCH=x1
MATCH=x1
正規表現のメタ文字をエスケープします。
正規表現では「.」や「+」などの文字に意味を持たせて表記するルールがありますが、検索文字に「.」そのものを指定したい場合は、「\.」と表記(エスケープ)する必要があります。本マクロは引き数の文字列全てをエスケープした文字に置換して返却します。
正規表現の詳細については参考書等を参照願います。(.NETの正規表現ライブラリを使用しています。)
{%WRITE_LOG({%REGEX_CAPTURE((.+),ABC.+DEF)})}
{%WRITE_LOG({%REGEX_CAPTURE(({%ESCAPE_REGEX(.+)}),ABC.+DEF)})}
結果
ABC.+DEF マクロ名[WRITE_LOG]
.+ マクロ名[WRITE_LOG]
{%IF({%REGEX_CAPTURE(({%ESCAPE_REGEX({%GET_FIELD_VALUE(CSV読み込み1,1)})}),{%GET(FolderName)})}!=,
#該当の文字が見つかった場合
{%SET_U(属性,配信先,{%GET_FIELD_VALUE(CSV読み込み1,2)})}
,)}
文字列の変換処理を行います。
文字列に変換したい文字を指定します。
変換種類には、以下の変換種類の番号を指定します。番号を足し算して複数指定することも可能です。(例「小文字を大文字 + 全角を半角」は1+8で9を指定)
| 変換種類 | 内容 |
|---|---|
| 1 | 小文字を大文字に変換します。 |
| 2 | 大文字を小文字に変換します。 |
| 3 | 各単語の先頭文字を大文字に変換します。 |
| 4 | 半角文字を全角文字に変換します。 |
| 8 | 全角文字を半角文字に変換します。 |
| 16 | ひらがなをカタカナに変換します。 |
| 32 | カタカナをひらがなに変換します。 |
#小文字を大文字
{%WRITE_LOG({%STR_CONV(abc,1)})} -> ABC
{%WRITE_LOG({%STR_CONV(abc,1)})} -> ABC
#大文字を小文字
{%WRITE_LOG({%STR_CONV(ABC,2)})} -> abc
{%WRITE_LOG({%STR_CONV(ABC,2)})} -> abc
#先頭文字を大文字
{%WRITE_LOG({%STR_CONV(abc def,3)})} -> Abc Def
#半角を全角
{%WRITE_LOG({%STR_CONV(abc,4)})} -> abc
{%WRITE_LOG({%STR_CONV(アイウ,4)})} -> アイウ
#全角を半角
{%WRITE_LOG({%STR_CONV(abc ,8)})} -> abc
{%WRITE_LOG({%STR_CONV(アイウ,8)})} -> アイウ
#ひらがなをカタカナ
{%WRITE_LOG({%STR_CONV(あいう,16)})} -> アイウ
#カタカナをひらがな
{%WRITE_LOG({%STR_CONV(アイウ,32)})} -> あいう
{%WRITE_LOG({%STR_CONV(アイウ,32)})} -> アイウ
#小文字を大文字 + 全角を半角
{%WRITE_LOG({%STR_CONV(abc,9)})} -> ABC
{%WRITE_LOG({%STR_CONV(abc,9)})} -> ABC
#カタカナをひらがな + 半角を全角
{%WRITE_LOG({%STR_CONV(アイウ,36)})} -> あいう
#矛盾したパラメータ
{%WRITE_LOG({%STR_CONV(abc ,12)})} -> エラー
全角文字から半角文字、及び、半角文字から全角文字への変換処理を行います。
対象文字列に変換したい文字列を指定します。
変換後文字種には、以下の文字種を指定します。|で連結して複数指定可能です。 省略した場合は、「半角英数記号|全角カタカナ」になります。
| 変換文字種 | 内容 |
|---|---|
| 半角英字 | 全角英字を半角英字に変換します。 |
| 半角数字 | 全角数字を半角数字に変換します。 |
| 半角記号 | 全角記号を半角記号に変換します。 |
| 半角カタカナ | 全角カタカナを半角カタカナに変換します。 |
| 全角英字 | 半角英字を全角英字に変換します。 |
| 全角数字 | 半角数字を全角数字に変換します。 |
| 全角記号 | 半角記号を全角記号に変換します。 |
| 全角カタカナ | 半角カタカナを全角カタカナに変換します。 |
| 半角英数記号 | 全角英数記号を半角英数記号に変換します。 |
| 全角英数記号 | 半角英数記号を全角英数記号に変換します。 |
#全角英数記号を半角英数記号に、半角カタカナを全角カタカナに変換
{%WRITE_LOG({%STR_CONV_ZEN_HAN(〒104-0031 東京都中央区京橋3-7-6 国立映画アーカイブ本館)})} > 〒104-0031 東京都中央区京橋3-7-6 国立映画アーカイブ本館
#全角英字を半角英字に、全角数字を半角数字に変換
{%WRITE_LOG({%STR_CONV_ZEN_HAN(109CINEMAS,半角英字|半角数字)})} > 109CINEMAS
#全角カタカナを半角カタカナに変換
{%WRITE_LOG({%STR_CONV_ZEN_HAN(スケジュール,半角カタカナ)})} > スケジュール
特定文字列の変換処理を行います。
変換内容を指定します。
変換内容には、以下の文字列を指定します。|で連結して複数指定可能です。 省略した場合は、「特殊を標準|長音をマイナス 」になります。
| 変換文字種 | 内容 |
|---|---|
| ひらがなをカタカナ | 全角ひらがなを全角カタカナに変換します。 |
| カタカナをひらがな | 全角カタカナ及び半角カタカナを全角ひらがなに変換します。 |
| 特殊を標準 | 特殊文字(㈱など)を標準文字(半角英数記号と標準的な全角文字)に変換します。 |
| 長音をマイナス | 直前に全角カタカナひらがなが存在しない全角長音を全角マイナスに変換します。直前に半角カタカナが存在しない半角長音を半角マイナスに変換します。 |
#特殊文字を標準文字に変換
{%WRITE_LOG({%STR_CONV_SPEC_CHAR(㈱YK-HOME)})} > (株)YK-HOME
#カタカナをひらがなに変換
{%WRITE_LOG({%STR_CONV_SPEC_CHAR(サイタマ市,カタカナをひらがな)})} > さいたま市
ユーザーデータにセットされたキーに合致する文字を、対応する値に変換します。
対象文字列に変換したい文字列を指定します。
ユーザーデータ名には、変換したい文字をキーに、変換後の文字を値にセットしたユーザーデータの名前を指定します。
#ライナックス、リーヌークス、リヌックスをリナックスに変換
{%SET_U(変換テーブル,ライナックス,リナックス)}
{%SET_U(変換テーブル,リーヌークス,リナックス)}
{%SET_U(変換テーブル,リヌックス,リナックス)}
{%WRITE_LOG({%STR_CONV_BY_USER_DATA(ライナックス,変換テーブル)})} > リナックス
値を書式に従って整形します。
書式の仕様については、日付に関して日付取得マクロと同じになります。内部的にはVB.NETのStrings.Format(名前空間:Microsoft.VisualBasic)を呼び出していますので、マイクロソフトのサイト等で、Formatの仕様を参照してください。
{%FORMAT(5,000)} -> "005"
{%FORMAT(005,0)} -> "5"
{%FORMAT(2004/10/01,yyyy/MM/dd)} -> "2004/10/01"
{%FORMAT(2014/11/12 18:10:20,ggge年M月d日(aaa) HH:mm:ss)}
-> "平成26年11月12日(水) 18:10:20"
引数の文字列を指定回数複製した文字列を返却します。繰り返し回数に負の値を設定した場合は空文字列を返却します。
{%STRING(0,3)} -> "000"
{%STRING(X,5)} -> "XXXXX"
{%STRING(ABC,2)} -> "ABCABC"
区切り文字が入った文字列を、引数の区切り文字により、分割することができます。
分割結果はユーザーデータに格納されます。
内容はユーザーデータのキーに項目番号(1~)を指定することで参照できます。
また、分割数は「GET_USER_DATA_COUNT」マクロで参照できます。
{%SPLIT(山田-19-男,-,分割結果)}
ユーザーデータに格納されたデータは、ユーザーデータ名、キーを指定することにより、検索することができます。
{%SPLIT(田中-女-90,-,分割結果)}
{%WRITE_LOG({%GET_USER_DATA_COUNT(分割結果)})}
{%WRITE_LOG({%GET_U(分割結果,1)})}
{%WRITE_LOG({%GET_U(分割結果,2)})}
{%WRITE_LOG({%GET_U(分割結果,3)})}
ログには、
3
田中
女
90
と順に表示されます。
区切り文字が「,」である場合には、入力する区切り文字を「|,」としてください。
{%SPLIT(東京|,13,|,,地名)}
{%LOOP L1 {%GET_USER_DATA_COUNT(地名)}(
{%WRITE_LOG({%GET_USER_DATA(地名,[L_IDX(L1)])})}
)}
ログには、
東京
13
と順に表示されます。
ユーザーデータに格納された値を連結文字で連結します。
{%SET_USER_DATA(果物,1,りんご)}
{%SET_USER_DATA(果物,2,みかん)}
{%SET_USER_DATA(果物,3,すいか)}
{%MSGBOX({%JOIN(果物,|,)})}
結果
りんご,みかん,すいか
引数で渡された文字列を空文字で返却します。 マクロを処理した結果の文字を消したい場合に使います。
引数文字列を返却します。
文字列中にマクロが含まれていてもマクロを実行せず、そのままの文字列を返却します。
エスケープマクロの引数文字列はeDocFinderのマクロ実行は行いませんが、 マクロの構文解析は行います。構文に誤りがあると末尾の「)}」を認識できずに期待通り機能しません。
引数の文字列はマクロの実行が行われなくなるので、マクロのコメントアウトのように使うこともできます。
{%ADD_USER_DATA(writeData,メッセージボックス表示マクロについて)}
{%ADD_USER_DATA(writeData,{%ESCAPE({%MSGBOX(メッセージ)}と書くとメッセージを表示します。)})}
{%WRITE_FILE(D:\test.txt,writeData,SJIS,New)}
{%ESCAPE( 2024/05/21 一時的にコメントとする
#ファクス番号のチェック
{%IF({%GET_U(属性,受信ファクス番号)}=,
#空の場合はエラー
{%SET_U(属性,判定,False)}
{%SET_U(属性,メッセージ,■ERR■【ファクス受信】ファクス受信番号がありません。)}
,)}
)}
引数の数式を計算します。数式には、四則演算を表記できます。
{%CALC(1+2)} -> "3"
{%CALC(3*(2+1))} -> "9"
引数の数値を小数点の位置で四捨五入します。
{%ROUND(12.3,0)} -> "12"
引数の数値を小数点の位置で切り捨てします。
{%ROUND_DOWN(12.5,0)} -> "12"
引数の数値を小数点の位置で切り上げします。
{%ROUND_UP(12.3,0)} -> "13"
数値1を数値2で割った余りを返却します。
{%MOD(199,100)}
結果
99
条件を判定し、条件に合致する場合は真の値を返却し、合致しない場合は偽の値を返却します。条件の比較記号は、>,<,=,>=,<=,!=が使用可能です。条件の左辺、右辺が両方とも数字の場合、数値としての比較を行います。それ以外は文字比較になります。条件や、真の値、偽の値には、各種書式を入れ子で記述することが可能です。
カンマそのものを条件や値に記述したい場合は、「|,」と記述します。
比較式の左辺と右辺が両方とも数値の場合は、比較を数値として行います。
比較式の左辺、右辺は空白も文字列として比較対象とします。
{%SET_U(属性,処理日,{%DATE(yyyy/MM/dd)})}
{%IF({%FORMAT({%GET_U(属性,処理日)},dd)}>20,{%DATE_ADD({%GET_U(属性,処理日)},yyMM,+1M)},{%FORMAT({%GET_U(属性,処理日)},yyMM)})}
現在の日付が2004年2月20日の場合、0402となります。
現在の日付が2004年2月21日の場合、0403となります。
DATEマクロはマクロ毎にシステム日付を取得するので、0時付近に処理をすると日付が変わるので、上記のようにユーザーデータに一度セットしてから、ユーザーデータの日付で判定と取得を行います。
文字列を繰り返し回数分展開します。名前には任意の文字列を指定します。文字列には、改行が含まれても問題ありません。
文字列には、以下の特殊キーワードが使用できます。
[L_IDX(名前)]
L_IDXキーワードは、LOOPマクロの引数文字列中に使用すると、ループの展開時に、インデックスに置換します。名前には、LOOPマクロで指定した名前と同じ名前を指定します。
{%LOOP L1 3(
{%WRITE_LOG([L_IDX(L1)])}
)}
結果
1
2
3