Google Sheets モジュール

Adobe Workfront Fusion のシナリオでは、Google Sheets を使用するワークフローを自動化したり、複数のサードパーティのアプリケーションやサービスに接続したりすることができます。

Google Sheets アカウントを Workfront Fusion に接続する手順について詳しくは、Adobe Workfront Fusion への接続の作成 - 基本手順を参照してください

アクセス要件

展開すると、この記事の機能のアクセス要件が表示されます。
table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Adobe Workfront パッケージ

任意の Adobe Workfront Workflow パッケージと任意の Adobe Workfront Automation および Integration パッケージ

Workfront Ultimate

Workfront Fusion を追加購入した Workfront Prime および Select パッケージ。

Adobe Workfront ライセンス

標準

Work またはそれ以上

Adobe Workfront Fusion ライセンス

オペレーションベース:Workfront Fusion ライセンス要件なし

コネクターベース(レガシー):Workfront Fusion for Work Automation および Integration

製品 組織が Workfront Automation および Integration を含まない Select またはPrime Workfront パッケージを持っている場合は、Adobe Workfront Fusion を購入する必要があります。

この表の情報について詳しくは、ドキュメントのアクセス要件を参照してください。

Adobe Workfront Fusion ライセンスについて詳しくは、Adobe Workfront Fusion ライセンスを参照してください。

前提条件

Google スプレッドシートモジュールを使用するには、Google アカウントが必要です。

Google Sheets APIの情報

Google Sheets コネクタでは、次の機能が使用されます。

ベース URL
https://sheets.googleapis.com/v4
API バージョン
v4
API タグ
v2.5.7

Google Sheets モジュールとそのフィールド

Google Forms モジュールを設定すると、Workfront Fusion には以下のフィールドが表示されます。 これらとともに、アプリやサービスのアクセスレベルなどの要因に応じて、追加の「Google Sheets」フィールドが表示される場合があります。 モジュール内の太字のタイトルは、必須フィールドを示します。

フィールドまたは関数の上にマップボタンが表示されている場合は、このボタンを使用すると、そのフィールドの変数や関数を設定できます。 詳しくは、モジュール間での情報のマッピングを参照してください。

マップ切り替え

トリガー

行を監視

スプレッドシートに新しく追加された行から値を取得します。

モジュールは、以前に入力されていない新しい行のみを取得します。 トリガーは、上書きされた行を処理しません。

IMPORTANT
ワークシートに空白の行が含まれている場合、空白の行の後に行は処理されません。
Connection
Google Sheets アカウントをWorkfront Fusionに接続する手順については、接続の作成 – 基本手順を参照してください。
Spreadsheet
監視するシートが含まれているスプレッドシートを選択します。
Sheet
新しい行を監視するシートを選択します。
Table contains headers

スプレッドシートにヘッダー行を含めるかどうかを選択します。

  • Yes

    モジュールは、出力データとしてヘッダー行を取得しません。

    出力内の変数名は、ヘッダーによって呼び出されます。

  • No

    また、このモジュールは、最初のテーブル行を取得します。

    出力内の変数名は、A、B、C、D などと呼ばれます。

Row with headers
ヘッダー行の範囲を入力します。 例:A1:F1
First table row
テーブルの最初の行の範囲を入力します。 例:A1:F1
Value render option
  • Formatted value

    値は、セルの書式設定に従って、返信で計算および書式設定されます。 書式設定は、リクエスト元のユーザーのロケールではなく、スプレッドシートのロケールに基づいて行われます。 例えば、A11.23A2=A1 で通貨の形式に設定されている場合、A2"$1.23" を返します。

  • Unformatted value

    値は計算されますが、返信ではフォーマットされません。 例えば、A11.23A2=A1 で通貨の形式に設定されている場合、A2 は数値 "1.23" を返します。

  • Formula

    値は計算されません。 返信には数式が含まれます。 例えば、A11.23A2=A1 で通貨の形式に設定されている場合、A2"=A1" を返します。

