NAME ファイル削除

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

ファイル名に指定されたファイルを削除します。ファイルが存在しない場合は何もしません。

戻り値にファイル名を返却します。

{%IF({%GET(FolderPath)}={%GET_G(TopFolder)}\入力,
  {%DELETE_FILE({%GET(FullPathFileName)})}
,)}

{%DELETE_FILE(D:\Test\File01.tif)}

NAME フォルダ削除

FORMAT {%DELETE_FOLDER(フォルダ名)}

フォルダ名に指定されたフォルダを削除します。フォルダが存在しない場合は何もしません。

フォルダの中が空の場合のみ削除します。

戻り値にフォルダ名を返却します。

フォルダの中にファイル又はフォルダが存在する場合はエラーとなります。

{%DELETE_FOLDER(D:\Test)}

NAME フォルダ作成

FORMAT {%CREATE_FOLDER(フォルダ名)}

フォルダ名に指定されたフォルダを作成します。上位から順番に存在しないフォルダを作成していきますので、パスで指定された全てのフォルダを一度に作成できます。

マクロの戻り値に引数で渡されたフォルダパスを返却します。

{%CREATE_FOLDER(C:\Home\test\abc)}

{%WRITE_LOG({%CREATE_FOLDER(C:\Home\test\abc)})}

NAME ジャンクション作成

FORMAT {%CREATE_JUNCTION(リンクパス,ターゲットフォルダ)}

リンクパスに指定された場所にフォルダージャンクション(リパースポイント)を作成します。ターゲットフォルダに指定されたフォルダーへのジャンクションが作成されます。

リンクパスが既に存在する場合は無条件に上書きします。既存がジャンクションの場合は削除後に再作成、空の通常フォルダーの場合は削除後に再作成、ファイルの場合も削除後に作成されます。

ターゲットフォルダが存在しない場合は、ターゲット側のフォルダーを新規に作成してからジャンクションを作成します。この場合、ログに警告メッセージ（「ターゲット ... が存在しなかったため作成しました」）が出力されます。

マクロの戻り値にリンクパスを返却します。

フォルダージャンクションは管理者権限を必要とせず作成できます（シンボリックリンクと異なり、ユーザー権限で作成可能です）。

{%CREATE_JUNCTION(D:\Link,D:\Target)}

{%WRITE_LOG({%CREATE_JUNCTION(C:\Work\Link,D:\Data\Target)})}

NAME ジャンクション削除

FORMAT {%DELETE_JUNCTION(リンクパス)}

リンクパスに指定されたフォルダージャンクションを削除します。ターゲットの実体フォルダーには影響を与えません（リパースポイントのみ解除して削除します）。

リンクパスが存在しない場合は何もしません。

リンクパスが通常のフォルダー（ジャンクションではないフォルダー）の場合はエラーとなります。これは誤ってターゲットの実体を削除してしまうことを防ぐための安全機能です。通常のフォルダーを削除する場合は {%DELETE_FOLDER(...)} を使用してください。

戻り値に削除したリンクパスを返却します。リンクパスが存在しなかった場合は空文字列を返します。

{%DELETE_JUNCTION(D:\Link)}

NAME ジャンクション存在チェック

FORMAT {%EXISTS_JUNCTION(リンクパス)}

リンクパスに指定されたパスがフォルダージャンクションであるかチェックします。ジャンクションの場合はTrueを返却し、そうでない場合（存在しない、通常のフォルダー、他種のリパースポイント）はFalseを返却します。

{%IF({%EXISTS_JUNCTION(D:\Link)}=True,MSGBOX(ジャンクション),MSGBOX(通常フォルダ))}

NAME ジャンクションターゲット取得

FORMAT {%GET_JUNCTION_TARGET(リンクパス)}

リンクパスに指定されたフォルダージャンクションのターゲット（リンク先）の絶対パスを返却します。

リンクパスが存在しない場合、またはジャンクションでない場合（通常のフォルダー、ファイル等）は空文字列を返します。{%EXISTS_JUNCTION(...)} と組み合わせなくても安全に呼び出せます。

{%WRITE_LOG({%GET_JUNCTION_TARGET(D:\Link)})}

{%SET_U(W,Target,{%GET_JUNCTION_TARGET(D:\Link)})}
{%IF({%GET_U(W,Target)}=,{%WRITE_LOG(リンクなし)},{%WRITE_LOG(ターゲット={%GET_U(W,Target)})})}

