ワークスペース機能概要

Workspace Overview

機能概要

ワークスペースとは何か

ワークスペースは、組織内のさまざまな立場や役割のユーザーが、自分たちの業務や目的に応じたデータや情報をリアルタイムで視覚的に表示・分析するツールです。

以下のような使用方法があります。

  • 経営者向け：企業全体の業績、財務状況、市場動向などを一目で把握できるツールとして使用できます。これにより、経営者は迅速な意思決定を行い、戦略の策定や業績改善に取り組めます。
  • マネージャー・リーダー向け：部門やプロジェクトの進捗状況、リソースの使用状況、チームのパフォーマンスなどを管理・分析するためのツールとして使用できます。これにより、業務効率の向上や問題の早期発見、部下のサポートが容易になります。
  • 各部門担当者向け：各部門の業績や進捗、目標達成状況、リソース管理などに関連するデータを表示・分析することができます。これにより、部門ごとの業務効率の向上や問題の早期発見、他部門との連携が促進されます。
  • スタッフ向け：個人のタスク管理、業務進捗、目標達成状況などを把握するためのツールとして使用できます。これにより、自己評価や業務効率の向上、チームとの協力が促進されます。

ワークスペースには、以下の特徴があります。

  • 可視化：データをグラフやチャートで視覚的に表現し、分かりやすく伝えることができます。これにより、ユーザーは情報を迅速に理解し、適切な意思決定やアクションが行えます。
  • カスタマイズ：各ユーザーの立場や目的に応じて、表示するデータや形式をカスタマイズすることができます。これにより、必要な情報だけを効率的に把握できます。
  • リアルタイム：データはリアルタイムで更新され、最新の情報が常に表示されます。これにより、ユーザーは現在の状況を正確に把握し、素早い対応が可能です。
  • 直感的な操作：ユーザーが簡単にデータを操作・分析できるよう、直感的なインターフェースが提供されます。これにより、ユーザーは迅速かつ効果的な意思決定や業務遂行が行えます。

ワークスペースは、経営者からスタッフまで、さまざまな立場や役割のユーザーが、自分たちの業務や目的に応じたデータや情報をリアルタイムで視覚的に表示・分析するための重要なツールです。組織全体でワークスペースを活用することで、データの可視化やリアルタイムの情報共有が実現し、業務効率の向上や競争力の強化につながります。

本マニュアルは開発者・管理者向けで、一部利用者には制限があります。

制限により、更新系の操作ができない場合があります。

通常利用者はワークスペース閲覧・情報活用に焦点を当て、更新・カスタマイズ要望は適切な権限を持つ管理者・開発者に依頼してください。

ワークペースへのアクセス方法

グローバルナビゲーションメニューから「ワークスペース」を選択することで使用できます。

ワークスペースの作成と設定

announcement ヒント

ワークスペースのロゴは変更可能です。変更したい場合は、MAGELLAN BLOCKSのお問い合わせ機能からリクエストしてください。

ワークスペースを作成

  1. 「新規作成」ボタンをクリック
  2. 「ワークスペース」をクリック

自由レイアウトタブもしくは知識探索（サイト）タブを持ったワークスペースを作成：

  1. 「新規作成」をクリック
  2. ワークスペース名を入力
  3. 「自由レイアウト」もしくは「知識探索（サイト）」を選択
  4. タブ名を入力
  5. タブの中にパネルが一つの場合、そのパネルをウェブブラウザーのコンテンツエリアの最大サイズに自動的に拡大させたい場合は、トグルスイッチをオン
  6. 「プロジェクトの権限を継承」もしくは「個別に権限を付与」をクリック
  7. 「個別に権限を付与」を選択した場合は、メンバーごとの適切な権限を設定
  8. 「作成」ボタンをクリック

ワークスペースをエクスポートしたファイルから作成：

  1. 「インポート」をクリック
  2. ワークスペースをエクスポートしたファイルを「ここにファイルをドラッグ＆ドロップまたはファイルを選択」と書かれた枠内にドラッグ＆ドロップ操作するか、この枠内をクリックしてOSのファイル選択画面からワークスペースをエクスポートしたファイルを選択
  3. 「プロジェクトの権限を継承」もしくは「個別に権限を付与」をクリック
  4. 「個別に権限を付与」を選択した場合は、メンバーごとの適切な権限を設定
  5. 「作成」ボタンをクリック

announcement 重要

知識探索（サイト）の利用にあたっては、別途Autonomous MAGELLANの契約が必要です。

ワークスペースの設定

