add-excel

📋 共通手順： shared-instructions.md - 横断的な注意事項です。

Excel Online を追加する

ワークフロー

1. メモリーバンクを確認 → 2. 情報を収集 → 3. コネクタを追加 → 4. 設定 → 5. ビルド → 6. メモリーバンクを更新

---

ステップ 1：メモリーバンクを確認する

memory-bank.md に従って、memory-bank.md を確認します。

ステップ 2：情報を収集する

ユーザーに次の情報を尋ねます。

1. ワークブックの保存場所（OneDrive または SharePoint）
2. ワークブックのファイル名
3. アクセスするワークブック内のテーブル

ステップ 3：コネクタを追加する

まず、接続 ID を確認します（connector-reference.md を参照してください）。

/list-connections スキルを実行します。出力から Excel Online (Business) の接続を探します。接続がない場合は、環境固有の接続 URL を使って作成するようユーザーに案内します。現在の環境 ID（power.config.json または前のステップから取得）を使って URL を組み立てます：https://make.powerapps.com/environments/<environment-id>/connections → + 新しい接続 → コネクタを検索 → 作成。

Excel Online は表形式のデータソースです。-c（接続 ID）、-d（ドライブ）、および --table（ワークブック内のテーブル名）が必要です。

# OneDrive workbook
pa app add data-source --connector excelonlinebusiness -c <connection-id> -d 'me' --table 'Table1'

# SharePoint workbook -- dataset is the document library path
pa app add data-source --connector excelonlinebusiness -c <connection-id> -d 'sites/your-site' --table 'Table1'

ユーザーが必要とするテーブルごとに実行します。

ステップ 4：設定する

AddRowIntoTable -- Excel テーブルに行を追加します。

// OneDrive workbook
await ExcelOnlineBusinessService.AddRowIntoTable({
  source: "me",
  drive: "me",
  file: "MyWorkbook.xlsx",
  table: "Table1",
  body: { column1: "value1", column2: "value2" } // Flat object, NO "items" wrapper
});

// SharePoint workbook
await ExcelOnlineBusinessService.AddRowIntoTable({
  source: "sites/your-site",
  drive: "drive-id",
  file: "SharedWorkbook.xlsx",
  table: "Table1",
  body: { column1: "value1", column2: "value2" }
});

重要なポイント：

• OneDrive の個人用ファイルには source: "me" と drive: "me" を指定します。
• SharePoint の場合は、サイトパスとドライブ ID を使用します。
• body は列ヘッダーに対応するフラットなキーと値のオブジェクトです。{ items: ... } で囲まないでください。

Grep を使って、src/generated/services/ExcelOnlineBusinessService.ts 内の特定のメソッドを探します（生成ファイルは非常に大きい場合があります。connector-reference.md を参照してください）。

ステップ 5：ビルドする

npm run build

続行する前に、TypeScript のエラーを修正します。まだデプロイしないでください。

ステップ 6：メモリーバンクを更新する

memory-bank.md を更新し、追加したコネクタ、設定したワークブックとテーブル、ビルドの状態を記録します。