NAME 日付取得

FORMAT {%DATE(?????)[XYZ]}

?????の部分には、日付を表す日付記号を記述します。日付記号は下記を参照してください。

[]の部分は省略可能です。記述すると日付の加減算が行えます。

Xの部分には、「-」又は「+」が記述できます。日付を減算する場合は「-」、加算する場合は「+」を記述します。

Yの部分には、数字を記述できます。Zで示される単位についての値になります。

Zの部分には、単位を表す記号を記述できます。

年号「令和」は、WindowsUpdateで対応されている場合のみ使用できます。

以下、マクロを実行した日時が 2019年5月1日 12時5分の場合

NAME 日時加減算

FORMAT {%DATE(日時,日付書式)[XYZ]}

日時には、日付(yyyy/mm/dd)又は、日時(yyyy/mm/dd hh:nn:ss)の形式で日付又は日時を指定します。日付を指定した場合、時刻は00:00:00が指定されたとみなします。

その他の書式は日付取得と同じです。日付取得では、システム日付から取得した日時しか処理できませんが、日付加減算では、1番目の引数に任意の日時を指定できます。

NAME 日時形式判定

FORMAT {%IS_DATE(日時)}

日時には、日付(yyyy/mm/dd等)又は、日時(yyyy/mm/dd hh:nn:ss等)の形式で日付又は日時を指定します。指定された日時が日時として認識できる場合は、Trueを認識できない場合はFalseを返却します。

NAME 和暦取得

FORMAT {%CALENDAR_JP(年月日,結果格納先ユーザーデータ名[,和暦定義ファイル])}

和暦はDATEマクロでも取得できますが、元号が変わった場合の対応を考慮して、定義ファイル(CSV形式)から情報を取得して、変換する処理を提供します。定義ファイルに元号と開始年月日を記述することで将来の元号にも対応できます。

年月日には、和暦に変換したい日付(yyyymmdd)を指定します。

結果格納先ユーザーデータ名には結果を格納するユーザーデータの名前を指定します。和暦の情報は以下のキーで取得できます。

本マクロは和暦定義ファイルを参照して処理しています。和暦定義ファイルは省略可能です。省略した場合は、eDocArrangementのインストールフォルダにある「Wareki.ini」を参照します。指定した場合は指定したファイルを読み込みます。和暦定義ファイルは以下のフォーマットでデータを作成してください。(「Wareki.ini」も参考にしてください。)

和暦定義ファイルはカンマ区切りとします。ヘッダ行は記述せず1行目から定義してください。また、日付は降順(新しい日付が上)に定義してください。

NAME 営業日取得

FORMAT {%BUSINESS_DATE(日付,前営業日(BEFORE)、翌営業日(AFTER)または日数指定,祝祭日ユーザーデータ名,休日ユーザーデータ名)}

本マクロは、2営業日後や、1営業日前などの、指定した日付からの営業日日数を計算した日付を取得する機能(機能1)と、指定した休日日付の翌営業日、または前営業日を取得する機能(機能2)を利用できます。

日付には、yyyy/mm/dd、yyyy/m/dなどの形式で日付を指定します。

2番目の引数について、

機能1では、未来日付の営業日日数を指定する場合は、正の整数を、過去日付の営業日日数を指定する場合は、負の整数を指定します。(例 2営業日後は2、1営業日前は-1)

日付に祝祭日又は休日を指定し、0を指定した場合は、AFTER(翌営業日)を指定した場合と同じになります。

機能2では、翌営業日を指定する場合はAFTERを、前営業日を指定する場合はBEFOREを指定します。どちらを指定した場合でも、指定した日付が営業日の場合は、指定した日付をそのまま返却します。

祝祭日ユーザーデータ名には、CSVファイル読み込みマクロ(CSV_FILE_READ)で読み取ったCSVデータの格納ユーザーデータ名を指定します。

祝祭日CSVファイルは、キーに祝祭日の日付が格納されていれば、他はどんなデータでもかまいません。日付の形式は、yyyy/mm/dd又は、yyyy/m/dに対応しています。

おすすめは、内政府が公開している祝祭日CSVデータです。以下のページからダウンロードできます