ワークスペースの設定機能では、ワークスペースの見た目や機能をカスタマイズできます。以下の項目が設定可能です。

  1. ワークスペース名を変更：ワークスペース名を変更できます。
  2. 変数を定義：ワークスペースで使用する変数が定義できます。変数は、ワークスペース内で共有され、一貫したデータや設定を維持するのに役立ちます。
  3. パネル表示サイズの自動拡大：パネルの表示サイズを自動的に拡大させることができます。これにより、画面サイズに応じて最適な表示が可能になります。
  4. 公開設定：ワークスペースを公開するかどうかを設定できます。公開されたワークスペースは、他のユーザーに共有され、コラボレーションが可能になります。
  5. ワークスペースをエクスポート：ワークスペースの内容をエクスポートして、別のプロジェクトや環境で使用できます。
  6. インポート：他のワークスペースやプロジェクトからワークスペース・タブ・パネルをインポートできます。
  7. 権限を管理：ワークスペースへのアクセス権限や編集権限をユーザーごとに設定できます。
  8. 複製：ワークスペースの複製ができます。
  9. ワークスペースを削除：不要になったワークスペースを削除できます。

ワークスペースの設定機能へのアクセスは、サイドバーのワークスペースの切り替えから行います。

  1. ワークスペース名をクリック
  2. settingsをクリック
ワークスペース名を変更
  1. ワークスペース名を変更
  2. 「保存」ボタンをクリック
変数を定義

ワークスペースには、「変数」機能があります。変数とは、ワークスペース利用中に文字列や整数などのデータを格納・参照できる記憶領域のことで、固有の名称（変数名）で識別できます。

変数は、複数持つことができ、それぞれに名前を付けて区別します。名前のルールは以下のとおりです。

  • 名称に使える文字は、英大文字・英小文字・数字・アンダースコアー（_）のみ
  • 数字のみの名称は使用不可
  • アンダースコアー（_）で始まる名称は使用不可
  • 変数で扱える値の種類は以下のとおり
    • 文字列
    • 整数
    • 浮動小数点数
    • 真偽値
    • 値なし（NULL）

定義された変数をパネル内で参照するためには、${変数名}のように記述します。たとえば、変数FOO_BARが定義されていたとすると、${FOO_BAR}のように記述します。

変数参照は、以下の箇所で利用できます。

  • メモパネル：メモ欄
  • URLパネル：URL欄
  • 可視化専用パネル：ワークブック欄・ビュー欄
  • LOOKERパネル：URL欄
  • BigQueryテーブルパネル：SQL欄
  • BigQueryグラフ（Alpha）パネル：データセット欄・テーブル欄
  • ファイルダウンロードパネル：ディレクトリ欄
  • ファイルアップロードパネル：ディレクトリ欄・ファイル名の設定の「アップロード時にファイル名を指定」の入力欄と「指定パターンに従ってファイル名を生成」の入力欄
  • Google Mapパネル：GCP API Key欄・URL欄
  • フローを開始パネル：フローデザイナー欄・フロー欄・パラメーター（キー欄・デフォルトの値欄・選択肢欄・GCS URL欄）・メモ欄・フローの同時実行を制限の制限対象の処理名欄
  • メッセージパネル：チャンネル欄
  • YouTubeパネル：ビデオID欄

ワークスペース変数の定義方法は、以下のとおりです。

  1. 「＋変数を追加」ボタンをクリック
  2. 変数の名前を入力
  3. 変数の型を選択
  4. 変数の値を入力

上記1から4を定義する変数の回数分繰り返します。

  1. 変数の定義が終わったら「保存」ボタンをクリック
パネル表示サイズの自動拡大

タブの中にパネルが1つのとき、そのパネルをウェブブラウザーのコンテンツエリアの最大サイズに自動的に拡大させるかどうかが設定できます。

  1. 用途に応じてトグルスイッチをオン・オフ
    • オン：タブの中にパネルが1つのとき、そのパネルをウェブブラウザーのコンテンツエリアの最大サイズに自動的に拡大させる
    • オフ：タブの中にパネルが1つのとき、そのパネルをウェブブラウザーのコンテンツエリアの最大サイズに自動的に拡大させない
  2. 「保存」ボタンをクリック
公開設定
  1. 用途に応じてトグルスイッチをオン・オフ
    • オン：ワークスペースをインターネットに公開する
    • オフ：ワークスペースをインターネットに公開しない
  2. 「保存」ボタンをクリック
ワークスペースをエクスポート
  1. ワークスペース変数を一緒にダウンロードしたい場合は、「ワークスペース変数を一緒にエクスポートする」のチェックボックスをオン
    チャックボックスをオンにした場合、変数の値を保持するかしないかを選択
  2. 「ダウンロード」ボタンをクリック

