$p.apiDeleteSite

/**
 * ================================================================
 * サンプル01  サイト廃止申請のレコードから、確認のうえサイトを削除する
 * ================================================================
 *
 * 【概要】
 *   使わなくなったサイトの削除を「サイト廃止申請」テーブルで受け付けます。
 *   編集画面のプロセスボタンから、次の処理を行います。
 *     ・対象確認：$p.apiGetSite で対象サイトのタイトル・種別・親フォルダIDを
 *                 取得してレコードに記録し、状況を「確認済」にする
 *                 （承認者が、何を削除するのかを確かめられるようにする）
 *     ・削除実行：もう一度 $p.apiGetSite で取得し、記録と一致することを
 *                 確かめてから $p.apiDeleteSite で削除し、削除日時を記録して
 *                 状況を「削除済」にする
 *   承認・却下は標準のプロセスだけで行い、このスクリプトは関わりません。
 *
 * 【安全のための確認】
 *   ・$p.apiDeleteSite にレコードのIDを渡すと、エラーにならず、そのレコードが
 *     属するサイトがまるごと削除されます。$p.apiGetSite はレコードのIDに対して
 *     エラー（404）を返すため、削除の前に必ず $p.apiGetSite で確かめます。
 *   ・フォルダを削除すると配下のサイトも一緒に削除されるため、フォルダは
 *     対象にしません。
 *   ・申請後にサイトの改名や入れ替わりがあった場合に備え、削除の直前に
 *     タイトルと種別が記録と一致するかを確かめます。
 *
 * 【ポイント】
 *   OnClick を設定したプロセスは、ボタンを押しただけでは保存されません。
 *   API の呼び出しが成功したあとに $p.set で項目へ値を入れてから
 *   $p.execProcess を呼ぶと、その値と一緒に保存し、状況を変更します。
 *   確認で問題が見つかったときや、API の呼び出しが失敗したときは
 *   $p.execProcess を呼ばないため、状況は変わりません。
 *
 * 【使い方】
 *   下記の定数を、実際に使用する項目コードに置き換えてください。
 *   あわせて「テーブルの管理 > プロセス」で、以下のプロセスを追加して
 *   ください（いずれも 画面種別：編集、実行種別：追加したボタン、
 *   アクション種別：保存）。
 *     ・対象確認：現在の状況 下書き → 変更後の状況 確認済
 *                 OnClick：confirmTargetSite($(this))
 *     ・削除実行：現在の状況 承認済 → 変更後の状況 削除済
 *                 OnClick：deleteTargetSite($(this))
 *                 アクセス制御でテナント管理者だけに表示する
 * ================================================================
 */

// ===== 設定 =====
// 対象サイトIDの項目コード（申請者が入力する）
const TARGET_SITE_ID_COLUMN = 'ClassA';
// 対象サイトのタイトルを記録する項目コード
const TARGET_TITLE_COLUMN = 'ClassB';
// 対象サイトの種別（Issues／Results／Wikis）を記録する項目コード
const TARGET_TYPE_COLUMN = 'ClassC';
// 対象サイトの親フォルダのサイトIDを記録する項目コード
const TARGET_PARENT_ID_COLUMN = 'NumA';
// 削除日時を記録する項目コード
const DELETED_AT_COLUMN = 'DateA';

// フォルダの種別
const FOLDER_TYPE = 'Sites';

// ===== 共通処理 =====
function showError(text) {
    $p.clearMessage();
    $p.setMessage('#Message', JSON.stringify({
        Css: 'alert-error',
        Text: text,
    }));
}

// APIの失敗応答から、表示用のメッセージを取り出す
function getErrorMessage(jqXHR) {
    try {
        return JSON.parse(jqXHR.responseText).Message;
    } catch (e) {
        return `HTTP ${jqXHR.status}`;
    }
}

// 入力された対象サイトID（数字でなければ null）
function getTargetSiteId() {
    const value = String($p.getValue(TARGET_SITE_ID_COLUMN) || '').trim();
    return /^\d+$/.test(value) ? Number(value) : null;
}

// 対象サイトを取得する。取得できなかったときはエラーを表示し、onFound を呼ばない
function getTargetSite(siteId, onFound) {
    $p.apiGetSite({
        id: siteId,
        done: function (data) {
            // data.Response.Data に SiteId, Title, ReferenceType, ParentId などが入っている
            onFound(data.Response.Data);
        },
        fail: function (jqXHR) {
            if (jqXHR.status === 404) {
                // レコードのIDや、存在しないサイトIDを指定したときはここに来る
                showError(`サイトID ${siteId} のサイトが見つかりません。`);
            } else {
                showError(`サイトID ${siteId} のサイトを取得できませんでした。${getErrorMessage(jqXHR)}`);
            }
        },
    });
}

function formatNow() {
    const now = new Date();
    const pad = (n) => String(n).padStart(2, '0');
    return `${now.getFullYear()}/${pad(now.getMonth() + 1)}/${pad(now.getDate())} ` +
        `${pad(now.getHours())}:${pad(now.getMinutes())}`;
}

// ===== プロセス「対象確認」 =====
function confirmTargetSite($button) {
    const siteId = getTargetSiteId();
    if (siteId === null) {
        showError('対象サイトIDを数字で入力してください。');
        return;
    }

    getTargetSite(siteId, function (site) {
        // フォルダは配下のサイトごと削除されるため、対象にしない
        if (site.ReferenceType === FOLDER_TYPE) {
            showError(`サイトID ${siteId} はフォルダです。フォルダは対象にできません。`);
            return;
        }
        // 取得した内容を記録し、保存して状況を「確認済」にする
        $p.set($p.getControl(TARGET_TITLE_COLUMN), site.Title);
        $p.set($p.getControl(TARGET_TYPE_COLUMN), site.ReferenceType);
        $p.set($p.getControl(TARGET_PARENT_ID_COLUMN), site.ParentId);
        $p.execProcess($button);
    });
}

// ===== プロセス「削除実行」 =====
function deleteTargetSite($button) {
    const siteId = getTargetSiteId();
    if (siteId === null) {
        showError('対象サイトIDを数字で入力してください。');
        return;
    }
    const recordedTitle = $p.getValue(TARGET_TITLE_COLUMN);
    const recordedType = $p.getValue(TARGET_TYPE_COLUMN);

    // 削除の直前にもう一度取得し、記録と一致するかを確かめる
    getTargetSite(siteId, function (site) {
        if (site.ReferenceType === FOLDER_TYPE) {
            showError(`サイトID ${siteId} はフォルダです。フォルダは対象にできません。`);
            return;
        }
        if (site.Title !== recordedTitle || site.ReferenceType !== recordedType) {
            showError(
                `サイトID ${siteId} の現在の内容（タイトル「${site.Title}」、種別 ${site.ReferenceType}）が、` +
                `確認時の記録（タイトル「${recordedTitle}」、種別 ${recordedType}）と一致しないため、削除しません。`,
            );
            return;
        }
        if (!confirm(`サイト「${site.Title}」（サイトID：${siteId}）を削除します。よろしいですか？`)) {
            return;
        }

        $p.apiDeleteSite({
            id: siteId,
            done: function () {
                // 削除日時を記録し、保存して状況を「削除済」にする
                $p.set($p.getControl(DELETED_AT_COLUMN), formatNow());
                $p.execProcess($button);
            },
            fail: function (jqXHR) {
                showError(`サイト「${site.Title}」（サイトID：${siteId}）を削除できませんでした。${getErrorMessage(jqXHR)}`);
            },
        });
    });
}