Box: フォルダ作成 (Box: Create Folder)
Box の指定フォルダ内に新しいフォルダを作成し、フォルダ ID / URL を保存しま す。すでに同名のフォルダがある場合は、そのフォルダ ID / URL を保存します。
Configs
  • C1: OAuth2 設定 *
  • C2: 作成するフォルダの親フォルダの ID (空白の場合ルートフォルダに作成されます)#{EL}
  • C3: 作成するフォルダの名称 *#{EL}
  • C4: フォルダ ID を保存するデータ項目
  • C5: フォルダ URL を保存するデータ項目
Script (click to open)

main();
function main(){
  const newFolderName = configs.get("FolderName");
  checkNewFolderName(newFolderName);

  const parentFolderId = configs.get("ParentFolderId");
  
  // get OAuth2 Setting
  const oauth2 = configs.get("conf_OAuth2");

  const newFolderId = createFolder(oauth2, parentFolderId, newFolderName);

  const IdData = configs.get("FolderIdItem");
  const UrlData = configs.get("WebViewUrlItem");
  if (IdData !== null && IdData !== "") {
      engine.setDataByNumber(IdData, newFolderId);
  }
  if (UrlData !== null && UrlData !== "") {
      engine.setDataByNumber(UrlData, `https://app.box.com/folder/${newFolderId}`);
  }
}

/**
  * 新しいフォルダのフォルダ名をチェックする。(サポートされていない文字が使われていないか)
  */
function checkNewFolderName(newFolderName){

  //空ではないか
  if(newFolderName === "" ||newFolderName === null) {
    throw "Folder Name is blank";
  }

  //255文字を超えていないか
  if(newFolderName.length > 255){
    throw"Folder Name shoule be less than 256 characters";
  }

  //「/」や「\」が含まれていないか
  const reg = new RegExp('[/\\\\]');
  if(newFolderName.search(reg) !== -1) {
    throw "Invalid Folder Name";
  }

  //先頭と末尾に半角スペースが使われていないか
  if(newFolderName.slice(0,1) === " " || newFolderName.slice(-1) === " ") {
    throw "Invalid Folder Name";
  }

  //「.」や「..」ではないか
  if(newFolderName === "." || newFolderName === ".."){
    throw "Invalid Folder Name";
  }
}

//create folder on box
function createFolder(oauth2, parentFolderId, name) {
  let jsonReq = {};
  //mime type of google drive folder
  if (parentFolderId !== "" && parentFolderId !== null){
    jsonReq["parent"] = {"id": parentFolderId };
  }else{
    jsonReq["parent"]= {"id": 0 };
  }
  jsonReq["name"] = name;
  
  const url = 'https://api.box.com/2.0/folders';
  const response = httpClient.begin()
    .authSetting(oauth2)
    .body(JSON.stringify(jsonReq), "application/json; charset=UTF-8")
    .post(url);
  const status = response.getStatusCode();
  const responseTxt = response.getResponseAsString();

  engine.log(`status: ${status}`);
  engine.log(responseTxt);

  let jsonRes;
  try {
    jsonRes = JSON.parse(responseTxt);
  } catch(e) {
    engine.log("failed to parse as json");
    throw `Failed to create. status: ${status}`;
  }

  // フォルダ作成成功
  if (status === 201) {
    return jsonRes.id;
  }
  try {
    // 同名のフォルダがすでにある
    if(status === 409 && jsonRes.context_info.conflicts[0].type === "folder"){
      return jsonRes.context_info.conflicts[0].id;
    }
  } catch (e) {
    // 何もしない(上記2つのケース以外はすべてエラーにする)
  }
  throw `Failed to create. status: ${status}`;
}

Download

2021-03-19 (C) Questetra, Inc. (MIT License)
https://support.questetra.com/ja/addons/box-folder-create/
Addonファイルのインポートは Professional もしくは Enterprise でのみご利用いただけます

Notes

  1. フォルダ ID は、URL に含まれています。 https://{sub-domain}.app.box.com/folder/(Folder ID)
  2. Box のリフレッシュトークンには、期限があります。期限を超えないよう、定期的に利用する必要があります。(Box: トークンおよびURLの有効期限)

Capture

See also

%d人のブロガーが「いいね」をつけました。