ワークスペースをエクスポートしたファイル（JSON形式のテキストファイル）は、ウェブブラウザーのダウンロード機能を利用しています。ファイルは、ウェブブラウザーのダウンロード機能に沿って適切な場所に保存してください。

インポート
  1. インポートしたいファイルを「ここにファイルをドラッグ＆ドロップまたはファイルを選択」と書かれた枠内にドラッグ＆ドロップ操作するか、この枠内をクリックしてOSのファイル選択画面からインポートしたいファイルを選択

インポートは、ワークスペース・タブ・パネルごとにエクスポートしたJSON形式のファイルを受け付けます。

権限を管理
  • プロジェクトの権限を継承する場合：
    1. 「プロジェクトの権限を継承」をオン
    2. 「保存」ボタンをクリック
  • メンバー個別に権限を設定する場合：
    1. 「個別に権限を付与」をオン
    2. メンバーごとに適切な権限をオン
    3. 「保存」ボタンをクリック

    この例では、管理者のみとなっていますが、プロジェクトメンバーも同様に個別に権限の設定ができます。

複製
  1. ワークスペース名を入力
  2. ワークスペース変数の値を保存するかどうかを設定
  3. 「複製」ボタンをクリック
ワークスペースを削除
  1. 「削除」ボタンをクリック

タブの作成と管理

タブを作成

  1. 「新規作成」ボタンをクリック
  2. 「タブ」をクリック
  3. タブ名を入力
  4. タイプを選択
    • 自由レイアウト：自由な配置でパネルが追加できる
    • 知識探索（サイト）open_in_new：LLMを活用してウェブサイトの情報分析やトピックの検索・要約ができるサービス（パネルの追加はできない）
  5. 「作成」ボタンをクリック

info知識探索（サイト）open_in_newの利用にあたっては、別途ライセンスが必要です。詳しくは、MAGELLAN BLOCKSのお問い合わせ機能から問い合わせ願います。

タブ名を変更

  1. editをクリック
  1. タブ名を変更
  2. 「保存」ボタンをクリック

タブをエクスポート

info知識探索（サイト）open_in_newでは利用できません。

  1. エクスポートしたいタブのmore_vertをクリック
  2. 「タブをエクスポート」をクリック
  1. 「ダウンロード」ボタンをクリック

タブの内容をエクスポートしたファイル（JSON形式のテキストファイル）は、ウェブブラウザーのダウンロード機能を利用しています。ファイルは、ウェブブラウザーのダウンロード機能に沿って適切な場所に保存してください。

タブを複製

info知識探索（サイト）open_in_newでは利用できません。

  1. 複製したいタブのmore_vertをクリック
  2. 「タブを複製する」をクリック
  1. 複製元タブ名の先頭に「Copy of 」が付いたタブが複製され、そのタブが選択状態になる

タブを削除

  1. 削除したいタブのmore_vertをクリック
  2. 「タブを削除する」をクリック
  1. 「削除」ボタンをクリック

パネルの作成と管理

パネルを作成

  1. 「新規作成」ボタンをクリック
  2. 「パネル」をクリック
  3. 作成したいパネルの種類をクリック
  4. 「次へ」ボタンをクリック
  1. パネル名を入力
  2. パネルの種類ごとの設定（詳しくは「パネルの種類」を参照）
  3. 「作成」ボタンをクリック
  1. 「完了」ボタンをクリック

パネル種類の一覧は、カテゴリーで絞り込みできます。

カテゴリーで絞り込むと、現在選択しているパネルと絞り込みリストで指定されたカテゴリー内のパネルで一覧表示されます。

  1. パネル種類の一覧上部の絞り込みリストをクリック
  2. 絞り込みたいカテゴリーをクリック

カテゴリーは複数選択可能です。複数選択する場合は、上記手順を繰り返します。

  • 基本カテゴリーで絞り込んだ例：
  • 基本カテゴリーとツールカテゴリーで絞り込んだ例：

選択したカテゴリーを取り消したい場合は、絞り込みリスト内のclearをクリックします。

パネルをリロード

パネルの手動リロードには、2通りあります。

1つ目は、パネルヘッダーのアイコンを使った方法です。

  1. refreshをクリック

2つ目は、パネルメニューから選択する方法です。

  1. more_vertをクリック
  2. 「refreshリロード」をクリック

パネルを編集

  1. more_vertをクリック
  2. 「editパネルを編集」をクリック
  1. （必要に応じて）パネル名の変更
  2. （必要に応じて）パネルの種類ごとの設定を変更（詳しくは「パネルの種類」を参照）
  3. 「保存」ボタンをクリック