NAME ファイル存在チェック

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

ファイル名に指定されたファイルが存在するかチェックします。ファイルが存在する場合はTrueを返却し、存在しない場合はFalseを返却します。

{%IF({%EXISTS_FILE(D:\Test\File01.txt)}=True,MSGBOX(あり),MSGBOX(なし))}

NAME フォルダ存在チェック

FORMAT {%EXISTS_FOLDER(フォルダ名)}

フォルダ名に指定されたフォルダが存在するかチェックします。フォルダが存在する場合はTrueを返却し、存在しない場合はFalseを返却します。

{%IF({%EXISTS_FOLDER(D:\Test)}=True,MSGBOX(あり),MSGBOX(なし))}

NAME ファイルコピー

FORMAT {%COPY_FILE(コピー元ファイル名,コピー先ファイル名,[コピー先ファイル存在時の処理(SeqNo|Overwrite|DoNothing|Error)],[コピー先タイプ指定(File|Folder)])}

ファイルをコピーします。

コピー先のフォルダが存在しない場合は自動で作成します。

コピー元ファイル名が空文字の場合は何も処理を行いません。

コピー先ファイル存在時の処理は、以下の何れかを指定します。省略時はファイル名の末尾に連番を付与します。

コピー先タイプ指定は、ファイル名(File)、フォルダ名(Folder)の何れかを指定します。省略するとファイル(File)になります。コピー先のパスにフォルダ名を指定した場合は、コピー先タイプ指定に「Folder」を指定してください。コピー元のファイル名と同じファイル名でコピーを行います。

マクロの戻り値に、コピー先ファイルのフルパスが返却されます。

{%COPY_FILE(D:\Test\File01.txt,D:\Test\控え\File01.txt)}

{%COPY_FILE(D:\Test\File01.txt,D:\Test\控え,,Folder)}

{%COPY_FILE(D:\Test\File01.txt,D:\Test\控え\File01.txt,Overwrite)}

NAME 複数ファイルコピー

FORMAT {%MULTI_COPY_FILE(コピー元ファイル名,コピー先ファイル名,回数)}

ファイルを回数で指定された数分コピー（複製）します。コピー先ファイル名には[No]という文字を含ませてください。実行時に[No]が番号に置換されます。

コピー先に既に同名のファイルが存在する場合は、エラーが発生します。

{%MULTI_COPY_FILE(D:\Test\File.txt,D:\Test\控え\File[No].txt,3)}

NAME ファイル移動

FORMAT {%MOVE_FILE(移動元ファイル名,移動先ファイル名,[移動先ファイル存在時の処理(SeqNo|Overwrite|DoNothing|Error)],[移動先タイプ指定(File|Folder)],[移動方式(CopyDelete|Move)])}

ファイルを移動します。

移動先のフォルダが存在しない場合は自動で作成します。

移動元ファイル名が空文字の場合は何も処理を行いません。

移動先ファイル存在時の処理は、以下の何れかを指定します。省略時はファイル名の末尾に連番を付与します。

移動先タイプ指定は、ファイル名(File)、フォルダ名(Folder)の何れかを指定します。省略するとファイル(File)になります。移動先のパスにフォルダ名を指定した場合は、移動先タイプ指定に「Folder」を指定してください。移動元のファイル名と同じファイル名で移動を行います。

移動方式にファイル移動(Move)を指定した場合は、通常のファイル移動APIを使用します。省略するとファイルコピー後削除(CopyDelete)になり、ファイルコピーを行った後に、コピー元ファイルを削除する方式でファイル移動を行います。

ファイルシステムのAPIでは、同一ドライブのファイル移動はパスの付け替えだけを行っているので、ファイルの権限が移動元の状態のまま変化しません。ですが、コピーの場合はコピー先フォルダの権限を継承します。

マクロの戻り値に、移動先ファイルのフルパスが返却されます。

{%MOVE_FILE(D:\Test\File01.txt,D:\Test\処理済み\File01.txt)}

{%MOVE_FILE(D:\Test\File01.txt,D:\Test\処理済み,,Folder)}

{%MOVE_FILE(D:\Test\File01.txt,D:\Test\処理済み\File01.txt,Overwrite)}

NAME ファイル・フォルダの作成日時取得

FORMAT {%GET_CREATION_TIME(ファイル名、又は、フォルダ名)}

指定されたファイル、又は、フォルダの作成日時を取得します。取得される形式は、「yyyy/MM/dd HH:mm:ss」です。