このページの「平成３１年（２０１９年）及び令和２年（２０２０年）の「国民の祝日」」というタイトルの最後にダウンロードのリンクがあります。(タイトル、CSVのリンクは変わる可能性があります。)

このCSVファイルは以下のようになっています。

国民の祝日・休日月日,国民の祝日・休日名称
1955/1/1,元日
1955/1/15,成人の日
1955/3/21,春分の日
・
・
2020/9/22,秋分の日
2020/11/3,文化の日
2020/11/23,勤労感謝の日

この場合、1列目が日付になっていますので、CSVファイル読み込みマクロ(CSV_FILE_READ)で読み込む場合は、以下のようになります。

#祝祭日CSV読み込み
{%CSV_FILE_READ({%GET_G(TopFolder)}\90_System\10_マスタ\holiday.csv,祝祭日,1)}

休日ユーザーデータ名は、休日の曜日をキーにセットしたユーザーデータを指定します。以下のような記述になります。

#休日指定
{%SET_U(休日,土,)}
{%SET_U(休日,日,)}

以下、カレンダーが以下のような場合の例となります。

02/07(金)
02/08(土)
02/09(日)
02/10(月)
02/11(火) 建国記念の日
02/12(水)

#祝祭日CSV読み込み
{%CSV_FILE_READ({%GET_G(TopFolder)}\90_System\10_マスタ\holiday.csv,祝祭日,1)}

#休日指定
{%SET_U(休日,土,)}
{%SET_U(休日,日,)}

#翌営業日取得
{%LOG_OUT({%BUSINESS_DATE(2020/02/08,AFTER,祝祭日,休日)})} 

結果
2020/02/10

#前営業日取得
{%LOG_OUT({%BUSINESS_DATE(2020/02/08,BEFORE,祝祭日,休日)})} 

結果
2020/02/07

#営業日を指定した場合は、指定した営業日がそのまま返却される
{%LOG_OUT({%BUSINESS_DATE(2020/02/07,AFTER,祝祭日,休日)})} 

結果
2020/02/07

#2営業日後の日付を取得
{%LOG_OUT({%BUSINESS_DATE(2020/02/08,2,祝祭日,休日)})}

結果
2020/02/12

#2営業日前の日付を取得
{%LOG_OUT({%BUSINESS_DATE(2020/02/12,-2,祝祭日,休日)})}

結果
2020/02/10

#休みの日で0営業日後を指定した場合はAFTERと同じ結果になる
{%LOG_OUT({%BUSINESS_DATE(2020/02/11,0,祝祭日,休日)})}

結果
2020/02/12

NAME ファイル名取得

FORMAT {%FILE_NAME}

処理中のファイル名を返却します。

NAME ベースファイル名取得

FORMAT {%BASE_FILE_NAME}

処理中のファイル名(拡張子を除いた名前)を返却します。

NAME フォルダパス取得

FORMAT {%FOLDER_PATH}

処理中のファイルのフォルダパスを返却します。最後に\がつきます。

NAME フォルダ名取得

FORMAT {%FOLDER_NAME}

処理中のファイルが格納されているフォルダ名を返却します。ドライブの直下にあるファイルを対象とした場合はドライブ名 + ":" が返却されます。(「C:\Test.xdw」の場合は「C:」)

NAME フルパスファイル名取得

FORMAT {%FILE_FULL_PATH}

処理中のフルパスファイル名を返却します。

NAME ファイル番号取得

FORMAT {%FILE_NO}

処理中のファイル番号を返却します。

NAME 総ファイル数取得

FORMAT {%TOTAL_FILE_COUNT}

処理中のファイルの合計数を返却します。

NAME ページ番号取得

FORMAT {%PAGE_NO}

処理中のページ番号を返却します。（マクロ実行で、ページ単位の処理にした場合に使用できます。）

NAME 設定名取得

FORMAT {%SETTING_NAME}

処理中の設定名を返却します。

NAME 処理名取得

FORMAT {%PROC_NAME}

処理中の処理名を返却します。このマクロは処理のパネルに記述された場合のみ、取得できます。それ以外の場所に記述した場合は、空文字が返却されます。

NAME 処理ファイル変更

