【GAS】二次元配列で列単位でのIF条件設定方法

Question

前提

次の3つのスプレッドシートファイルがあります。
1)全体票
２)個票ひな形
３)個票ひな形のコピー

1)のイメージ

２)のイメージ　一部抜粋

実現したいこと

a：ファイル1)のB列にチェックを入れ、GAS実行すると、
指定フォルダ内にファイル2)をコピーしたファイル3)を作成する。
ファイル1)のD列、E列にファイル3)のファイルID、URLを転記する。
(複数行にチェックありの時には、複数ファイルを生成)

b：ファイル3)のファイル名を指定ファイル名に変更し、
ファイル3)のいくつかの項目内容をファイル1)から転記する。
(複数行にチェックありの時には、各ファイルに対し、同処理)

c:処理が完了したら、ファイル1)のC列にタイムスタンプを追記する。
最後に処理終了のポップアップメッセージを表示する。

d:処理の際、b列のどこにもチェックがなかった場合には、
処理中断する旨のポップアップメッセージを表示し、処理終了。

発生している問題・エラーメッセージ

dの処理がうまくできず困っています。
どのようにコード修正すればよいかアドバイスが欲しいです。

以下の方法でファイル1)の「b列のどこにもチェックがなかった」判別
をさせようと試みました。

(試みた方法)
二次元配列fromDetaの各行から一番はじめの要素0? 1?　flagのみを
spliceで抽出し、新たな配列flagArrを作成。
if条件で　flagArr === false　の時に、処理中止のメッセージを表示させ、
ループから抜ける想定。

<困っていること①>
console.log()で確認すると、flagArrの配列は取得自体はできている
ようなのですが、false３つ以外に想定していなかった後ろに' 'の要素が
いくつもついてきてしまい、spliceで抜きだしたいと思っていた通りに
抜けてきていないようです。
ちなみにconsole.log()でtargetRows想定通りの3となっています。
二次元配列の特定列の削除(抽出)の方法は、以前教えていただいた下リンク先
を参照しました。

以前の照会リンク

<困っていること②>
dの処理が失敗しているから、なのかもしれないですが、
「b列のどこにもチェックがなかった」場合でも、正常に処理終了したときの
メッセージが表示されてしまいます。
「b列のどこにもチェックがなかった」場合は、「処理終了」メッセージのみ
表示させ正常処理のメッセージは表示させないようにしたいのですが、
どのようにコード修正すればよいかアドバイスが欲しいです。

該当のソースコード

以下、コード全文記載します。
もし、ココをこう修正するともっとすっきりとわかりやすいコードになる、
というアドバイスがあれば併せてご教示いただけると助かります。

