テーブルの新しい行(トリガー)

このピースでできること

  • Microsoft Excel 365のテーブルに新規行が追加されたときに検知してワークフローを起動します。
 

Microsoft Excel 365の接続方法

1. 接続を作成

  • 接続から「接続を作成」をクリックします。

2. 接続設定

  • 接続名を設定して、「接続する」をクリックします。
 

3. Excelへのアクセス許可を与えます

  • 管理者アカウントを選んでログインします。

4. 「保存」を押して接続名が設定されていることを確認します

  • 「保存」を押して接続名が設定されていることを確認します。

⚠️ Microsoft系アプリで管理者の同意が必要な場合

企業のMicrosoftセキュリティポリシーにより、外部アプリへのアクセス許可がブロックされている場合、接続時に以下のようなメッセージが表示されることがあります。
「workrunには、組織内のリソースへのアクセス許可が必要です。このアクセス許可を付与できるのは管理者のみです。」
この場合、貴社の情シス部門にMicrosoft Entra IDでの管理者同意(Admin Consent)の付与を依頼してください。
【標準のworkrun接続を利用している場合に、情シス担当者へ共有する情報】
  • アプリ表示名:workrun
  • クライアントID:f099e7f6-b923-41ce-9362-ee72073805f4
自社Azureアプリを利用している場合は、自社で登録したアプリの表示名とクライアントIDを共有してください。
管理者同意の具体的な手順は、以下のMicrosoft公式ドキュメントをご参照ください。
管理者同意の付与後、再度Microsoft Excel 365へのアクセス許可を行ってください。

ピースの設定項目

1. Excelファイル ソース(必須)

  • OneDrive または SharePoint を選択します。初期値は OneDrive です。

2. Sharepoint サイト(SharePointの場合に必要)

  • SharePointを選ぶ場合は、対象のサイトを選択します。

3. Sharepoint ドキュメントライブラリ(SharePointの場合に必要)

  • 対象のドキュメントライブラリを選択します。OneDriveの場合はサイト・ライブラリの指定は不要です。

4. ワークブック(必須)

  • f(動的値)をクリックすると任意で入力できます。

5. ワークシート(必須)

  • f(動的値)をクリックすると任意で入力できます。

6. テーブル(必須)

  • f(動的値)をクリックすると任意で入力できます。

7. 先頭行をヘッダーとして使用(必須)

  • f(動的値)をクリックすると任意で入力できます。

取得できる情報

選択したExcelテーブルの行を、1行ずつ取得できます。
  • :テーブル内の0始まりの行インデックス。ワークシートの行番号とは異なります。
  • :セルの値をまとめたオブジェクト。ヘッダー設定が有効かつヘッダーの取得・キャッシュが利用できる場合は列名がキーです。
  • ヘッダーを利用できない場合は / などの列文字をキーにします。

取得条件と注意点

  • 「Excelファイル ソース」でOneDriveまたはSharePointを選びます。SharePointの場合はサイト・ドキュメントライブラリも必要です。
  • 保存した行インデックスより大きい行を候補にします。行内容の更新を比較する方式ではありません。途中への行挿入や削除による位置の変化を含め、常に新規追加だけを一度ずつ検知する保証はありません。
  • ヘッダーはキャッシュされるため、後から列名を変更しても出力キーへすぐ反映されるとは限りません。ヘッダー取得に失敗した場合は列文字で出力します。
  • 行一覧は先頭ページの応答だけを使います。テストは取得した最大5行で、通常実行と同じ新規行の境界判定ではありません。

利用例

の各キーを後続の登録項目へ対応付け、追加されたテーブル行の内容を渡せます。

出力例(抜粋)

キーと階層を示す架空例です。実際の項目・値は受信内容や接続先により異なります。