ブロックリファレンス

BLOCKS Reference

Google Drive

スプレッドシート存在チェック【ベータ版】

notificationsこのブロックはベータ版です。機能改善や不具合などの情報提供は、MAGELLAN BLOCKSのお問い合わせ機能からお願いします。

概要

このブロックは、Googleスプレッドシートのファイルおよび複数シートの存在を確認し、すべて存在する場合は次のブロックへ進みます。存在しないものが1つでもあるとエラーとなり、カスタムエラーメッセージを表示しフローが終了します。

このブロックを利用すると、正確なデータ処理のための前提条件を満たしているか確認する際に非常に有用です。人的ミスによるエラーを大幅に削減し、効率的なデータ処理フローの実現に寄与します。

infoゴミ箱に入ってるGoogleスプレッドシートも存在確認の対象です。ゴミ箱内に存在確認の対象となるファイルがあれば、ファイルは存在することになります。同様にシートの存在有無も確認します。

プロパティ名 説明
ブロック名

編集パネルに配置した当該ブロックの表示名が変更できます。

ブロックリストパネル中のブロック名は変更されません。

GCPサービスアカウント

このブロックで使用するGCPサービスアカウントを選択します。

チェックするファイルのURL

存在を確認するGoogleスプレッドシートのURLを指定します。共有リンクおよびファイルのURL(ウェブブラウザーのアドレス欄に表示)のどちらも指定可能です。

変数展開の指定が可能]
チェックするシート名リスト(複数可、省略可能)

+ボタンをクリックして、存在を確認するシート名を指定します。複数のシート名の確認ができます。その場合は、シート数分+ボタンをクリックして、シート名を指定してください。

シート名は省略可能です。この場合は、「チェックするファイルのURL」プロパティで指定されたGoogleスプレッドシートの存在有無の確認のみとなります。

変数展開の指定が可能][%形式の文字列書式の指定が可能]
スプレッドシートが存在しないときのエラーメッセージ

チェックするファイルのURL」プロパティで指定されたGoogleスプレッドシートが存在しない場合、ここで指定したメッセージがログに出力されます。

変数展開の指定が可能][%形式の文字列書式の指定が可能]
シートが存在しないときのエラーメッセージ

チェックするシート名リスト(複数可、省略可能)」プロパティで指定されたシート名のリストの内、ひとつでも存在しないシートがある場合、ここで指定したメッセージがログに出力されます。

エラーメッセージには、以下の特殊な変数が使用できます。

変数 説明
_all_sheet_names チェックするシート名リスト(複数可、省略可能)」プロパティで指定されたシート名のリスト(出力例:["シート1","シート2","シート3"])
_sheet_not_found_names 存在しなかったシート名のリスト(出力例:["シート1","シート3"])
  • 指定例:
    シートが不足しています。チェック対象のシート:${_all_sheet_names}、不足しているシート:${_sheet_not_found_names}
    
  • 出力例:
    シートが不足しています。チェック対象のシート:["シート1","シート2","シート3"]、不足しているシート:["シート1","シート3"]
    
変数展開の指定が可能][%形式の文字列書式の指定が可能]
ブロックメモ このブロックに関するメモが記載できます。このブロックの処理に影響しません。

この情報は役に立ちましたか?