function createIndvSS() {

  /* (処理概要) 個票を作成
  ・全体票_案件シートの個票作成(B列)にチェックありの場合に処理 ★未完★
  ・ひな形ファイルtempSSをコピーし、全体票ファイル_【作業要シート】セルC12のフォルダに格納
  ・新設個票ファイルのファイル名を「個票_案件(氏名)」に変更する
  ・新設個票ファイルに全体票の内容を転記する
  ・全体票_案件シートのC列にタイムスタンプを追記する
  ・処理完了のポップアップメッセージを表示する
  */

  //個票ひな形ファイルのコピーを作成

  //▼個票ひな形ファイルtempSSの指定
  //URL https://docs.google.com/spreadsheets/d/～省略～/edit#gid=0
  //～省略～
  //ひな形ファイル(FromSS)のIDは全体票SS_【作業用】シートのセルC6から取得
  const AllSS = SpreadsheetApp.getActiveSpreadsheet();
  const AddrSheet = AllSS.getSheetByName('【作業用】');
  const tempId = AddrSheet.getRange(6, 3).getValue();
  console.log('tempId ' + tempId);
  const tempSS = DriveApp.getFileById(tempId);

  //▼新設個票ファイルの保存先フォルダToFの指定
  //URL https://drive.google.com/drive/～省略～
  //1cdHckGcAAbUlF7elu6Z-BFCLDh38W6C4
  //保存先フォルダToFのフォルダIDは全体票SS_【作業用】シートのセルC12から取得
  const toFolId = AddrSheet.getRange(12, 3).getValue();
  console.log('toFolId ' + toFolId);
  const toFol = DriveApp.getFolderById(toFolId);

  //全体票_案件シートのH列データあり最終行lastRowの取得
  const AllSheet = AllSS.getSheetByName('案件シート');
  const lastRow = AllSheet.getRange(AllSheet.getMaxRows(), 8).getNextDataCell(SpreadsheetApp.Direction.UP).getRow();
  console.log('lastRow ' + lastRow); //8が正解
  const targetRows = lastRow - 6
  console.log('targetRows ' + targetRows); //2が正解  

  //▼全体票_案件シートのB列～Y列の内容を二次元配列fromDetaとして取得
  const fromDeta = AllSheet.getRange(7, 2, targetRows, 24).getValues();
  console.log('fromDeta ' + fromDeta);

  for (let i = 0; i < targetRows; i++) {
    let flag = fromDeta[i][0];  //作成フラグ
    let case = fromDeta[i][6];  //案件
    let No1 = fromDeta[i][7];  //項目1
    let No2 = fromDeta[i][8];  //項目2
    let No3 = fromDeta[i][9];  //項目3
    let No5 = fromDeta[i][10]; //項目5
    let No6 = fromDeta[i][11]; //項目6
    let No7 = fromDeta[i][13]; //項目7
    let No9 = fromDeta[i][15]; //項目9
    let No10 = fromDeta[i][17]; //項目10
    let No11 = fromDeta[i][19]; //項目11
    let No12 = fromDeta[i][20]; //項目12
    let No14 = fromDeta[i][22]; //項目14
    let No15 = fromDeta[i][23]; //項目15 

    //個票作成フラグにチェックありの時だけ処理
    //ブランクの時は処理スキップ
    //　if(条件){ 
    //　　　　　　条件trueの時に行う処理
    //　　　　　}

    /*【条件①】//★うまくできない_ここから★　*****************************
    //個票作成フラグがALLブランクの時は、ポップアップMsgを表示して
    //処理中止

    //二次元配列fromDetaの各行から要素1のflagのみをspliceで抽出し、
    //新しい配列flagArrを作成する
    for (let i = 0; i < targetRows; i++) {
      const flagArr = fromDeta[i].splice(0, 1);
      console.log('targetRows ' + targetRows);      
      console.log('fromDeta[0] ' + fromDeta[0][0]);
      console.log('fromDeta[1] ' + fromDeta[1][0]);
      console.log('fromDeta[2] ' + fromDeta[2][0]);
      console.log('flagArr ' + flagArr);

      if (flagArr === false) {
        Browser.msgBox("個票作成フラグが選択されていません。\\nどの案件の個票を作成するか、指定してください。\\n処理を中止します。");
        return;
      }
    }
  　★ここまでうまくできない_ここまで★　**********************************/
    //【条件②】
    //個票作成フラグにチェックありtrueの時
    if (flag === true) {

      //▼新設個票ファイルのファイル名SSName指定
      //全体票SS_案件シートの案件(セルF7)_氏名(セルJ) 
      //★セル位置可変に変更要★
      const SSName1 = AllSheet.getRange(i + 7, 6).getValue();
      const SSName2 = AllSheet.getRange(i + 7, 10).getValue();
      const NewFileName = "個票_" + SSName1 + "(" + SSName2 + ")";　//新個票のファイル名
      console.log('NewFileName ' + NewFileName);

      //▼個票ひな形ファイルのコピーを作成  
      const newFile = tempSS.makeCopy(NewFileName, toFol);

      //▼新設個票のファイルID、URLの取得
      const newSSiD = newFile.getId();
      const newURL = newFile.getUrl();
      console.log('newSSiD ' + newSSiD);
      console.log('newURL ' + newURL);

      //▼新設個票のファイルID、URLを全体票_案件シートのD列とE列に転記
      //★行位置可変に変更要★
      AllSheet.getRange(i + 7, 4).setValue(newSSiD);
      AllSheet.getRange(i + 7, 5).setValue(newURL);
      SpreadsheetApp.flush();

      //▼配列fromDetaとして取得した内容を新設個票IndvSS_経過シートに転記
      const IndvSS = SpreadsheetApp.openById(newSSiD);
      const IndvSheet = IndvSS.getSheetByName('経過シート');
      IndvSheet.getRange(2, 5, 1, 1).setValue(case);　　//案件(セルE2)の転記
      IndvSheet.getRange(4, 5, 1, 1).setValue(No2);　  //項目2(セルE4)の転記
      IndvSheet.getRange(5, 5, 1, 1).setValue(No5); 　  //項目5(セルE5)の転記
      IndvSheet.getRange(6, 5, 1, 1).setValue(No3); 　  //項目3(セルE6)の転記  
      IndvSheet.getRange(7, 5, 1, 1).setValue(No4); 　  //項目4(セルE7)の転記
      IndvSheet.getRange(10, 5, 1, 1).setValue(No6);  //項目6(セルE10)の転記   
      IndvSheet.getRange(10, 6, 1, 1).setValue(No7);  //項目7(セルF10)の転記
      IndvSheet.getRange(11, 5, 1, 1).setValue(No9);  //項目9(セルE11)の転記   
      IndvSheet.getRange(11, 6, 1, 1).setValue(No10);  //項目10(セルF11)の転記   
      IndvSheet.getRange(12, 5, 1, 1).setValue(No11);  //項目11(セルE12)の転記   
      IndvSheet.getRange(12, 6, 1, 1).setValue(No13);  //項目13(セルF12)の転記             
      IndvSheet.getRange(13, 5, 1, 1).setValue(No14);  //項目14(セルE13)の転記   
      IndvSheet.getRange(13, 6, 1, 1).setValue(No15);  //項目15 (セルF13)の転記   

      //▼全体票_案件シートのC列にタイムスタンプ追記
      const timeStamp = new Date();
      console.log("timeStamp " + timeStamp);

      //getRange(●行目,列目,行分,列分)
      //7　+　ループ処理回数i　行目
      AllSheet.getRange(i + 7, 3, 1, 1).setValue(timeStamp);
    }
  }
  //▼処理完了Msgの表示
  //処理が詰まらないように強制実行
  SpreadsheetApp.flush();
  Browser.msgBox("全体票ファイル_【作業用】シート_セルC12で指定したフォルダ内に個票ファイルを作成しました。\\n個票ファイル上に情報を転記済です。\\n適宜、個票ファイルをご確認ください。");
}

