課題のカスタム関数

お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。

カスタム関数を使用して、課題のワークフローを自動化できます。カスタム関数とは、処理を自動化するためのコードの一部です。Delugeで独自の関数を作成し、1つまたは複数のビジネスルールから呼び出すことができます。これは、Javascript の組み込み関数であるDATE、CONCAT、REPLACEなどと同様のものです。Zoho プロジェクトでは、ワークフロールールを使用して、課題の項目を自動的に更新できます。カスタム関数を利用すると、通知の自動送信、Webhook の呼び出し、ワークフロールールの実行後にロジックを実行することなどが可能になります。

機能の提供状況: 最新 エンタープライズ プラン

メリット

課題がエスカレーションされたときに、カスタム関数を使用してユーザーにメールまたは Zoho Chat で通知できます。
課題の重大度が更新されたときに、カスタム関数を使用して関連するコメントを課題に追加できます。
カスタム関数を使用して、Zoho アプリやサードパーティアプリとの連携を行うことができます。

カスタム関数を追加する

上部ナビゲーションバーのをクリックします。
［マーケットプレイス］に移動し、開発者向け情報の下にある カスタム Functions をクリックします。
Issues をドロップダウンボックスから選択します。
新規カスタム Function をクリックします。
Function 名前 と説明を入力します。
Arguments を設定します。
Deluge スクリプトエディターにコードを入力するか、エディター左側のパネルにある利用可能なパラメーターをドラッグ＆ドロップしてカスタマイズします。
保存をクリックします。

Helen は、特定の課題がエスカレーションされた際に、その課題の担当者の変更について、プロジェクト内の特定のユーザーに通知したいと考えています。今後も同じ件名について、同じユーザーに頻繁に通知を送信する必要があるかもしれません。そのため Helen はカスタム関数を作成し、いずれかのビジネスルールから呼び出されるようにすることにしました。以下は、Helen のカスタム関数の例です。

カスタム関数をビジネスルールに関連付ける

上部ナビゲーションバーのをクリックします。
Issue Tracker に移動し、ビジネスルール をクリックします。
ルールを 1 つ選択し、処理タブに移動します。
処理で、カスタム Function を呼び出す をクリックします。
プラスアイコンをクリックして新しいカスタム関数を作成するか、チェーンアイコンをクリックして、ビジネスルールから既存の関数を呼び出します。
ルールを保存 をクリックします。

ビジネスルールの設定方法についてはこちらを参照してください

ギャラリー関数

すぐに使用できる、あらかじめ定義されたギャラリー関数をいくつか用意しています。

上部ナビゲーションバーのをクリックします。
開発者向け情報 に移動し、カスタム Functions をクリックします。
カスタム Functions ヘッダー横のドロップダウンにカーソルを合わせ、ドロップダウンから Issues を選択します。
作成カスタム Function をクリックします。
一覧に表示されている任意の関数にカーソルを合わせ、使用する Function をクリックします。
作成カスタム Function ページで、プロジェクトを選択し、必要に応じて関数名と引数を変更します。
メモ: Deluge コードはあらかじめ入力されています。TODO コメントで、実行前にコードへ加える必要がある編集内容をユーザーに知らせます。
保存または 保存 and 実行する をクリックして、カスタム関数を実行します。

ポータル URL がご利用のデータセンターと一致していることを確認してください。一致していない場合、関数が期待どおりに実行されない可能性があります。

サポートされているギャラリー関数

課題にタスクを作成する
関連タスクのステータスを更新する
課題を作成し、既存の課題にリンクする
バグのステータスのタイムラインを分析と同期する
Slack チャンネルにメッセージを送信する
関連する時間ログの記録を承認または却下する
フェーズを自動完了する
すべての課題が完了したら、関連タスクを完了にする
プロジェクトのステータスを更新する
リンクされた課題のステータスを更新する
バグの期限日の変更を分析と同期する
課題が再オープンされた回数をカウントする
Cliq チャンネルにメッセージを送信する

カスタム関数を実行する

上部ナビゲーションバーのをクリックします。
［マーケットプレイス］に移動し、開発者向け情報 の下にある カスタム Functions をクリックします。
ドロップダウンボックスから Issues を選択します。
実行したい関数をクリックします。ここでは、Helen が「Send_Mail」関数を実行します。
下部の 保存 and 実行する をクリックします。
課題 ID（引数）を入力します。
実行する をクリックします。

カスタム関数連携をテストする

ビジネスルールの条件に一致するテストデータを Zoho プロジェクトに追加します。
カスタム関数を通じて実行された通知により、アプリケーションで Zoho プロジェクトからの更新が受信されているか確認します。
エラーがある場合は、Zoho プロジェクトでカスタム関数を修正し、再度テストします。
正しい結果が得られるまでテストを続けます。この例では、John Marsh、Victor Young、Lin Brenn が、Helen からの課題担当者の変更に関する通知を受信します。