パネルを複製

  1. more_vertをクリック
  2. 「content_copyパネルを複製」をクリック
  1. 複製元パネル名の先頭に「Copy of 」が付いたパネルが複製される

パネルをエクスポート

  1. more_vertをクリック
  2. 「downloadパネルをエクスポート」をクリック
  1. 「ダウンロード」ボタンをクリック

パネルの内容をエクスポートしたファイル（JSON形式のテキストファイル）は、ウェブブラウザーのダウンロード機能を利用しています。ファイルは、ウェブブラウザーのダウンロード機能に沿って適切な場所に保存してください。

パネルを削除

  1. more_vertをクリック
  2. 「deleteパネルを削除」をクリック
  1. 「削除」ボタンをクリック

パネルの種類と設定項目

パネル種類一覧：
カテゴリー パネルの種類 説明
基本 メモ メモをマークダウン形式のテキストで記述ができます（マークダウン部分は書式化して表示）。
URL 外部サービスで発行された埋め込み用のURLなど、指定したURL情報の表示ができます。
可視化ツール 可視化専用パネル MAGELLAN BLOCKS専用のビューが表示できます。
Looker Lookerによるデータ視覚化ビューの表示ができます。
BigQueryテーブル GCP（Google Cloud Platform）のBigQueryクエリー結果の表示ができます。
BigQueryグラフ【アルファ版】 BigQueryのデータを視覚化できます。
目的に応じて多様なチャートタイプ（棒グラフ・積み上げ棒グラフ・線グラフ・エリアグラフ・円グラフ）が選択可能です。
ツール ファイルダウンロード ファイルを所定のGoogle Cloud Storage（GCS）からダウンロードできます。
ファイルアップロード ファイルを所定のGCSへアップロードできます。
Google Map 埋め込み用に発行されたURLを指定して、Google Mapの表示ができます。
フローデザイナー フローを開始 特定フローデザイナーのフロー実行と実行結果の表示ができます。
フロー実行時に、パラメーターの指定も可能です（プルダウンメニューによる指定も可）。
メッセージ フローデザイナーの「ワークスペースへメッセージを送信」ブロックから送信されたメッセージを表示します。
フローの実行状況 フローの実行状況をグラフで表示するパネルです。データ取得期間は、3日間 ・7日間・1か月 から選択できます。その期間のフロー実行の成功・失敗・キャンセルの数をグラフで表示します。
フローの実行回数 指定期間で実行されたフローの回数を表示します。データの取得期間は、当日・1日前・3日間・7日間・1か月 から選択できます。
フローの実行の特徴 フローが実行された曜日と時間をバブルマップで表示します。
フロー実行時のエラー数 フロー実行時のエラー数を表示します。データの取得期間は、当日・1日前・3日間・7日間・1か月 から選択できます。
フロー実行時のエラー率 フロー実行時のエラーの割合を表示します。データの取得期間は、当日・1日前・3日間・7日間・1か月 から選択できます。
フローの定期／API実行数 フローの定期実行およびAPI実行数を表示します。データの取得期間は、当日・1日前・3日間・7日間・1か月 から選択できます。
フローの定期／API実行率 フローの定期実行およびAPI実行の割合を表示します。データの取得期間は、当日・1日前・3日間・7日間・1か月 から選択できます。
フローの定期／API実行時のエラー数 フローの定期実行およびAPI実行のエラー数を表示します。データの取得期間は、当日・1日前・3日間・7日間・1か月 から選択できます。
フローの定期／API実行時のエラー率 フローの定期実行およびAPI実行のエラー割合を表示します。データの取得期間は、当日・1日前・3日間・7日間・1か月 から選択できます。
その他 YouTube YouTube動画の表示ができます。
LLM 知識探索（拡張対話）【アルファ版】

登録したデータに加えてLLMが持つデータまで情報を拡張して、知識探索のための対話機能を提供します。
知識探索（ファイル参照）【ベータ版】

インポートしたファイルのデータから知識探索のための対話機能を提供します。
知識探索（ファイル登録）【アルファ版】

データベースに登録されたファイルのデータから知識探索のための対話機能を提供します。
知識探索（マルチモーダル）【アルファ版】

テキスト、画像、音声、動画ファイルなどを対象に知識探索のための対話機能を提供します。
知識探索（外部アプリ）【アルファ版】

外部アプリにチャットテキストを送信して履歴を表示します。送信先のURL、HTTPメソッド、パラメーター、ヘッダーなどを設定できます。

