Edge Delivery ServicesのForms送信サービス

次に最適：

• コンテンツ作成者 シンプルなデータ収集フォームの作成
• 迅速なフォームからスプレッドシートへのワークフローが必要な中小規模企業
• マーケティングチーム リード情報の収集
• 主催者 登録の管理

次の代替策を検討してください：

• カスタムロジックが必要な複雑なワークフロー
• データベースとのエンタープライズ統合
• 高度な検証または処理を必要とするForms

• バックエンドインフラストラクチャなし 必須 – Adobeは送信エンドポイントをホストします
• 一般的なスプレッドシートプラットフォームを使用した 直接統合
• フォームフィールドからスプレッドシート列への 自動データマッピング

• 即時のデータ取得 – 送信された内容は、即座にスプレッドシートに表示されます
• 構造化ストレージ – 分析を容易にする整理された列
• ライブコラボレーション – 複数のチームメンバーがデータにアクセスして分析できます。

• 既存の権限を活用 - スプレッドシートプラットフォームの共有コントロールを使用します。
• Adobeで管理されるセキュリティ - エンタープライズクラスの保護により、送信エンドポイントを保護します
• データの所有権 - データは、選択したスプレッドシートプラットフォームにとどまります

• GitHub リポジトリ 最新のアダプティブ Forms ブロックがインストールされたEdge Delivery Services プロジェクト用に設定されます
• アクセスの承認 - リポジトリが許可リストに追加されました

サポートされているプラットフォームを選択します。

• Google シート - シート作成権限のあるGoogle アカウント
• Microsoft OneDrive - Microsoft 365 アカウント （Excel Online アクセスあり）
• SharePoint - リスト/ライブラリ権限を持つSharePoint アクセス

• 対象スプレッドシートの 編集権限
• へのアクセスを許可する 共有機能 forms@adobe.com
• 選択したプラットフォームの リンクの生成 権限

どちらの方法を設定する場合でも、事前にAEM プロジェクト基盤の準備が整っていることを確認してください。

1. AEM プロジェクトを作成または更新 し、最新のアダプティブ Forms ブロックを使用します（ はじめる前にチュートリアル）。

2. プロジェクトルートのfstab.yaml を更新します。

   code language-yaml
   # Replace with the path to your shared folder mountpoints: /: https://drive.google.com/drive/folders/your-shared-folder-id

3. プロジェクトフォルダーの共有 を forms@adobe.com と共有する（編集権限が必要）

Google Sheets またはMicrosoft Excel を使用してフォーム構造を作成します。

フォーム作成手順：

1. スプレッドシートプラットフォームを開く （Google Sheets またはMicrosoft Excel）
2. フォームプロジェクトの 新しいスプレッドシートの作成
3. シートに名前を付ける （helix-default または shared-aem のいずれかにする必要があります）
4. フォーム作成ガイド 使用した フォーム構造の定義

例：フィールドタイプ、ラベル、検証ルールを含むフォーム定義

検証チェックポイント：

• すべての必須フィールドでフォーム構造が完了しています
• シートに正しい名前を付ける（helix-default または shared-aem）
• フィールドタイプと検証ルールが適切に設定されている

フォーム送信データを受け取る専用シートを設定します。

データ シートの設定：

1. 既存のスプレッドシートに 新しいシートを追加 します
2. シートに正確にincoming の名前を付ける（大文字と小文字を区別）
3. フォームフィールドに一致する 列ヘッダーの設定
4. スプレッドシートを保存 して、変更が保持されるようにします

例：フォームフィールドと一致する列ヘッダーを持つ受信シート

検証チェックポイント：

• シート incoming スプレッドシートに存在します
• 列ヘッダーは、フォームフィールド名と一致します
• シートは適切に保存され、アクセス可能です

スプレッドシートへのAdobe Forms送信サービスへのアクセス権を付与します。

共有プロセス：

1. スプレッドシートの右上隅にある 「共有」ボタンをクリック します

2. Adobe サービスアカウントを追加します。

   • 電子メール：forms@adobe.com
   • 権限レベル：エディター （データの書き込みに必要）

3. 共有招待を送信する

