NetSuite管理者ヒント|スイートレットでサブリスト列を必須にする

データ入力、承認または内部ツール用のカスタム・スイートレットを構築する際の一般的な課題の1つは、ユーザーがサブリストの各行に完全な情報を提供できるようにすることです。入力が不完全な場合は、処理エラー、データ欠落または追加のフォローアップが発生する可能性があります。

これに対処する便利な方法は、サブリスト列を必須にする方法です。Suiteletインタフェースで必須フィールドを直接適用することで、管理者および開発者は、ユーザーがフォームを送信する前に重要なフィールドに入力していることを確認できます。

サブリスト列を必須にする理由

Suiteletサブリストに必須フィールドを設定すると、次のことに役立ちます:

• ユーザーが複数の明細を追加する場合、未完了の発行を防止します。
• トランザクションを処理する前に重要なデータが取得されていることを確認します。
• バックエンド処理中の検証エラーの削減。
• カスタム・ワークフローおよび承認プロセスのデータ精度の向上。

これは、経費入力、承認、一括更新またはカスタム・データ相談受付フォーム用に設計されたSuiteletsでは特に役立ちます。

isMandatoryプロパティの使用

SuiteScriptでは、isMandatoryプロパティを使用して、N/ui/serverWidgetモジュールで作成されたフィールドに必須入力を適用できます。

サブリスト・フィールドに適用する場合、ユーザーはフォームを送信する前に、各行についてその列に値を入力する必要があります。

重要:

このプロパティは、Suiteletsで動的に作成されたフィールド、またはserverWidgetで生成されたカスタムUIにのみ適用されます。

例: 必須のサブリスト列を含むSuitelet

次の例は、次の方法を示しています。

• Suiteletフォームの作成
• 編集可能なサブリストの追加
• 列を必須として設定
• デバッグの必須ステータスを記録します

/**
 * @NApiVersion 2.x
 * @NScriptType Suitelet 
 */
define(['N/ui/serverWidget', 'N/log'], function(serverWidget, log) {
    function onRequest(context) {
        // Suiteletフォームの作成
        var form = serverWidget.createForm({ title: 'Mandatory Column Example' });

        // フォームにサブリストを追加
        var sublist = form.addSublist({
            id: 'custpage_list',              // サブリスト内部ID
            label: 'Sample Sublist',          // ユーザーに示されるサブリスト・ラベル
            type: serverWidget.SublistType.INLINEEDITOR // Allows inline editing
        });

        // サブリストに列(フィールド)を追加
        var col = sublist.addField({
            id: 'custpage_col',               // Column internal ID
            label: 'Required Column',         // Column label as shown to the user
            type: serverWidget.FieldType.TEXT // Column type is text
        });

        // UIで列を必須にする
        col.isMandatory = true;

        // この列のisMandatoryプロパティをログに記録
        log.debug({
            title: 'Is Column Mandatory?',
            details: col.isMandatory // Will log 'true'