FORMAT {%CHANGE_FILE(フルパスファイル名)}

一時的に処理中のファイルを変更します。通常、DocuWorksAPI系の処理は、現在処理中のファイルに対して処理が行われます。

よって、現在処理中のファイル以外のファイルを処理できません。本マクロは、現在処理中のファイル以外のファイルを対象にDocuWorksAPI系のマクロを実行したい場合に、一時的に対象ファイルを変更する目的で使用します。

処理中のファイルをすり替えるので目的のマクロを記述したら直ぐに、{%PUT_BACK_FILE}マクロで元の状態に戻してください。

なお、処理中ファイルの変更中は、読み取り結果系のマクロが使用できません。読み取り結果は、ファイル名によって情報が分類され保存されていますので、処理中ファイル変更中は正しくデータを取得することが出来なくなります。

本マクロは、マクロ実行処理内でのみ動作します。また、処理中ファイルの変更が有効になるのは、マクロ実行処理が終了するまでになります。

NAME 処理ファイル復元

FORMAT {%PUT_BACK_FILE}

CHANGE_FILEマクロで一時的に変更した処理中のファイルを元に戻します。使用例はCHANGE_FILEマクロを参照してください。

NAME 外部マクロ読み込み

FORMAT {%LOAD_MACRO(ファイル名)}

テキストファイルに記述されたマクロを読み込み、実行します。

NAME 空白削除

FORMAT {%TRIM(文字列)}

引数文字列の先頭と末尾の連続するスペースを削除します。

NAME 文字列置換

FORMAT {%REPLACE(文字列,検索文字,置換文字)}

引数文字列から検索文字を検索し、置換文字に置換します。検索文字が複数見つかった場合も全て置換します。

検索文字や、置換文字に、改行コードやタブコードを指定する場合は、下記のキーワードを使用します。

NAME 正規表現文字列置換

FORMAT {%REGEX_REPLACE(正規表現,置換文字列,対象文字列,オプション)}

正規表現(perl互換)で文字列置換を行います。対象文字列を正規表現で検索して、マッチした文字列を置換文字列で置換します。結果は戻り値として返却します。

gオプションを指定することで、すべてのマッチする文字を置換できます。

オプション文字の意味は以下の通りです。

正規表現の詳細についてはPerlの参考書等を参照願います。

NAME 文字列書式整形

FORMAT {%FORMAT(値,書式)}

値を書式に従って整形します。

NAME 文字列分割

FORMAT {%SPLIT(文字列,区切り文字,ユーザデータ名)}

区切り文字が入った文字列を、引数の区切り文字により、分割することができます。
分割結果はユーザデータに格納されます。
内容はユーザデータのキーに項目番号(1〜)を指定することで参照できます。
また、分割数は、キーに「Count」を指定することで参照できます。

ユーザデータに格納されたデータは、ユーザデータ名、キーを指定することにより、検索することができます。

区切り文字が「,」である場合には、入力する区切り文字を「\,」としてください。

NAME 文字列連結

FORMAT {%JOIN(ユーザデータ名,連結文字)}

ユーザデータに格納された値を連結文字で連結します。

NAME 正規表現文字列抽出

FORMAT {%REGEX_CAPTURE(正規表現,文字列,オプション)}

正規表現(perl互換)で文字列の一部分を取得します。正規表現には必ず一組の()を記述してください。()の中の正規表現にマッチする文字が返却されます。

オプション文字の意味は以下の通りです。

正規表現の詳細についてはPerlの参考書等を参照願います。

NAME 正規表現文字列検索

FORMAT {%REGEX_MATCH(正規表現,対象文字列,結果格納用ユーザデータ名,オプション)}

正規表現(perl互換)で文字列検索を行います。結果は引数で指定された結果格納用ユーザデータに格納します。

引数の正規表現にマッチする文字を結果格納用のユーザーデータに格納します。gオプションを指定することで、複数のマッチした文字を取得できます。

オプション文字の意味は以下の通りです。

正規表現の詳細についてはPerlの参考書等を参照願います。

NAME 文字列変換

FORMAT {%STR_CONV(文字列,変換種類)}

文字列の変換処理を行います。

