$p.siteId

/**
 * ================================================================
 * サンプル  取引先コードを入力すると、取引先マスタから名称・住所を自動入力する
 * ================================================================
 *
 * 【概要】
 *   受注管理の編集画面で取引先コードを入力すると、$p.siteId('取引先マスタ') で
 *   取引先マスタのサイトIDを名前から求め、$p.apiGet でコードが完全一致する
 *   取引先を探して、取引先名と住所を自動で入れます。
 *   取引先コードが空のとき、マスタに無いコードのときは、保存を止めて
 *   エラーメッセージを表示します。
 *
 * 【標準の「ルックアップ」との使い分け】
 *   取引先が少なく、プルダウンから選べば足りる場合は、標準の「ルックアップ」を
 *   使ってください。このサンプルは、取引先が数百〜数千件あってプルダウンから
 *   探すのが難しい場合や、伝票などからコードをそのまま入力・貼り付けする
 *   運用を想定しています。
 *
 * 【$p.siteId でサイトIDを求める理由】
 *   サイトIDをコードに直接書くと、サイトパッケージで別の環境に移したときに
 *   書き換えが必要になります。$p.siteId('サイトのタイトル') は、リンクしている
 *   サイトのIDをタイトルから返すので、書き換えずに使えます。
 *   そのため、取引先マスタへのリンクを持つ項目（下の ClassD）を1つ用意します。
 *
 * 【照合のタイミングと保存の判定】
 *   照合は、取引先コードの入力欄から離れたとき（change）と、編集画面を
 *   開いたときに行います。$p.apiGet は非同期で結果が返るため、保存のときに
 *   取得し直すのではなく、直近の照合結果（照合したコードと、見つかったか）を
 *   覚えておき、保存の直前にその結果で判定します。
 *   コードを入力してすぐ保存ボタンを押すと、先に入力欄の change が発生して
 *   照合が始まりますが、保存の判定の時点ではまだ結果が返っていません。
 *   そのときは保存をいったん止めて「照合しています」と表示し、照合が
 *   成功したら自動でもう一度保存します（マスタに無ければ保存しません）。
 *   照合はコードを変えたときに1回 API を呼ぶだけで、画面の再読み込み
 *   （ポストバック）は起きません。
 *
 * 【使い方】
 *   受注管理テーブルに、次の項目を有効にしてください。
 *     ・ClassA：取引先コード（選択肢なし、自由入力）
 *     ・ClassB：取引先名（自動入力）
 *     ・ClassC：住所（自動入力）
 *       この2つは、項目の設定で「読取専用」にしないでください。読取専用の項目は
 *       $p.set で入れた値が画面に出ず、保存もされません。代わりにこのスクリプトが
 *       入力欄を書き換えできないようにします。
 *     ・ClassD：取引先マスタへのリンク用。選択肢一覧に [[取引先マスタのサイトID]]
 *               を設定する。$p.siteId のためだけの項目なので、画面に出さなくてよい
 *   取引先マスタは、Title＝取引先名、ClassA＝取引先コード、ClassB＝住所 とします。
 *   スクリプトの出力先は「新規作成」と「編集」にチェックしてください。
 * ================================================================
 */

// ===== 設定 =====
// 取引先マスタのタイトル（$p.siteId でサイトIDを求めるのに使う）
const MASTER_SITE_TITLE = '取引先マスタ';
// 受注管理の項目
const CODE_COLUMN = 'ClassA'; // 取引先コード
const NAME_COLUMN = 'ClassB'; // 取引先名（自動入力）
const ADDRESS_COLUMN = 'ClassC'; // 住所（自動入力）
// 取引先マスタの項目
const MASTER_CODE_COLUMN = 'ClassA'; // 取引先コード
const MASTER_NAME_COLUMN = 'Title'; // 取引先名
const MASTER_ADDRESS_COLUMN = 'ClassB'; // 住所

// ===== 処理 =====
// 直近の照合結果。code が今の取引先コードと同じで、ok が true のときだけ保存できる。
// pending は照合の結果待ち
let lookupResult = { code: null, ok: false, pending: false, message: '' };
// 照合の結果待ちの間に保存ボタンが押されたか（照合が成功したら保存し直す）
let saveAfterLookup = false;

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

function currentCode() {
    return String($p.getValue(CODE_COLUMN) || '').trim();
}

