{"id":188431,"date":"2026-07-01T16:25:55","date_gmt":"2026-07-01T07:25:55","guid":{"rendered":"https:\/\/support.questetra.com\/?p=188431"},"modified":"2026-07-01T16:36:31","modified_gmt":"2026-07-01T07:36:31","slug":"excel-row-append-2026","status":"publish","type":"post","link":"https:\/\/support.questetra.com\/en\/addons\/excel-row-append-2026\/","title":{"rendered":"Microsoft 365 Excel: Append New Row"},"content":{"rendered":"\n

Microsoft 365 Excel: Append New Row<\/strong><\/h4>\n\n\n\n

Microsoft 365 Excel: \u884c\u8ffd\u52a0<\/a><\/p>\n\n\n\n

Adds new cells after the last row with data in a sheet.<\/p>\n\n\n\n

\"Auto<\/figure>\n\n\n\n
\n
Configs for this Auto Step<\/summary>
\n
\n
conf_OAuth2<\/dt>
C1: OAuth2 Setting *<\/span><\/dd>\n
conf_Url<\/dt>
C2: Target Book URL *<\/span><\/dd>\n
conf_Title<\/dt>
C3: Target Sheet Title *<\/span>#{EL}<\/sup><\/span><\/dd>\n
conf_Range<\/dt>
C4: Column Range to Append (e.g. “A:O”)(Up to 15 columns) *<\/span><\/dd>\n
conf_Column1<\/dt>
C5_1: 1st Column Value of Inserted Row#{EL}<\/sup><\/span><\/dd>\n
conf_Column2<\/dt>
C5_2: 2nd Column Value of New Row#{EL}<\/sup><\/span><\/dd>\n
conf_Column3<\/dt>
C5_3: 3rd Column Value of New Row#{EL}<\/sup><\/span><\/dd>\n
conf_Column4<\/dt>
C5_4: 4th Column Value of New Row#{EL}<\/sup><\/span><\/dd>\n
conf_Column5<\/dt>
C5_5: 5th Column Value of New Row#{EL}<\/sup><\/span><\/dd>\n
conf_Column6<\/dt>
C5_6: 6th Column Value of New Row#{EL}<\/sup><\/span><\/dd>\n
conf_Column7<\/dt>
C5_7: 7th Column Value of New Row#{EL}<\/sup><\/span><\/dd>\n
conf_Column8<\/dt>
C5_8: 8th Column Value of New Row#{EL}<\/sup><\/span><\/dd>\n
conf_Column9<\/dt>
C5_9: 9th Column Value of New Row#{EL}<\/sup><\/span><\/dd>\n
conf_Column10<\/dt>
C5_10: 10th Column Value of New Row#{EL}<\/sup><\/span><\/dd>\n
conf_Column11<\/dt>
C5_11: 11th Column Value of New Row#{EL}<\/sup><\/span><\/dd>\n
conf_Column12<\/dt>
C5_12: 12th Column Value of New Row#{EL}<\/sup><\/span><\/dd>\n
conf_Column13<\/dt>
C5_13: 13th Column Value of New Row#{EL}<\/sup><\/span><\/dd>\n
conf_Column14<\/dt>
C5_14: 14th Column Value of New Row#{EL}<\/sup><\/span><\/dd>\n
conf_Column15<\/dt>
C5_15: 15th Column Value of New Row#{EL}<\/sup><\/span><\/dd>\n
conf_RowNum<\/dt>
C6: Data item that stores the appended row number (update)<\/dd>\n\n<\/dl>\n<\/div><\/details><\/div>\n<\/div>\n\n\n\n
\n
Script (click to open)<\/summary>
\n
\n  \n\/\/ OAuth2 config sample at [OAuth 2.0 Setting]\n\/\/ - Authorization Endpoint URL: https:\/\/login.microsoftonline.com\/common\/oauth2\/v2.0\/authorize\n\/\/ - Token Endpoint URL: https:\/\/login.microsoftonline.com\/common\/oauth2\/v2.0\/token\n\/\/ - Scope: https:\/\/graph.microsoft.com\/Files.ReadWrite.All offline_access\n\/\/ - Consumer Key: (Get by Microsoft Azure Active Directory)\n\/\/ - Consumer Secret: (Get by Microsoft Azure Active Directory)\n\nconst GRAPH_URI = \"https:\/\/graph.microsoft.com\/v1.0\/\";\n\nconst COLUMN_NUM = 15;\n\nmain();\nfunction main(){\n  \/\/\/\/ == Config Retrieving \/ \u5de5\u7a0b\u30b3\u30f3\u30d5\u30a3\u30b0\u306e\u53c2\u7167 ==\n  const oauth2 = configs.getObject( \"conf_OAuth2\" );\n  const bookUrl = retrieveBookUrl();\n  const sheetName = configs.get( \"conf_Title\" ) + \"\";\n  if(sheetName === \"\" || sheetName === null){\n    throw \"Sheet Title is empty.\";\n  }\n\n  const range = configs.get( \"conf_Range\" );\n\n  let values = [];\n  retrieveValues( range, values );\n\n  \/\/\/\/ == Calculating \/ \u6f14\u7b97 ==\n  \/\/ Access to the API 1st(Get Book Info)\n  const bookInfo = getFileInfoByUrl( bookUrl, oauth2 );\n  const worksheetId = getWorksheetId(bookInfo, sheetName, oauth2);\n\n  \/\/ Access to the API 2nd(Get Last Row Number)\n  const lastRow = getLastRowNumber( bookInfo, worksheetId, oauth2 );\n  const rowNumber = lastRow + 1;\n\n  \/\/ Access to the API 3rd(PATCH)\n  patchData( bookInfo, worksheetId, rowNumber, values, range, oauth2);\n\n  const dataId = configs.get( \"conf_RowNum\" );\n  if ( dataId ){\n    engine.setDataByNumber( dataId, rowNumber + \"\" );\n  }\n}\n\n\/**\n  * config \u304b\u3089\u30d6\u30c3\u30af\u306e URL \u3092\u8aad\u307f\u51fa\u3059\u3001\u7a7a\u306a\u3089\u30a8\u30e9\u30fc\n  * @return {String} \u30d6\u30c3\u30af\u306e URL\n  *\/\nfunction retrieveBookUrl() {\n  const bookUrlDef = configs.getObject( \"conf_Url\" );\n  let bookUrl;\n  if ( bookUrlDef === null ) {\n    bookUrl = configs.get( \"conf_Url\" )\n  }else{\n    bookUrl = engine.findData( bookUrlDef );\n  }\n  if ( bookUrl === \"\" || bookUrl === null){\n    throw \"Book URL is empty.\"\n  }\n  return bookUrl;\n}\n\n\/**\n  * \u6307\u5b9a\u3055\u308c\u305f\u7bc4\u56f2\u3092\u8003\u616e\u3057\u3064\u3064\u8ffd\u52a0\u30c7\u30fc\u30bf\u3092\u6e96\u5099\n  * \u7bc4\u56f2\u3092\u512a\u5148\u3057\u3001\u7bc4\u56f2\u5916\u306e\u6307\u5b9a\u30c7\u30fc\u30bf\u9805\u76ee\u306f\u7121\u8996\u3059\u308b\n  * @param {Array} range  \u7bc4\u56f2\u306e\u914d\u5217\n  * @param {Array} values  \u8ffd\u52a0\u30c7\u30fc\u30bf\u306e\u914d\u5217\n  *\/\nfunction retrieveValues( range, values ) {\n\n  \/\/range\u306e\u7bc4\u56f2\u306b\u5408\u308f\u305b\u3066\u30c7\u30fc\u30bf\u3092\u6e96\u5099\u3001\u6700\u5927\u6570\u306e\u5236\u9650\u3042\u308a\n  const rangeArr = range.split(':');\n  const from = convertA1toR1C1(rangeArr[0] + \"\");\n  const to = convertA1toR1C1(rangeArr[1] + \"\");\n  const target = to - from + 1;\n  let limit = COLUMN_NUM;\n  if (target <= COLUMN_NUM) {\n    limit = target;\n  }\n\n  for (let i = 0; i < limit; i++) {\n    const columnConfigName = `conf_Column${i+1}`;\n    const columnValue = configs.get( columnConfigName );\n    values.push( columnValue );\n  }\n}\n\n\/**\n  * \u30d5\u30a9\u30eb\u30c0\u306e URL \u304b\u3089\u30d5\u30a1\u30a4\u30eb\u60c5\u5831\uff08\u30c9\u30e9\u30a4\u30d6 ID \u3068\u30d5\u30a1\u30a4\u30eb ID\uff09\u3092\u53d6\u5f97\u3057\u3001\n  * \u30aa\u30d6\u30b8\u30a7\u30af\u30c8\u3067\u8fd4\u3059\uff08URL \u304c\u7a7a\u306e\u5834\u5408\u306f\u30a8\u30e9\u30fc\u3068\u3059\u308b\uff09\n  * @param {String} fileUrl  \u30d5\u30a9\u30eb\u30c0\u306e URL\n  * @param {String} oauth2  OAuth2 \u8a2d\u5b9a\n  * @return {Object} fileInfo  \u30d5\u30a1\u30a4\u30eb\u60c5\u5831 {driveId, fileId}\n  *\/\nfunction getFileInfoByUrl( fileUrl, oauth2 ) {\n  let fileInfo;\n  if ( fileUrl !== \"\" && fileUrl !== null ) {\n    \/\/ \u5206\u5272\u4ee3\u5165\n    const {\n      id,\n      parentReference: {\n        driveId\n      }\n    } = getObjBySharingUrl( fileUrl, oauth2 );\n    fileInfo = {driveId: `drives\/${driveId}`, fileId: id};\n  }\n  return fileInfo;\n}\n\n\/**\n  * OneDrive \u306e\u30c9\u30e9\u30a4\u30d6\u30a2\u30a4\u30c6\u30e0\uff08\u30d5\u30a1\u30a4\u30eb\u3001\u30d5\u30a9\u30eb\u30c0\uff09\u306e\u30e1\u30bf\u30c7\u30fc\u30bf\u3092\u53d6\u5f97\u3057\u3001JSON \u30aa\u30d6\u30b8\u30a7\u30af\u30c8\u3092\u8fd4\u3059\n  * API \u306e\u4ed5\u69d8\uff1ahttps:\/\/docs.microsoft.com\/ja-jp\/onedrive\/developer\/rest-api\/api\/shares_get?view=odsp-graph-online\n  * @param {String} sharingUrl  \u30d5\u30a1\u30a4\u30eb\u306e\u5171\u6709 URL\n  * @param {String} oauth2  OAuth2 \u8a2d\u5b9a\n  * @return {Object} responseObj  \u30c9\u30e9\u30a4\u30d6\u30a2\u30a4\u30c6\u30e0\u306e\u30e1\u30bf\u30c7\u30fc\u30bf\u306e JSON \u30aa\u30d6\u30b8\u30a7\u30af\u30c8\n  *\/\nfunction getObjBySharingUrl( sharingUrl, oauth2 ) {\n  if (sharingUrl === \"\" || sharingUrl === null) {\n    throw `Sharing URL is empty.`;\n  }\n\n  \/\/ encoding sharing URL\n  const encodedSharingUrl = encodeSharingUrl(sharingUrl);\n\n  \/\/ API Request\n  const response = httpClient.begin()\n    .authSetting( oauth2 )\n    .get( `${GRAPH_URI}shares\/${encodedSharingUrl}\/driveItem` );\n\n  const responseStr = logAndJudgeError(response, \"GET\");\n\n  return JSON.parse( responseStr );\n}\n\n\/**\n  * \u5171\u6709URL\u3092unpadded base64url \u5f62\u5f0f\u306b\u30a8\u30f3\u30b3\u30fc\u30c9\u3059\u308b\n  * @param {String} sharingUrl  \u5171\u6709 URL\n  * @return {String} encodedSharingUrl  \u30a8\u30f3\u30b3\u30fc\u30c9\u3055\u308c\u305f\u5171\u6709 URL\n  *\/\nfunction encodeSharingUrl( sharingUrl ) {\n  let encodedSharingUrl = base64.encodeToUrlSafeString( sharingUrl );\n  while ( encodedSharingUrl.slice(-1) === '=' ) {\n    encodedSharingUrl = encodedSharingUrl.slice(0,-1);\n  }\n  return `u!${encodedSharingUrl}`;\n}\n\n\/**\n  * \u30ef\u30fc\u30af\u30b7\u30fc\u30c8\u306e ID \u3092\u53d6\u5f97\u3059\u308b\n  * @param {Object} bookInfo\n  * @param {String} bookInfo.driveId  \u30ef\u30fc\u30af\u30d6\u30c3\u30af\u306e\u30c9\u30e9\u30a4\u30d6 ID\n  * @param {String} bookInfo.fileId  \u30ef\u30fc\u30af\u30d6\u30c3\u30af\u306e\u30d5\u30a1\u30a4\u30eb ID\n  * @param {String} sheetName  \u30b7\u30fc\u30c8\u306e\u540d\u524d\n  * @param {String} oauth2  OAuth2 \u8a2d\u5b9a\n  *\/\nfunction getWorksheetId({driveId, fileId}, sheetName, oauth2) {\n    const getWorksheetsUrl = `${GRAPH_URI}${driveId}\/items\/${fileId}\/workbook\/worksheets`;\n    const response = httpClient.begin()\n        .authSetting(oauth2)\n        .get(getWorksheetsUrl);\n\n    const responseStr = logAndJudgeError(response, \"2nd GET\");\n    const jsonRes = JSON.parse(responseStr);\n    const worksheet = jsonRes.value.find(worksheet => worksheet.name === sheetName);\n    if (worksheet === undefined) {\n        throw 'Worksheet not found.';\n    }\n    return worksheet.id;\n}\n\n\/**\n  * \u6700\u7d42\u884c\u306e\u884c\u756a\u53f7\u3092\u3068\u308b\n  * @param {Object} bookInfo\n  * @param {String} bookInfo.driveId  \u30ef\u30fc\u30af\u30d6\u30c3\u30af\u306e\u30c9\u30e9\u30a4\u30d6 ID\n  * @param {String} bookInfo.fileId  \u30ef\u30fc\u30af\u30d6\u30c3\u30af\u306e\u30d5\u30a1\u30a4\u30eb ID\n  * @param {String} worksheetId  \u30b7\u30fc\u30c8\u306e ID\n  * @param {String} oauth2  OAuth2 \u8a2d\u5b9a\n  *\/\nfunction getLastRowNumber( {driveId, fileId}, worksheetId, oauth2 ){\n\n  const getUri = `${GRAPH_URI}${driveId}\/items\/${fileId}\/workbook\/worksheets\/${encodeURIComponent(worksheetId)}\/usedRange\/`;\n  const response = httpClient.begin()\n    .authSetting( oauth2 )\n    .get( getUri );\n\n  const responseStr = logAndJudgeError(response, \"GET\");\n  const jsonObj = JSON.parse( responseStr );\n\n  \/\/\u53d6\u5f97\u3067\u304d\u305f\u30c7\u30fc\u30bf\u306e\u7bc4\u56f2\n  \/\/ Index \u306f0\u59cb\u307e\u308a\u3001Count \u306f\u5217\u3084\u884c\u6570\n  \/\/ \u4f8b\u3048\u3070 rowIndex \u304c2\u3067\u3001rowCount \u304c3\u306a\u3089\u30013\u884c\u76ee\u59cb\u307e\u308a\u30675\u884c\u76ee\u307e\u3067\u5024\u3042\u308a\n  const rowIndex = jsonObj.rowIndex;\n  const rowCount = jsonObj.rowCount;\n\n  return rowIndex + rowCount;\n}\n\n\/**\n  * \u6307\u5b9a\u30b7\u30fc\u30c8\u306e\u6307\u5b9a\u884c\u306b\u30c7\u30fc\u30bf\u3092\u5165\u529b\u3059\u308b\n  * @param {Object} bookInfo\n  * @param {String} bookInfo.driveId  \u30ef\u30fc\u30af\u30d6\u30c3\u30af\u306e\u30c9\u30e9\u30a4\u30d6 ID\n  * @param {String} bookInfo.fileId  \u30ef\u30fc\u30af\u30d6\u30c3\u30af\u306e\u30d5\u30a1\u30a4\u30eb ID\n  * @param {String} worksheetId  \u30b7\u30fc\u30c8\u306e ID\n  * @param {Number} rowNumber  \u633f\u5165\u7b87\u6240\u306e\u884c\u756a\u53f7\n  * @param {Array} values  \u633f\u5165\u3059\u308b\u30c7\u30fc\u30bf\u306e\u914d\u5217\n  * @param {String} range  \u633f\u5165\u3059\u308b\u5217\u7bc4\u56f2\n  * @param {String} oauth2  OAuth2 \u8a2d\u5b9a\n  *\/\nfunction patchData( {driveId, fileId}, worksheetId, rowNumber, values, range, oauth2 ){\n\n  const rangeArr = range.split(':');\n\n  const patchUri = `${GRAPH_URI}${driveId}\/items\/${fileId}\/workbook\/worksheets\/${encodeURIComponent(worksheetId)}\/range(address='${rangeArr[0]}${rowNumber}:${rangeArr[1]}${rowNumber}')\/`;\n  const requestBody = makeRequestToAdd(values);\n\n  const response = httpClient.begin()\n    .authSetting( oauth2 )\n    .body( JSON.stringify(requestBody), \"application\/json\" )\n    .patch( patchUri );\n  \n  logAndJudgeError(response, \"PATCH\");\n}\n\n\/**\n  * \u65b0\u3057\u3044\u884c\u306b\u8ffd\u52a0\u3059\u308b\u30c7\u30fc\u30bf\u3092\u3001JSON \u5f62\u5f0f\u306b\u5909\u63db\u3059\u308b\n  * @param {Array} values  \u30c7\u30fc\u30bf\u306e\u5165\u3063\u305f\u914d\u5217\n  * @return {JSON Object} \u5909\u63db\u3057\u305f JSON \u30aa\u30d6\u30b8\u30a7\u30af\u30c8\n  *\/\nfunction makeRequestToAdd(values){\n  let request = {\n    values : [[]]\n  };\n  for(let i = 0; i < values.length; i++){\n    if(values[i] === \"\" || values[i] === null){\n      request.values[0].push(null);\n    }else{\n      if(values[i].length > 32767){\n        throw \"Can't set text over 32,767 character.\";\n      }\n      request.values[0].push(values[i]);\n    }\n  }\n  return request;\n}\n\n\/**\n  * \u5217\u3092\u6307\u5b9a\u3059\u308b\u30a2\u30eb\u30d5\u30a1\u30d9\u30c3\u30c8\u3092\u6570\u5024\u5909\u63db\u3059\u308b\uff08\u4f8b\uff1aA\u21921\u3001C\u21923\uff09\n  * @param {String} columnString \u5217\u3092\u6307\u5b9a\u3059\u308b\u30a2\u30eb\u30d5\u30a1\u30d9\u30c3\u30c8\n  * @return {Number} num \u30a2\u30eb\u30d5\u30a1\u30d9\u30c3\u30c8\u306b\u5bfe\u5fdc\u3057\u305f\u6570\u5024\n  *\/\nfunction convertA1toR1C1(columnString) {\n  const RADIX = 26;\n  const A = 'A'.charCodeAt(0);\n  let str = columnString.toUpperCase();\n  let num = 0;\n  let strLength = str.length;\n  for (let i = 0; i < strLength; i++) {\n    num = (num * RADIX) + (str.charCodeAt(i) - A + 1);\n  }\n  return num;\n}\n\n\/**\n  * \u30ed\u30b0\u306e\u51fa\u529b\u3068\u3001\u30a8\u30e9\u30fc\u767a\u751f\u6642\u306e\u30b9\u30ed\u30fc\u3092\u884c\u3046\n  * @param {HttpResponseWrapper} response  \u30ea\u30af\u30a8\u30b9\u30c8\u306e\u5fdc\u7b54\n  * @param {String} requestType \u30ea\u30af\u30a8\u30b9\u30c8\u3092\u3069\u306e\u5f62\u5f0f\u3067\u884c\u3063\u305f\u304b(\"GET\" or \"POST\" or \"PATCH\")\n  * @return {String} responseStr \u30ec\u30b9\u30dd\u30f3\u30b9\u306e\u6587\u5b57\u5217\n  *\/\nfunction logAndJudgeError(response, requestType){\n  const responseStr = response.getResponseAsString();\n  const status = response.getStatusCode();\n  if(status >= 300){\n    const accessLog = `---${requestType} request--- ${status}\\n${responseStr}\\n`;\n    engine.log(accessLog);\n    throw `Failed in ${requestType} request. status: ${status}`;\n  }\n  return responseStr;\n}\n<\/code><\/pre><\/div>\n<\/div><\/details><\/div>\n<\/div>\n\n\n\n
Download<\/span><\/h3>\n\n\n\n