補足情報

次回から類似のケースなら自分で解決できるようになりたいので
(残念ながら、なかなかそのレベルに到達できずにいますが、、、)
回答は急ぎませんので非エンジニアビギナーでも理解できるレベル
での解説、アドバイスをいただけると助かります。

お忙しいところお手を煩わせて申し訳ありません。
よろしくお願いいたします。

Answer 1

• 「チェックボックスに1つもチェックがない」というのは、言い方を変えると「trueが0こ」です。
  • 取得してきた2次元配列を.fliter()でtrueをもつものだけに絞り、
    • 絞った2次元配列の長さが0なら → 1つもチェックされていない。
    • 長さが1以上なら → 1つまたはそれ以上がチェックされている。という考え方です。
• 質問者様のコードをじっくりとは見ていないのですが、どうやら、チェックが1つもなかった場合にしなくてもいい処理も最初に全部しているような気がします。
  • しなくてもいい処理は、チェックボックスの判定した後にするようにしましょう。
• 1つの関数のなかにたくさんの処理をかくことは、コードの可読性の観点からあまりよくありません。
  • 長すぎる場合＆汎用性のある処理は、なるべく別関数にしましょう。

コード例

function createIndvSS() {
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  const sheet = ss.getActiveSheet();
  const lastRow = sheet.getLastRow();

  // 1つでもチェックされているかどうかの判定
  const flag = isChecked(sheet, 2, lastRow, 1); // 例　true
  
  // flagがfalseなら（1つもチェックされていなかったら）
  if (!flag) {
    // 「処理中断のお知らせ」のメッセージボックスが表示されて、
    
    // 処理を中断する（関数をここで終了。以降の行は実行されない）
    return;
  }

  // ここ以降に、チェックされた行がある場合の処理を書く
}