文字列に変換したい文字を指定します。

変換種類には、以下の変換種類の番号を指定します。番号を足し算して複数指定することも可能です。(例「小文字を大文字 + 全角を半角」は1+8で9を指定)

NAME 計算

FORMAT {%CALC(計算式)}

引数の数式を計算します。数式には、四則演算を表記できます。

NAME 四捨五入

FORMAT {%ROUND(数値,小数点の位置)}

引数の数値を小数点の位置で四捨五入します。

NAME 切り捨て

FORMAT {%ROUND_DOWN(数値,小数点の位置)}

引数の数値を小数点の位置で切り捨てします。

NAME 切り上げ

FORMAT {%ROUND_UP(数値,小数点の位置)}

引数の数値を小数点の位置で切り上げします。

NAME 剰余

FORMAT {%MOD(数値1,数値2)}

数値1を数値2で割った余りを返却します。

NAME 条件式

FORMAT {%IF(条件,真の値,偽の値)}

条件を判定し、条件に合致する場合は真の値を返却し、合致しない場合は偽の値を返却します。条件の比較記号は、>,<,=,>=,<=,!=が使用可能です。条件の左辺、右辺が両方とも数字の場合、数値としての比較を行います。それ以外は文字比較になります。条件や、真の値、偽の値には、各種書式を入れ子で記述することが可能です。

カンマそのものを条件や値に記述したい場合は、「\,」と記述します。

比較式の左辺と右辺が数値の場合は数値として比較しますが、その際の数値判定は以下のようになります。

• 数値の有効範囲はVB6のCurrency型と同じで、-922,337,203,685,477.5808 〜 922,337,203,685,477.5807となります。
• 123E-4や1D3などのの指数を表した文字がある場合は文字列とみなします。(EとDのみ)
• 123+や456-などの末尾に符号がついている場合は文字列とみなします。
• 123+や456-などの末尾に符号がついている場合は文字列とみなします。
• カンマが含まれている場合は文字列とみなします。
• 全角の数字は数値とみなします。

実際のところ比較式を数値とみなしたい場合は少ないと思います。確実に文字列として比較したい場合は、比較式の左辺と右辺の先頭にXなどの文字を付加して比較するとよいです。例えば以下のようになります。

{%IF(X{%GET_USER_DATA(wk,data1)}=X{%GET_USER_DATA(wk,data2)},True,False)}

また、LOOPマクロとIFマクロは特殊な処理方式を行っています。一般的なスクリプトと異なる部分があります。詳細は マクロの処理方式と分割について をご覧ください。

NAME 繰り返し式

FORMAT {%LOOP 名前 繰り返し回数(文字列)}

文字列を繰り返し回数分展開します。名前には任意の文字列を指定します。文字列には、改行が含まれても問題ありません。

文字列には、以下の特殊キーワードが使用できます。

[L_IDX(名前)]

L_IDXキーワードは、LOOPマクロの引数文字列中に使用すると、ループの展開時に、インデックスに置換します。名前には、LOOPマクロで指定した名前と同じ名前を指定します。

[L_IDX_R(名前)]

L_IDX_Rキーワードは、LOOPマクロの引数文字列中に使用すると、ループの展開時に、逆インデックス(例 ループ回数が3の場合、3→2→1)に置換します。名前には、LOOPマクロで指定した名前と同じ名前を指定します。

LOOPマクロは実行時に指定された回数分展開しますので、LOOP内の文字列、回数によっては展開される文字列が大量になります。大量になった場合、マクロが正常に処理されず、異常終了するなどの問題が発生する可能性があります。
LOOPマクロは展開後のデータが少量のデータ(多くて1KB程度)で使用するようお願いします。ループ回数が多くなる場合は、スクリプト実行を利用してください。

また、LOOPマクロとIFマクロは特殊な処理方式を行っています。一般的なスクリプトと異なる部分があります。詳細は マクロの処理方式と分割について をご覧ください。

LOOPマクロを入れ子に記述した場合、最も内側のループから展開を行う為、ループマクロの引き数にL_IDXキーワードを使用することができません。例えば、例2のマクロは動作しますが、例3のマクロは動作いたしません。