$p.apiUsersCreate

/**
 * ================================================================
 * サンプル01  アカウント払い出し申請のレコードから、ユーザーを作成する
 * ================================================================
 *
 * 【概要】
 *   新しく入る社員・外部要員のアカウントを「アカウント払い出し申請」テーブルで
 *   申請・承認し、承認済みのレコードで IT 管理者がプロセス「アカウント作成」を
 *   押すと、$p.apiUsersCreate で申請内容（ログインID・氏名・所属組織）の
 *   ユーザーを作成します。
 *     ・初期パスワードはブラウザで生成し、画面に一度だけ表示します。
 *       レコードやログには残しません。
 *     ・作成したユーザーは、初回ログイン時にパスワードの変更を求められます
 *       （パスワードの有効期限を作成した時点にするため）。
 *     ・返ってきたユーザーIDを申請レコードに書き戻し、状況を「作成済」にします。
 *
 * 【ポイント】
 *   ・パスワードを渡さないと、ユーザーは作成できません（パスワードポリシーの
 *     エラーになります）。そのため、必ず生成して渡します。
 *   ・ログインIDが既に使われているときは、エラー（ステータスコード 500）で
 *     「このログインIDは既に使用中です」が返ります。ステータスコードで
 *     分岐せず、返ってきたメッセージをそのまま表示します。
 *     申請テーブルのログインIDを「重複禁止」にしておくと、申請の段階で気付けます。
 *   ・OnClick を設定したプロセスは、ボタンを押しただけでは保存されません。
 *     ユーザーの作成が成功したあとに $p.set でユーザーIDを入れてから
 *     $p.execProcess を呼ぶと、その値と一緒に保存し、状況を変更します。
 *     作成に失敗したときは $p.execProcess を呼ばないため、状況は変わりません。
 *
 * 【使い方】
 *   下記の定数を、実際に使用する項目コードに置き換えてください。
 *   あわせて「テーブルの管理 > プロセス」で、プロセス「アカウント作成」を
 *   追加してください（画面種別：編集、実行種別：追加したボタン、
 *   アクション種別：保存、現在の状況：承認済、変更後の状況：作成済、
 *   OnClick：createAccount($(this))）。ユーザーを作成できるのはテナント管理者
 *   だけなので、プロセスの「アクセス制御」でテナント管理者にだけ表示します。
 *   スクリプトの出力先は「編集」にチェックしてください。
 * ================================================================
 */

// ===== 設定 =====
const NAME_COLUMN = 'Title'; // 氏名（ユーザーの名前になる）
const LOGIN_ID_COLUMN = 'ClassA'; // ログインID
const DEPT_COLUMN = 'ClassB'; // 所属組織（選択肢一覧に [[Depts*]]。値は組織ID）
const USER_ID_COLUMN = 'NumA'; // 作成したユーザーID（スクリプトが書き戻す）
// 初期パスワードの長さ
const PASSWORD_LENGTH = 12;

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

// 失敗の応答から、表示するメッセージを取り出す
function errorMessage(data) {
    try {
        return JSON.parse(data.responseText).Message;
    } catch (e) {
        return `ユーザーを作成できませんでした（ステータスコード ${data.status}）。`;
    }
}

// Date を「2026/10/07 14:30:00」の形にする
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())}:${pad(date.getSeconds())}`
    );
}

// 初期パスワードを生成する。小文字・大文字・数字・記号を1文字以上ずつ含めるので、
// パスワードポリシーで文字の種類を求める設定にしていても満たす
function generatePassword(length) {
    const groups = [
        'abcdefghijkmnopqrstuvwxyz', // 見間違えやすい l を除く
        'ABCDEFGHJKLMNPQRSTUVWXYZ', // 見間違えやすい I・O を除く
        '23456789', // 見間違えやすい 0・1 を除く
        '!#$%&*+-=?@',
    ];
    const all = groups.join('');
    const random = (max) => {
        const values = new Uint32Array(1);
        window.crypto.getRandomValues(values);
        return values[0] % max;
    };
    const chars = groups.map((group) => group[random(group.length)]);
    while (chars.length < length) {
        chars.push(all[random(all.length)]);
    }
    // 種類ごとの1文字が先頭に固まらないように並べ替える
    for (let i = chars.length - 1; i > 0; i--) {
        const j = random(i + 1);
        [chars[i], chars[j]] = [chars[j], chars[i]];
    }
    return chars.join('');
}

// プロセス「アカウント作成」の OnClick から呼ぶ
function createAccount($button) {
    // 作成済みのユーザーIDがあれば、二重に作らない（数値項目は未入力でも 0 になる）
    if (Number($p.getValue(USER_ID_COLUMN)) > 0) {
        showError('このレコードのアカウントは作成済みです。');
        return;
    }
    const loginId = String($p.getValue(LOGIN_ID_COLUMN) || '').trim();
    const name = String($p.getValue(NAME_COLUMN) || '').trim();
    const deptId = Number($p.getValue(DEPT_COLUMN)) || 0;
    if (loginId === '' || name === '') {
        showError('ログインIDと氏名を入力してください。');
        return;
    }
    const password = generatePassword(PASSWORD_LENGTH);

    $p.apiUsersCreate({
        data: {
            LoginId: loginId,
            Name: name,
            DeptId: deptId,
            Password: password,
            // パスワードの有効期限を今にして、初回ログイン時に変更を求める。
            // toISOString() は世界標準時になるため、画面と同じ「年/月/日 時:分:秒」で渡す
            PasswordExpirationTime: formatDateTime(new Date()),
        },
        done: function (data) {
            // 初期パスワードは、ここで一度だけ表示する（レコードには保存しない）。
            // prompt の入力欄に入れて表示すると、選択してコピーできる
            window.prompt(
                `ユーザー「${name}」（ログインID：${loginId}）を作成しました。\n` +
                    '初期パスワードは次のとおりです。この画面を閉じると再表示できないので、控えてから閉じてください。',
                password
            );
            $p.set($p.getControl(USER_ID_COLUMN), data.Id);
            $p.execProcess($button);
        },
        fail: function (data) {
            showError(errorMessage(data));
        },
    });
}