Ruleの作成

PublisherとEvent Functionの設定が完了したので、Ruleを設定してイベントの処理と配信方法を定義しましょう。

Ruleを作成するには、以下の手順に従ってください：

1. Developer Consoleで、プロジェクトInvoiceNotifierを選択します。

2. Catalyst Signalsに移動し、左側のナビゲーションでRulesをクリックします。
   

3. Add Ruleをクリックし、Ruleの名前と説明を入力します。
   

イベントソースの定義

4. Sourceの下でChoose Eventをクリックし、先ほど追加したZoho Books Publisherを選択します。

5. 利用可能なイベントの一覧からCustomer Payment Createdを選択し、Doneをクリックします。
   

イベントフィルターの定義

6. Filterセクションで編集アイコンをクリックし、Events matching certain conditionsを選択します。
   

7. 請求書ステータスがPaidのイベントのみを含むフィルター条件を作成します：

   • Pathドロップダウンで、payment_statusフィールドに対応するJSONパスを選択します。
   • Paidに一致する条件を定義します。

8. Saveをクリックしてフィルターを適用します。
   

ターゲット設定の構成

9. Choose Targetをクリックし、ターゲットに名前を付けます。

10. Consumer Typeで、CLIで先ほど作成したEvent Functionを選択します。

11. Dispatch PolicyをBatch by Intervalに設定します：

    • インターバルを1時間に設定します。
    • Retry Countを5に設定します。
      

ペイロードの変換

12. Target InputセクションでTransformを選択します。

13. Customer Payment Createdイベントのデフォルトイベントペイロードから、必要なデータのみを選択し、以下のように構造化します。

{
    "data" : [
        [
            {
                "Customer" : "test",
                "Invoice Number" : "Customer opening balance",
                "Amount" : "₹3,24,244.00",
                "Paid On" : "31/10/2023",
                "Invoice Id" : "275557000000158181"
            }
        ]
    ]
}

{
    "data" : $.events.forEach((event)->
        event.data.payment.invoices.forEach((invoice)->
            {
                "Customer" : event.data.payment.customer_name,
                "Invoice Number" : invoice.invoice_number,
                "Amount" : invoice.total_formatted,
                "Paid On" : event.data.payment.date_formatted,
                "Invoice Id" : invoice.invoice_id
            }
        )
    )
}

この構造をテンプレートコンパイラに貼り付けて、必要なフィールドを抽出し、Generate Outputをクリックします。

イベントペイロードのカスタマイズ方法の詳細については、イベントボディ変換ヘルプガイドを参照してください。

14. ターゲット設定を保存し、SaveをクリックしてRuleを確定します。

これで、顧客が支払いを完了するたびに、Zoho Booksの対応する請求書が更新されます。この更新によりイベントがトリガーされ、Catalyst Signalsで毎時処理され、Zoho Cliqチャンネルにサマリーメッセージが自動的に送信されます。