Deluge Functionsの定義

Delugeは、Zohoクラウド環境のネイティブオンラインスクリプト言語です。Delugeを使用して、Business Logicを記述し、複数のZohoアプリケーション間でActionsを自動化し、サードパーティの外部サービスとの統合を有効にすることができます。また、一般的なタスクを実行するための組み込み関数のパックも含まれており、これを使用してアプリケーションロジックを迅速に構築し、アプリケーションの機能を強化できます。Delugeはユーザーフレンドリーな構文を持ち、強力なアプリケーションを素早く構築できます。

Deluge Functionsを使用して、ConvoKraft Botsのバックエンドロジックをシームレスにコーディングできます。Deluge Functionsでサポートされるデータ型の詳細については、こちらのページをご覧ください。

ConvoKraftは、BotsのBusiness Logicを定義するために、それぞれ独自の目的と呼び出しポイントを持つ以下の定義済みDeluge Functionsを提供しています。

• Execution関数
• Context Handler関数
• Button Click関数

システム定義の入力引数

以下のシステム定義入力引数は、すべての定義済みDeluge Function型で使用できます：

上記のシステム定義引数に加えて、コンソールでActionに定義されたすべての静的paramも、各Deluge Functionの入力引数として個別に利用可能になります。ConvoKraftはすべての変数に適切な値を設定し、すべての関数の入力引数として渡します。

ConvoKraftが提供する組み込みエディタでDeluge Functionsをコーディングできます。このセクションでは、エディタ、その使用方法と機能について詳しく説明します。

コードエディタの概要

ConvoKraftのDelugeエディタは、基本的な操作から複雑な操作まですべてを同じ場所で実行できる統合されたエクスペリエンスを提供します。タスクをドラッグしてエディタのスクリプト領域にドロップすることでスクリプティングが可能です。変数の設定、情報ステートメントやコメントの追加、if、else if、elseを含む条件ステートメントの追加への迅速なアクセスを提供します。

さらに、エディタを使用してメールで通知を送信したり、Zoho Cliq（Zohoが提供するコミュニケーションプラットフォーム）に通知として投稿したりすることもできます。他のZohoサービスや、Webhooksを使用して外部サーバーでホストされているアプリケーションと統合することもできます。コレクションの作成、コレクションへのデータ挿入、データの取得、更新、削除、またはコレクションの各要素の取得が可能です。Delugeエディタの詳細については、こちらのページをご覧ください。

ConvoKraftは、エディタ内のDeluge Functionsの構文と戻り値の正確性を自動的に検証します。

構文の検証

構文の検証は、Deluge Functionを保存しようとするたびに行われます。コンパイル時エラーにより構文の検証が失敗した場合、関数は保存されず、適切なエラーメッセージが表示されます。コンパイル時エラーには、不正な構文、句読点、変数初期化の欠落などが含まれます。

戻り値の検証

構文の検証に加えて、ConvoKraftコードエディタでのすべての関数実行に対して、Deluge Functionsの戻り値も検証されます。Deluge Functionsの定義済み戻り値形式の詳細については、こちらのページをご覧ください。

戻り値の検証は、コンソール内のBotのチャットウィンドウを使用してActionをテストする際に実行されます。Test this botをクリックして対話を開始します。ConvoKraftは、message、card、broadcast、followupなどのレスポンス内のキーのデータ型を検証します。

Actionの適切な機能のために、Deluge Functionsの戻りマップ内のすべての値を必ず満たすようにしてください。関数の戻り値が指定された形式に違反している場合、エラーを引き起こしたJSON要素を含むエラーメッセージがLogsウィンドウに表示されます。

関数ログ

すべてのログには、以下のラベルの少なくとも1つが含まれます：

• INFO：デバッグ情報を表示し、コード内で指定されたものを出力します。

• WARNING：何かが間違っているまたは異常と検出された場合に警告テキストを表示します。たとえば、コード内での非推奨構文の使用などです。警告はAction実行中に無視されます。

• ERROR：コードの実行中に発生するエラーを表示します。たとえば、構文の不一致や未処理の例外などです。エラーはAction実行を中断し、適切なメッセージが応答としてスローされます。

エディタ内でさまざまなログレベルを切り替えて、それぞれのログのみを表示できます。