開発者向け機能：サーバスクリプト：logs.Log

// ============================================================
// デバッグモード。true にすると debug() と type=10(Info) のログが出力される
// ============================================================
const DEBUG_MODE = true;
/**
 * 出力先の制御
 *   console : ブラウザ開発者ツールのコンソールに出力するか
 *   syslogs : システムログ（SysLogs テーブル）に出力するか
 */
const LOG_TARGET = {
    console: true,
    syslogs: true,
};
// ============================================================
// ログ種別の定数（logs.Log の type 引数に対応）
// ============================================================
const LOG_TYPE = {
    INFO: 10,
    WARNING: 50,
    USER_ERROR: 60,
    SYSTEM_ERROR: 80,
    EXCEPTION: 90,
};
// ============================================================
// ロガー本体
// ============================================================
const logEx = (function (debugMode, target) {
    /**
     * DEBUG_MODE=false のとき、Info（type=10）は抑制する。
     * Warning 以上（type>=50）は常に出力する。
     */
    function _isOutputAllowed(type) {
        if (type === LOG_TYPE.INFO && !debugMode) return false;
        return true;
    }
    return {
        /**
         * logs.Log をそのままラップしたメソッド。
         * type=10(Info) は DEBUG_MODE=true のときのみ出力される。
         * type=50 以上（Warning/UserError/SystemError/Exception）は常に出力される。
         *
         * @param {number} type    - ログ種別（LOG_TYPE 定数を推奨）
         * @param {string} message - ログメッセージ
         * @param {string} [method] - メソッド名（省略可）
         */
        log: function (type, message, method) {
            if (!_isOutputAllowed(type)) return;
            const m = method || '';
            logs.Log(type, message, m, target.console, target.syslogs);
        },
        /**
         * デバッグ専用ログ。DEBUG_MODE=true のときのみ Info（type=10）で出力。
         * 変数の中身確認や処理トレースなど、本番では不要な出力に使う。
         *
         * @param {string} message
         * @param {string} [method]
         */
        debug: function (message, method) {
            if (!debugMode) return;
            const m = method || '';
            logs.Log(
                LOG_TYPE.INFO,
                '[DEBUG] ' + message,
                m,
                target.console,
                target.syslogs,
            );
        },
    };
})(DEBUG_MODE, LOG_TARGET);
// ======================
// 使用例
// ======================
// ─── 例1：デバッグログ（DEBUG_MODE=true のときだけ出力） ───
logEx.debug('処理開始: siteId=' + 1000, 'MyScript');
// ─── 例2：INFO ログ（DEBUG_MODE=true のときだけ出力） ───
logEx.log(LOG_TYPE.INFO, 'レコードを取得しました。', 'FetchRecord');
// ─── 例3：WARNING ログ（常に出力） ───
logEx.log(
    LOG_TYPE.WARNING,
    '対象レコードが見つかりませんでした。',
    'FetchRecord',
);
// ─── 例4：UserError ログ（常に出力） ───
logEx.log(LOG_TYPE.USER_ERROR, '必須項目が未入力です。', 'Validate');
// ─── 例5：SystemError ログ（常に出力） ───
logEx.log(LOG_TYPE.SYSTEM_ERROR, 'APIへの接続に失敗しました。', 'CallApi');
// ─── 例6：Exception ログ（catch と組み合わせて使う） ───
try {
    const item = items.NewIssue();
    item.Title = 'テスト';
    items.Create(2, abcd); // 強制的に例外発生
    logEx.log(LOG_TYPE.INFO, '作成成功', 'CreateIssue');
} catch (e) {
    logEx.log(LOG_TYPE.EXCEPTION, e.message + '\n' + e.stack, 'CreateIssue');
}
// ─── 例7：数値を直接指定することも可能 ───
logEx.log(50, '直接指定の警告ログ', 'DirectType');