カスタム関数について

カスタム関数について

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

Zoho Sprints では、カスタム関数を作成して業務プロセスを自動化できます。

カスタム関数は、特定の処理を実行するためにまとめられた一連の Deluge ステートメントで構成されます。この関数は、その処理が必要なときにアプリケーション内から呼び出すことができます。関数を使用すると、複数の場面で利用できる Deluge スクリプトのタブを作成できます。複数の関数を組み合わせて、一連の処理を実行することも可能です。

もう 1 つの重要なポイントは、関数を使用するとアプリケーションがサードパーティサービスと連携できることです。これにより、1 つのアプリケーション内のスクリプトで、別々の 2 つのアプリケーションのデータを更新できます。Zoho Sprints では、自動化関数とスタンドアロン関数の 2 種類を提供しています。

カスタム関数を使用するメリット

  1. カスタム関数は、繰り返し作業を効率的かつ短時間で実行する方法です。
  2. 特定の処理を実行することを目的とした Deluge スクリプトのまとまりをカプセル化し、複数のイベントで実行できるため、再利用可能なエンティティになります。
  3. Webhook の呼び出し、通知の送信、イベントのトリガー時にアクションを実行するなど、一部のプロセスを自動化できます。
  4. コードがモジュール化されているため、管理や利用が容易になります。
  5. Deluge には、スクリプト作成を容易にする組み込み関数が用意されています。
  6. Sprints には、いくつかの標準タスクを実行できる事前構築済み関数の一覧が用意されています。
  7. 安全な認証メカニズムを使用して、Sprints をサードパーティサービスと連携できます。
Info利用可能プラン: Premier、Enterprise、Zoho One プラン
ギャラリー関数は、特定のタスクの自動化をすぐに開始できるように用意された、あらかじめ定義された関数です。これらはテンプレートとして提供されており、要件に合わせて調整し、独自の関数として利用できます。Sprints のプロジェクト運用中によく発生する特定のユースケースに対する解決策を提供します。



次の事前構築済み関数が利用できます:

アイテムが再オープンまたはクローズされたときにリリースのステータスを更新

この関数は、そのリリースに関連付けられているすべての作業アイテムがクローズされたときにリリースのステータスを「Closed」に更新したり、関連付けられている作業アイテムのいずれかが再オープンされたときにリリースのステータスを「Open」に更新したりするために使用します。

タブ: Item

トリガーイベント: Item Closed、Item Reopened
 

すべてのサブアイテムがクローズされたら親アイテムをクローズ

この関数は、複数のサブアイテムを持つ親アイテムがある場合に使用します。この関数を実行すると、すべてのサブアイテムがクローズされたタイミングで親アイテムがクローズされます。

タブ: Item

トリガーイベント: Item Closed
 

アイテムが再オープンまたはクローズされたときにエピックのステータスを更新

この関数は、そのエピックに関連付けられているすべての作業アイテムがクローズされたときにエピックをアーカイブしたり、関連付けられている作業アイテムのいずれかが再オープンされたときにアーカイブ済みエピックをアクティブ化したりするために使用します。

タブ: Item

トリガーイベント: Item Closed、Item Reopened
 

リンクされたアイテムにステータス更新メモを追加

この関数は、アイテムのステータスが更新されたときに、リンクされているすべてのアイテムにアイテムメモを追加するために使用します。作業アイテム同士はリンクできます。ある作業アイテムのステータスが更新されたとき、その更新内容を、リンクされている作業アイテムのアイテムメモとして追加できます。これにより、関連する作業アイテム群を自動的に最新の状態に保つことができます。

タブ: Item

トリガーイベント: Item Updated、Item Closed、Item Reopened
 

コメントでメンションされたユーザーにメールで通知

この関数は、コメント内でタグ付けされたユーザーのメールアドレス宛てに、メール通知を自動送信するために使用します。

タブ: Item Comments、Sprint Comments、Meeting Comments

トリガーイベント: Item Comment Add、Item Comment Update、Item Comment 削除、Sprint Comment Add、Sprint Comment Update、
Sprint Comment 削除、Meeting Comment Add、Meeting Comment Update、Meeting Comment 削除
 

Slack チャンネルにメッセージを投稿

この関数を使用すると、外部のオフィスコミュニケーションサービスである Slack と Sprints を連携できます。作業アイテムのクローズや再オープン、スプリントの開始などのイベントがトリガーされたときに、Slack にメッセージを投稿できます。イベントがトリガーされると、スプリントチーム用の Slack チャンネルでチームに通知できます。

タブ: すべてのタブ

トリガーイベント: すべてのイベント
Notes
他サービスとの連携には、コネクションの作成が必要です。詳細はこちらをご覧ください。
  1. Slack サービス用のコネクションを作成し、スコープに「chat:write:bot」を指定します。
  2. スクリプト内の「slackconnection」を探し、作成したコネクション名に置き換えます。
  3. 左側のカスタムパラメーター「channelId」に、有効な Slack チャンネル ID を設定します。
  4. コネクション作成時は、「ログインユーザーの認証情報を使用」をオフにします。

Cliq チャンネルにメッセージを投稿

この関数を使用すると、別の Zoho サービスであるオフィスコミュニケーションシステム「Cliq」と Sprints を連携できます。作業アイテムのクローズや再オープン、スプリントの開始などのイベントがトリガーされたときに、Cliq にメッセージを投稿できます。イベントがトリガーされると、スプリントチーム用の Cliq チャンネルでチームに通知できます。

タブ: すべてのタブ

トリガーイベント: すべてのイベント
Notes
他サービスとの連携には、コネクションの作成が必要です。詳細はこちらをご覧ください。
  1. ZohoCliq サービス用のコネクションを作成し、スコープに「ZohoCliq.Webhooks.CREATE」を指定します。
  2. スクリプト内の「cliqconnection」を探し、作成したコネクション名に置き換えます。
  3. 左側のカスタムパラメーター「channelUniqueName」に、有効な Cliq チャンネル名を設定します。
  4. コネクション作成時は、「ログインユーザーの認証情報を使用」をオフにします。

注意事項

  1. 1 つの関数に含められるパラメーターは最大 20 個です。
  2. 1 つの関数に含められるカスタムパラメーターは最大 15 個です。
  3. 関数は有効化・無効化できます。
  4. 関数名は作成後に変更できません。
  5. 関数の実行が 15 回連続で失敗すると、「Function Disable Alert」メールがチームオーナーおよびその関数の作成者・更新者に送信されます。
  6. 関数が無効化されている場合、その関数は実行されません。
  7. コネクションを使用すると、他サービスとの連携が可能になります。コネクションを作成するには、［Automation］で［Connections］を選択します。
  8. 関数は手動で実行できますが、その場合、パラメーター値は「null」として渡されます。
  9. 実行された関数は、Function Logs に記録されます。
  10. 1 か月より前の関数ログは完全に削除されます。
  11. 失敗した関数は、最大 3 回まで再実行を試行できます。
  12. すでに正常に実行された関数を再度実行することはできません。