{%WRITE_LOG({%GET_CREATION_TIME(C:\Test\File01.txt)})}

NAME ファイル・フォルダのアクセス日時取得

FORMAT {%GET_LAST_ACCESS_TIME(ファイル名、又は、フォルダ名)}

指定されたファイル、又は、フォルダのアクセス日時を取得します。取得される形式は、「yyyy/MM/dd HH:mm:ss」です。

{%WRITE_LOG({%GET_LAST_ACCESS_TIME(C:\Test\File01.txt)})}

NAME ファイル・フォルダの更新日取得

FORMAT {%GET_LAST_WRITE_TIME(ファイル名、又は、フォルダ名)}

指定されたファイル、又は、フォルダの更新日を取得します。処理中ファイルの更新日の取得は「{%GET(LastWriteTime)}」でも取得できます。

{%GET_LAST_WRITE_TIME(D:\Test\File01.txt)}

{%GET_LAST_WRITE_TIME({%GET(FolderPath)})}

NAME ファイル・フォルダの作成日時変更

FORMAT {%CHANGE_CREATION_TIME(ファイル名、又は、フォルダ名,日時)}

指定されたファイル、又は、フォルダの作成日時を変更します。

{%CHANGE_CREATION_TIME(D:\Test\File01.txt,2012/05/01 00:00:00)}

NAME ファイル・フォルダの更新日時変更

FORMAT {%CHANGE_LAST_WRITE_TIME(ファイル名、又は、フォルダ名,日時)}

指定されたファイル、又は、フォルダの更新日時を変更します。

{%CHANGE_LAST_WRITE_TIME(D:\Test\File01.txt,2012/05/01 00:00:00)}

{%CHANGE_LAST_WRITE_TIME({%GET(FolderPath)},{%GET(LastWriteTime)})}

NAME ファイル・フォルダのアクセス日時変更

FORMAT {%CHANGE_LAST_ACCESS_TIME(ファイル名、又は、フォルダ名,日時)}

指定されたファイル、又は、フォルダのアクセス日時を変更します。

{%CHANGE_LAST_ACCESS_TIME(D:\Test\File01.txt,2012/05/01 00:00:00)}

NAME ファイルサイズ取得

FORMAT {%GET_FILE_SIZE(ファイル名、又は、フォルダ名,[サブフォルダ検索指定(Sub|Current)])}

指定されたファイル、又は、フォルダ内のファイルについて、ファイルサイズの合計値を取得します。

ファイル名にはワイルドカードを使用できます。

サブフォルダ検索指定には、「Sub」又は「Current」を指定します。「Sub」を指定するとサブディレクトリも検索の対象となります。「Current」を指定すると指定したフォルダのみを検索対象とします。省略すると「Current」となります。

{%GET_FILE_SIZE(C:\Home\Temp1\upload.zip)}

{%GET_FILE_SIZE(C:\Home\Temp1\*,Sub)}

NAME 空フォルダチェック

FORMAT {%IS_FOLDER_EMPTY(フォルダ名)}

フォルダ名に指定されたフォルダ内にファイル又は、フォルダが存在するかチェックします。存在しない場合はTrueを返却し、存在する場合はFalseを返却します。

{%IF({%IS_FOLDER_EMPTY(D:\Test)}=True,{%DELETE_FOLDER(D:\Test)},)}

NAME 連番ファイル名取得

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

ファイル名に指定されたファイルが存在するかチェックし、ファイルが存在する場合はファイル名の末尾に連番を付与したファイル名を返却します。

{%GET_SEQUENCE_FILENAME(D:\Test\File01.txt)}

結果 ファイルが存在する場合
D:\Test\File01_0001.txt

NAME ファイル検索(フォルダ検索)

FORMAT {%SEARCH_FILE(フォルダ名,ファイル名,データ名,[サブフォルダ検索指定(Sub|Current)],[フォルダ検索指定(File|Folder)],[検索結果の形式(Full|Name)])}

指定のフォルダからファイル又は、フォルダを検索します。

フォルダ名には、検索するフォルダを指定します。

Version2.4.13からフォルダ名にワイルドカードを使用できるようになりました。詳細は ファイル検索処理 の検索フォルダをご覧ください。

ファイル名に検索したいファイルを指定します。ファイル名にはワイルドカードが使用できます。;(セミコロン)で区切ることによって複数指定が可能です。

データ名には、検索結果を保存するユーザデータのデータ名を指定します。