announcement 警告

LLMカテゴリーのパネルの利用にあたっては、別途ライセンスが必要です。詳しくは、MAGELLAN BLOCKSのお問い合わせ機能から問い合わせ願います。

パネルごとの設定項目：
パネルの種類 設定項目
メモ
  • メモ
URL
  • URL
  • 描画の自動更新
    • パネルの描画を一定間隔で自動更新したい場合は「一定時間ごとの自動更新を有効にする」クリックし、秒単位の更新間隔を入力
    • パネルの描画をメッセージ受信のタイミングで行いたい場合は、「メッセージ受信による自動更新を有効にする」をクリックし、メッセージを受信するチャンネルを入力
可視化専用パネル
  • パネル名
  • ビューのURL
  • ツールバー
    • オン：ツールバーを表示する
    • オフ：ツールバーを表示しない
  • 描画の自動更新
    • パネルの描画を一定間隔で自動更新したい場合は「一定時間ごとの自動更新を有効にする」クリックし、秒単位の更新間隔を入力
    • パネルの描画をメッセージ受信のタイミングで行いたい場合は、「メッセージ受信による自動更新を有効にする」をクリックし、メッセージを受信するチャンネルを入力
Looker
  • URL
  • 描画の自動更新
    • パネルの描画を一定間隔で自動更新したい場合は「一定時間ごとの自動更新を有効にする」クリックし、秒単位の更新間隔を入力
    • パネルの描画をメッセージ受信のタイミングで行いたい場合は、「メッセージ受信による自動更新を有効にする」をクリックし、メッセージを受信するチャンネルを入力
BigQueryテーブル
  • GCPサービスアカウント
  • SQL
  • 描画の自動更新
    • パネルの描画を一定間隔で自動更新したい場合は「一定時間ごとの自動更新を有効にする」クリックし、秒単位の更新間隔を入力
    • パネルの描画をメッセージ受信のタイミングで行いたい場合は、「メッセージ受信による自動更新を有効にする」をクリックし、メッセージを受信するチャンネルを入力
BigQueryグラフ【アルファ版】ー棒グラフ
  • GCPサービスアカウント
  • データセット
  • テーブル
  • X軸のカラム
  • Y軸のカラム
  • 描画の自動更新
    • パネルの描画を一定間隔で自動更新したい場合は「一定時間ごとの自動更新を有効にする」クリックし、秒単位の更新間隔を入力
    • パネルの描画をメッセージ受信のタイミングで行いたい場合は、「メッセージ受信による自動更新を有効にする」をクリックし、メッセージを受信するチャンネルを入力
BigQueryグラフ【アルファ版】ー積み上げ棒グラフ
  • GCPサービスアカウント
  • データセット
  • テーブル
  • X軸のカラム
  • Y軸のカラム
  • 描画の自動更新
    • パネルの描画を一定間隔で自動更新したい場合は「一定時間ごとの自動更新を有効にする」クリックし、秒単位の更新間隔を入力
    • パネルの描画をメッセージ受信のタイミングで行いたい場合は、「メッセージ受信による自動更新を有効にする」をクリックし、メッセージを受信するチャンネルを入力
BigQueryグラフ【アルファ版】ー線グラフ
  • GCPサービスアカウント
  • データセット
  • テーブル
  • X軸のカラム
  • Y軸のカラム
  • 描画の自動更新
    • パネルの描画を一定間隔で自動更新したい場合は「一定時間ごとの自動更新を有効にする」クリックし、秒単位の更新間隔を入力
    • パネルの描画をメッセージ受信のタイミングで行いたい場合は、「メッセージ受信による自動更新を有効にする」をクリックし、メッセージを受信するチャンネルを入力
BigQueryグラフ【アルファ版】ーエリアグラフ
  • GCPサービスアカウント
  • データセット
  • テーブル
  • X軸のカラム
  • Y軸のカラム
  • 描画の自動更新
    • パネルの描画を一定間隔で自動更新したい場合は「一定時間ごとの自動更新を有効にする」クリックし、秒単位の更新間隔を入力
    • パネルの描画をメッセージ受信のタイミングで行いたい場合は、「メッセージ受信による自動更新を有効にする」をクリックし、メッセージを受信するチャンネルを入力
BigQueryグラフ【アルファ版】ー円グラフ
  • GCPサービスアカウント
  • データセット
  • テーブル
  • X軸のカラム
  • 描画の自動更新
    • パネルの描画を一定間隔で自動更新したい場合は「一定時間ごとの自動更新を有効にする」クリックし、秒単位の更新間隔を入力
    • パネルの描画をメッセージ受信のタイミングで行いたい場合は、「メッセージ受信による自動更新を有効にする」をクリックし、メッセージを受信するチャンネルを入力