Date and time render option
  • Serial number

    日付、時刻、日時、期間のフィールドは、Lotus 1-2-3で普及しているように、「シリアル番号」形式で倍数として出力されます。 値の整数部分(小数点の左側)は、1899年12月30日からの日数を数えます。 小数部分(小数点の右側)は、時間を日の端数として数えます。 例えば、1900年1月1日の正午は、1899年12月30日の 2 日後で、正午は半日後なので 0.5 なので 2.5 になります。 1900年2月1日の午後3時は33.625です。 これは、1900年をうるう年として正しく扱います。

  • Formatted string

    日付、時刻、日時、期間のフィールドは、指定された数値形式(スプレッドシートのロケールに依存します)で文字列として出力されます。

Limit
1回の実行サイクルでWorkfront Fusionが処理する結果の最大数を設定します。

アクション

行を追加

このモジュールは、シートに行を追加します。

Google Sheets モジュールを設定すると、Workfront Fusion には以下のフィールドが表示されます。 これらとともに、アプリやサービスのアクセスレベルなどの要因に応じて、追加の「Google Sheets」フィールドが表示される場合があります。 モジュール内の太字のタイトルは、必須フィールドを示します。

フィールドまたは関数の上にマップボタンが表示されている場合は、このボタンを使用すると、そのフィールドの変数や関数を設定できます。 詳しくは、モジュール間での情報のマッピングを参照してください。

マップ切り替え

Connection
Google Sheets アカウントをWorkfront Fusionに接続する手順については、接続の作成 – 基本手順を参照してください。
Mode

スプレッドシートとシートを手動で選択するか、マッピングを行うかを選択します。

注意:手動マッピングは、例えば、新しいスプレッドシートがWorkfront Fusion シナリオで作成され、新しく作成したスプレッドシートにデータを直接追加する場合などに便利です。

Spreadsheet
Google スプレッドシートを選択します。
Sheet
行を追加するシートを選択します。
Column Range
使用する列の範囲を選択します。
Table contains headers

スプレッドシートにヘッダー行を含めるかどうかを選択します。

  • Yes

    モジュールは、出力データとしてヘッダー行を取得しません。

    出力内の変数名は、ヘッダーによって呼び出されます。

  • No

    また、このモジュールは、最初のテーブル行を取得します。

    出力内の変数名は、A、B、C、D などと呼ばれます。

Values
追加する行の目的のセルを入力またはマッピングします。
Value input option
  • User entered

    値は、ユーザーが UI に入力したかのように解析されます。 数値は数値のまま保持されますが、文字列の場合は Google Sheets UI を経由してセルにテキストを入力する時に適用されるルールと同じルールに従って数値、日付、もしくは他の形式に変換される可能性があります。

  • Raw

    ユーザーが入力した値は解析されず、入力された時点で保存されます。

Insert data option

新しいデータが入力されるときの既存のデータの変更方法を指定します。

  • Insert rows

    行が新しいデータ用に挿入されます。

  • Overwrite

    新しいデータは、書き込まれたエリアの既存のデータを上書きします。 シートの末尾にデータを追加すると、新しい行または列が挿入され、データを書き込むことができます。

シートを追加

選択したスプレッドシートにシートを新規作成します。

Connection
Google Sheets アカウントをWorkfront Fusionに接続する手順については、接続の作成 – 基本手順を参照してください。
Spreadsheet
シートを追加する Google スプレッドシートを選択します。
Properties
  • Title

    新しいシートの名前を入力します。

  • Index

    シートの位置を入力します。 デフォルトは0です(シートを最初に配置します)。

セルのクリア

指定したセルから値を削除します。

Connection
Google Sheets アカウントをWorkfront Fusionに接続する手順については、接続の作成 – 基本手順を参照してください。
Spreadsheet
セルをクリアするシートを含む Google スプレッドシートを選択します。
Sheet
セルをクリアするシートを選択します。
Cell
消去するセルのIDを入力またはマッピングします。 例:A5

行のクリア

指定した行から値を削除します。

Connection
Google Sheets アカウントをWorkfront Fusionに接続する手順については、接続の作成 – 基本手順を参照してください。
Spreadsheet
行をクリアするシートを含む Google スプレッドシートを選択します。
Sheet
データをクリアするシートを選択します。
Row number
データをクリアする行の数を入力します。 例: 23

スプレッドシートの作成

Connection
Google Sheets アカウントをWorkfront Fusionに接続する手順については、接続の作成 – 基本手順を参照してください。
Title
新しいスプレッドシートの名前を入力します。
Locale