サブフォルダ検索指定には、「Sub」又は「Current」を指定します。「Sub」を指定するとサブディレクトリも検索の対象となります。「Current」を指定すると指定したフォルダのみを検索対象とします。省略すると「Current」となります。

フォルダ検索指定には、「File」又は「Folder」を指定します。「File」を指定するとファイルを検索します。「Folder」を指定すると検索対象がファイルではなくフォルダのみとなります。省略すると「File」となります。

検索結果の形式には、「Full」又は「Name」を指定します。「Full」を指定すると検索結果がフルパスで格納されます。「Name」を指定すると検索結果が名前のみで格納されます。省略すると「Full」となります。

検索結果は指定したデータ名のユーザデータに格納されます。1から始まる連番がキーとなり、値にはフルパスファイル(フォルダ)名か、ファイル(フォルダ)名がセットされます。

検索結果に指定したユーザデータは処理前にクリアされます。

{%SEARCH_FILE(C:\Home\図面,X0002.xdw,FileList,Sub)}

{%MSGBOX({%IF({%GET_USER_DATA_COUNT(FileList)}>0,発見! {%GET_USER_DATA(FileList,1)},見つからない)})}

{%SEARCH_FILE(C:\Home\図面,*.xdw;*.tif,FileList,Current)}
{%LOOP L1 {%GET_USER_DATA_COUNT(FileList)}(
  {%WRITE_LOG({%GET_USER_DATA(FileList,[L_IDX(L1)])})}
)}

{%SEARCH_FILE(C:\Home\営業,*伊藤,FolderList,Current,Folder,Name)}
{%LOOP L1 {%GET_USER_DATA_COUNT(FolderList)}(
  {%WRITE_LOG({%GET_USER_DATA(FolderList,[L_IDX(L1)])})}
)}

NAME ジャンクション検索

FORMAT {%SEARCH_JUNCTION(フォルダ名,データ名,[サブフォルダ検索指定(Sub|Current)],[検索結果の形式(Full|Name)])}

指定のフォルダからフォルダージャンクションを検索して一覧を取得します。

フォルダ名には、検索するフォルダーを指定します。

データ名には、検索結果を保存するユーザデータのデータ名を指定します。

サブフォルダ検索指定には、「Sub」又は「Current」を指定します。「Sub」を指定するとサブディレクトリも検索の対象となります。「Current」を指定すると指定したフォルダのみを検索対象とします。省略すると「Current」となります。ジャンクションの中は再帰検索しません（無限ループ回避のため）。

検索結果の形式には、「Full」又は「Name」を指定します。「Full」を指定するとフルパスで格納されます。「Name」を指定すると名前のみで格納されます。省略すると「Full」となります。

検索結果は指定したデータ名のユーザデータに格納されます。1から始まる連番がキーとなり、値にはフルパスまたは名前がセットされます。

検索結果に指定したユーザデータは処理前にクリアされます。

{%SEARCH_JUNCTION(D:\Data,JList,Current,Full)}
{%MSGBOX({%GET_USER_DATA_COUNT(JList)}件のジャンクションが見つかりました)}

{%SEARCH_JUNCTION(D:\Data,JList,Sub,Name)}
{%LOOP L1 {%GET_USER_DATA_COUNT(JList)}(
  {%WRITE_LOG({%GET_USER_DATA(JList,[L_IDX(L1)])})}
)}

NAME ファイル取得(フォルダ指定・1ファイルのみ)

FORMAT {%GET_ANY_FILE(ファイル名(ワイルドカード),フォルダパス)}

フォルダパスで指定されたフォルダからファイル検索を行い、更新日時の最も古いファイルのパスを返却します。

フォルダパスで指定されたフォルダが見つからない場合は、エラーになります。また、ファイルが1つも見つからない場合は、空文字が返却されます。

{%MOVE_FILE({%GET_ANY_FILE(*.xdw,C:\Demo\In)},C:\Demo\Out,SeqNo,Folder)}

NAME ファイルロック

FORMAT {%LOCK(ファイル名,[リトライ秒数])}

ファイル名に指定されたファイルをロックします。ロックしたファイルはUNLOCKマクロで解除されるか、処理が終了するまでロックされます。指定されたファイルが存在しない場合は新規作成してロックを行います。

ファイルのロックに成功すると「True」が戻り値として返却されます。失敗すると「False」が返却されます。