ファイルダウンロード
  • GCPサービスアカウント
  • フォルダー（GCS URL）
  • フォルダーの作成とアイテムの削除
    • オン：フォルダーの作成とアイテムの削除を許可する
    • オフ：フォルダーの作成とアイテムの削除を許可しない
  • ファイルの表示順
    • 「最終更新日」か「ファイル名」を選択
    • 「昇順」か「降順」を選択
ファイルアップロード
  • GCPサービスアカウント
  • フォルダー（GCS URL）
  • 複数ファイルのアップロードを許可するかどうか
  • ファイル名の設定方法（複数ファイルのアップロードを許可しない場合のみ有効）
    • デフォルトのファイル名を保持：ファイルアップロード時にファイル名の変更不可。
    • アップロード時にファイル名を指定：ファイルアップロード時にファイル名の変更可能。
      デフォルトのファイル名が指定可能。デフォルトのファイル名は、固定文字列・変数・特殊キーワードを組み合わせて指定（例：${@FILE.BASENAME}_${@USER.ID}_${@DATE.TODAY)${@FILE.EXTNAME}）。
    • 指定パターンに従ってファイル名を生成：固定文字列・変数・特殊キーワードを組み合わせてパターンを指定（例：${@FILE.BASENAME}_${@USER.ID}_${@DATE.TODAY)${@FILE.EXTNAME}）。ファイルアップロード時にファイル名の変更不可。
  • アップロード完了時にメッセージを送信
    • チャンネル名：メッセージを送信先のメッセージパネルのチャンネル名を指定
    • 送信メッセージ：メッセージパネルに送信するテキストを指定。変数や特殊キーワードが指定可能（例：${@FILE}をアップロードしました。）。
Google Map
  • GCP API key
  • URL
フローを開始
  • フローデザイナー
  • フロー
  • パラメーター
    • キー
    • タイプ（文字列／数値／選択／複数選択／テキスト／GCSファイル）
    • 選択肢（タイプが選択および複数選択のときのみ）
      選択肢をカンマ区切りで指定（例：a,b,c）
    • GCSディレクトリ（タイプがGCSファイルのときのみ）
      • GCPサービスアカウント
      • フォルダー（選択させたいファイルが存在するフォルダーを指定）
    • 並び順（タイプがGCSファイルのときのみ）
      • 並び順の対象（ファイル名・最終更新日）
      • 並び順（昇順・降順）
    • デフォルトの値
    • 表示名
    • 説明

    lightbulb ヒント

    キー：_job_name、タイプ：文字列の場合、ジョブに関連付けるラベルが設定できます。これを設定すると、フローデザイナーのログにおいて、ラベルが以下のように表示されます。

    • ログ一覧のフロー名欄：「flow_sample - foobar」と表示
      （フロー名：flow_sample、ラベル：foobar）
    • ログの詳細情報：「info : Job Name: foobar」と表示
      （ラベル：foobar）

    この機能を用いることで、ログからジョブを簡単に識別し、管理できます。

  • ログ表示
    • なし（ログ表示なし）
    • 簡易（フローの開始・終了およびブロックの開始・終了のみ）
    • 詳細（すべてのメッセージを表示）
  • フローの情報を隠す
    • オン：フローの情報を隠す
    • オフ：フローの情報を隠さない
  • メモ
  • フローの同時実行を制限
    • オン：同時実行を制限する
    • オフ：同時実行を制限しない
    • 制限対象の処理名（英数字、アンダースコア、ハイフン、変数展開が使用可能。変数展開は${変数名}の形式で指定。）

    warning 警告

    同じ処理名を設定したフローは同時に実行できなくなります。データの一括更新など、同時実行を避けたい処理に使用してください。処理名には変数を使用することができ、例えば「${foo}_process」のように指定できます。

  • 描画の自動更新
    • パネルの描画を一定間隔で自動更新したい場合は「一定時間ごとの自動更新を有効にする」クリックし、秒単位の更新間隔を入力
    • パネルの描画をメッセージ受信のタイミングで行いたい場合は、「メッセージ受信による自動更新を有効にする」をクリックし、メッセージを受信するチャンネルを入力
メッセージ
  • チャンネル
  • 表示件数
  • 描画の自動更新
    • パネルの描画を一定間隔で自動更新したい場合は「一定時間ごとの自動更新を有効にする」クリックし、秒単位の更新間隔を入力
    • パネルの描画をメッセージ受信のタイミングで行いたい場合は、「メッセージ受信による自動更新を有効にする」をクリックし、メッセージを受信するチャンネルを入力