4. 次の手順のために スプレッドシートリンクをコピー します

   
   Adobe サービスアクセスを許可するためのステップバイステップの共有プロセス

プラットフォーム固有の手順：

Google シート：

• forms@adobe.com をエディターとして追加
• 「リンクを持つすべてのユーザーが表示できる」が有効になっていることを確認します
• 共有可能なリンクをコピー

Microsoft Excel （OneDrive/SharePoint）:

• 編集権限を持つ forms@adobe.com を追加

• リンク共有を「リンクを持つすべてのユーザーが編集できる」に設定します

• 共有 URL をコピー

  
  例：フォーム設定の共有可能なリンクをコピーする

検証チェックポイント：

• forms@adobe.com はスプレッドシートに編集者としてアクセスできます
• スプレッドシートのリンクがコピーされ、使用できるようになりました
• 共有権限による外部アクセス

フォーム定義を送信スプレッドシートにリンクします。

フォームとスプレッドシートの接続：

1. フォーム定義スプレッドシートを開きます （helix-default または shared-aem シートが含まれているスプレッドシート）。

2. フォーム定義で 送信フィールドの行を見つけます

3. コピーしたスプレッドシートリンク を送信フィールドの アクション 列に貼り付けます

4. フォーム定義に 変更を保存 します

   

例：送信アクションをデータ収集スプレッドシートに接続する

フォームの公開：

1. ブラウザーで AEM Sidekickを開く
2. フォームをプレビュー して、設定をテストします
3. フォームを公開 してライブにする

最終検証：

• スプレッドシートリンクが「フィールドを送信」アクションに正しく追加される
• フォーム定義が保存され、公開されます
• フォームのプレビューに、すべてのフィールドが正しく表示される
• 「送信」ボタンが正しく設定されている

参考資料：

• 適切に設定された 完全なスプレッドシートの例
• 公開ガイダンスの AEM Sidekick ドキュメント

次に最適：

• 自動データ収集システム
• カスタムフォームの実装
• 既存のアプリケーションとの統合
• 一括データ送信ワークフロー

API を使用する前に、次のことを確認します。

• スプレッドシート設定 完了（incoming シートを含む）
• Adobe サービスアクセス が forms@adobe.com に付与されました
• 公開済みフォームの フォーム ID
• リポジトリ情報 （組織およびサイト名）

ベース URL: https://forms.adobe.com/adobe/forms/af/submit/{id}

必須ヘッダー：

• Content-Type: application/json
• x-adobe-routing: tier=live,bucket=main--[repository]--[organization]

API ドキュメント： ​ 完全な API リファレンス

Postmanは、API 送信をテストするための使いやすいインターフェイスを提供します。

設定手順：

1. Postmanでの 新しい POST リクエストの作成

2. エンドポイントを設定します： https://forms.adobe.com/adobe/forms/af/submit/{id}

3. プレースホルダーを置換：

   • 実際→フォーム ID を {id} します
   • [repository] → GitHub リポジトリ名
   • [organization] → GitHub 組織/ユーザー名

リクエスト設定：

POST https://forms.adobe.com/adobe/forms/af/submit/your-form-id

Headers:
Content-Type: application/json
x-adobe-routing: tier=live,bucket=main--your-repo--your-org

Body (JSON):
{
        "data": {
            "startDate": "2025-01-10",
            "endDate": "2025-01-25",
            "destination": "Australia",
            "class": "First Class",
            "budget": "2000",
            "amount": "1000000",
            "name": "Mary",
            "age": "35",
            "subscribe": null,
            "email": "mary@gmail.com"
                }
}

期待される応答：

• 状態コード： 201 Created
• データがすぐに スプレッドシート シートに表示されます incoming

例：Postman インターフェイスを使用した API 送信の成功

ターミナル/コマンドプロンプトを希望する開発者は、curl を使用してプログラムによりデータを送信します。

コマンドライン設定：

以下のコマンドの次のプレースホルダーを置き換えます。

• 実際→フォーム ID を {id} します
• [repository] → GitHub リポジトリ名
• [organization] → GitHub 組織/ユーザー名