ファイルがロックされている場合は、リトライ秒数で指定された秒数だけリトライを行います。リトライ秒数を超えてロックされていた場合は、「False」が返却されます。

リトライ秒数を省略するとリトライ秒数は3秒になります。0を指定するとリトライは行いません。-1を指定するとロック解除されるまで無限(メイン画面のキャンセル等で中断できます。)に待ちます。

ロックされたファイルは他のプロセスからロックすることができないので、排他処理を行う場合などに使えます。

ファイルロック後にロック解除マクロを実行しない場合でも、eDocArrangementの処理終了時にロック解除されます。

{%IF({%LOCK(C:\temp\lock1.txt)}=True,
  {%MOVE_FILE({%GET_ANY_FILE(*.xdw,C:\Demo\In)},C:\Demo\Out,SeqNo,Folder)}
  {%UNLOCK(C:\temp\lock1.txt)}
,)}

NAME ファイルロック解除

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

LOCKマクロでロックされたファイルをロック解除します。

NAME 共有フォルダのユーザー・パスワード設定

FORMAT {%NET_ADD_CONNECTION(共有フォルダ名,ユーザー名,パスワードファイル)}

認証情報が必要な共有フォルダに接続します。

共有フォルダ名はUNCパスです。

共有フォルダ名は「ホスト名 + 共有名」となりますが、共有フォルダの設定によっては、ホスト名のみを指定する事もできます。

共有フォルダ名に「ホスト名 + 共有名」以下のフォルダが含まれていても構いません。

ホスト名のみ
\\host

ホスト名 + 共有名
\\host\share1

ホスト名 + 共有名 + フォルダ名
\\host\share1\folder1

パスワードファイルには、パスワードを暗号化したファイルを指定します。暗号化したファイルを作成するには、メイン画面のメニューのツールの 暗号ファイル作成ツール を使用します。

{%NET_ADD_CONNECTION(\\nas01\disk1,admin,C:\Home\Password\nas01.txt)}

NAME 共有フォルダの切断

FORMAT {%NET_CANCEL_CONNECTION(共有フォルダ名)}

接続中の共有フォルダを切断します。

共有フォルダ名はUNCパスです。

共有フォルダ名は「ホスト名 + 共有名」となりますが、共有フォルダの設定によっては、ホスト名のみを指定する事もできます。

共有フォルダ名に「ホスト名 + 共有名」以下のフォルダが含まれていても構いません。

ホスト名のみ
\\host

ホスト名 + 共有名
\\host\share1

ホスト名 + 共有名 + フォルダ名
\\host\share1\folder1

{%NET_CANCEL_CONNECTION(\\nas01\disk1)}

NAME オープンチェック

FORMAT {%CHECK_FILE_OPEN(ファイル名,リトライ秒数)}

引き数のファイルがオープン可能か調べます。

オープンに成功した場合はTrueを返却します。

オープンに失敗した場合はリトライ秒数で指定された秒数の間、リトライを行います。リトライしてもオープンできなかった場合は、Falseを返却します。

リトライ秒数に0を指定するとリトライは行いません。

{%SET_U(属性,判定,{%CHECK_FILE_OPEN({%GET(FullPathFileName)},0)})}

NAME ファイル名取得

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

{%WRITE_LOG({%GET_FILE_NAME(C:\Test\sample01.txt)})}

NAME フォルダパス取得

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

{%WRITE_LOG({%GET_FOLDER_PATH(C:\Test\sample01.txt)})}

NAME フォルダ名取得

FORMAT {%GET_FOLDER_NAME(フォルダパス,[階層番号])}

{%WRITE_LOG({%GET_FOLDER_NAME(C:\Test\sample01.txt)})}

NAME 拡張子を除いたファイル名取得

FORMAT {%GET_FILE_NAME_WITHOUT_EXTENSION(フルパスファイル名又はファイル名)}

{%WRITE_LOG({%GET_FILE_NAME_WITHOUT_EXTENSION(C:\Test\sample01.txt)})}
{%WRITE_LOG({%GET_FILE_NAME_WITHOUT_EXTENSION(sample01.txt)})}

NAME ファイル名の拡張子取得

FORMAT {%GET_EXTENSION_FROM_FILE_NAME(フルパスファイル名又はファイル名)}

{%WRITE_LOG({%GET_EXTENSION_FROM_FILE_NAME(C:\Test\sample01.txt)})}
{%WRITE_LOG({%GET_EXTENSION_FROM_FILE_NAME(sample01.txt)})}