$p.apiUpdateSite

/**
 * ================================================================
 * サンプル01  案件レコードの担当者・承認者を、案件サイトのアクセス権に反映する
 * ================================================================
 *
 * 【概要】
 *   案件ごとに作った案件サイト（案件の担当者と承認者にだけ権限を付けたサイト）に
 *   ついて、担当者や承認者が交代したときに、案件管理テーブルのレコードで
 *   プロセス「権限反映」を押すと、案件サイトのアクセス権を今の担当者・承認者に
 *   合わせます。
 *     1. $p.apiGetSite で、案件サイトの今のアクセス権を取得する
 *     2. ユーザーに付けた権限を外し、担当者（書き込み）と承認者（読取専用）の
 *        権限を加える。組織・グループに付けた権限と、サイトの管理者（サイトの管理と
 *        権限の管理の両方を持つユーザー）の権限はそのまま残す
 *     3. $p.apiUpdateSite でアクセス権だけを書き戻し、反映した日時をレコードに残す
 *
 * 【ポイント】
 *   ・$p.apiUpdateSite に送るのは InheritPermission と Permissions だけにします。
 *     この2つだけを送ると、タイトル・一覧・エディタ・スクリプトなどのサイトの設定は
 *     そのまま残り、アクセス権だけが置き換わります。取得したサイトの情報
 *     （SiteSettings を含む）をまるごと送り返すと、設定全体が置き換わるので
 *     避けてください。
 *   ・Permissions は送った内容でまるごと置き換わります（追記ではありません）。
 *     そのため、取得したアクセス権から組み立て直して送ります。
 *   ・アクセス権には、「サイトの管理」と「権限の管理」の両方を持つ人（ユーザー・
 *     組織・グループのどれか）が少なくとも1つ必要です。いなくなる内容を送ると、
 *     エラー（ステータスコード 500、メッセージ「無し」）になり更新されません。
 *     そのため、管理者のユーザーは外さず、管理者がいなくなるときは送る前に止めます。
 *   ・アクセス権を継承しているサイトは、取得すると Permissions が空になります。
 *     空を「権限なし」として書き戻すと継承を壊すので、継承しているサイトは
 *     変更しません。
 *   ・OnClick を設定したプロセスは、ボタンを押しただけでは保存されません。
 *     アクセス権の更新が成功したあとに $p.set で反映日時を入れてから
 *     $p.execProcess を呼ぶと、その値と一緒にレコードを保存します。
 *
 * 【注意】
 *   ・案件サイトにユーザー単位で付けた権限は、管理者を除き、担当者・承認者以外の
 *     ものも外れます。ほかの人にも権限を付けたい場合は、組織かグループで付けてください。
 *   ・組織をAPIやインポートでまとめて作成・更新した直後は、Pleasanter内部の
 *     組織情報が古いままになり、一部の組織の権限が $p.apiGetSite の Permissions に
 *     含まれないことがあります。その状態で書き戻すと、その組織の権限が消えます。
 *     組織をまとめて作成・更新した直後に使うときは、先にいずれかの組織を1件
 *     更新（画面で保存し直すだけでよい）してから実行してください。
 *
 * 【使い方】
 *   下記の定数を、実際に使用する項目コードに置き換えてください。
 *   あわせて「テーブルの管理 > プロセス」で、プロセス「権限反映」を追加して
 *   ください（画面種別：編集、実行種別：追加したボタン、アクション種別：保存、
 *   現在の状況・変更後の状況：指定しない、OnClick：applySitePermissions($(this))）。
 *   押せるのは、案件サイトの「権限の管理」の権限を持つ人です。
 *   スクリプトの出力先は「編集」にチェックしてください。
 * ================================================================
 */

// ===== 設定 =====
const SITE_ID_COLUMN = 'ClassD'; // 案件サイトのID
const MANAGER_COLUMN = 'ClassB'; // 案件担当者（選択肢一覧に [[Users*]]。値はユーザーID）
const APPROVER_COLUMN = 'ClassC'; // 承認者（選択肢一覧に [[Users*]]）
const APPLIED_AT_COLUMN = 'DateA'; // 権限の最終反映日時（スクリプトが入れる）
// 付ける権限（読取 1／作成 2／更新 4／削除 8／メール送信 16 … の合計）
const MANAGER_PERMISSION = 31; // 担当者：書き込み（読取・作成・更新・削除・メール送信）
const APPROVER_PERMISSION = 1; // 承認者：読取専用
// サイトの管理（128）＋権限の管理（256）。これを含む権限を持つ人を「管理者」として残す
const MANAGE_PERMISSION = 128 + 256;

