{"id":191006,"date":"2026-07-24T13:53:25","date_gmt":"2026-07-24T04:53:25","guid":{"rendered":"https:\/\/support.questetra.com\/?p=191006"},"modified":"2026-07-24T17:07:01","modified_gmt":"2026-07-24T08:07:01","slug":"script-task-files-send-receive","status":"publish","type":"post","link":"https:\/\/support.questetra.com\/ja\/developer-blog\/script-task-files-send-receive\/","title":{"rendered":"\u30b9\u30af\u30ea\u30d7\u30c8\u30bf\u30b9\u30af\u304b\u3089 HTTP \u3067\u30d5\u30a1\u30a4\u30eb\u3092\u9001\u53d7\u4fe1\u3059\u308b"},"content":{"rendered":"\n

\u30b9\u30af\u30ea\u30d7\u30c8\u30bf\u30b9\u30af\u3067\u306f\u3001\u30d5\u30a1\u30a4\u30eb\u578b\u30c7\u30fc\u30bf\u9805\u76ee\u306b\u683c\u7d0d\u3055\u308c\u305f\u30d5\u30a1\u30a4\u30eb\u3092 HTTP \u3067\u5916\u90e8 API \u306b\u9001\u4fe1\u3057\u305f\u308a\u3001\u9006\u306b API \u304b\u3089\u53d6\u5f97\u3057\u305f\u30d5\u30a1\u30a4\u30eb\u3092\u30c7\u30fc\u30bf\u9805\u76ee\u306b\u4fdd\u5b58\u3057\u305f\u308a\u3067\u304d\u307e\u3059\u3002\u3053\u306e\u8a18\u4e8b\u3067\u306f\u3001\u305d\u306e\u57fa\u672c\u7684\u306a\u64cd\u4f5c\u3092\u89e3\u8aac\u3057\u307e\u3059\u3002<\/p>\n\n\n\n

\n\n\n\n

\u30d5\u30a1\u30a4\u30eb\u578b\u30c7\u30fc\u30bf\u9805\u76ee\u306e\u8aad\u307f\u53d6\u308a<\/h2>\n\n\n\n

\u30d5\u30a1\u30a4\u30eb\u578b\u30c7\u30fc\u30bf\u9805\u76ee\u306f\u3001engine.findDataByVarName()<\/code> \u3067 QfileView<\/code> \u30aa\u30d6\u30b8\u30a7\u30af\u30c8\u306e\u30ea\u30b9\u30c8\u3068\u3057\u3066\u53d6\u5f97\u3067\u304d\u307e\u3059\u3002<\/p>\n\n\n\n

const files = engine.findDataByVarName("q_attachment");\n\nif (files === null || files.isEmpty()) {\n  throw new Error("\u30d5\u30a1\u30a4\u30eb\u304c\u6dfb\u4ed8\u3055\u308c\u3066\u3044\u307e\u305b\u3093");\n}\n\n\/\/ 1 \u4ef6\u76ee\u306e\u30d5\u30a1\u30a4\u30eb\u3092\u53d6\u5f97\nconst file = files.get(0);\n\nengine.log("\u30d5\u30a1\u30a4\u30eb\u540d: "    + file.getName());\nengine.log("MIME\u30bf\u30a4\u30d7: "    + file.getContentType());\nengine.log("\u30b5\u30a4\u30ba (\u30d0\u30a4\u30c8): " + file.getLength());<\/code><\/pre><\/div>\n\n\n\n
QfileView<\/code> \u3067\u53d6\u5f97\u3067\u304d\u308b\u4e3b\u306a\u60c5\u5831\u306f\u4ee5\u4e0b\u306e\u3068\u304a\u308a\u3067\u3059\u3002<\/p>\n\n\n\n
\u30e1\u30bd\u30c3\u30c9<\/th>\u5185\u5bb9<\/th><\/tr><\/thead>
getName()<\/code><\/td>\u30d5\u30a1\u30a4\u30eb\u540d<\/td><\/tr>
getContentType()<\/code><\/td>MIME \u30bf\u30a4\u30d7<\/td><\/tr>
getLength()<\/code><\/td>\u30d5\u30a1\u30a4\u30eb\u30b5\u30a4\u30ba\uff08\u30d0\u30a4\u30c8\uff09<\/td><\/tr>
getMalwareScanStatus()<\/code><\/td>\u30de\u30eb\u30a6\u30a7\u30a2\u30b9\u30ad\u30e3\u30f3\u7d50\u679c<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
\u30d5\u30a1\u30a4\u30eb\u305d\u306e\u3082\u306e\u306e\u30d0\u30a4\u30c8\u5217\u306f QfileView<\/code> \u304b\u3089\u76f4\u63a5\u306f\u53d6\u308a\u51fa\u305b\u307e\u305b\u3093\u3002\u30a2\u30c3\u30d7\u30ed\u30fc\u30c9\u3084\u66f8\u304d\u8fbc\u307f\u3067\u306f\u3001\u5f8c\u8ff0\u306e\u3088\u3046\u306b QfileView<\/code> \u30aa\u30d6\u30b8\u30a7\u30af\u30c8\u305d\u306e\u3082\u306e\u3092 API \u306b\u6e21\u3059<\/strong> \u5f62\u3067\u6271\u3044\u307e\u3059\u3002<\/p>\n\n\n\n
\n\n\n\n
HTTP \u3067\u30d5\u30a1\u30a4\u30eb\u3092\u30a2\u30c3\u30d7\u30ed\u30fc\u30c9\u3059\u308b<\/h2>\n\n\n\n
\u30d5\u30a1\u30a4\u30eb\u3092\u5916\u90e8 API \u306b multipart\/form-data<\/code> \u5f62\u5f0f\u3067\u9001\u4fe1\u3059\u308b\u306b\u306f\u3001.multipart(name, file)<\/code> \u3067\u30d5\u30a1\u30a4\u30eb\u30d1\u30fc\u30c8\u3092\u8ffd\u52a0\u3057\u307e\u3059\u3002\u7b2c 2 \u5f15\u6570\u306b QfileView<\/code> \u30aa\u30d6\u30b8\u30a7\u30af\u30c8\u3092\u305d\u306e\u307e\u307e\u6e21\u3059<\/strong> \u306e\u304c\u30dd\u30a4\u30f3\u30c8\u3067\u3059\u3002<\/p>\n\n\n\n
const files = engine.findDataByVarName("q_attachment");\nif (files === null || files.isEmpty()) {\n  throw new Error("\u30d5\u30a1\u30a4\u30eb\u304c\u6dfb\u4ed8\u3055\u308c\u3066\u3044\u307e\u305b\u3093");\n}\nconst file = files.get(0);\n\nconst response = httpClient.begin()\n  .multipart("file", file)                  \/\/ QfileView \u3092\u305d\u306e\u307e\u307e\u6e21\u3059\n  .post("https:\/\/api.example.com\/upload");\n\nconst statusCode = response.getStatusCode();\nif (statusCode < 200 || statusCode >= 300) {\n  engine.log("\u30a8\u30e9\u30fc\u30ec\u30b9\u30dd\u30f3\u30b9: " + response.getResponseAsString());\n  throw new Error("\u30d5\u30a1\u30a4\u30eb\u306e\u30a2\u30c3\u30d7\u30ed\u30fc\u30c9\u306b\u5931\u6557\u3057\u307e\u3057\u305f\u3002\u30b9\u30c6\u30fc\u30bf\u30b9\u30b3\u30fc\u30c9: " + statusCode);\n}\n\nengine.log("\u30a2\u30c3\u30d7\u30ed\u30fc\u30c9\u5b8c\u4e86: " + response.getResponseAsString());<\/code><\/pre><\/div>\n\n\n\n
\u30d5\u30a1\u30a4\u30eb\u540d\u3084 MIME \u30bf\u30a4\u30d7\u306f QfileView<\/code> \u304c\u4fdd\u6301\u3057\u3066\u3044\u308b\u306e\u3067\u3001\u5225\u9014\u6307\u5b9a\u3059\u308b\u5fc5\u8981\u306f\u3042\u308a\u307e\u305b\u3093\u3002<\/p>\n\n\n\n
\u30c6\u30ad\u30b9\u30c8\u30d5\u30a3\u30fc\u30eb\u30c9\u3068\u7d44\u307f\u5408\u308f\u305b\u308b\u5834\u5408<\/h3>\n\n\n\n
.multipart(name, value)<\/code>\uff082 \u5f15\u6570\u7248\uff09\u3067\u30c6\u30ad\u30b9\u30c8\u30d1\u30fc\u30c8\u3092\u8ffd\u52a0\u3067\u304d\u307e\u3059\u3002\u540c\u3058 .multipart()<\/code> \u30e1\u30bd\u30c3\u30c9\u3067\u3001\u5f15\u6570\u306e\u578b\u306b\u5fdc\u3058\u3066\u30d5\u30a1\u30a4\u30eb\uff0f\u30c6\u30ad\u30b9\u30c8\u304c\u81ea\u52d5\u7684\u306b\u533a\u5225\u3055\u308c\u307e\u3059\u3002<\/p>\n\n\n\n
const files   = engine.findDataByVarName("q_attachment");\nconst comment = engine.findDataByVarName("q_comment");\n\nconst file = files.get(0);\n\nconst response = httpClient.begin()\n  .multipart("comment", comment)            \/\/ \u30c6\u30ad\u30b9\u30c8\u30d1\u30fc\u30c8\n  .multipart("file",    file)               \/\/ \u30d5\u30a1\u30a4\u30eb\u30d1\u30fc\u30c8\n  .post("https:\/\/api.example.com\/upload");<\/code><\/pre><\/div>\n\n\n\n
\u30d5\u30a1\u30a4\u30eb\u3092\u30ea\u30af\u30a8\u30b9\u30c8\u30dc\u30c7\u30a3\u3068\u3057\u3066\u9001\u308b<\/h3>\n\n\n\n
multipart\/form-data<\/code> \u3067\u306f\u306a\u304f\u3001\u30d5\u30a1\u30a4\u30eb\u305d\u306e\u3082\u306e\u3092\u30ea\u30af\u30a8\u30b9\u30c8\u30dc\u30c7\u30a3\u3068\u3057\u3066\u9001\u308a\u305f\u3044\u5834\u5408\u306f .body(file)<\/code> \u3092\u4f7f\u3044\u307e\u3059\u3002S3 \u3078\u306e PUT \u306a\u3069\u3001raw \u30d0\u30a4\u30ca\u30ea<\/strong> \u3092\u30dc\u30c7\u30a3\u306b\u8981\u6c42\u3059\u308b API \u3067\u4f7f\u3048\u307e\u3059\u3002<\/p>\n\n\n\n
const files = engine.findDataByVarName("q_attachment");\nconst file  = files.get(0);\n\nconst response = httpClient.begin()\n  .body(file)                               \/\/ \u30d5\u30a1\u30a4\u30eb\u3092\u305d\u306e\u307e\u307e\u30dc\u30c7\u30a3\u306b\n  .post("https:\/\/api.example.com\/upload\/raw");\n<\/code><\/pre><\/div>\n\n\n\n
Content-Type \u306f QfileView<\/code> \u304c\u4fdd\u6301\u3057\u3066\u3044\u308b MIME \u30bf\u30a4\u30d7\u304c\u81ea\u52d5\u7684\u306b\u4f7f\u7528\u3055\u308c\u307e\u3059\u3002API \u5074\u3067\u5225\u306e Content-Type \u3092\u8981\u6c42\u3055\u308c\u308b\u5834\u5408\u306f\u7b2c 2 \u5f15\u6570\u3067\u660e\u793a\u3067\u304d\u307e\u3059\u3002<\/p>\n\n\n\n
.body(file, "application\/octet-stream")     \/\/ Content-Type \u3092\u660e\u793a<\/code><\/pre><\/div>\n\n\n\n
\n\n\n\n
HTTP \u30ec\u30b9\u30dd\u30f3\u30b9\u3092\u30d5\u30a1\u30a4\u30eb\u3068\u3057\u3066\u4fdd\u5b58\u3059\u308b<\/h2>\n\n\n\n
\u5916\u90e8 API \u304b\u3089\u53d6\u5f97\u3057\u305f\u30d0\u30a4\u30ca\u30ea\u30c7\u30fc\u30bf\uff08PDF\u30fb\u753b\u50cf\u306a\u3069\uff09\u3092\u30d5\u30a1\u30a4\u30eb\u578b\u30c7\u30fc\u30bf\u9805\u76ee\u306b\u4fdd\u5b58\u3059\u308b\u306b\u306f\u3001\u30ec\u30b9\u30dd\u30f3\u30b9\u306e\u30d0\u30a4\u30c8\u5217\u3092 NewQfile<\/code><\/strong> \u30af\u30e9\u30b9\u306b\u30e9\u30c3\u30d7\u3057\u3066\u304b\u3089\u30c7\u30fc\u30bf\u9805\u76ee\u306b\u30bb\u30c3\u30c8\u3057\u307e\u3059\u3002<\/p>\n\n\n\n
\u30dd\u30a4\u30f3\u30c8\u306f 2 \u3064\uff1a<\/p>\n\n\n\n
    \n
  1. \u30ec\u30b9\u30dd\u30f3\u30b9\u306e\u30d0\u30a4\u30c8\u5217\u306f\u00a0response.getResponse()<\/code><\/strong>\u00a0\u3067\u00a0ByteArrayWrapper<\/code>\u00a0\u3068\u3057\u3066\u53d6\u5f97\u3059\u308b<\/li>\n\n\n\n
  2. new NewQfile(fileName, contentType, byteArrayWrapper)<\/code><\/strong>\u00a0\u3067\u30d5\u30a1\u30a4\u30eb\u30aa\u30d6\u30b8\u30a7\u30af\u30c8\u3092\u751f\u6210\u3059\u308b<\/li>\n<\/ol>\n\n\n\n
    NewQfile<\/code> \u306f Questetra \u72ec\u81ea\u306e\u30af\u30e9\u30b9\u3067\u3001\u30d5\u30eb\u4fee\u98fe\u540d\u306f com.questetra.bpms.core.event.scripttask.NewQfile<\/code> \u3067\u3059\u3002\u30b9\u30af\u30ea\u30d7\u30c8\u304b\u3089\u5229\u7528\u3059\u308b\u306b\u306f\u3001Java.type()<\/code> \u3067\u53c2\u7167\u3092\u53d6\u5f97\u3057\u3066\u304b\u3089\u4f7f\u3046\u306e\u304c\u7c21\u6f54\u3067\u3059\u3002<\/p>\n\n\n\n
    const response = httpClient.begin()\n  .get("https:\/\/api.example.com\/report.pdf");\n\nconst statusCode = response.getStatusCode();\nif (statusCode < 200 || statusCode >= 300) {\n  engine.log("\u30a8\u30e9\u30fc\u30ec\u30b9\u30dd\u30f3\u30b9: " + response.getResponseAsString());\n  throw new Error("\u30d5\u30a1\u30a4\u30eb\u306e\u53d6\u5f97\u306b\u5931\u6557\u3057\u307e\u3057\u305f\u3002\u30b9\u30c6\u30fc\u30bf\u30b9\u30b3\u30fc\u30c9: " + statusCode);\n}\n\n\/\/ NewQfile \u30af\u30e9\u30b9\u3092\u53c2\u7167\nconst NewQfile = Java.type("com.questetra.bpms.core.event.scripttask.NewQfile");\n\n\/\/ \u30d0\u30a4\u30c8\u5217\u304b\u3089\u30d5\u30a1\u30a4\u30eb\u30aa\u30d6\u30b8\u30a7\u30af\u30c8\u3092\u751f\u6210\nconst newFile = new NewQfile("report.pdf", "application\/pdf", response.getResponse());\n\n\/\/ \u30d5\u30a1\u30a4\u30eb\u578b\u30c7\u30fc\u30bf\u9805\u76ee\u306b\u66f8\u304d\u8fbc\u3080\nconst fileList = new java.util.ArrayList();\nfileList.add(newFile);\nengine.setDataByVarName("q_downloaded_file", fileList);<\/code><\/pre><\/div>\n\n\n\n
    Java.type()<\/code> \u306b\u3064\u3044\u3066<\/strong> Java.type(\"\u30af\u30e9\u30b9\u306e\u30d5\u30eb\u4fee\u98fe\u540d\")<\/code> \u306f\u3001GraalJS \u304c\u63d0\u4f9b\u3059\u308b Java \u30af\u30e9\u30b9\u53c2\u7167\u306e\u53d6\u5f97\u8a18\u6cd5\u3067\u3059\u3002\u8fd4\u308a\u5024\u3092\u4e00\u5ea6\u5909\u6570\uff08\u4e0a\u306e\u4f8b\u3067\u306f NewQfile<\/code>\uff09\u306b\u53d7\u3051\u3066\u304a\u3051\u3070\u3001\u305d\u308c\u4ee5\u964d\u306f\u77ed\u3044\u540d\u524d\u3067\u7e70\u308a\u8fd4\u3057\u4f7f\u3048\u307e\u3059\u3002<\/p>\n\n\n\n
    \u3082\u3061\u308d\u3093 new com.questetra.bpms.core.event.scripttask.NewQfile(...)<\/code> \u306e\u3088\u3046\u306b\u30d5\u30eb\u4fee\u98fe\u540d\u3092\u76f4\u63a5\u66f8\u304f\u3053\u3068\u3082\u3067\u304d\u307e\u3059\uff08\u610f\u5473\u306f\u540c\u3058\u3067\u3059\uff09\u3002\u672c\u8a18\u4e8b\u3067\u306f\u30af\u30e9\u30b9\u540d\u304c\u9577\u304f\u8907\u6570\u7b87\u6240\u3067\u4f7f\u3046\u305f\u3081\u3001Java.type()<\/code> \u3067\u77ed\u7e2e\u3059\u308b\u66f8\u304d\u65b9\u3092\u63a1\u7528\u3057\u3066\u3044\u307e\u3059\u3002<\/p>\n\n\n\n
    NewQfile<\/code> \u306e\u30b3\u30f3\u30b9\u30c8\u30e9\u30af\u30bf<\/strong> \u5f15\u6570\u306f \u30d5\u30a1\u30a4\u30eb\u540d \/ Content-Type \/ ByteArrayWrapper<\/code><\/strong>\uff08\u307e\u305f\u306f\u6587\u5b57\u5217\uff09\u306e\u9806\u3067\u3059\u3002ByteArrayWrapper<\/code> \u306f\u30b9\u30af\u30ea\u30d7\u30c8\u5074\u304b\u3089\u306f\u65b0\u898f\u751f\u6210\u3067\u304d\u305a\u3001HTTP \u30ec\u30b9\u30dd\u30f3\u30b9\u304b\u3089\u3057\u304b\u53d6\u308a\u51fa\u305b\u306a\u3044<\/strong> \u5236\u7d04\u304c\u3042\u308b\u305f\u3081\u3001HTTP \u7d4c\u7531\u3067\u53d6\u5f97\u3057\u305f\u30c7\u30fc\u30bf\u3092\u305d\u306e\u307e\u307e\u30d5\u30a1\u30a4\u30eb\u5316\u3059\u308b\u7528\u9014\u306b\u5411\u3044\u3066\u3044\u307e\u3059\u3002<\/p>\n\n\n\n
    \n\n\n\n
    \u5b9f\u8df5\u4f8b\uff1aPDF \u3092\u53d6\u5f97\u3057\u3066\u6dfb\u4ed8\u30d5\u30a1\u30a4\u30eb\u3068\u3057\u3066\u4fdd\u5b58\u3059\u308b<\/h2>\n\n\n\n
    \u6ce8\u6587 ID \u3092\u3082\u3068\u306b\u5916\u90e8\u30b7\u30b9\u30c6\u30e0\u304b\u3089 PDF \u3092\u53d6\u5f97\u3057\u3001\u30d5\u30a1\u30a4\u30eb\u578b\u30c7\u30fc\u30bf\u9805\u76ee\u306b\u683c\u7d0d\u3059\u308b\u4f8b\u3067\u3059\u3002<\/p>\n\n\n\n
    \/\/ \u6ce8\u6587 ID \u3092\u53d6\u5f97\nconst orderId = engine.findDataByVarName("q_order_id");\nif (orderId === null) {\n  throw new Error("\u6ce8\u6587 ID \u304c\u5165\u529b\u3055\u308c\u3066\u3044\u307e\u305b\u3093");\n}\n\n\/\/ \u8a8d\u8a3c\u8a2d\u5b9a\u3092\u53d6\u5f97\nconst setting = httpClient.findAuthSetting("\u53d7\u767a\u6ce8\u30b7\u30b9\u30c6\u30e0", false);\n\n\/\/ PDF \u3092\u53d6\u5f97\nconst response = httpClient.begin()\n  .authSetting(setting)\n  .get("https:\/\/api.example.com\/orders\/" + encodeURIComponent(orderId) + "\/pdf");\n\nconst statusCode = response.getStatusCode();\nif (statusCode < 200 || statusCode >= 300) {\n  engine.log("\u30a8\u30e9\u30fc\u30ec\u30b9\u30dd\u30f3\u30b9: " + response.getResponseAsString());\n  throw new Error("PDF \u306e\u53d6\u5f97\u306b\u5931\u6557\u3057\u307e\u3057\u305f\u3002\u30b9\u30c6\u30fc\u30bf\u30b9\u30b3\u30fc\u30c9: " + statusCode);\n}\n\n\/\/ \u30d5\u30a1\u30a4\u30eb\u578b\u30c7\u30fc\u30bf\u9805\u76ee\u306b\u4fdd\u5b58\nconst NewQfile = Java.type("com.questetra.bpms.core.event.scripttask.NewQfile");\nconst pdfFile  = new NewQfile("order_" + orderId + ".pdf", "application\/pdf", response.getResponse());\n\nconst fileList = new java.util.ArrayList();\nfileList.add(pdfFile);\nengine.setDataByVarName("q_order_pdf", fileList);\n\nengine.log("PDF \u3092\u4fdd\u5b58\u3057\u307e\u3057\u305f: order_" + orderId + ".pdf");<\/code><\/pre><\/div>\n\n\n\n
    \n\n\n\n
    \u8a2d\u8a08\u4e0a\u306e\u6ce8\u610f<\/h2>\n\n\n\n
    \u30d5\u30a1\u30a4\u30eb\u64cd\u4f5c\u3092\u542b\u3080\u30b9\u30af\u30ea\u30d7\u30c8\u30bf\u30b9\u30af\u3067\u306f\u3001\u5b9f\u884c\u6642\u9593\uff08\u6700\u5927 30 \u79d2<\/strong>\uff09\u306b\u7279\u306b\u6ce8\u610f\u304c\u5fc5\u8981\u3067\u3059\u3002\u5927\u5bb9\u91cf\u30d5\u30a1\u30a4\u30eb\u306e\u30a2\u30c3\u30d7\u30ed\u30fc\u30c9\u30fb\u30c0\u30a6\u30f3\u30ed\u30fc\u30c9\u306f\u6642\u9593\u304c\u304b\u304b\u308b\u305f\u3081\u3001\u5bfe\u8c61\u30d5\u30a1\u30a4\u30eb\u306e\u30b5\u30a4\u30ba\u3092\u8003\u616e\u3057\u3066\u8a2d\u8a08\u3057\u3066\u304f\u3060\u3055\u3044\u3002file.getLength()<\/code> \u3067\u4e8b\u524d\u306b\u30b5\u30a4\u30ba\u3092\u78ba\u8a8d\u3057\u3001\u60f3\u5b9a\u5916\u306b\u5927\u304d\u3044\u5834\u5408\u306f\u51e6\u7406\u3092\u30b9\u30ad\u30c3\u30d7\u3059\u308b\u3001\u3068\u3044\u3063\u305f\u30ac\u30fc\u30c9\u3092\u5165\u308c\u308b\u306e\u3082\u6709\u52b9\u3067\u3059\u3002<\/p>\n\n\n\n
    \n\n\n\n
    \u95a2\u9023\u30ea\u30d5\u30a1\u30ec\u30f3\u30b9<\/h2>\n\n\n\n