カスタム関数について

カスタム関数について

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

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

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

関数のもう1つの重要な特徴は、アプリケーションを外部サービスと連携できることです。これにより、1つのアプリケーションのスクリプトで、2つの異なるアプリケーションのデータを更新できます。Zoho Sprintsには、自動化関数と単独実行関数の2種類があります。

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

  1. カスタム関数を使用すると、繰り返し行うタスクを効率的に実行でき、時間を節約できます。
  2. 特定のタスクを実行するDelugeスクリプトをひとまとめにし、複数のイベントで実行することで、再利用できます。
  3. Webhookの呼び出し、通知の送信、イベントの発生に応じた処理の実行など、特定のプロセスを自動化できます。
  4. コードが機能ごとにまとまっているため、管理や利用が簡単になります。
  5. Delugeには、スクリプトの作成を容易にする組み込み関数が用意されています。
  6. Sprintsには、標準的なタスクを実行できる作成済みの関数が用意されています。
  7. 安全な認証の仕組みを使用して、Sprintsを外部サービスと連携できます。
情報利用可能なプラン：プレミア、エンタープライズ、Zoho One
ギャラリーの関数は、特定のタスクの自動化を始めやすくするために用意された定義済みの関数です。これらをテンプレートとして、要件に合わせて調整し、関数を作成できます。Sprintsのプロジェクトで想定される具体的な利用場面に対応できます。



次の作成済み関数が用意されています：

項目の再開時または完了時のリリースのステータス更新

この関数は、リリースに関連付けられたすべての作業項目が完了すると、リリースのステータスを「完了」に更新します。また、関連する作業項目のいずれかが再開されると、リリースのステータスを「未完了」に更新します。

モジュール：項目

実行条件となるイベント：項目の完了、項目の再開
 

すべてのサブ項目の完了時に親項目を完了

この関数は、複数のサブ項目を持つ親項目に使用します。この関数を実行すると、すべてのサブ項目が完了したときに、親項目も完了になります。

モジュール：項目

実行条件となるイベント：項目の完了
 

項目の再開時または完了時のエピックのステータス更新

この関数は、エピックに関連付けられたすべての作業項目が完了すると、そのエピックをアーカイブします。また、関連する作業項目のいずれかが再開されると、アーカイブ済みのエピックを有効にします。

モジュール：項目

実行条件となるイベント：項目の完了、項目の再開
 

関連付けられた項目へのステータス更新メモの追加

この関数は、項目のステータスが更新されたときに、関連付けられているすべての項目にメモを追加します。作業項目は相互に関連付けることができます。作業項目のステータスが更新されると、その更新内容を、関連付けられた作業項目のメモとして追加できます。これにより、関連する作業項目全体を自動的に最新の状態に保てます。

モジュール：項目

実行条件となるイベント：項目の更新、項目の完了、項目の再開
 

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

この関数は、コメントでタグ付けされたユーザーのメールアドレスへの通知を自動化します。

モジュール：項目のコメント、スプリントのコメント、ミーティングのコメント

実行条件となるイベント：項目のコメントの追加、項目のコメントの更新、項目のコメントの削除、スプリントのコメントの追加、スプリントのコメントの更新、
スプリントのコメントの削除、ミーティングのコメントの追加、ミーティングのコメントの更新、ミーティングのコメントの削除
 

Slackのチャンネルへのメッセージの投稿

この関数を使用すると、Sprintsを外部の業務用コミュニケーションサービスであるSlackと連携できます。作業項目の完了や再開、スプリントの開始などのイベントが発生したときに、Slackにメッセージを投稿できます。イベントが発生すると、スプリントのチーム用のSlackチャンネルで、チームに通知できます。

モジュール：すべてのモジュール

実行条件となるイベント：すべてのイベント
メモ
他のサービスと連携するには、外部連携を作成する必要があります。詳細をご確認ください。
  1. Slackサービスの外部連携を作成し、スコープに「chat:write:bot」を指定します。
  2. 「slackconnection」を検索し、設定した外部連携名に置き換えます。
  3. 左側のカスタムパラメーター「channelId」に、有効なSlackのチャンネルIDを設定します。
  4. 外部連携の作成時に、［ログインユーザーの認証情報を使用する］をオフにします。

Cliqのチャンネルへのメッセージの投稿

この関数を使用すると、SprintsをZohoの業務用コミュニケーションサービスであるCliqと連携できます。作業項目の完了や再開、スプリントの開始などのイベントが発生したときに、Cliqにメッセージを投稿できます。イベントが発生すると、スプリントのチーム用のCliqチャンネルで、チームに通知できます。

モジュール：すべてのモジュール

実行条件となるイベント：すべてのイベント
メモ
他のサービスと連携するには、外部連携を作成する必要があります。詳細をご確認ください。
  1. ZohoCliqサービスの外部連携を作成し、スコープに「ZohoCliq.Webhooks.CREATE」を指定します。
  2. 「cliqconnection」を検索し、設定した外部連携名に置き換えます。
  3. 左側のカスタムパラメーター「channelUniqueName」に、有効なCliqのチャンネル名を設定します。
  4. 外部連携の作成時に、［ログインユーザーの認証情報を使用する］をオフにします。

注意事項

  1. 関数の作成時に指定できるパラメーターは、最大20個です。
  2. 関数の作成時に指定できるカスタムパラメーターは、最大15個です。
  3. 関数は無効または有効に設定できます。
  4. 作成後に関数名を変更することはできません。
  5. 関数の実行が15回連続で失敗すると、チームの所有者と、その関数を作成および更新したユーザーに、関数の無効化を知らせる警告メールが送信されます。
  6. 無効な関数は実行されません。
  7. 外部連携を使用すると、他のサービスと連携できます。外部連携を作成するには、［自動化］に移動し、［外部連携］を選択します。
  8. 関数は手動で実行できますが、パラメーターの値には「null」のみが渡されます。
  9. 実行された関数は、「関数のログ」に記録されます。
  10. 1か月を超えた関数のログは、完全に削除されます。
  11. 実行に失敗した関数は、3回まで再実行できます。
  12. すでに正常に実行された関数は、再実行できません。