// 取引先コードで取引先マスタを探し、見つかれば取引先名・住所を入れる
function lookupPartner() {
    const code = currentCode();
    if (code === '') {
        lookupResult = { code: '', ok: false, pending: false, message: '取引先コードを入力してください。' };
        return;
    }
    // リンクしているサイトのIDを、タイトルから求める（見つからなければ 0 などの偽の値）
    const masterSiteId = $p.siteId(MASTER_SITE_TITLE);
    if (!masterSiteId) {
        lookupResult = {
            code: code,
            ok: false,
            pending: false,
            message: `「${MASTER_SITE_TITLE}」のサイトIDを取得できません。リンクの設定を確認してください。`,
        };
        showError(lookupResult.message);
        return;
    }
    // 結果が返るまでは「照合中」として、保存を止める
    lookupResult = { code: code, ok: false, pending: true, message: '' };

    $p.apiGet({
        id: masterSiteId,
        data: {
            View: {
                ApiDataType: 'KeyValues',
                ApiColumnKeyDisplayType: 'ColumnName',
                GridColumns: [MASTER_CODE_COLUMN, MASTER_NAME_COLUMN, MASTER_ADDRESS_COLUMN],
                // 指定しないと部分一致になるため、完全一致（ExactMatch）を指定する
                ColumnFilterHash: { [MASTER_CODE_COLUMN]: code },
                ColumnFilterSearchTypes: { [MASTER_CODE_COLUMN]: 'ExactMatch' },
            },
        },
        done: function (data) {
            // 照合の途中でコードが書き換えられていたら、この結果は使わない
            if (currentCode() !== code) {
                return;
            }
            const partner = (data.Response.Data || [])[0];
            if (!partner) {
                lookupResult = {
                    code: code,
                    ok: false,
                    pending: false,
                    message: `取引先コード「${code}」は${MASTER_SITE_TITLE}にありません。`,
                };
                saveAfterLookup = false;
                $p.set($p.getControl(NAME_COLUMN), '');
                $p.set($p.getControl(ADDRESS_COLUMN), '');
                showError(lookupResult.message);
                return;
            }
            $p.set($p.getControl(NAME_COLUMN), partner[MASTER_NAME_COLUMN]);
            $p.set($p.getControl(ADDRESS_COLUMN), partner[MASTER_ADDRESS_COLUMN]);
            lookupResult = { code: code, ok: true, pending: false, message: '' };
            $p.clearMessage();
            if (saveAfterLookup) {
                // 照合の結果待ちの間に押された保存を、もう一度行う
                saveAfterLookup = false;
                $('#CreateCommand, #UpdateCommand').first().click();
            }
        },
        fail: function () {
            if (currentCode() !== code) {
                return;
            }
            lookupResult = {
                code: code,
                ok: false,
                pending: false,
                message: `${MASTER_SITE_TITLE}を照合できませんでした。時間をおいてもう一度試してください。`,
            };
            saveAfterLookup = false;
            showError(lookupResult.message);
        },
    });
}

// 編集画面を開いたとき：入力済みのコードを照合しておく（既存のレコードを保存できるように）
$p.events.on_editor_load = function () {
    // 自動入力する項目は、利用者が書き換えられないようにする
    $p.getControl(NAME_COLUMN).prop('readonly', true);
    $p.getControl(ADDRESS_COLUMN).prop('readonly', true);
    // 名前空間（.lookupPartner）を付けて、二重に登録されないようにする
    $p.getControl(CODE_COLUMN).off('change.lookupPartner').on('change.lookupPartner', lookupPartner);
    lookupPartner();
};

// 保存の直前：直近の照合結果が今のコードのもので、見つかっていれば保存する
$p.events.before_validate_Create = $p.events.before_validate_Update = function () {
    const code = currentCode();
    if (code === '') {
        showError('取引先コードを入力してください。');
        return false;
    }
    if (lookupResult.code !== code || lookupResult.pending) {
        // 照合の結果待ち（または、まだ照合していない）。照合が成功したら保存し直す
        if (lookupResult.code !== code) {
            lookupPartner();
        }
        saveAfterLookup = true;
        showError('取引先コードを照合しています。照合が終わると自動で保存します。');
        return false;
    }
    if (!lookupResult.ok) {
        showError(lookupResult.message);
        return false;
    }
    return true;
};