$p.apiGroupsCreate

/**
 * ================================================================
 * サンプル01  プロジェクトグループの作成・メンバー反映・廃止を申請レコードで行う
 * ================================================================
 *
 * 【概要】
 *   「プロジェクトグループ申請」テーブルの1レコードで、プロジェクトごとの
 *   グループを管理します。編集画面のプロセスボタンから、次の処理を行います。
 *     ・グループ作成：$p.apiGroupsCreate でグループを作り、返ってきた
 *                     グループIDをレコードに記録して、状況を「有効」にする
 *     ・メンバー反映：$p.apiGroupsUpdate で、その時点のリーダーとメンバーに
 *                     グループのメンバーを置き換える
 *     ・グループ廃止：確認のうえ $p.apiGroupsDelete でグループを削除し、
 *                     状況を「廃止済」にする
 *   グループの作成から廃止までを申請レコードで追えるようにし、使われなく
 *   なったグループが残り続けるのを防ぎます。
 *
 * 【なぜサーバースクリプトではなくスクリプトで行うか】
 *   サーバースクリプトの groups.Create は戻り値が真偽値だけで、作成した
 *   グループのIDを受け取れません。また、サーバースクリプトにはグループを
 *   削除するメソッドがありません。$p.apiGroupsCreate は作成したグループの
 *   IDを返すため、IDをレコードに記録して後の更新・削除に使えます。
 *
 * 【ポイント】
 *   ・同じ名前のグループを何度でも作れてしまうため、グループは名前ではなく
 *     IDで追います。グループIDが記録済みのレコードでは作成しません。
 *   ・$p.apiGroupsUpdate で GroupMembers を送ると、メンバーは送った内容で
 *     まるごと置き換わります。そのため、毎回リーダーとメンバー全員を送ります。
 *   ・OnClick を設定したプロセスは、ボタンを押しただけでは保存されません。
 *     API の呼び出しが成功したあとに $p.set で項目へ値を入れてから
 *     $p.execProcess を呼ぶと、その値と一緒に保存し、状況を変更します。
 *     API の呼び出しが失敗したときは $p.execProcess を呼ばないため、
 *     状況は変わりません。
 *
 * 【使い方】
 *   下記の定数を、実際に使用する項目コードに置き換えてください。
 *   あわせて「テーブルの管理 > プロセス」で、以下の3つのプロセスを
 *   追加してください（いずれも 画面種別：編集、実行種別：追加したボタン、
 *   アクション種別：保存）。
 *     ・グループ作成：現在の状況 申請中 → 変更後の状況 有効
 *                     OnClick：createProjectGroup($(this))
 *     ・メンバー反映：現在の状況 有効（変更後の状況は指定しない）
 *                     OnClick：updateProjectGroupMembers($(this))
 *     ・グループ廃止：現在の状況 有効 → 変更後の状況 廃止済
 *                     OnClick：deleteProjectGroup($(this))
 *   グループの作成・更新・削除は、テナント管理者が行ってください。
 * ================================================================
 */

// ===== 設定 =====
// 作成するグループ名の接頭辞（グループ名は「接頭辞＋タイトル」になる）
const GROUP_NAME_PREFIX = 'PJ_';
// プロジェクト名の項目コード（グループ名に使う）
const PROJECT_NAME_COLUMN = 'Title';
// プロジェクトリーダーの項目コード（グループの管理者として登録する）
const LEADER_COLUMN = 'Manager';
// メンバーの項目コード（選択肢一覧 [[Users*]]、複数選択。一般メンバーとして登録する）
const MEMBERS_COLUMN = 'ClassA';
// グループIDを記録する項目コード
const GROUP_ID_COLUMN = 'NumA';

// ===== 共通処理 =====
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（未記録なら0）
function getGroupId() {
    return Number($p.getValue(GROUP_ID_COLUMN)) || 0;
}

// 複数選択の項目の値を、ユーザーIDの配列にする
// （値が配列でも、JSON文字列（例：["2","5"]）でも扱えるようにする）
function getMemberIds() {
    const value = $p.getValue(MEMBERS_COLUMN);
    if (Array.isArray(value)) {
        return value;
    }
    if (!value) {
        return [];
    }
    try {
        const parsed = JSON.parse(value);
        return Array.isArray(parsed) ? parsed : [String(parsed)];
    } catch (e) {
        return [String(value)];
    }
}

// リーダーを管理者、メンバーを一般メンバーとして GroupMembers を組み立てる
// 形式は "User,ユーザーID,管理者かどうか"
function buildGroupMembers() {
    const leaderId = String($p.getValue(LEADER_COLUMN) || '');
    const groupMembers = [];
    if (leaderId) {
        groupMembers.push(`User,${leaderId},True`);
    }
    getMemberIds()
        .map(String)
        .filter((userId) => userId && userId !== leaderId) // リーダーは管理者として登録済み
        .forEach((userId) => {
            groupMembers.push(`User,${userId},False`);
        });
    return groupMembers;
}

// ===== プロセス「グループ作成」 =====
function createProjectGroup($button) {
    // グループIDが記録済みなら作成しない（二重作成を防ぐ）
    if (getGroupId() > 0) {
        showError(`グループは作成済みです（グループID：${getGroupId()}）。`);
        return;
    }

    const groupName = GROUP_NAME_PREFIX + $p.getValue(PROJECT_NAME_COLUMN);
    $p.apiGroupsCreate({
        data: {
            GroupName: groupName,
            GroupMembers: buildGroupMembers(),
        },
        done: function (data) {
            // data.Id に作成したグループのIDが入っている
            $p.set($p.getControl(GROUP_ID_COLUMN), data.Id);
            // グループIDと一緒に保存し、状況を「有効」にする
            $p.execProcess($button);
        },
        fail: function (jqXHR) {
            showError(`グループ「${groupName}」を作成できませんでした。${getErrorMessage(jqXHR)}`);
        },
    });
}

// ===== プロセス「メンバー反映」 =====
function updateProjectGroupMembers($button) {
    const groupId = getGroupId();
    if (groupId === 0) {
        showError('グループIDが記録されていません。');
        return;
    }

    // メンバーは送った内容でまるごと置き換わるため、リーダーとメンバー全員を送る
    $p.apiGroupsUpdate({
        id: groupId,
        data: {
            GroupMembers: buildGroupMembers(),
        },
        done: function () {
            // 変更したメンバー欄を保存する
            $p.execProcess($button);
        },
        fail: function (jqXHR) {
            showError(`グループ（グループID：${groupId}）のメンバーを更新できませんでした。${getErrorMessage(jqXHR)}`);
        },
    });
}

// ===== プロセス「グループ廃止」 =====
function deleteProjectGroup($button) {
    const groupId = getGroupId();
    if (groupId === 0) {
        showError('グループIDが記録されていません。');
        return;
    }
    const groupName = GROUP_NAME_PREFIX + $p.getValue(PROJECT_NAME_COLUMN);
    if (!confirm(`グループ「${groupName}」（グループID：${groupId}）を削除します。よろしいですか？`)) {
        return;
    }

    $p.apiGroupsDelete({
        id: groupId,
        done: function () {
            // 保存し、状況を「廃止済」にする
            $p.execProcess($button);
        },
        fail: function (jqXHR) {
            showError(`グループ（グループID：${groupId}）を削除できませんでした。${getErrorMessage(jqXHR)}`);
        },
    });
}