{"id":174051,"date":"2025-06-11T10:24:28","date_gmt":"2025-06-11T01:24:28","guid":{"rendered":"https:\/\/support.questetra.com\/?p=174051"},"modified":"2025-06-12T16:05:24","modified_gmt":"2025-06-12T07:05:24","slug":"files-filter-by-filename-2025","status":"publish","type":"post","link":"https:\/\/support.questetra.com\/en\/addons\/files-filter-by-filename-2025\/","title":{"rendered":"#Files: Filter by FileName"},"content":{"rendered":"\n

#Files: Filter by FileName<\/strong><\/h4>\n\n\n\n

translate<\/span> #\u8907\u6570\u30d5\u30a1\u30a4\u30eb: \u30d5\u30a1\u30a4\u30eb\u540d\u30d5\u30a3\u30eb\u30bf<\/a><\/p>\n\n\n\n

Extracts only files that match the conditions from the files stored in File-type Data Items. The conditions can be specified as “equal to”, “contains”, “starts with”, or “ends with”. A case-insensitive filter can be specified. You can also store the remaining files that were not extracted.<\/p>\n\n\n\n

\"Auto<\/figure>\n\n\n\n
\n
Configs for this Auto Step<\/summary>
\n
\n
SelectConfA1<\/dt>
A1: Select FILE DATA for Original Files *<\/span><\/dd>\n
OptionConfB1<\/dt>
B1: Select OPERATOR for Matching Condition *<\/span><\/dd>\n
StrConfB2<\/dt>
B2: Set KEYWORDs for Matching Condition (Multi Rows: OR-Search) *<\/span>#{EL}<\/sup><\/span><\/dd>\n
StrConfB3<\/dt>
B3: To Limit, Set Max Number to Extract (eg: “1”)#{EL}<\/sup><\/span><\/dd>\n
SelectConfC1<\/dt>
C1: Select FILE DATA that stores Extracted Files (update)<\/dd>\n
SelectConfC2<\/dt>
C2: Select FILE DATA that stores Extracted Files (append)<\/dd>\n
SelectConfC3<\/dt>
C3: Select FILE DATA that stores Not Extracted (update)<\/dd>\n\n<\/dl>\n<\/div><\/details><\/div>\n<\/div>\n\n\n\n
\n
Script (click to open)<\/summary>
\n
\n\/**\n * Questetra Add-on: FILE\u540d\u306b\u3088\u308b\u30d5\u30a3\u30eb\u30bf\n * \n * \u30d5\u30a1\u30a4\u30eb\u578b\u30c7\u30fc\u30bf\u306b\u683c\u7d0d\u3055\u308c\u305f\u8907\u6570\u306e\u30d5\u30a1\u30a4\u30eb\u304b\u3089\u3001\n * \u6307\u5b9a\u3055\u308c\u305f\u6587\u5b57\u5217\u6761\u4ef6\uff08equals \/ contains \/ startsWith \/ endsWith \u306a\u3069\uff09\u306b\u57fa\u3065\u3044\u3066\n * \u30de\u30c3\u30c1\u3059\u308b\u30d5\u30a1\u30a4\u30eb\u306e\u307f\u3092\u62bd\u51fa\u3057\u3001\u5225\u306e\u30d5\u30a1\u30a4\u30eb\u578b\u30c7\u30fc\u30bf\u306b\u683c\u7d0d\u3059\u308b\u3002\n * \n * \u5bfe\u5fdc\u6f14\u7b97\u5b50: \u5927\u6587\u5b57\u5c0f\u6587\u5b57\u533a\u5225\u3042\u308a\u30fb\u306a\u3057\u3092\u6307\u5b9a\u53ef\u80fd\u3002\n * \n * @engine GraalJS standard mode (engine-type: 3)\n * @license MIT License\n * @lastModified 2025-06-10\n *\/\n\n\n\/\/\/\/\/\/\/\/ START "main()" \/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\nmain();\nfunction main(){ \n\n\/\/\/\/ == Config Retrieving \/ \u5de5\u7a0b\u30b3\u30f3\u30d5\u30a3\u30b0\u306e\u53c2\u7167 ==\nconst filesPocketOriginal = configs.getObject( "SelectConfA1" );  \/\/\/ REQUIRED \/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\n  let filesOriginal       = engine.findData( filesPocketOriginal );  \/\/ java.util.ArrayList\n      \/\/ java.util.List of com.questetra.bpms.core.event.scripttask.QfileView\n  if( filesOriginal     === null ) {\n    throw new Error( "\\n AutomatedTask UnexpectedFileError:" +\n                     " No File {A1} is attached \\n" );\n  }else{\n    engine.log( " AutomatedTask FilesArray {A1}: " +\n                filesOriginal.size() + " files" );\n  }\nconst strOperator         = configs.get      ( "OptionConfB1" ); \/\/\/ REQUIRED (SELECT_ITEM)\n  \/\/ "equals",  "conains",  "stratswith",  "endswith",\n  \/\/ "equals2", "conains2", "startswith2", "endswith2" (2:ignore case)\nconst strKeywords         = configs.get      ( "StrConfB2" );    \/\/\/ REQUIRED\n  if( strKeywords       === "" ){\n    throw new Error( "\\n AutomatedTask ConfigError:" +\n                     " Config {B2: String} is empty \\n" );\n  }\n\n\/** @type {number} \u6700\u5927\u62bd\u51fa\u6570\uff08\u6307\u5b9a\u306a\u3057\u306e\u5834\u5408\u306f\u7121\u5236\u9650\uff09 *\/\nconst strMax              = configs.get      ( "StrConfB3" );     \/\/ not required\nconst numMax              = isNaN ( parseInt(strMax,10) ) ?\n                            Infinity : \/\/ defalut\n                            parseInt(strMax,10);\n  engine.log( " #of Max: " + numMax );\n\n\/** @type {java.util.ArrayList} \u62bd\u51fa\u30d5\u30a1\u30a4\u30eb\u683c\u7d0d\u7528 *\/\nconst filesPocketUpdate   = configs.getObject( "SelectConfC1" );  \/\/ NotRequired \/\/\/\/\/\/\/\/\/\/\/\/\/\n  let filesUpdate         = new java.util.ArrayList();\n\n\/** @type {java.util.ArrayList} \u8ffd\u52a0\u683c\u7d0d\u7528\uff08\u65e2\u5b58\u306b\u8ffd\u52a0\uff09 *\/\nconst filesPocketAppend   = configs.getObject( "SelectConfC2" );  \/\/ NotRequired \/\/\/\/\/\/\/\/\/\/\/\/\/\n  let filesAppend         = new java.util.ArrayList();\n  if ( filesPocketAppend !== null ) {\n    if ( engine.findData( filesPocketAppend ) !== null ) {\n      filesAppend         = engine.findData( filesPocketAppend ); \/\/ java.util.ArrayList\n      engine.log( " AutomatedTask FilesArray {C2}: " +\n                  filesAppend.size() + " files" );\n    }\n  }\n\n\/** @type {java.util.ArrayList} \u62bd\u51fa\u3055\u308c\u306a\u304b\u3063\u305f\u30d5\u30a1\u30a4\u30eb\u683c\u7d0d\u7528 *\/\nconst filesPocketLeft     = configs.getObject( "SelectConfC3" );  \/\/ NotRequired \/\/\/\/\/\/\/\/\/\/\/\/\/\n  let filesLeft           = new java.util.ArrayList();\n\n\n\n\/\/\/\/ == Data Retrieving \/ \u30ef\u30fc\u30af\u30d5\u30ed\u30fc\u30c7\u30fc\u30bf\u306e\u53c2\u7167 ==\n\/\/ (Nothing. Retrieved via Expression Language in Config Retrieving)\n\n\n\n\/\/\/\/ == Calculating \/ \u6f14\u7b97 ==\nconst arrKeywords  = strKeywords.split( '\\n' ).filter(k => k !== "");\n\nif ( strOperator === "equals" ) {\n  loopInput:\n  for ( let i = 0; i < filesOriginal.size(); i++ ) {\n    const fileTmp = new com.questetra.bpms.core.event.scripttask.NewQfile(\n      filesOriginal.get(i).getName(), \n      filesOriginal.get(i).getContentType(), \n      filesOriginal.get(i)\n    );\n    if ( filesUpdate.size() < numMax ){\n      for ( let j = 0; j < arrKeywords.length; j++ ) {\n        if ( filesOriginal.get(i).getName() == arrKeywords[j] ){\n          filesUpdate.add ( fileTmp );\n          filesAppend.add ( fileTmp );\n          continue loopInput;\n        }\n      }\n    }\n    filesLeft.add ( fileTmp );\n  }\n} else if ( strOperator === "equals2" ) {\n  loopInput:\n  for ( let i = 0; i < filesOriginal.size(); i++ ) {\n    const fileTmp = new com.questetra.bpms.core.event.scripttask.NewQfile(\n      filesOriginal.get(i).getName(), \n      filesOriginal.get(i).getContentType(), \n      filesOriginal.get(i)\n    );\n    if ( filesUpdate.size() < numMax ){\n      for ( let j = 0; j < arrKeywords.length; j++ ) {\n        if ( filesOriginal.get(i).getName().toUpperCase() == arrKeywords[j].toUpperCase() ){\n          filesUpdate.add ( fileTmp );\n          filesAppend.add ( fileTmp );\n          continue loopInput;\n        }\n      }\n    }\n    filesLeft.add ( fileTmp );\n  }\n\n} else if ( strOperator === "contains" ) {\n  loopInput:\n  for ( let i = 0; i < filesOriginal.size(); i++ ) {\n    const fileTmp = new com.questetra.bpms.core.event.scripttask.NewQfile(\n      filesOriginal.get(i).getName(), \n      filesOriginal.get(i).getContentType(), \n      filesOriginal.get(i)\n    );\n    if ( filesUpdate.size() < numMax ){\n      for ( let j = 0; j < arrKeywords.length; j++ ) {\n        if ( filesOriginal.get(i).getName().includes( arrKeywords[j] ) ){\n          filesUpdate.add ( fileTmp );\n          filesAppend.add ( fileTmp );\n          continue loopInput;\n        }\n      }\n    }\n    filesLeft.add ( fileTmp );\n  }\n\n} else if ( strOperator === "contains2" ) {\n  loopInput:\n  for ( let i = 0; i < filesOriginal.size(); i++ ) {\n    const fileTmp = new com.questetra.bpms.core.event.scripttask.NewQfile(\n      filesOriginal.get(i).getName(), \n      filesOriginal.get(i).getContentType(), \n      filesOriginal.get(i)\n    );\n    if ( filesUpdate.size() < numMax ){\n      for ( let j = 0; j < arrKeywords.length; j++ ) {\n        if ( filesOriginal.get(i).getName().toUpperCase().includes( arrKeywords[j].toUpperCase() ) ){\n          filesUpdate.add ( fileTmp );\n          filesAppend.add ( fileTmp );\n          continue loopInput;\n        }\n      }\n    }\n    filesLeft.add ( fileTmp );\n  }\n\n} else if ( strOperator === "startswith" ) {\n  loopInput:\n  for ( let i = 0; i < filesOriginal.size(); i++ ) {\n    const fileTmp = new com.questetra.bpms.core.event.scripttask.NewQfile(\n      filesOriginal.get(i).getName(), \n      filesOriginal.get(i).getContentType(), \n      filesOriginal.get(i)\n    );\n    if ( filesUpdate.size() < numMax ){\n      for ( let j = 0; j < arrKeywords.length; j++ ) {\n        if ( filesOriginal.get(i).getName().startsWith( arrKeywords[j] ) ){\n          filesUpdate.add ( fileTmp );\n          filesAppend.add ( fileTmp );\n          continue loopInput;\n        }\n      }\n    }\n    filesLeft.add ( fileTmp );\n  }\n\n} else if ( strOperator === "startswith2" ) {\n  loopInput:\n  for ( let i = 0; i < filesOriginal.size(); i++ ) {\n    const fileTmp = new com.questetra.bpms.core.event.scripttask.NewQfile(\n      filesOriginal.get(i).getName(), \n      filesOriginal.get(i).getContentType(), \n      filesOriginal.get(i)\n    );\n    if ( filesUpdate.size() < numMax ){\n      for ( let j = 0; j < arrKeywords.length; j++ ) {\n        if ( filesOriginal.get(i).getName().toUpperCase().startsWith( arrKeywords[j].toUpperCase() ) ){\n          filesUpdate.add ( fileTmp );\n          filesAppend.add ( fileTmp );\n          continue loopInput;\n        }\n      }\n    }\n    filesLeft.add ( fileTmp );\n  }\n\n} else if ( strOperator === "endswith" ) {\n  loopInput:\n  for ( let i = 0; i < filesOriginal.size(); i++ ) {\n    const fileTmp = new com.questetra.bpms.core.event.scripttask.NewQfile(\n      filesOriginal.get(i).getName(), \n      filesOriginal.get(i).getContentType(), \n      filesOriginal.get(i)\n    );\n    if ( filesUpdate.size() < numMax ){\n      for ( let j = 0; j < arrKeywords.length; j++ ) {\n        if ( arrKeywords[j] === "" ){\n          engine.log( " AutomatedTask RuntimeWarning: Empty in Keywords config" );\n          continue;\n        }\n        if ( filesOriginal.get(i).getName().endsWith( arrKeywords[j] ) ){\n          filesUpdate.add ( fileTmp );\n          filesAppend.add ( fileTmp );\n          continue loopInput;\n        }\n      }\n    }\n    filesLeft.add ( fileTmp );\n  }\n\n} else if ( strOperator === "endswith2" ) {\n  loopInput:\n  for ( let i = 0; i < filesOriginal.size(); i++ ) {\n    const fileTmp = new com.questetra.bpms.core.event.scripttask.NewQfile(\n      filesOriginal.get(i).getName(), \n      filesOriginal.get(i).getContentType(), \n      filesOriginal.get(i)\n    );\n    if ( filesUpdate.size() < numMax ){\n      for ( let j = 0; j < arrKeywords.length; j++ ) {\n        if ( arrKeywords[j] === "" ){\n          engine.log( " AutomatedTask RuntimeWarning: Empty in Keywords config" );\n          continue;\n        }\n        if ( filesOriginal.get(i).getName().toUpperCase().endsWith( arrKeywords[j].toUpperCase() ) ){\n          filesUpdate.add ( fileTmp );\n          filesAppend.add ( fileTmp );\n          continue loopInput;\n        }\n      }\n    }\n    filesLeft.add ( fileTmp );\n  }\n\n} else {\n  throw new Error( "\\n AutomatedTask RuntimeError:" +\n                   " Unexpected OPERATOR \\n" );\n}\n\n\n\/\/\/\/ == Data Updating \/ \u30ef\u30fc\u30af\u30d5\u30ed\u30fc\u30c7\u30fc\u30bf\u3078\u306e\u4ee3\u5165 ==\nif ( filesPocketUpdate !== null ) {\n  engine.setData( filesPocketUpdate, filesUpdate );\n}\nif ( filesPocketAppend !== null ) {\n  engine.setData( filesPocketAppend, filesAppend );\n}\nif ( filesPocketLeft !== null ) {\n  engine.setData( filesPocketLeft, filesLeft );\n}\n\n} \/\/\/\/\/\/\/\/ END "main()" \/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\n\n\n\/*\nNotes:\n- Use this when you want to extract a part of the files stored in the "File type data item".\n    - When a Process token reaches the automatde step, files that match the conditions will be automatically extracted.\n    - If to narrow down to image files only:\n        - File name "ends with" `.png` or `.jpg`\n    - If to pass "one PNG file" to the generation AI:\n        - File name "ends with" `.png`\n        - and Maximum number of extractions is `1`\n- Also possible to store files that were not extracted.\n\nNotes-ja:\n- "\u30d5\u30a1\u30a4\u30eb\u578b\u30c7\u30fc\u30bf\u9805\u76ee" \u306b\u683c\u7d0d\u3055\u308c\u3066\u3044\u308b\u30d5\u30a1\u30a4\u30eb\u7fa4\u304b\u3089\u3001\u4e00\u90e8\u3092\u62bd\u51fa\u3057\u305f\u3044\u5834\u5408\u306b\u5229\u7528\u3057\u307e\u3059\u3002\n    - \u6848\u4ef6\u304c\u81ea\u52d5\u5de5\u7a0b\u306b\u5230\u9054\u3057\u305f\u969b\u3001\u6761\u4ef6\u306b\u30de\u30c3\u30c1\u3059\u308b\u30d5\u30a1\u30a4\u30eb\u304c\u81ea\u52d5\u7684\u306b\u62bd\u51fa\u3055\u308c\u307e\u3059\u3002\n    - \u753b\u50cf\u30d5\u30a1\u30a4\u30eb\u3060\u3051\u306b\u7d5e\u308a\u8fbc\u307f\u305f\u3044\u5834\u5408\u306e\u8a2d\u5b9a\u4f8b\uff1a\n        - \u30d5\u30a1\u30a4\u30eb\u540d\u304c `.png` \u3082\u3057\u304f\u306f `.jpg` \u3067 "\u7d42\u308f\u308b"\n    - \u751f\u6210AI\u306b\u300c1\u679a\u306ePNG\u30d5\u30a1\u30a4\u30eb\u300d\u3092\u6e21\u3057\u305f\u3044\u5834\u5408\u306e\u8a2d\u5b9a\u4f8b\uff1a\n        - \u30d5\u30a1\u30a4\u30eb\u540d\u304c `.png` \u3067 "\u7d42\u308f\u308b"\n        - \u6700\u5927\u62bd\u51fa\u6570\u306f `1`\n- \u62bd\u51fa\u3055\u308c\u306a\u304b\u3063\u305f\u30d5\u30a1\u30a4\u30eb\u7fa4\u3092\u683c\u7d0d\u3059\u308b\u3053\u3068\u3082\u53ef\u80fd\u3067\u3059\u3002\n*\/\n\n<\/code><\/pre><\/div>\n<\/div><\/details><\/div>\n<\/div>\n\n\n\n
Download<\/span><\/h3>\n\n\n\n