スプレッドシートのロケールを次のいずれかの形式で入力します。

  • ISO 639-1 言語コード(例: en
  • ISO 639-2 言語コード(例:haw(639-1 コードが存在しない場合)
  • ISO 言語コードと国コードの組み合わせ(例: en_US
Recalculation interval

揮発性関数が再計算されるまでの待機時間:

  • On change

    揮発性関数は、変更のたびに更新されます。

  • On change and every minute

    揮発性関数は、変化のたびおよび 1 分ごとに更新されます。

  • On change and hourly

    揮発性関数は、変更のたびおよび 1 時間ごとに更新されます。

Time zone
スプレッドシートのタイムゾーンを選択します。
Number format

スプレッドシート内のすべてのセルのデフォルトの形式を選択します。

Text:テキストの書式設定。 例: 1000. 12

Number:数値の書式設定。 例: 1,000.12

Percent:割合の書式設定。 例: 10. 12%

Currency:通貨の書式設定。 例: $1,000.12

Date:日付の書式設定。 例: 9/26/2008

Time:時間の形式設定。 例: 3:59:00 PM

Date time:日付と時刻の書式設定。 例:9/26/08 15:59:00

Scientific:科学番号の書式設定 例: 1. 01E+03

Sheets
スプレッドシートに追加する各シートについて、Add itemをクリックし、シートのタイトルとシートのインデックスを入力またはマッピングします。 インデックス 0 は最初のシートを表します。

行を削除

指定した行を削除します。

Connection
Google Sheets アカウントをWorkfront Fusionに接続する手順については、接続の作成 – 基本手順を参照してください。
Spreadsheet
行をクリアするシートを含む Google スプレッドシートを選択します。
スプレッドシート
行を削除するシートを選択します。
行番号
削除する行の数を入力します。 例: 23

シートを削除

特定のシートを削除します。

Connection
Google Sheets アカウントをWorkfront Fusionに接続する手順については、接続の作成 – 基本手順を参照してください。
Spreadsheet
Google スプレッドシートを選択します。
Sheet
削除するシートを選択します。

セルを取得

選択したセルから値を取得します。

Connection
Google Sheets アカウントをWorkfront Fusionに接続する手順については、接続の作成 – 基本手順を参照してください。
Spreadsheet
Google スプレッドシートを選択します。
Sheet
データを取得するセルを含むシートを選択します。
Cell
データの取得元のセルの ID を入力します。 例: A6
Value render option
  • Formatted value

    値は、セルの書式設定に従って、返信で計算および書式設定されます。 書式設定は、リクエスト元のユーザーのロケールではなく、スプレッドシートのロケールに基づいて行われます。 例えば、A11.23A2=A1 で通貨の形式に設定されている場合、A2"$1.23" を返します。

  • Unformatted value

    値は計算されますが、返信ではフォーマットされません。 例えば、A11.23A2=A1 で通貨の形式に設定されている場合、A2 は数値 "1.23" を返します。

  • Formula

    値は計算されません。 返信には数式が含まれます。 例えば、A11.23A2=A1 で通貨の形式に設定されている場合、A2"=A1" を返します。

Date and time render option
  • Serial number

    日付、時刻、日時、期間のフィールドは、Lotus 1-2-3で普及しているように、「シリアル番号」形式で倍数として出力されます。 値の整数部分(小数点の左側)は、1899年12月30日からの日数を数えます。 小数部分(小数点の右側)は、時間を日の端数として数えます。 例えば、1900年1月1日の正午は、1899年12月30日の 2 日後で、正午は半日後なので 0.5 なので 2.5 になります。 1900年2月1日の午後3時は33.625です。 これは、1900年をうるう年として正しく扱います。

  • Formatted string

    日付、時刻、日時、期間のフィールドは、指定された数値形式(スプレッドシートのロケールに依存します)で文字列として出力されます。

API 呼び出しを実行

このアクションモジュールでは、カスタム API 呼び出しを実行できます。

Connection
Google Sheets アカウントをWorkfront Fusionに接続する手順については、Adobe Workfront Fusionへの接続の作成 – 基本手順を参照してください。
URL
https://sheets.googleapis.com/v4/ からの相対パスを入力します。
Method
API 呼び出しの設定に必要な HTTP リクエストメソッドを選択します。 詳しくは、HTTP リクエスト方法を参照してください。
Headers
リクエストのヘッダーを標準 JSON オブジェクトの形式で追加します。 例えば、{"Content-type":"application/json"}。 Workfront Fusion は認証ヘッダーを追加します。
Query String
API 呼び出しのクエリを標準 JSON オブジェクトの形式で追加します。
Body

標準の JSON オブジェクトの形式で、API 呼び出しの本文の内容を追加します。

メモ:

if などの条件文を JSON で使用する場合は、条件文を引用符で囲みます。

セルを更新

Connection
Google Sheets アカウントをWorkfront Fusionに接続する手順については、接続の作成 – 基本手順を参照してください。
Spreadsheet
Google スプレッドシートを選択します。
Sheet
セルを更新するシートを選択します。
Cell
更新するセルの ID を入力します。 例: A5
Value
セルの新しい値を入力します。
Value input option
  • User entered

    値は、ユーザーが UI に入力したかのように解析されます。 数値は数値のまま保持されますが、文字列の場合は Google Sheets UI を経由してセルにテキストを入力する時に適用されるルールと同じルールに従って数値、日付、もしくは他の形式に変換される可能性があります。

  • Raw

    ユーザーが入力した値は解析されず、入力された時点で保存されます。

行の更新

このモジュールでは、選択した行のセルの内容を変更できます。

Connection
Google Sheets アカウントをWorkfront Fusionに接続する手順については、接続の作成 – 基本手順を参照してください。
Mode

スプレッドシートとシートを手動で選択するか、マッピングを行うかを選択します。

メモ:手動マッピングは、新しいスプレッドシートが Workfront Fusion シナリオで作成され、新しく作成されたスプレッドシートにデータをシナリオ内で直接追加する場合などに役立ちます。

Spreadsheet
Google スプレッドシートを選択します。
Sheet
行を更新するシートを選択します。
Row number
更新する行の数を入力します。
Table contains headers

スプレッドシートにヘッダー行を含めるかどうかを選択します。

  • Yes

    モジュールは、出力データとしてヘッダー行を取得しません。

    出力内の変数名は、ヘッダーによって呼び出されます。

  • No

    また、このモジュールは、最初のテーブル行を取得します。

    出力内の変数名は、A、B、C、D などと呼ばれます。

Values
変更(更新)する行の目的のセルに値を入力またはマッピングします。
Value input option
  • User entered

    値は、ユーザーが UI に入力したかのように解析されます。 数値は数値のまま保持されますが、文字列の場合は Google Sheets UI を経由してセルにテキストを入力する時に適用されるルールと同じルールに従って数値、日付、もしくは他の形式に変換される可能性があります。

  • Raw

    ユーザーが入力した値は解析されず、入力された時点で保存されます。

検索

範囲の値を取得

Connection
Google Sheets アカウントをWorkfront Fusionに接続する手順については、接続の作成 – 基本手順を参照してください。
Spreadsheet
Google スプレッドシートを選択します。
Sheet
範囲の内容を取得するシートを選択します。
Range
取得する範囲を入力します。 例:A1:D25
Table contains headers
シートにヘッダー行がある場合は、このチェックボックスをオンにする
Row with headers
テーブルヘッダーの範囲を入力します。 例:A1:F1 フィールドを空のままにすると、Workfront Fusionは、指定された範囲の最初の行をヘッダーとして扱います。
Value render option
  • Formatted value

    値は、セルの書式設定に従って、返信で計算および書式設定されます。 書式設定は、リクエスト元のユーザーのロケールではなく、スプレッドシートのロケールに基づいて行われます。 例えば、A11.23A2=A1 で通貨の形式に設定されている場合、A2"$1.23" を返します。

  • Unformatted value

    値は計算されますが、返信ではフォーマットされません。 例えば、A11.23A2=A1 で通貨の形式に設定されている場合、A2 は数値 "1.23" を返します。

  • Formula

    値は計算されません。 返信には数式が含まれます。 例えば、A11.23A2=A1 で通貨の形式に設定されている場合、A2"=A1" を返します。

Date and time render option
  • Serial number

    日付、時刻、日時、期間のフィールドは、Lotus 1-2-3で普及しているように、「シリアル番号」形式で倍数として出力されます。 値の整数部分(小数点の左側)は、1899年12月30日からの日数を数えます。 小数部分(小数点の右側)は、時間を日の端数として数えます。 例えば、1900年1月1日の正午は、1899年12月30日の 2 日後で、正午は半日後なので 0.5 なので 2.5 になります。 1900年2月1日の午後3時は33.625です。 これは、1900年をうるう年として正しく扱います。

  • Formatted string

    日付、時刻、日時、期間のフィールドは、指定された数値形式(スプレッドシートのロケールに依存します)で文字列として出力されます。

シートをリスト

このモジュールは、スプレッドシート内のすべてのシートのリストを返します。

Connection
Google Sheets アカウントをWorkfront Fusionに接続する手順については、接続の作成 – 基本手順を参照してください。
Spreadsheet
リストするシートが含まれている Google スプレッドシートを選択します。

行を検索

フィルターオプションを使用して行を検索します。

Connection
Google Sheets アカウントをWorkfront Fusionに接続する手順については、Adobe Workfront Fusionへの接続の作成 – 基本手順を参照してください。
Spreadsheet
Google スプレッドシートを選択します。
Sheet
行を検索するシートを選択します。
Table contains headers
スプレッドシートにヘッダー行を含めるかどうかを選択します。 Yes オプションが選択されている場合、出力データと出力内の変数名がヘッダーによって呼び出されるので、モジュールはヘッダー行を取得しません。 No オプションが選択されている場合、モジュールはまた、出力内の最初のテーブル行と変数名を取得し、その後 A、B、C、D などと呼ばれます。
Column range
操作する列の範囲を選択します。 例: A-F
Filter

行の検索に使用するフィルターを設定します。

Sort order
昇順と降順のどちらで並べ替えるかを選択します。
Order by
並べ替える列を選択します。
Value render option
  • Formatted value

    値は、セルの書式設定に従って、返信で計算および書式設定されます。 書式設定は、リクエスト元のユーザーのロケールではなく、スプレッドシートのロケールに基づいて行われます。 例えば、A11.23A2=A1 で通貨の形式に設定されている場合、A2"$1.23" を返します。

  • Unformatted value

    値は計算されますが、返信ではフォーマットされません。 例えば、A11.23A2=A1 で通貨の形式に設定されている場合、A2 は数値 "1.23" を返します。

  • Formula

    値は計算されません。 返信には数式が含まれます。 例えば、A11.23A2=A1 で通貨の形式に設定されている場合、A2"=A1" を返します。

Date and time render option
  • Serial number

    日付、時刻、日時、期間のフィールドは、Lotus 1-2-3で普及しているように、「シリアル番号」形式で倍数として出力されます。 値の整数部分(小数点の左側)は、1899年12月30日からの日数を数えます。 小数部分(小数点の右側)は、時間を日の端数として数えます。 例えば、1900年1月1日の正午は、1899年12月30日の 2 日後で、正午は半日後なので 0.5 なので 2.5 になります。 1900年2月1日の午後3時は33.625です。 これは、1900年をうるう年として正しく扱います。

  • Formatted string

    日付、時刻、日時、期間のフィールドは、指定された数値形式(スプレッドシートのロケールに依存します)で文字列として出力されます。

Maximum number of returned rows
1回の実行サイクルでWorkfront Fusionが返す最大行数を設定します。

行の検索(詳細)

指定された条件に一致する結果を返します。

Connection
Google Sheets アカウントをWorkfront Fusionに接続する手順については、接続の作成 – 基本手順を参照してください。
Spreadsheet
検索するシートが含まれているGoogle スプレッドシートを選択します。
Sheet
検索する行を含むシートを選択します。
Query

Google Charts Query Language を使用します。 例: select * where B = "John"

Google Charts Query Language について詳しくは、Google ドキュメントの クエリー関数リファレンスを参照してください。

使用制限

エラー 429: RESOURCE_EXHAUSTED が発生した場合、API のレート制限を超えています。

Google Sheets API には、1 プロジェクトあたり 100 秒あたり 500 個のリクエストと、1 ユーザーあたり 100 秒あたり 100 個のリクエストという制限があります。 読み取りと書き込みの制限は、別々に追跡されます。 1 日の使用制限はありません。

詳しくは、developers.google.com/sheets/api/limits を参照してください。

ヒントとテクニック

Google Sheetから空のセルを取得

空のセルを取得するには、行の検索(詳細) ​ モジュールを使用できます。 この数式を使用して、空の列を取得します。

select * where E is null

ここで、「E」は列、「is null」は条件です。 Googleのクエリ言語を使用して、より高度なクエリを作成できます。 詳しくは、Google ドキュメントのGoogle Query Langを参照してください。

シートへのシナリオを実行するためのボタンの追加

  1. Workfront Fusionで、Webhook > カスタム webhook モジュールをシナリオに挿入して設定します。 手順については、Webhookを参照してください。

  2. Web フックの URL をコピーします。

  3. シナリオを実行します。

  4. Google Sheet のメインメニューバーから​挿入図面… を選択します。

  5. 描画 ウィンドウで、ウィンドウの上部付近にある​テキストボックス アイコン ​ テキストボックス ​ をクリックします。

  6. ボタンをデザインし、右上隅にある「保存して閉じる」ボタンをクリックします。

  7. ボタンはワークシートに配置されます。 ボタンの右上隅にある 3 つの縦並びのドットをクリックします。

  8. メニューから「スクリプトを割り当て….」を選択します。

  9. スクリプト(関数)の名前(例:runScenario)を入力して、「OK」をクリックします。

  10. メインメニューバーから​ツールスクリプトエディター​を選択します。

  11. 次のコードを挿入します。

    • 関数の名前は、手順 9 で指定した名前に対応している必要があります。

    • この URL を、手順 2 でコピーした web フックの URL に置き換えます。

      code language-none
      function runScenario() {
      UrlFetchApp.fetch("<webhook you copied>");
      }
      
  12. Ctrl + S を押してスクリプトファイルを保存し、プロジェクト名を入力して「OK」をクリックします。

  13. Google Sheets に戻って、新しいボタンをクリックします。

  14. スクリプトに必要な認証を付与します。

  15. Workfront Fusionで、シナリオが正常に実行されたことを確認します。

スプレッドシートでの日付の保存

書式なしでスプレッドシートに日付値を保存すると、スプレッドシートにISO 8601形式のテキストとして表示されます。 ただし、このテキストを理解しない日付で動作するGoogle Sheetsの数式または関数(例:数式=A1+10)には、次のエラーが表示されます。

エラー

Google Sheetsが日付を理解できるように、formatDate関数でフォーマットします。 2 番目の引数として関数に渡される正しい形式は、スプレッドシートのロケール設定によって異なります。

この関数について詳しくは、日付と時刻の関数の記事「formatDate (date; format; [timezone]) ​」を参照してください。

正しい形式を判断するには、次の手順を実行します。

  1. Google シートで、メインメニューから​ファイル > スプレッドシート​の設定を選択して、ロケールを確認および設定します。

  2. 適切なロケールを検証または設定したら、メインメニューから​形式 > 番号​を選択して、対応する日付と時刻の形式を決定します。 形式は、日付と時刻メニュー項目の横に表示されます。

  3. formatDate () ​関数に渡す必要がある正しい形式を作成するには、日付と時刻の書式設定🔗の トークンのリストを参照してください。

例:

MM/DD/YYYY HH:mm:ss形式(米国ロケールの場合):

​ ロケール時間の数式

Google Sheets 関数の活用

Google Sheetsの組み込み関数を使用するには、それを利用します。 詳しくは、「関数を使用してアイテムをマッピングする Google Sheets 関数」を参照してください。

Google Sheetsが数値を日付に変更できないようにする

テキストとして使用している数値の文字列がGoogle ワークシートの日付として解釈されている場合は、数値をプレーンテキストとして事前にフォーマットして、これを防ぐことができます。 例えば、「1-2019」と入力してテキストとして入力すると、Googleはそれを日付として解釈する場合があります。

  1. Google Sheets で、数値を含む列またはセルをハイライト表示します。
  2. 形式数字プレインテキスト​をクリックします。

Workfront Fusionのもう1つの回避策は、数字の前にアポストロフィ(')を入力することです(例:「1-2019」または「1/47」)。 Workfront Fusionからデータを送信した後、セルにアポストロフィが表示されません。

recommendation-more-help
workfront-fusion-help-workfront-fusion