/**
 * スプレッドシートからチェックボックスの値を全て取得し、その2次元配列の中にtrueが含まれるか判定する関数
 * @param {object} sheet チェックボックスのあるシート
 * @param {number} startRow 開始行番号
 * @param {number} lastRow 最終行番号
 * @param {number} col チェックボックスのある列番号
 * @return {boolean} trueが1つでもあれば、true。なければfalse
 */
function isChecked(sheet, startRow, lastRow, col) {
  const allValues = sheet.getRange(startRow, col, lastRow-startRow+1).getValues();
  // 例　[ [ true ], [ false ], [ true ], [ false ], [ false ] ]

  const trueValues = allValues.filter(arr => arr[0]);
  // 例　[ [ true ], [ true ] ]

  return trueValues.length > 0; // 例　true
}

---

ご質問への回答

①isCheckedの後ろの(sheet, startRow, lastRow, col)は、isChecked関数に渡す値(引数)かと。引数指定の要否、何を引数として指定するかはどのように判断すればよいのですか?

isChecked()関数に限らず、関数を作成する際は汎用性を持たせる（他でも使い回しやすい）ようにしています。
ですので何を引数として指定するのかはコードの作成者の好みです。
（なので、質問者様の使いやすいように引数などアレンジしていただいて大丈夫です）
使いまわさないのであれば引数は不要です。

---

②filter()は、配列の要素１つずつに対して、条件に合致するか見ていき、合致したもの 　だけを集めて、新たな配列trueValuesを作る、であっていますか?

あっています💮

すべてfalseの時、 　trueを混ぜた時ともに 　console.log(trueValues )、console.log(trueValues.length)、で確認できませんでした。

私のエディタでは問題なくconsole.log(trueValues)もconsole.log(trueValues.length)も確認できているので、質問者様の方でできない理由は不明です。
正しく理解はできていますが、試したコードかスプレッドシート側かもしくは確認方法が間違っている可能性があります。
もしよかったら詳細を教えてくださいませ。

---

③filter(arr => arr[0])の部分がよくわかりません。arr => arr[0]は、arr[0]は配列の要素0のことで、arrにarr[0]の値を代入すると 　いうことを指示している??

違います。
質問者様はアロー関数について理解する必要があります。

アロー関数について

ES6から登場した新しい関数の記法です。
従来のfunctionキーワードによる関数より簡略した書き方をすることができます。
他に機能的な違いもありますが今回は関係ないので説明を割愛します。

// 従来の関数
function oldFunc(number) {
  return number * 10;
}
console.log( oldFunc(5) ); // 50

// アロー関数
const newFunc = (number) => {
  return number * 10;
}
console.log( newFunc(6) ); // 60

• アロー関数は引数が1つだけの場合()を省略可能です。
• 処理が1行だけの場合、returnを省略可能です。

よって、より簡潔に↑のアロー関数を書くと以下のようになります。

const newFunc = number => number * 10;

してがって、こういうことです。

// アロー関数
const trueValues = allValues.filter(arr => arr[0]);

// 従来の書き方
var trueValues = allValues.filter( function(arr) {
  return arr[0];
} );

• allValuesは、2次元配列。
• 引数のarrは、その各要素（1次元配列）を表現。
• arr[0]は、各要素（1次元配列）の0番目の要素を指定して、（省略しているけど）returnで値を戻しており、その値はtrue or falseです。

.filter()について

配列.filter(コールバック関数)

