メインコンテンツへスキップ

​
クールカードのワークフローについて

カードの送信と更新は統合と自動化によって行われます。ここでは「チームビルディングのフィードバック収集」シナリオを例に、統合と自動化を用いた実装方法を説明します。

​
ビジネスシナリオ

  1. 「チームビルディングのフィードバック収集」フォームを用意します。社員がフォームを送信すると、送信内容がグループチャットにカードとして送信されます。
  2. 他の社員はグループ内でそのカードを確認し、いいねを付けたり、自分のチームビルディングのフィードバックを送信したりできます。
フォーム例：
グループ内のカード例：

​
1. 統合と自動化

統合と自動化：イベントによってトリガーされるビジネスオーケストレーション／ワークフローです。 「チームビルディングのフィードバック」フォームを送信してグループにカードを送信する — このシナリオでは、フォームの送信が「イベント」に、グループへのカード送信が「ワークフロー」に該当します。
統合と自動化の詳細については、統合と自動化を参照してください。本記事では、統合と自動化を通じてカードを送信・更新する方法に焦点を当てます。 統合と自動化のエントリ
「チームビルディングカード送信」のワークフロー例

​
2. フォームイベントトリガー

機能：フォームが送信、更新、または削除された際にワークフローをトリガーします。 シナリオ例：「チームビルディングのフィードバック収集」フォームを用意し、社員がフォームを送信すると、送信内容がグループチャットにカードとして送信されます。
  1. 「フォームイベントトリガー」を含む統合と自動化を作成します。作成 > 名前を入力 > 「チームビルディングのフィードバック送信」フォームを選択の順にクリックします。
  1. ワークフローデザイナーに入り、フォームイベントトリガーを選択します。
  1. 「カード送信」ノードを追加します。
  1. 「カード送信」ノードを設定します。設定内容は「カードを選択」→「カードコンテンツを設定」→「属性設定」です。各設定項目の詳細については、セクション4「カード送信ノードの設定」を参照してください。

​
3. 手動カードトリガー

機能：カード上のボタンがクリックされた際にワークフローをトリガーします。 シナリオ例：社員がグループ内でチームビルディングのフィードバックカードを確認し、「いいね」ボタンをクリックしていいねを追加します。
  1. 「手動カードトリガー」を含む統合と自動化を作成します。作成 > 名前を入力 > 「チームビルディングのフィードバック送信」フォームを選択の順にクリックします。
フォーム選択のルール：カードはフォームイベントトリガーワークフローによって送信されるため、手動カードトリガーで選択するフォームは、フォームイベントトリガーで選択したフォームと同一でなければなりません。これにより、カードのコンテキストの一貫性が保たれます。
  1. ワークフローデザイナーに入り、「単一レコード取得」ノードを追加して、いいね数を更新する対象のチームビルディングフィードバックレコードを絞り込みます。
  2. 「データ更新」ノードを追加し、直前の「単一レコード取得」ノードで絞り込んだチームビルディングフィードバックのいいね数を更新します。
  1. 「カード更新」ノードを追加し、グループ内の対応するカードのいいね数を最新の値に更新します。

​
4. カード送信ノードの設定

このセクションでは、カードノードの設定に焦点を当てます。ここでいうカード設定はカードデザインとは異なる点にご注意ください。カードデザインについては、クールなカードデザインドキュメントを参照してください。 カードにはスタイル、データ、ボタン／リンクの3つの要素があります。カードデザインは主にスタイルを扱い、カード設定はそれ以外の要素（データ、ボタン／リンク）に焦点を当てます。 設定手順：1) 送信／更新するカードを選択、2) カードにデータをバインド、3) カードのボタン／リンクのアクションを設定、4) 送信スコープとルールを定義。 1) 送信／更新するカードを選択
公式のカードテンプレートまたはカスタムカードテンプレートを選択できます。選択後、「カードプレビューを開く」をクリックしてカードのスタイルをプレビューできます。 2) カードにデータをバインド
ワークフロー内の各ノードから取得したデータを、カード上の対応するデータ変数にバインドします。（カードの3要素：スタイル、データ変数、ボタン／リンク。） 3) カードのボタン／リンクのアクションを設定
カードのボタンは、「手動カードトリガー」ワークフローまたはリンクにバインドできます。 ボタンをリンクにバインドするかワークフローにバインドするかは、カードデザイン時に決定します。 カードデザイン時に、ボタンクリックを異なるイベントタイプにマッピングできます。通常はカスタムアクションまたはリンクリダイレクトを選択します。
カスタムアクション：「手動カードトリガー」ワークフローをバインドします。ボタンをクリックすると、対応するワークフローが実行されます。 リンクリダイレクト：ボタンをクリックすると、対応するリンクが開きます。リンクの値は固定値（カードデザイン時に入力）または変数（統合と自動化のカードノードで設定）にできます。
4) 送信スコープとルールを定義 カードの送信スコープ：個別のユーザーまたはグループに送信します。
グループは「現在のグループ」に設定できます。 「現在のグループ」：クールアプリがグループにインストールされた後、そのグループ内のフォームリンクからフォームデータが送信された場合、送信先を「現在のグループ」に設定すると、カードはフォームが送信されたグループに送信されます。
カード送信ルール： シナリオ1：送信されたフォームレコードごとに1枚のカードを送信 — 「フォームインスタンスID」フィールドを選択します。 シナリオ2：当日送信されたすべてのフォームレコードに対して1日1枚のカードのみを送信 — 現在の日付を表すフィールドを選択します。

