新しいカスタム関数の作成

Deluge（デリュージ）とは、Data Enriched Language for the Universal Grid Environmentの略語で、Zohoサービスと連携したオンラインのスクリプト言語です。このスクリプトを使用すると、さまざまな種類のロジックや処理をカスタム関数に追加できます。保存してあるデータの値を関数の中で利用することも可能です（関連項目：Delugeスクリプト - ガイド）。

対象者

ワークフローの自動化ルールを設定するヘルプデスク管理者
Delugeスクリプトの知識を持つプログラマー

必要な権限
この機能を利用するには、 システム管理者の権限が必要です。
各プランの機能と制限を確認する

新しい関数の作成

新しいカスタム関数は次の3つの手順で作成できます：

カスタム関数を作成する
カスタム関数をワークフロールールに関連付ける
カスタム関数の処理をテストする

カスタム関数を作成するには：

上部のバーにある設定アイコン ( )をクリックします。
［設定］ページで、［自動化］の［ワークフロー］をクリックします。
［ワークフロー］のサブメニューで、［カスタム関数］をクリックします。
［カスタム関数］ページで、右上にある［新しいカスタム関数］をクリックします。
［カスタム関数の設定］ページで、［自分で作成］をクリックします。
［Delugeスクリプト］ページで、次の手順を実行します：

関数の名前を入力し、それらの項目を変更するタブを選択します。
［引数の編集］リンクをクリックします。
［引数の編集］ボックスで、引数をサポートタブの項目と関連付けるか、指定値を設定します。
［完了する］をクリックします。

Delugeスクリプト作成ツールで、必要な関数を作成します。コードを認証するには、［スクリプトを保存して実行］をクリックします。
エラーがなければ、ワークフロールールにスクリプトを関連付ける準備が整いました。
［保存する］をクリックします。

ワークフロールールにカスタム関数を関連付けるには：

上部のバーにある設定アイコン ( )をクリックします。
［設定］ページで、［自動化］の［ワークフロー］をクリックします。
［ワークフロールール］ページの右上にある［ルールを作成する］ をクリックします。
［新しいワークフロー］ページで、ワークフローに関する基本情報を入力して、［次へ］をクリックします。
次のページで、実行する処理とワークフロールールのパラメーターを設定します。
［処理］で、関数の追加アイコン ( )をクリックし、既存のカスタム関数を選択します。
次のページで、関連付けるカスタム関数を選択し、［保存する］をクリックします。

メモ：

または、［処理］で、カスタム関数の［新規］ をクリックして、新しい関数を作成することもできます。完了したら、［保存して関連付ける］をクリックして、ワークフローに関数を関連付けます。

カスタム関数の連携をテストするには：

ワークフロールールの条件に基づいて、Zoho Deskにデータを追加する必要があります。
カスタム関数を利用してZoho Deskから取得したデータの内容を確認します。
データが受信されなかった場合、またはアプリケーションに不一致があった場合は、Zoho Deskでカスタム関数コードを修正します。
Zoho Deskからアプリケーションに必要なデータを取得するまで、関数のテストを続けることができます。

重要事項

1件のワークフローにつき関連付けられるカスタム関数は、1件だけです。
Zoho Deskから外部アプリケーションに対し、最大10件のサポート項目の値（引数）を送信できます。
カスタム関数を使用して、他のアプリケーションからZoho Deskにデータを取得できます。
APIの認証情報は、外部アプリケーションの制限にしたがって、定期的に更新する必要があります。
カスタム関数において、外部アプリケーションのAPIの問題が原因で機能を停止しても、通知メールは送信されません。
Zoho Creatorサービスへの接続が確立できなかった場合、システムはその特定のワークフローの通知の送信を停止する前に3回再試行します。エラーが発生した場合じゃ、［失敗］セクションに表示されます。
一日あたりの上限を超えた場合、システムから外部アプリにカスタム関数の残数情報は送信されませんが、管理者に障害を通知します。
「send mail」（メール送信）のdelugeタスクを設定する際、「差出人」または「宛先」アドレスのいずれかにヘルプデスク管理者のメールアドレスが含まれている必要があります。
対象のサービスに応じた「連携タスク」を初めて作成すると、それぞれのユーザーの認証情報がそのサービスに保存されます。

Delugeスクリプト作成ツールの使用

Delugeスクリプト作成ツールでは、ドラッグ＆ドロップ操作で関数の内容を設定でき、Zoho Desk内でその関数を実行できます。Delugeスクリプトの構文や関数を覚える必要もなく、処理の内容を簡単に記述できます。次の内容から構成されます：

Delugeのスクリプトコード(1)
Delugeのタスク(2)

条件
その他
デバッグ
リストの操作
マップの操作
Webデータ
XMLの操作

コードの実行(3)

Delugeの標準の認証情報

Delugeの編集画面では、あらかじめ定義されている2種類の認証情報のみを使用できます。

loginUserId：現在Zoho Deskポータルにサインインしているユーザー
adminUserId：DRE（外部連携の管理ページ）の管理者

カスタム関数や新しい連携を最初に作成／実行したZoho Deskユーザーは、DREの管理者に設定されます。

DREの管理者の詳細情報を取得するには、Delugeの編集画面で以下の画像内に表示されているコマンドを実行します。

(1) カスタム関数スクリプトでのadminUserIdの使用

adminUserIdが、Delugeのメール送信処理のカスタム関数スクリプトで差出人メールアドレスとして使用されている場合、受信者（宛先メールアドレス）のメールボックスでは、メールの差出人として現在のDREの管理者のユーザー名が表示されます。

(2) カスタム関数スクリプトでのadminUserIdの更新

adminUserIdは、Delugeの編集画面で直接変更できません。現在のadminUserIdを別のZoho Deskユーザーに変更する必要がある場合は、サポート窓口に以下の情報を提供し、情報の更新を依頼してください。

既存の情報

メールアドレス（例：abc@zylkers.com）

ZUID（例：12345）

更新後の情報

メールアドレス（例：xyz@zylkers.com）

ZUID（例：98765）

情報の確認が完了すると、更新対応が開始されます。

Delugeのタスクの一覧

Delugeのタスク	用途
条件	if、else if、else conditional if
その他	set variable call function send mail share または unshare return add comment
デバッグ	info
リストの操作	create list add remove index remove element add all remove all clear sort for each element for each index
マップの操作	create map put key put all keys remove key clear map
Webデータ	get url post url
XMLの操作	executeXPath