チャネルデータベースにおける事前に拡張されたカラム

チャネルデータベース内の一部の列は、事前拡張 されています。つまり、チャネルデータベースの列の長さが、Microsoft Dynamics 365 Commerce 本社の列の長さを超えています。たとえば、 INVENTSERIALID フィールドの長さは本社データベースでは 20 文字ですが、チャネルデータベースでは 50 文字です。

多くの場合、チャネルデータベースのフィールドを拡張しますが、それらのフィールドの列の長さを拡張することはできません。したがって、拡張が必要となった場合にも対応できるよう、標準で列の長さが増設されています。

メモ

まだ事前拡張されていないフィールドを拡張する必要がある場合は、ライフサイクルサービス (LCS) で拡張要求を提出する必要があります。詳細については、拡張性要求を参照してください。

フィールドはチャネルデータベースで拡張されますが、拡張機能では拡張データ型 (EDT) 拡張モデルを使用して、本社データベース内のフィールドも拡張する必要があります。さらに、これに対応する販売時点管理 (POS) 、または Commerce Runtime (CRT) ユーザーインターフェイス (UI) を拡張する必要があります。

本社データベースを拡張しない場合、P ジョブ中にチャネルデータベースと本社データベースの間の同期が失敗するか、余分な文字が切り捨てられます。同様に、対応する POS (POS) ユーザーインターフェイス (UI) またはコマースランタイム (CRT) を拡張しない場合、検証では既定の文字長を超える文字が入力されなくなります。既定の長さは、本社データベースのベース列の長さによって決まります。

次にいくつか例を挙げます。

チャネルデータベースの INVENTSERIALID フィールドの長さは 50 文字ですが、POS UI では最大で 20 文字までのシリアル番号が入力できます。この場合、POS UI と本社データベースの両方でフィールドを拡張する必要があります。
チャネルデータベース内の STREET フィールドの長さは 400 文字に拡張されますが、CRT での検証では、本社データベースの既定の長さを超える長さが許容されなくなります。この場合、CRT 要求ハンドラー (ValidateAddressLengthServiceRequest) と本社データベースの両方を拡張して、 STREET フィールドに対して 400 文字を受け入れるようにする必要があります。

一部のフィールドは、POS 内の読み取り専用フィールドである可能性があるため、POS UI または CRT ハンドラーの拡張は不要です。たとえば、ECORES 製品に関連するフィールドは読み取り専用です。 POS では製品の作成がサポートされていないため、POS の製品の書き込みシナリオはありません。

ValidateAddressLengthServiceRequest ハンドラーをオーバーライドするサンプルコード

次の例では、ValidateAddressLengthServiceRequest を上書きする方法を示しています。

namespace Contoso
{
    namespace Commerce.Runtime.ReceiptsSample
    {
        using System;
        using System.Collections.Generic;
        using Microsoft.Dynamics.Commerce.Runtime;
        using Microsoft.Dynamics.Commerce.Runtime.Messages;
        using Microsoft.Dynamics.Commerce.Runtime.Services.Messages;

        public class ValidateAddressLengthServiceRequestExt : IRequestHandler
        {
            private static int maxDefaultFullAddressColumnLength = 250;
            private static int maxDefaultStreetColumnLength = 250;
            private static int maxDefaultCountyColumnLength = 10;

            /// <summary>
            /// Gets the collection of supported request types by this handler.
            /// </summary>
            public IEnumerable<Type> SupportedRequestTypes
            {
                get
                {
                    return new[]
                    {
                        typeof(ValidateAddressLengthServiceRequest),
                    };
                }
            }

            public Response Execute(Request request)
            {
                if (request == null)
                {
                    return null;
                }

                ValidateAddressLengthServiceRequest validateAddressLengthServiceRequest = (ValidateAddressLengthServiceRequest)request;

                var validationFailures = new List<DataValidationFailure>();

                // Add custom logic to check your desired length.

                if (!string.IsNullOrEmpty(validateAddressLengthServiceRequest?.Address?.FullAddress) 
                && validateAddressLengthServiceRequest.Address.FullAddress.Length > maxDefaultFullAddressColumnLength)
                {
                    validationFailures.Add(new DataValidationFailure(
                        DataValidationErrors.Microsoft_Dynamics_Commerce_Runtime_AddressLengthExceeded,
                        string.Format("The full address exceeds the maximum number of {0} characters allowed.",
                        maxDefaultFullAddressColumnLength))
                    {
                        LocalizedMessageParameters = new object[] { maxDefaultFullAddressColumnLength }
                    });
                }

                // Add custom logic to check your desired length.

                if (!string.IsNullOrEmpty(validateAddressLengthServiceRequest?.Address?.Street) 
                && validateAddressLengthServiceRequest.Address.Street.Length > maxDefaultStreetColumnLength)
                {
                    validationFailures.Add(new DataValidationFailure(
                        DataValidationErrors.Microsoft_Dynamics_Commerce_Runtime_StreetLengthExceeded,
                        string.Format("The street exceeds the maximum number of {0} characters allowed.", maxDefaultStreetColumnLength))
                    {
                        LocalizedMessageParameters = new object[] { maxDefaultStreetColumnLength }
                    });
                }

                // Add custom logic to check your desired length.

                if (!string.IsNullOrEmpty(validateAddressLengthServiceRequest?.Address?.County) 
                && validateAddressLengthServiceRequest.Address.County.Length > maxDefaultCountyColumnLength)
                {
                    validationFailures.Add(new DataValidationFailure(
                        DataValidationErrors.Microsoft_Dynamics_Commerce_Runtime_CountyLengthExceeded,
                        string.Format("The county exceeds the maximum number of {0} characters allowed.", maxDefaultCountyColumnLength))
                    {
                        LocalizedMessageParameters = new object[] { maxDefaultCountyColumnLength }
                    });
                }

                if (validationFailures.Count > 0)
                {
                    throw new DataValidationException(DataValidationErrors.Microsoft_Dynamics_Commerce_Runtime_AggregateValidationError,
                    validationFailures, "An error occurred when validating the address.");
                }

                return new NullResponse();
            }
        }
    }
}