例1

現在の日が20日より後の場合、翌月を返却し、20日以前の場合は、当月を返却する場合

{%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時付近に処理をすると日付が変わるので、上記のようにユーザーデータに一度セットしてから、ユーザーデータの日付で判定と取得を行います。

例2

19桁以上の数字を比較する場合（文字列として比較）

19桁以上の数字は数値として比較できないため、桁数を揃えて先頭に数字以外の文字（例: x）を付加し、文字列として比較します。桁数を揃えるには、STRINGマクロで0を並べた文字列を数字の先頭に連結し、RIGHTマクロで右から必要な桁数を取り出します（0埋め）。文字列比較は先頭の文字から順に行われるため、桁数を揃えないと正しく大小判定できません。先頭のxは両辺に付けることで、数値ではなく文字列として比較させるためのものです（x以外の数字以外の文字でも構いません）。

{%IF(x{%RIGHT({%STRING(0,20)}1234567890123456789,20)}<x{%RIGHT({%STRING(0,20)}1234567890123456790,20)},小さい,大きいか等しい)}
結果
小さい

{%STRING(0,20)} で「00000000000000000000」(0を20個)を作り、その後ろに数字を連結してから {%RIGHT(...,20)} で右から20文字を取り出すことで、20桁に0埋めした文字列になります。
両辺とも「x」で始まる同じ桁数の文字列に変換され、文字列として比較されます。
STRINGとRIGHTの桁数(例では20)は、比較する数字の最大桁数に合わせて指定します。

この方法は数値への変換を行わない文字列処理のため、桁数に上限はありません。FORMATマクロでも0埋めできますが、値が9223372036854775807（Int64の最大値）を超えると内部で丸められて正しく桁を揃えられないため、19桁以上の数字にはこのSTRING+RIGHTの方法を使用してください。口座番号などで元の値が既に同じ桁数の文字列として得られる場合は、0埋めを行わず両辺の先頭にxを付けるだけで比較できます。

例1

ログ出力を3回繰り返す。

{%LOOP L1 3(
  {%WRITE_LOG([L_IDX(L1)])}
)}
結果
1
2
3

ファイルの繰り返しパネルと同等のファイルループ処理をマクロで実行します。

識別子はファイルの繰り返し式の処理名としてログに出力されます。

オプションには、あらかじめSET_Uマクロで属性をセットしたユーザーデータのキー名を指定します。オプションを省略（空括弧）した場合は、すべての属性がデフォルト値で動作します。

文字列にはファイル毎に実行するマクロを記述します。文字列には改行が含まれても問題ありません。文字列中ではGETマクロの以下の値が使用できます。

{%GET(FullPathFileName)} ... 処理中のファイルのフルパス
{%GET(FileLoopCount)} ... 現在のループカウンタ(1始まり)
{%GET(FileCount)} ... ファイル総数

LOOPマクロのL_IDXキーワードもLOOP_FILEの文字列中で使用できます。

ファイルの繰り返しパネルと同等の以下の処理を自動的に行います。

• キャンセル処理(Cancel / FileLoopCancel)
• ログ出力(「～を処理します。」)
• プログレスバーの初期化・カウントアップ・後処理
• ユーザーデータのクリア(属性で指定した場合)
• 中断条件(Until)の評価
• エラーハンドリング(ErrCatch / ErrorProc)
• グループ処理(File / Folder / RegExp)
• メインファイルリスト処理時の「実行済み」状態出力
• 分割データの削除

オプションで指定したユーザーデータにセットできる属性は以下の通りです。

メイン画面のファイルリスト
処理名(ファイル検索処理等の処理名)

なし(ファイル)
フォルダ
フルパスの一部(正規表現)

昇順
昇順 (自然順)
降順
降順 (自然順)

する
しない

ファイル
フルパス
フルパスの一部(正規表現)
更新日
作成日

昇順
昇順 (自然順)
降順
降順 (自然順)

する
しない

する
しない

LOOP_FILE実行中にエラーが発生すると、デフォルト（ErrCatch省略時＝「しない」）ではエラーを「エラー」レベルでログに出力し、次のファイルの処理を継続します。ErrCatch属性を「する」に設定するとエラー発生時にループを中断します。ループ本体の処理を TRY_CATCH マクロで囲むと、エラーの内容をGET_ERROR_MESSAGE()で取得してログに記録するなど、柔軟なエラーハンドリングが可能です。また、TRY_CATCHでキャッチされたエラーはエラー回数に加算されないため、エラーレベルのログ出力を抑制できます。

{%LOOP_FILE FL1()(
  {%WRITE_LOG([L_IDX(FL1)] / {%GET(FileCount)} : {%GET(FullPathFileName)})}
)}

{%SET_U(Attr,FileSort,する)}
{%SET_U(Attr,SortTarget,ファイル)}
{%SET_U(Attr,SortOrder,昇順 (自然順))}
{%LOOP_FILE FL1(Attr)(
  {%WRITE_LOG({%GET(FullPathFileName)})}
)}

{%SET_U(Attr,ClearUserData,する)}
{%SET_U(Attr,UserDataNotCleared,Attr)}
{%SET_U(Attr,ErrCatch,しない)}
{%LOOP_FILE FL1(Attr)(
  {%WRITE_LOG({%GET(FullPathFileName)})}
)}

{%SET_U(Attr,FileSort,する)}
{%SET_U(Attr,SortTarget,ファイル)}
{%SET_U(Attr,SortOrder,昇順)}
{%SET_U(Attr,Until,{%ESCAPE({%IF({%GET(FileLoopCount)}>=4,True,False)})})}
{%LOOP_FILE FL1(Attr)(
  {%WRITE_LOG({%GET(FullPathFileName)})}
)}

{%LOOP_FILE FL1(Attr)(
  {%TRY_CATCH(
    {%WRITE_LOG({%GET(FullPathFileName)} を処理中)}
    {%MOVE_FILE({%GET(FullPathFileName)},C:\Output\{%GET(FileName)})}
  ,
    {%WRITE_LOG(エラー: {%GET_ERROR_MESSAGE()})}
  )}
)}

例1

年齢が20以上であるかを判定する比較演算式情報を作成する。

{%SET_U(属性,年齢,21)}

{%CREATE_COMPARE({%GET_U(属性,年齢)},>=,20)}

例2

処理中ファイルのパスに「総務課」が含まれるかを判定する比較演算式情報を作成、評価して条件分岐の処理を行う。

{%IF({%EVALUATE({%CREATE_COMPARE({%GET(FullPathFileName)},部分一致,総務課)})}=True,
  #条件を満たす場合
  {%WRITE_LOG(条件を満たしています。)}
,
  #条件を満たさない場合
  {%WRITE_LOG(条件を満たしていません。)}
)}

例3

処理中ファイルのパスに「営業1課」又は「総務課」が含まれるかを判定する比較演算式情報を作成する。

{%CREATE_COMPARE({%GET(FullPathFileName)},正規表現,(?:営業1課|総務課))}

例3

処理中ファイル名の先頭が2024で始まっているかを判定する比較演算式情報を作成する。

{%CREATE_COMPARE({%GET(FileName)},前方一致,2024)}

例1

年齢が20以上、且つ、50以下であるかを判定する条件を作成する

{%SET_U(属性,年齢,21)}

{%CREATE_OPERATOR(AND,
  {%CREATE_COMPARE({%GET_U(属性,年齢)},>=,20)},
  {%CREATE_COMPARE({%GET_U(属性,年齢)},<=,50)}
)}

例1

年齢が20以上、且つ、50以下であるかを判定する条件を評価する。

{%SET_U(属性,年齢,21)}

{%SET_U(temp,条件式,
  {%CREATE_OPERATOR(AND,
    {%CREATE_COMPARE({%GET_U(属性,年齢)},>=,20)},
    {%CREATE_COMPARE({%GET_U(属性,年齢)},<=,50)}
  )}
)}

{%IF({%EVALUATE({%GET_U(temp,条件式)})}=True,
  #条件を満たす場合
  {%WRITE_LOG(条件を満たしています。)}
,
  #条件を満たさない場合
  {%WRITE_LOG(条件を満たしていません。)}
)}

例1

エラーが発生する可能性のある処理を実行し、エラー時にエラーメッセージをログに出力する。

{%TRY_CATCH(
  {%WRITE_LOG(処理を開始します)}
  {%MOVE_FILE({%GET(FullPathFileName)},C:\Output\{%GET(FileName)})}
,
  {%WRITE_LOG(エラー発生: {%GET_ERROR_MESSAGE()})}
)}

例2

エラーを無視して処理を続行する（第2引数を省略）。ファイル移動に失敗してもエラーにならない。

{%TRY_CATCH({%MOVE_FILE({%GET(FullPathFileName)},C:\Output\{%GET(FileName)})})}

例3

LOOP_FILEと組み合わせて、ファイル毎にエラーハンドリングを行う。エラーが発生しても次のファイルの処理を継続する。

{%LOOP_FILE FL1(Attr)(
  {%TRY_CATCH(
    {%WRITE_LOG([{%GET(FileLoopCount)}/{%GET(FileCount)}] {%GET(FileName)})}
    {%MOVE_FILE({%GET(FullPathFileName)},C:\Output\{%GET(FileName)})}
  ,
    {%WRITE_LOG(エラー: {%GET_ERROR_MESSAGE()})}
  )}
)}

例4

複数の処理ステップをそれぞれ独立してエラーハンドリングする。ステップ1でエラーが発生してもステップ2は実行される。

{%LOOP_FILE FL1(Attr)(
  {%TRY_CATCH(
    {%WRITE_LOG(ステップ1: マクロ実行)}
    {%PARSE_MACRO({%GET_U(属性,マクロ)})}
  ,
    {%WRITE_LOG(ステップ1でエラー: {%GET_ERROR_MESSAGE()})}
  )}
  {%TRY_CATCH(
    {%WRITE_LOG(ステップ2: ファイル移動)}
    {%MOVE_FILE({%GET(FullPathFileName)},C:\Output\{%GET(FileName)})}
  ,
    {%WRITE_LOG(ステップ2でエラー: {%GET_ERROR_MESSAGE()})}
  )}
)}

例5

TRY_CATCHをネストして、エラー時の処理自体のエラーもハンドリングする。

{%TRY_CATCH(
  {%MOVE_FILE({%GET(FullPathFileName)},C:\Output\{%GET(FileName)})}
,
  {%TRY_CATCH(
    {%WRITE_LOG(エラー: {%GET_ERROR_MESSAGE()})}
    {%SET_U(通知先,1,admin@example.com)}
    {%SEND_MAIL(メールサーバー1,通知先,noreply@example.com,,,エラー通知,{%GET_ERROR_MESSAGE()})}
  ,
    {%WRITE_LOG(エラー通知の送信にも失敗しました)}
  )}
)}