​
5. カード更新ノードの設定

カードには特徴的な機能があります。それは、コンテンツを更新できることです。この点が通常のチャットとの違いであり、グループがメッセージで埋め尽くされるのを防ぎます。 カード更新の設定手順：1) 更新するカードを選択、2) カード更新ルールを定義、3) 更新するデータを設定。 重要なポイントは2つあります。
  1. カードは送信された後でなければ更新できません。
  2. カード更新ルールで設定するフィールドは、カード送信ノードのカード送信ルールで設定したフィールドと一致する必要があります。これにより、正しいカードが更新されます。

​
その他のベストプラクティス（食事注文アクティビティ設定を例に）

「食事注文クールアプリ」では、「ヘルシーミール予約アクティビティを開始」と「ヘルシーミール予約アクティビティに参加」の両方で、アクティビティを紐付けてマークするための一意の識別子（シリアル番号）が必要です。では、このシリアル番号はどのように設定するのでしょうか。 1. ヘルシーミール予約アクティビティを開始
まず、「ヘルシーミール予約アクティビティを開始」フォームでシリアル番号機能を有効化し、シリアル番号のルールを設定します。ページ設定 → 基本設定 → プレミアム設定 → ユーザーがフォーム／ワークフローを送信後にシリアル番号を自動生成、の順にクリックし、保存します。
次に、「ヘルシーミール予約アクティビティを開始」フォームに「一行テキストボックス」コンポーネントを「アクティビティシリアル番号」として追加し、「非表示」に設定したうえで、データ送信を「常に送信」に設定します。
最後に、関数 SETSERIALNO(アクティビティシリアル番号) を使用してシリアル番号を自動生成するグローバルフォームイベントを追加します。新しいフォームインスタンスが送信されると、システムが自動的にシリアル番号を生成し、その値をテキストボックスに入力します。以降のすべての設定は、このシリアル番号に基づいてレコードのマッチングと関連付けを行います。
2. ヘルシーミール予約アクティビティに参加 まず、「ヘルシーミール予約アクティビティに参加」フォームにも同様に「一行テキストボックス」コンポーネントを「アクティビティシリアル番号」として追加し、「非表示」に設定したうえで、データ送信を「常に送信」に設定します。
次に、didMount 関数内で url から serialNumber パラメータを取得し、その値を「アクティビティシリアル番号」コンポーネントに割り当てます。ここで、textField_l3wp3mge は「アクティビティシリアル番号」コンポーネントの fieldId です。
3. 統合と自動化の設定
まず、「アクティビティ開始」の統合と自動化設定で、カード上のボタンに「システムシリアル番号」パラメータ（上記で生成されたシリアル番号）を追加し、シリアル番号がフォームに渡されるようにします。 次に、「ユーザーが注文を送信」の統合と自動化設定で、「アクティビティシリアル番号」によって「現在開始中の食事注文アクティビティ」を絞り込みます。
「食事注文ユーザーリストを取得」ノードでは、現在のフォームから送信された「アクティビティシリアル番号」に基づいて、対応する食事注文ユーザーリストをマッチングします。
「注文データサマリーカンバンカード」でも、「注文を表示」および「詳細分析」ボタンにシリアル番号パラメータを追加し、フォームがデータの絞り込みと分析のためにそれを取得できるようにします。