チャネル データベースの事前拡張された列

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

多くの場合、チャネル データベースのフィールドを拡張しますが、それらのフィールドの列の長さを拡張することはできません。 そのため、拡張シナリオをサポートするために、既定の列の長さが拡張されています。

フィールドはチャネル データベースで拡張されますが、拡張機能では拡張データ型 (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();
            }
        }
    }
}

チャネル データベースの事前拡張された列

次の表に、事前拡張されている列の一覧を示します。