// ===== 処理 =====
function showMessage(css, text) {
    $p.clearMessage();
    $p.setMessage('#Message', JSON.stringify({ Css: css, Text: text }));
}

// 失敗の応答から、表示するメッセージを取り出す
function errorMessage(data, fallback) {
    try {
        return JSON.parse(data.responseText).Message || fallback;
    } catch (e) {
        return fallback;
    }
}

// Date を「2026/10/07 14:30」の形にする
function formatDateTime(date) {
    const pad = (n) => String(n).padStart(2, '0');
    return (
        `${date.getFullYear()}/${pad(date.getMonth() + 1)}/${pad(date.getDate())} ` +
        `${pad(date.getHours())}:${pad(date.getMinutes())}`
    );
}

// 「User,2,31」の形の文字列を、種別・ID・権限の値に分ける
function parsePermission(text) {
    const [type, id, value] = text.split(',');
    return { type: type, id: id, value: Number(value) };
}

function isManager(value) {
    return (value & MANAGE_PERMISSION) === MANAGE_PERMISSION;
}

// 今のアクセス権から、ユーザーの権限を担当者・承認者に入れ替えたものを作る
function buildPermissions(current, managerId, approverId) {
    const others = []; // 組織（Dept）・グループ（Group）の権限。そのまま残す
    const userPermissions = {}; // ユーザーID → 権限の値
    current.map(parsePermission).forEach(function (p) {
        if (p.type !== 'User') {
            others.push(`${p.type},${p.id},${p.value}`);
        } else if (isManager(p.value)) {
            // 管理者のユーザーは外さない
            userPermissions[p.id] = p.value;
        }
    });
    // 担当者・承認者の権限を加える。同じ人（管理者を含む）なら、値をビットの論理和で合わせる
    if (managerId) {
        userPermissions[managerId] = (userPermissions[managerId] || 0) | MANAGER_PERMISSION;
    }
    if (approverId) {
        userPermissions[approverId] = (userPermissions[approverId] || 0) | APPROVER_PERMISSION;
    }
    return others.concat(
        Object.keys(userPermissions).map(function (userId) {
            return `User,${userId},${userPermissions[userId]}`;
        })
    );
}

// 管理者（サイトの管理と権限の管理の両方を持つ人）が1つ以上あるか
function hasManager(permissions) {
    return permissions.map(parsePermission).some(function (p) {
        return isManager(p.value);
    });
}

// 並び順を無視して、2つのアクセス権が同じか
function samePermissions(a, b) {
    return JSON.stringify([...a].sort()) === JSON.stringify([...b].sort());
}

// プロセス「権限反映」の OnClick から呼ぶ
function applySitePermissions($button) {
    const siteId = Number($p.getValue(SITE_ID_COLUMN));
    if (!siteId) {
        showMessage('alert-error', '案件サイトのIDが入っていません。');
        return;
    }
    const managerId = String($p.getValue(MANAGER_COLUMN) || '');
    const approverId = String($p.getValue(APPROVER_COLUMN) || '');

    $p.apiGetSite({
        id: siteId,
        done: function (data) {
            const site = data.Response.Data;
            // 継承しているサイトは、InheritPermission が継承元のサイトIDになっている
            if (Number(site.InheritPermission) !== siteId) {
                showMessage(
                    'alert-error',
                    `案件サイト（ID：${siteId}）はアクセス権を継承しているため、変更しません。` +
                        `継承元（ID：${site.InheritPermission}）のアクセス権を確認してください。`
                );
                return;
            }
            const current = site.Permissions || [];
            const next = buildPermissions(current, managerId, approverId);
            if (samePermissions(current, next)) {
                showMessage('alert-info', 'アクセス権の変更はありません。');
                return;
            }
            if (!hasManager(next)) {
                // 管理者がいなくなる内容は、送ってもエラーになるので送らない
                showMessage(
                    'alert-error',
                    `案件サイト（ID：${siteId}）の管理者（サイトの管理と権限の管理の両方を持つ人）が` +
                        'いなくなるため、変更できません。案件サイトに管理者を設定してください。'
                );
                return;
            }
            $p.apiUpdateSite({
                id: siteId,
                // アクセス権だけを送る（SiteSettings は送らない）
                data: { InheritPermission: siteId, Permissions: next },
                done: function () {
                    $p.set($p.getControl(APPLIED_AT_COLUMN), formatDateTime(new Date()));
                    $p.execProcess($button);
                },
                fail: function (error) {
                    showMessage('alert-error', errorMessage(error, 'アクセス権を更新できませんでした。'));
                },
            });
        },
        fail: function (error) {
            showMessage('alert-error', errorMessage(error, `案件サイト（ID：${siteId}）を取得できませんでした。`));
        },
    });
}