フローの実行状況
  • 期間：3日間／7日間／1か月
フローの実行回数
  • 期間：当日／1日前／3日間／7日間／1か月
フローの実行の特徴
  • 期間：1か月／3か月／6か月／1年
フロー実行時のエラー数
  • 期間：当日／1日前／3日間／7日間／1か月
フロー実行時のエラー率
  • 期間：当日／1日前／3日間／7日間／1か月
フローの定期／API実行数
  • 期間：当日／1日前／3日間／7日間／1か月
フローの定期／API実行率
  • 期間：当日／1日前／3日間／7日間／1か月
フローの定期／API実行時のエラー数
  • 期間：当日／1日前／3日間／7日間／1か月
フローの定期／API実行時のエラー率
  • 期間：当日／1日前／3日間／7日間／1か月
YouTube
  • ビデオID
知識探索（拡張対話）【アルファ版】
  • GCPサービスアカウント
  • ファイル選択
  • プロンプト
  • 設定
知識探索（ファイル参照）【ベータ版】
  • プロンプト
  • 設定
知識探索（ファイル登録）【アルファ版】
  • GCPサービスアカウント
  • ファイル選択
  • プロンプト
  • 設定
知識探索（マルチモーダル）【アルファ版】
  • GCPサービスアカウント
  • ファイル選択
  • 設定
知識探索（外部アプリ）【アルファ版】
  • URL
  • HTTPメソッド
  • パラメーター
  • ヘッダー

特殊キーワード

ここでは、ワークスペース内で使用できる「特殊キーワード」について説明します。

特殊キーワードを使用することで、日付情報・ユーザー情報・ファイル名情報などが簡単に扱えます。

特殊キーワードは、${特殊キーワード}という形式で使用します（例：${@DATE.TODAY}）。

以降、それぞれのキーワードの種類と使い方について詳しく説明します。

日付キーワード

ワークスペースでは、日付キーワードという特殊な文字列を使って、任意の日付や曜日を指定したり、表示したりできます。たとえば、来週の月曜日や今月末などが簡単に指定・表示できます。

日付キーワードは、今日の日付を表す@DATEから始まり、複数の日付操作を組み合わせて指定できます。その場合は、ピリオド（.）でつなげます。最後にFORMAT()という操作を使って、日付の表示形式を変えられます。

たとえば、@DATE.NEXT_MONTH.BEGINNING_OF_MONTH.FORMAT(%Y/%m/%d)という日付キーワードは、「次月の初日をyyyy/mm/ddの形式で表示する」という意味になります。今日の日付が2023年2月18日の場合は、「2023/03/01」という結果が得られます。

日付キーワードは、以下の場所で使用できます。

  1. ワークスペース変数
    • 値欄
    • 直接日付キーワードを指定
    • 例：@DATE.NEXT_MONTHや@DATE.ADD(5)など
  2. 「BigQueryテーブル」パネル
    • SQL編集
    • ${xxx}という形式で指定。プレビュー機能で日付キーワードの展開後が確認可能。
    • 例：${@DATE.ADD(5)}や${@DATE.PREV_WEEK.WEEKDAY(fri)}など
  3. 「ファイルアップロード」パネル
    • 「ファイル名の設定」内の「アップロード時にファイル名を指定」欄
    • 「ファイル名の設定」内の「指定パターンに従ってファイル名を生成」欄
    • 「アップロード完了時にメッセージを送信」の「送信メッセージ」欄
    • ${xxx}という形式で指定
    • 例：${@DATE.ADD(5)}や${@DATE.PREV_WEEK.WEEKDAY(fri)}など
  4. 「フローを開始」パネル
    • 「パラメーター」内の「デフォルトの値」欄
    • ${xxx}という形式で指定
    • 例：${@DATE.ADD(5)}や${@DATE.PREV_WEEK.WEEKDAY(fri)}など

日付キーワードには、以下の3種類があります。

