関数のスケジュール設定

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

スケジュール関数とは？

スケジュール関数を使用すると、毎時、毎日、毎週、毎月など、指定したスケジュールに基づいてカスタム関数を実行できます。この機能は、毎月のレポート作成や、今後公開予定のマイルストーンや期限についてポータルユーザーに自動メールを送信するなど、特定の処理に依存せずに繰り返し行う処理を自動化する際に役立ちます。

カスタム関数とスケジュール関数の違い

カスタム関数は、特定の処理やプロセスを自動化するためのコードです。スケジュール関数は、これらの処理やプロセスをいつ、どの頻度で実行するかを決定し、ユーザーが実行間隔を指定できるようにします。

利用例

プロジェクトマネージャーにとって、ポータルデータの定期的なバックアップを維持することは、データのセキュリティと完全性を確保するうえで不可欠です。バックアップデータを手動でエクスポートするのは時間がかかります。スケジュール関数を使用してバックアップデータのエクスポート処理を自動化し、定期的なバックアップを確実に実行できます。

これを設定するには、ProjectDataBackupExport という名前のスケジュール関数を作成し、最初の実行スケジュール（例：毎週または毎月）を指定し、繰り返し種別を選択し、必要に応じて終了条件と休日の動作を設定します。以下の Deluge スクリプトを入力し、エクスポート処理を自動化するようにカスタマイズします。Zoho プロジェクト内のスケジュール関数ログを監視して実行状況を確認できます。

Deluge スクリプト:

// TODO: Zoho プロジェクトサービス用に、スコープ 'ZohoProjects.portals.READ' を持つコネクションを作成し、'xxxxxxxxx' をコネクション名に置き換えてください。コネクションの作成方法については、以下のリンクをクリックして参照してください。

// https://help.zoho.com/portal/en/kb/projects/integration/connections/articles/connections-23-5-2022#How_to_establish_a_Connection

projectsAPIEndPoint = 'https://projectsapi.zoho.com/api/v3';

exportResponse = invokeurl

[

url :projectsAPIEndPoint + '/portal/' + portalId + '/portal_export'

種類 :POST

connection:'xxxxxxxxx'

];

info exportResponse;

スケジュール関数を作成する

右上隅のをクリックします。
開発者向け情報 > Schedule Functions に移動します。
Create Schedule Function をクリックします。
Function 名前 と説明を入力し、Arguments を設定します。
最初の実行のスケジュール日時を設定します。
希望に応じて 繰り返し Types を選択します。

Once: スケジュール関数は指定した日時に 1 回だけ実行されます。それ以降は実行されません。
毎時間: 関数を毎時間の間隔で繰り返し実行したい場合に選択します。繰り返し頻度項目で希望する時間間隔を指定すると、関数は「A」時間ごと（例：2 時間ごと、4 時間ごと）に実行されます。
毎日: 各実行の間隔となる日数を選択します。毎日実行する場合は 1、1 日おきに実行する場合は 2、というように繰り返し頻度項目で指定します。
Weekly: 繰り返し頻度項目で「A」週間ごとの頻度を定義します。繰り返し On 項目から希望する曜日（Monday、Tuesday など）を選択すると、関数は指定した曜日に「A」週間ごとにのみ実行されます。
月間: 繰り返し頻度項目から「A」か月ごとの頻度を選択します。繰り返し On 項目で「A specific day」を選択し、1 日、15 日など、月内の特定の日付を指定できます。また、月末に実行する、または繰り返し On 項目から第 2 金曜日、第 3 木曜日、最終金曜日など N 番目の曜日に実行するように設定することもできます。