DIRECTORY_LIST
このアクティビティで、ディレクトリのファイルをリスト表示します。
サブディレクトリまたはサブディレクトリのファイルは表示されません。
またはFILENAMEやEXTENSIONパラメータを使用してファイルにフィルタすることも可能です。両方とも指定されない場合は、すべての使用可能なファイルがリストに含まれます。
リスト変数を追加するアクティビティの後にはLOOP処理指令もしくはその他の構成が続き、リスト内容を処理する場合が多くあります。リスト変数の詳細は「変数」、「リスト」を参照してください。
INPUTパラメータ:
DIRECTORY: 必須
このパラメータで、リストに表示する内容が保管されたディレクトリのフル・パスを指定します。
例: Windows C:\mydirectory
IBM i /orders/January
FILENAME: 任意
このパラメータを使用して指定したファイル名や拡張子のパターンに一致するものをリストすることも可能です。このフィルタ一致では大文字と小文字は区別されません。例えば 'abc*.txt' という値だと、拡張子が.TXTか.txtで、名前が'ABC'か 'abc'で始まるファイルのみがファイルリストとして戻されます。
ファイル名にマスクを指定する場合は、以下のプレースホルダー文字が使用できます。
? |
ファイル名や拡張子の指定された位置にどんな文字があっても一致します。 |
* |
ファイル名や拡張子の指定された位置とその後ろにどんな文字があっても一致します。 |
ファイル名のマスクにおいて、 ファイル名でも拡張子でも最初の'*'の後に続く文字は無効になり、無視されます。拡張子部分が無い場合は、全ての拡張子(または拡張子のない)ファイルが一致します。
例:
*.* |
全てのファイルをリストします。(パラメータ値を省略した場合と同じ結果 |
ab*.* |
'ab'で始まる、あらゆる拡張子の(または拡張子のない)ファイルをリストします。 |
???d*.csv |
ファイル名の4番目の位置に'd'を含み、拡張子が'csv'のファイルをすべてリストします。 |
*.xm* |
拡張子が'xm'で始まる全てのファイルをリストします。 |
EXTENSION: 任意
特定の拡張子のファイルだけを表示したい場合は、このパラメータを使用します。
フィルターでは大文字小文字は区別されず、先頭に「.」を付ける必要はありません。
例えば、「xml」を指定すると、拡張子が.XMLまたは.xmlのファイルだけがファイル・リストに表示されます。
このパラメータは、拡張子だけでファイルを選択したい場合、FILENAMEパラメータのみを使用するよりも良い性能を提供します。(これはLANSA Integrator の処理語の段階ではなく、XMLFileServiceレベルで実行されるからです)FILENAME と EXTENSIONの両方を指定することも可能です。この場合、EXTENSIONパラメータが最初に適用され、一致したファイルがFILENAMEマスクでテストされます。
ORDERBY: 任意
このパラメータで、OUTPUTパラメータ、FILELISTにリストする順序を指定します。次の2つのグループの中からそれぞれ1つずつ指定できます。(それぞれの値の間は、少なくとも1つのスペースを空けて分けてください)
1. *NONE | *NAME | *MODIFIED
2. *ASCEND | *DESCEND
組み込み変数名と区別できるよう、値の両側には引用符を指定してください。
これらの値の詳細は以下を参照してください。それぞれのグループから1つ以上の値を指定すると、最後に指定された値が有効になります。このパラメータを指定しない場合の省略値は*NONEです。つまり、系統付けられた順序付けがなされないということです。(この場合、実際の順序はLANSA Composerによっては定義されません。動作環境要因によります)
1. *NONE | *NAME | *MODIFIED
この値はファイルリストを順序付ける際に使用される属性です。パスによって順序付ける場合は、*NAMEを指定してください。またそれぞれの最終更新日時によって順序付ける場合は、*MODIFIEDを指定してください。
2. *ASCEND | *DESCEND
この値で適用する順序を指定します。昇順には*ASCEND、降順には*DESCENDを指定します。指定されない場合の省略値は*ASCENDです。
例えば、'*MODIFIED *DESCEND'を指定すると、ファイルは更新日時の降順でリストされます。
OUTPUTパラメータ:
FILELIST :
正常に完了した場合にDIRECTORY内に作成されるファイルリストを含むリスト変数の名前を指定します。FILENAMEまたはEXTENSIONパラメータが指定されていると、このリストは指定されたファイル名または拡張子のマスクに一致するファイルのみを含みます。またこのリストにはフル・パスとファイル名が含まれます。
例:
Windows C:\mydirectory\file1.txt
IBM i /orders/January/ord01.xml