curl -X POST "https://forms.adobe.com/adobe/forms/af/submit/your-form-id" \
    --header "Content-Type: application/json" \
  --header "x-adobe-routing: tier=live,bucket=main--your-repo--your-org" \
    --data '{
        "data": {
            "startDate": "2025-01-10",
            "endDate": "2025-01-25",
            "destination": "Australia",
            "class": "First Class",
            "budget": "2000",
            "amount": "1000000",
            "name": "Joe",
            "age": "35",
            "subscribe": null,
      "email": "joe@example.com"
                }
            }'

curl -X POST "https://forms.adobe.com/adobe/forms/af/submit/your-form-id" ^
    --header "Content-Type: application/json" ^
  --header "x-adobe-routing: tier=live,bucket=main--your-repo--your-org" ^
  --data "{\"data\": {\"startDate\": \"2025-01-10\", \"endDate\": \"2025-01-25\", \"destination\": \"Australia\", \"class\": \"First Class\", \"budget\": \"2000\", \"amount\": \"1000000\", \"name\": \"Joe\", \"age\": \"35\", \"subscribe\": null, \"email\": \"joe@example.com\"}}"

$body = @{
  data = @{
    startDate = "2025-01-10"
    endDate = "2025-01-25"
    destination = "Australia"
    class = "First Class"
    budget = "2000"
    amount = "1000000"
    name = "Joe"
    age = "35"
    subscribe = $null
    email = "joe@example.com"
  }
} | ConvertTo-Json -Depth 3

Invoke-RestMethod -Uri "https://forms.adobe.com/adobe/forms/af/submit/your-form-id" `
  -Method POST `
  -Headers @{"Content-Type"="application/json"; "x-adobe-routing"="tier=live,bucket=main--your-repo--your-org"} `
  -Body $body

成功した応答：

HTTP/1.1 201 Created
Connection: keep-alive
Content-Length: 0
X-Request-Id: 02a53839-2340-56a5-b238-67c23ec28f9f
X-Message-Id: 42ecb4dd-b63a-4674-8f1a-05a4a5b0372c
Date: Fri, 10 Jan 2025 13:06:10 GMT
Access-Control-Allow-Origin: *

データ検証：

送信に成功したら、データがスプレッドシートに表示されることを確認します。

例：データが API を介して受信シートに正常に書き込まれた

応答の検証：

• HTTP ステータス： 201 Created は、送信が成功したことを示します
• X-Request-Id: 送信をトラッキングするための一意の識別子
• データが 秒以内に incoming シートに表示されます
• すべてのフォームフィールド は、スプレッドシートの列に正しくマッピングされます

問題：403 Forbidden エラー

Causes: Missing or incorrect access permissions
Solutions:
- Verify forms@adobe.com has Editor access to your spreadsheet
- Check that your repository is added to the allowlist
- Confirm the x-adobe-routing header format

問題：404 エラーが見つかりません

Causes: Incorrect Form ID or endpoint URL
Solutions:
- Verify your Form ID is correct
- Check the API endpoint URL format
- Ensure your form is published and live

問題：スプレッドシートにデータが表示されない

Causes: Missing 'incoming' sheet or permission issues
Solutions:
- Confirm 'incoming' sheet exists (case-sensitive)
- Verify column headers match form field names exactly
- Check forms@adobe.com has edit permissions
- Ensure spreadsheet is shared properly

問題：無効な JSON 形式のエラー

Causes: Malformed request body
Solutions:
- Validate JSON syntax using online JSON validators
- Ensure proper escaping of special characters
- Check quote marks and brackets are balanced

サポートチャネル：

• アーリーアクセスの問題： 電子メール aem-forms-ea@adobe.com
• API ドキュメント： ​ 開発者向けリファレンス
• コミュニティサポート： ​Adobe Experience League コミュニティ

• 詳細Formsの作成– 検証、条件付きロジック、カスタムスタイル設定を追加します
• フォームコンポーネントガイド– 使用可能なフォームフィールドタイプを調べます

• AEM送信内容の公開 – 複雑なワークフローおよび企業の統合の場合
• カスタム送信アクション – 高度な送信処理

• Form Analytics - フォームのパフォーマンスと使用状況の追跡
• データ統合 - フォームをデータベースおよび CRM システムに接続します