基本
キーワード 説明 使用例
@DATE 使用PCのタイムゾーンに基づく今日の日付。必須のキーワード。複数のキーワードを組み合わせる場合は、必ず先頭に指定。 @DATE
日時操作
キーワード 説明 使用例
TODAY 今日の日付 @DATE.TODAY
TOMORROW 明日の日付 @DATE.TOMORROW
YESTERDAY 昨日の日付 @DATE.YESTERDAY
ADD(num) num日分だけ前後にずらした日付。numには整数が指定できる。1以上は日付を進める。-1以下は日付を戻す。0もしくは省略した場合は、日付は変わらず。numを省略する場合は、()も省略可能。 @DATE.ADD(-2)：2日前
@DATE.ADD(2)：2日後
NEXT_WEEK 翌週 @DATE.NEXT_WEEK
PREV_WEEK 前週 @DATE.PREV_WEEK
ADD_WEEK(num) num週分だけ前後にずらした日付。numには整数が指定できる。1以上は日付を進める。-1以下は日付を戻す。0もしくは省略した場合は、日付は変わらず。numを省略する場合は、()も省略可能。 @DATE.ADD_WEEK(-2)：2週前の日付
@DATE.ADD_WEEK(2)：2週後の日付
WEEKDAY(曜日) 当該週の指定された曜日の日付。週の始まりは日曜日。当該週とは、@DATEもしくは日付操作後の日付の週。曜日は、sun・mon・tue・wed・thu・fri・satで指定する。 @DATE.NEXT_WEEK.WEEKDAY(sun)：翌週の日曜日の日付
NEXT_WEEKDAY(曜日) 当該日付を起点として次に進めた指定曜日の日付。当該日付とは、@DATEもしくは日付操作後の日付。曜日は、sun・mon・tue・wed・thu・fri・satで指定する。 @DATE.NEXT_WEEKDAY(wed)
PREV_WEEKDAY(曜日) 当該日付を起点として前に遡った指定曜日の日付。当該日付とは、@DATEもしくは日付操作後の日付。曜日は、sun・mon・tue・wed・thu・fri・satで指定する。 @DATE.PREV_WEEKDAY(fri)
NEXT_MONTH 翌月の日付 @DATE.NEXT_MONTH
PREV_MONTH 前月の日付 @DATE.PREV_MONTH
ADD_MONTH(num) num月分だけ前後にずらした日付。numには整数が指定できる。1以上は日付を進める。-1以下は日付を戻す。0もしくは省略した場合は、日付は変わらず。numを省略する場合は、()も省略可能。 @DATE.ADD_MONTH(-2)：2か月前の日付
@DATE.ADD_MONTH(2)：2か月後の日付
BEGINNING_OF_MONTH 月初め（1日） @DATE.PREV_MONTH.BEGINNING_OF_MONTH：前月の1日
END_OF_MONTH 月末（28日から31日） @DATE.NEXT_MONTH.END_OF_MONTH：次月の月末日
NEXT_YEAR 翌年の日付 @DATE.NEXT_YEAR
PREV_YEAR 前年の日付 @DATE.PREV_YEAR
ADD_YEAR(num) num年分だけ前後にずらした日付。numには整数が指定できる。1以上は日付を進める。-1以下は日付を戻す。0もしくは省略した場合は、日付は変わらず。numを省略する場合は、()も省略可能。 @DATE.ADD_YEAR(-2)：2年前の日付
@DATE.ADD_YEAR(2)：2年後の日付
フォーマット
キーワード 説明 使用例
FORMAT(書式) 日付の表示形式を変更。日付操作の末尾にのみ指定可能。指定できる書式は、「%形式の文字列書式」を参照（ただし、%と英字の間のオプションは指定不可）。 @DATE.NEXT_YEAR.FORMAT(%Y/%m/%d)：翌年の日付を2024/02/18の形式で表示

ユーザーキーワード

ユーザーキーワードを使うことで、特定のユーザー情報を取得し表示できます。これらはユーザーID、ユーザー名、メールアドレスを展開するために使用します。

  • @USER.ID：ユーザーID
  • @USER.NAME：ユーザー名
  • @USER.EMAIL：メールアドレス
  • @USER：ユーザーID

ファイルキーワード

ファイルキーワードを使用すると、ファイル名に関する情報を取得し表示できます。これらはファイルのベースネーム、拡張子、オリジナルのファイル名を展開するために使用します。

  • @FILE.BASENAME：ベースネーム（ファイル名の拡張子を除いた部分。例：sample.txt→sample）
  • @FILE.EXTNAME：拡張子（ファイル名のドットを含む拡張子の部分。例：sample.txt→.txt）
  • @FILE.ORIGINAL：オリジナルのファイル名（ファイル名そのもの。例：sample.txt→sample.txt）
  • @FILE：オリジナルのファイル名（@FILE.ORIGINALと同じ。）
  • @FILE.BEFORENAME：ファイルアップロードパネルでファイル名を変更した場合の、変更前のファイル名。ファイル名の変更がなかった場合は、オリジナルのファイル名。例：sample.txtをdocument.txtに変更した場合、sample.txt

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