• .filter()は、コールバック関数からreturn戻された条件に合致する要素のみに絞り、新しい配列を生成するメソッドです。
• 「条件」なのでtrueかfalseをreturnする（戻す）ことになります。
• 今回の場合「arr[0]の値がtrueだった場合true、そうじゃない場合はfalse」を戻すわけですから、
  • 丁寧に書くとreturn arr[0] === trueが条件式になるわけです。
  • でもarr[0]の値は元からbooleanなので、そんなことしなくてもその値そのものをreturnするだけですみます。

Comments

[donguriko]

Cocodeさま
お忙しい中回答ありがとうございます。
すみません、当方の知識が乏しく何点かわからない点があるので教えてください。
特に　functionの後ろに(引数)がある関数と　filter()の使い方について理解が
追い付かず消化不良気味です。。。
配列の時も苦戦しましたが、大きな壁にぶつかっている感じです。
以下、とんちんかんな質問でしたら申し訳ありません。

①isCheckedの後ろの(sheet, startRow, lastRow, col)は、
　isChecked関数に渡す値(引数)かと。
　引数指定の要否、何を引数として指定するかはどのように判断すればよいのですか?

②filter()は、配列の要素１つずつに対して、条件に合致するか見ていき、合致したもの
　だけを集めて、新たな配列trueValuesを作る、であっていますか?
　記載いただいたコードを自分で写経し、チェックボックスのチェックを入れたり
　外したりして、trueValuesがどう変わるのかを見ようとconsole.logでの確認を試みました。

　配列trueValuesには、filter()で指定した条件に合致した要素だけが集められる筈なので、
　条件でtrueのものだけ集めるとすれば２つチェックを入れると例で記載いだいた
　[ [ true ], [ true ] ]が確認できると想像していたのですが、すべてfalseの時、
　trueを混ぜた時ともに
　console.log(trueValues )、console.log(trueValues.length)、で確認できませんでした。
　console.log(flag)では、true/falseが確認できました。
　配列が作られるなら確認できるのでは?? と思ったのですが、正しく理解できていないですか?
　それとも、確認方法が正しくないですか?

③filter(arr => arr[0])の部分がよくわかりません。
　arr => arr[0]は、arr[0]は配列の要素0のことで、arrにarr[0]の値を代入すると
　いうことを指示している??
arrはconst　や　let　等で宣言なく突然出てきたように思うのですが、arrが何を
　さしているのかは、どこから読み解けばいいですか??
以前、別件の配列から空白値を除外する照会で、詳細な解説をいただいたのですが、
　やはり理解が追い付かず消化しきれていません。

お忙しいところ申し訳ありませんが、回答は急ぎませんので補足説明をいただけないでしょうか?

[Cocode]

回答を更新しました！

[Cocode]

「別関数にしましょう」とわざわざisChecked()をつくりましたが、理解しにくかったり無駄だと感じたら、別関数にせず、元々の関数の中に直接処理を書いてしまっても大丈夫です。
私が質問者様のコードを全部ちゃんとみていないので、ニーズに合っていない可能性もあります。（ごめんなさい）

[donguriko]

Cocodeさま
夜遅くまで手を取らせてしまい申し訳ありません。
かみ砕いた解かりやすい解説ありがとうございます。
ビギナーでもなんとかついていけます。

▼さら問い①　関数を分けた方がいい件
当方、スプレッドシートの図形に関数を割り当てて、図形クリックしたらGAS走る、
という使い方をしていることが多いのですが、

もし仮にやりたい処理が、
function myFunction1() {
}
function myFunction2() {
}
function myFunction3() {
}　というように３つの関数で1つの処理完了、というコードの書き方をした場合、
１つの図形に複数の関数を割り当てることも可能ですか?
ちなみに、コードの書き方は上記のように列記していく方法でOK?
今まで、関数を分けるという発想がなく、(使いまわすという発想もなかったです)
１つの関数内に全部盛り込んでいました。
勉強になりました。教えていただき感謝です!!

