Reportオブジェクト

次のオブジェクトは、reportAPIに直接関連しています。

レポート

レポートオブジェクトには、以下のプロパティがあります。

Property Type Description
reportid ID レポートのID。

Property behavior:
- read-only
- 更新操作で required
userid ID レポートを作成したユーザーのID。

Property behavior:
- 作成操作で required
name string レポートの一意な名前。

Property behavior:
- 作成操作で required
dashboardid ID レポートのベースとなるダッシュボードのID。

Property behavior:
- 作成操作で required
period integer レポートを作成する対象期間。

指定可能な値:
0 - (default) 前日;
1 - 前週;
2 - 前月;
3 - 前年。
cycle integer 期間の繰り返しスケジュール。

指定可能な値:
0 - (default) 毎日;
1 - 毎週;
2 - 毎月;
3 - 毎年。
start_time integer 送信のためにレポートを作成する時刻（1日の中の秒数）。

デフォルト: 0。
weekdays integer レポートを送信する曜日。

指定可能なビットマップ値:
1 - 月曜日;
2 - 火曜日;
4 - 水曜日;
8 - 木曜日;
16 - 金曜日;
32 - 土曜日;
64 - 日曜日。

これはビットマスクフィールドです。指定可能なビットマップ値の任意の合計を指定できます（たとえば、月曜日・水曜日・金曜日の場合は 21）。

デフォルト: 0。

Property behavior:
- cycle が "weekly" に設定されている場合は required
active_since string 開始日。

指定可能な値:
空文字列 - (default) 未指定（0 として保存）;
YYYY-MM-DD 形式の特定の日付（その日の開始時刻 (00:00:00) のタイムスタンプとして保存）。
active_till string 終了日。

指定可能な値:
空文字列 - (default) 未指定（0 として保存）;
YYYY-MM-DD 形式の特定の日付（その日の終了時刻 (23:59:59) のタイムスタンプとして保存）。
subject string レポートメッセージの件名。
message string レポートメッセージの本文。
status integer レポートが有効か無効か。

指定可能な値:
0 - 無効;
1 - (default) 有効。
description text レポートの説明。
state integer レポートの状態。

指定可能な値:
0 - (default) レポートはまだ処理されていません;
1 - レポートが生成され、すべての受信者への送信に成功しました;
2 - レポートの生成に失敗しました。"info" にエラー情報が含まれます;
3 - レポートは生成されましたが、一部（またはすべて）の受信者への送信に失敗しました。"info" にエラー情報が含まれます。

Property behavior:
- read-only
lastsent timestamp 最後に正常に送信されたレポートのUnixタイムスタンプ。

Property behavior:
- read-only
info string エラーの説明または追加情報。

Property behavior:
- read-only

ユーザー

usersオブジェクトには、以下のプロパティがあります。

プロパティ 型 説明
userid ID レポートの送信先ユーザーのID。

プロパティの動作:
- 必須
access_userid ID レポートが代理で生成されるユーザーのID。

0 - (デフォルト) 受信者によってレポートを生成。
exclude integer ユーザーをメーリングリストから除外するかどうか。

使用可能な値:
0 - (デフォルト) 含める;
1 - 除外。

ユーザーグループ

ユーザーグループオブジェクトには、以下のプロパティがあります。

プロパティ Type 説明
usrgrpid ID レポートの送信先となるユーザーグループのID。

プロパティの動作:
- 必須
access_userid ID レポートの生成時に代理として使用されるユーザーのID。

0 - (デフォルト) 受信者としてレポートを生成。