▼さら問②　関数の流用手順
もし、function isChecked()を別のスプレッドシートで流用したい場合は、
function isChecked(){
}
の部分を新しいGASコードのところにコピペする、という方法ですか?

▼console.log(trueValues )、console.log(trueValues.length)が表示されない件
理屈は全然わかりませんがどうやらconsole.logを記載する位置がダメだったようです。
記載位置を変えたら、想定通りに表示されました。

<NG>
const trueValues = allValues.filter(arr => arr[0]);　//条件合致を抽出し、新配列trueValuesを作成
return trueValues.length > 0 //(条件)新配列trueValuesの長さが0より大きい時をtrueとする
console.log('trueValues ' +　trueValues); 　　　 //画面上コードが半透明の薄い表示
console.log('trueValues[0] ' +　trueValues[0]); 　//画面上コードが半透明の薄い表示

<OK>
const trueValues = allValues.filter(arr => arr[0]);　//条件合致を抽出し、新配列trueValuesを作成
console.log('trueValues ' +　trueValues);
console.log('trueValues[0] ' +　trueValues[0]); //いつもの表示。returnの前に書かないとダメなのか?
return trueValues.length > 0

いただいた例のサンプルの内容を色々変えたりしながら、色々な条件で
filter()とコールバック関数、トライしてみました。
アロー関数はまだ自信がないですが、filter()とコールバック関数は
少しイメージがつかめた気がします。

もう少し、簡単な例で手を動かして、まずはfilter()とコールバック関数の
感覚をつかみたいと思います。
感覚がつかめたら、次はアロー関数もトライしたいと思います。
まずは簡単な例でイメージをつかむ方法、とても勉強になりました。
これから実践したいと思います。ありがとうございました。

[Cocode]

▼さら問い①　関数を分けた方がいい件
図形には1つのスクリプトしか割り当てられませんので、関数をわけた場合、1つの関数にまとめておく必要があります。

function mainProcess() {
myFunction1();
myFunction2();
myFunction3();
}

function myFunction1() {}
function myFunction2() {}
function myFunction3() {}

そしてmainProcess()関数を図形に割り当てます。

[Cocode]

▼さら問②　関数の流用手順
それも可能ですが私が意図した流用はそういう意味ではありません。

例えば、質問者様のGASを例にとると、
図形のボタンをクリックしたら、「全体票のチェックボックスにチェックのある行のみ、個別票シートを作成し内容を転記する」
という機能ですよね。

ではさらにボタンをもう一つ追加して、
図形のボタンをクリックしたら、「全体票のチェックボックスにチェックのある行のみ、その行を削除する」
という機能もつけたいとします。

『全体票のチェックボックスにチェックのある行のみ、』←この部分、共通だと思いません？
なので別関数に分けておいたやつを使っちゃおうという考えです。
そうすると、同じことを何回もかかなくてすみます。

こういうイメージ

function createIndividualSheet() { // これを「個別票作成ボタン」に割り当てる
// チェックされた行の値のみに絞る処理
const checkedValeus = getCheckedRows();

// 個別票を作成する処理
}

function deleteCheckedRows() { // これを「削除ボタン」に割り当てる
// チェックされた行の値のみに絞る処理
const checkedValeus = getCheckedRows();

// 行を削除する処理
}

function getCheckedRows() {
// チェックされた行の値のみをreturnで戻す
}

[donguriko]

Cocodeさま
さら問の回答ありがとうございます。

▼さら問い①　関数を分けた方がいい件
function mainProcess() {
myFunction1();　
myFunction2();
myFunction3();
}

function myFunction1() {コード詳細はこっちに書く}
function myFunction2() {}
function myFunction3() {}
と、いうことですね。
ありがとうございます。勉強になりました。

▼さら問②　関数の流用手順
イメージできました。
確かに同じことを何回もかかなくてすみますね。
具体例を挙げてくださり、とても分かりやすかったです。
お忙しい中、丁寧なレクチャー本当にありがとうございました!!
教えていただいたことを自分のモノにできるよう頑張ります。