Introdution
この更新プログラムは、フランスのローカリゼーション機能の製品版の Microsoft Dynamics AX 2012 の R3 を有効にする結合された更新プログラムのバイナリの一部です。この結合された更新プログラムが、小売り業向けの Microsoft Dynamics AX 2012 R3 は NF 525 認定要件ごと認定します。参照してください KB 4058329 、アプリケーションの一部の更新プログラムです。
この資料では、フランスの小売ポイント販売製品のローカリゼーション ソリューションのコンポーネントの概要と同様にフランスにある店舗で使用するには、(POS) の Microsoft Dynamics AX 2012 の R3 を構成する手順の概要が含まれています。SDK の製品です。
Microsoft Dynamics AX 2012 R3 フランスおよびローカライズの必要なセットアップ手順の小売のローカライズの詳細については、 KB 4058329を参照してください。
フランスの POS を構成します。
セクションの下には、フランスの point-of-sale (POS) を構成するために必要な手順を説明します。
フランスの企業の POS を構成します。
企業の POS の販売トランザクションのデジタル署名を有効にするには、証明書をインストールし、アプリケーション構成ファイル POS.exe.config に必要な設定を追加する必要があります。
-
企業の POS マシン上のローカル証明書ストレージには、有効なデジタル証明書をインストールします。
-
POS.exe.config ファイルのconfigSectionsセクションに次のコードをコピーします。
<sectionGroup name="applicationSettings" type="System.Configuration.ApplicationSettingsGroup, System, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" >
<section name="Microsoft.Dynamics.Retail.FiscalRegistrationServices.DigitalSignatureFiscalRegister.Properties.Settings" type="System.Configuration.ClientSettingsSection, System, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" requirePermission="false" />
<section name="Microsoft.Dynamics.Retail.FiscalRegistrationServices.Properties.Settings" type="System.Configuration.ClientSettingsSection, System, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" allowExeDefinition="MachineToLocalUser" requirePermission="false" />
</sectionGroup>
-
POS.exe.config ファイルの関連付け] セクションに次のコードをコピー :
<Microsoft.Dynamics.Retail.FiscalRegistrationServices.Properties.Settings>
< 設定名="FiscalRegisterAssembly_FR"serializeAs=「文字列」>
<value>DigitalSignatureFiscalRegister.dll</value>
</setting>
< 設定名="FiscalRegisterClass_FR"serializeAs=「文字列」>
<value>Microsoft.Dynamics.Retail.FiscalRegistrationServices.DigitalSignatureFiscalRegister.DigitalSignatureFiscalRegister</value>
</setting>
</Microsoft.Dynamics.Retail.FiscalRegistrationServices.Properties.Settings>
<Microsoft.Dynamics.Retail.FiscalRegistrationServices.DigitalSignatureFiscalRegister.Properties.Settings>
< 設定名=「証明」serializeAs=「文字列」>
< 値 >マイ</値 >
</setting>
< 設定名="CertificateStoreLocation"serializeAs=「文字列」>
< 値 >LocalMachine</値 >
</setting>
< 設定名="EncodingName"serializeAs=「文字列」>
<value>UTF-8</value>
</setting>
< 設定名="DataHashAlgorithm"serializeAs=「文字列」>
<value>SHA1</value>
</setting>
< 設定名="CertificateThumbprint"serializeAs=「文字列」>
<value></value>
</setting>
</Microsoft.Dynamics.Retail.FiscalRegistrationServices.DigitalSignatureFiscalRegister.Properties.Settings>
-
POS.exe.config ファイルの関連付け] セクションでインストールされている証明書の証明、CertificateStoreLocation および CertificateThumbprint の正しい値を設定します。
フランスの最新の POS を構成します。
最新の POS でのデジタル署名機能を有効にするには、証明書をインストールし、商取引の実行時構成ファイルの commerceRuntime.config に必要な設定を追加する必要があります。
-
最新の POS マシン上のローカル証明書ストレージには、有効なデジタル証明書をインストールします。
-
製品版のサーバーのインストール フォルダーにある commerceRuntime.config ファイルの「組版」セクションに次のコードを追加します。
< 追加ソース=「アセンブリ」値="Microsoft.Dynamics.Commerce.Runtime.Services.FiscalRegisterServiceFrance、バージョン = 6.3.0.0、カルチャ依存しない、次の = = 31bf3856ad364e35、processorArchitecture = MSIL」/>
< 追加ソース=「アセンブリ」値="Microsoft.Dynamics.Commerce.Runtime.Services.DigitalSignature、バージョン = 6.3.0.0、カルチャ依存しない、次の = = 31bf3856ad364e35、processorArchitecture = MSIL」/>
-
オフライン モードをサポートするためにブローカーのクライアントのインストール フォルダーにある commerceRuntime.config ファイルに、同じ変更を実行します。
-
Microsoft.Dynamics.Commerce.Runtime.Services.FiscalRegisterServiceFrance.dll.config ファイルでインストールされている証明書の証明、certificateStoreLocation および certificateThumbprint の正しい値を設定します。
SDK の概要
セクションの下フランスは、製品版の SDK に含まれているために製品のローカリゼーション ソリューションのコンポーネントの概要を説明します。これらのコンポーネントをカスタマイズまたはローカライズ機能を拡張するを変更することができます。
エンタープライズ POS
ソリューションは、次の 3 つの新しいプロジェクト、2 つの新しいインターフェイス、および 3 つの新しいデータベース テーブルで構成されます。以外にも、いくつかの既存のインターフェイスは、新しいメソッドで拡張されます。
-
DigitalSignatureFiscalRegisterプロジェクトでは、製品版の SDK\POS Plugins\FiscalRegistrationServices し、FiscalRegistrationServices のソリューションの一部であります。
-
FranceTriggersプロジェクトでは、小売 SDK\POS のプラグを ins\Triggers フォルダーにあるし、トリガーのソリューションの一部であります。
-
IAuditEventTriggerとIBatchOperationTriggerの新しいインターフェイスは、コントラクト アセンブリの部品です。
-
IApplicationTriggerの既存のインタ フェースは 2 つの新しいメソッドで拡張します。
-
ApplicationSettingChangedは、トレーニング モードなど、アプリケーションの設定と呼ばれるまたはオフライン モードに変更します。
-
PostPurgeChannelDataは、チャネルのデータベースからトランザクションをクリーニングした後に呼び出されます。
-
-
IPrintingTriggerの既存のインタ フェースは 2 つの新しいメソッドで拡張します。
-
GetReceiptFieldInfoは、レシートの上のフィールドを印刷する前に呼び出されます。
-
PostPrintReceiptCopyは、領収書のコピーを印刷した後に呼び出されます。
-
-
新しいRetailLogTransactionReferenceテーブルを使用して、監査ログのイベントと領収書のコピーの印刷のイベントと、元の小売トランザクションの参照などの対応する小売トランザクション間の参照を格納します。
-
新しいRetailLogFiscalTransactionテーブルを使用して、監査ログのイベントの登録情報を格納します。
-
小売トランザクションなどの署名付きのオブジェクトのいくつかの種類の最後の連続番号を格納し、イベントを監査するには、新しいRetailFiscalRegistrationSequenceテーブルが使用します。
監査イベントのトリガー
監査イベントの作成プロセスのカスタマイズを有効にするのには、新しい監査トリガーが追加されます。このトリガーは、他のトリガーと同様の動作し、MEF によって読み込まれます。PreLogEventとPostLogEvent、それぞれ、監査イベントをログ出力の前後に呼び出される 2 つの方法が用意されています。
IAuditEventTriggerの新しいインターフェイスは、コントラクトライブラリに追加されました。このインターフェイスについて説明します PreLogEventとPostLogEventメソッドです。
PreLogEventメソッドでは、ログの処理を中断でき、標準のPreTriggerResultオブジェクトを使用してメッセージを表示することができます。監査トリガーを使用するには、新しいクラスを作成する必要があります。このクラスは、 IAuditEventTriggerインターフェイスを実装する必要があります。この例では、MEF はアプリケーションの起動時にクラスをロードします。
FranceTriggers
FranceTriggersプロジェクトには、pos 機能プロファイルのISO コードのフィールドは、 FRに設定されている場合に読み込まれている標準の POS のトリガーが含まれています。
-
BatchOperationTriggerはIBatchOperationTriggerインターフェイスを実装して、 SaveCloseBatchメソッドをオーバーライドします。メソッドでは、シフトの終了の監査イベントを記録します。
-
FranceApplicationTriggerは、 IApplicationTriggerインターフェイスを実装して、 ApplicationStartメソッドとPostLogonメソッドをオーバーライドします。
-
ApplicationStartメソッド、 ActualizeRegistrationStateメソッドを呼び出すことによってRegistrationManagerの登録状態を初期化します。
-
PostLogonメソッドは、ログオン操作が成功した場合、 ShiftClosingCheckerクラスのCheckShiftClosingメソッドを呼び出すことによってシフト状態をチェックします。メソッドでは、現在のシフトが事前に定義された時間よりも長く続く場合に警告が表示されます。
-
-
FranceAuditEventTriggerは、 IAuditEventTriggerインターフェイスを実装して、 PreLogEventメソッドとPostLogEventメソッドをオーバーライドします。
-
PreLogEventメソッドは、 IAuditEventオブジェクトを受信し、監査が有効になっている場合、監査イベントの登録を実行します。
-
PostLogEventメソッドは、 IAuditEventオブジェクトを受信し、会計年度の登録情報を保存することで監査が有効になっている場合、監査イベントの登録を終了します。
-
-
FranceOperationTriggerはIOperationTriggerインターフェイスを実装して、 PreProcessOperationメソッドをオーバーライドします。メソッドは、 ShiftClosingCheckerクラスのCheckShiftClosingメソッドを呼び出すことによって、シフト状態をチェックします。メソッドは、現在のシフトが事前に定義された時間よりも長く持続し、警告メッセージが表示する場合に操作をブロックします。
-
FrancePaymentTriggerはIPaymentTriggerインターフェイスを実装して、前払メソッドをオーバーライドします。メソッドは、 PreProcessOperationメソッドと同じように動作し、現在のシフトが事前に定義された時間よりも長く続く場合に、支払をブロックします。
-
FrancePrintingTriggerはIPrintingTriggerインターフェイスを実装して、 GetReceiptFieldInfoメソッドをオーバーライドします。メソッドは、 IReceiptFieldとIReceiptPrintingContextオブジェクトを受信し、印刷されている [受信] 列の値を計算します。
-
FranceTransactionTriggerは、 ITransactionTriggerを実装し、 PreEndTransactionとSaveTransactionのメソッドをオーバーライドします。
-
PreEndTransactionメソッドは、 IPosTransactionオブジェクトを受信し、小売トランザクションの登録を行います。さらに、shift キーの状態をチェックし、現在のシフトが事前に定義された時間よりも長く続く場合は、トランザクションをブロックします。
-
SaveTransactionメソッドは、 IPosTransactionオブジェクトを受信し、会計年度の登録情報を保存することにより小売トランザクションの登録を終了します。
-
DigitalSignatureFiscalRegister
DigitalSignatureFiscalRegisterプロジェクトでは、デジタル署名小売トランザクションとイベントを監査する機能を提供します。
-
CertificateHelperクラスは、証明書ストアから証明書を読み込むためのメソッドを提供します。
-
DigitalSignatureFiscalRegisterクラスでは、 IFiscalRegisterDriverインターフェイスを実装して、初期化メソッドとRegisterFiscalDataメソッドをオーバーライドします。
-
、 Initializeメソッドは、構成ファイルから証明書の拇印や場所などのデジタル署名の設定を読み込みます。
-
RegisterFiscalDataメソッドは、シリアル化された会計情報を受信し、デジタル署名を計算します。
-
-
DigitalSignatureFiscalRegisterResponseクラスでは、デジタル署名の登録応答を表します。
登録プロセス
監査イベントおよび小売トランザクションの登録プロセスに似ています。FranceTriggersプロジェクトに登録可能なオブジェクトの種類ごとにIRegistrableEventインターフェイスを実装するクラスのアダプター クラスがあります。
-
監査イベントの登録をサポートするためにRegistrableEventAuditEventAdapterクラス
-
小売トランザクションの登録をサポートするためにRegistrableEventRetailTransactionAdapter
-
シフトをクローズのイベントの登録をサポートするためにRegistrableEventShiftTransactionEventAdapter
アダプターは、抽出し、登録可能なオブジェクトからの登録に使用される情報をシリアル化を行います。RegistrableEventFactoryクラスでPreEndTransaction、 PreLogEvent 、 SaveCloseBatchなどのトリガーのメソッド内の適切な種類のアダプターが作成されます。
登録可能なイベント オブジェクトの登録は、FranceTriggers プロジェクトであるRegistrationManagerクラスによって実行されます。RegistrationManagerは、 IFiscalRegisterインターフェイスを実装すると、MEF によって読み込まれるDefaultFiscalRegistrationServiceサービスを使用します。
DefaultFiscalRegistrationServiceは、作成し、 IFiscalRegisterDriverのインスタンスを設定します。使用してFiscalRegisterFactoryクラスIFiscalRegisterDriverの適切なインスタンスを作成し、インスタンスを生成するのフランスの国でDigitalSignatureFiscalRegisterクラス/領域のコンテキスト。
会計登録のシリアル化されたデータがそれぞれの小売トランザクションとイベントの監査のRetailTransactionFiscalTransactionとRetailLogFiscalTransactionのデータベース テーブルに JSON 形式で格納されます。
製品版のサーバー
4 つの新しい小売サーバーでは、フランスの製品のローカリゼーションをサポートするために要求が追加されました。
-
会計登録シーケンスを取得するGetFiscalRegistrationSequenceTypeValueは、指定されたトランザクション タイプを入力または監査イベントの種類。
-
GetLastRegisteredFiscalData要求を最後に取得するには、指定したトランザクションの種類の監査イベントの種類の会計年度のデータが登録されています。
-
監査イベントを登録する要求をRegisterAuditEvent 。
-
Shift キーの状態とシフトの終了の時刻を取得する要求をGetShiftClosingStateInfo 。
小売 SDK\Proxies\RetailProxy\Adapters のShiftManagerとStoreOperationsManager小売プロキシ アダプターに対応するメソッドが見つかりませんでした。
Commerce の実行時
Commerce ランタイムのローカリゼーションは、2 つの新しいプロジェクト、新しい要求ハンドラーで構成されます。
-
SDK です。DigitalSignatureプロジェクトは、小売 SDK\Commerce の実行-time\SDK にします。DigitalSignature Sdk.CommerceRuntimeソリューションの一部となります。
-
SDK です。FiscalRegisterServiceFranceプロジェクトは、小売 SDK\Commerce の実行-time\SDK にします。DigitalSignature Sdk.CommerceRuntimeソリューションの一部となります。
SDK.DigitalSignature
プロジェクトは、エンタープライズの POS のDigitalSignatureFiscalRegisterプロジェクトに似ています。デジタル小売トランザクションを署名し、イベントを監査する機能を提供します。
-
CertificateHelperクラスは、証明書ストアから証明書を読み込むためのメソッドを提供します。
-
DataSignatureRequestHandlerクラスは、 IRequestHandlerインターフェイスを実装し、 DigitalSignatureServiceRequest要求を処理します。
DigitalSignatureServiceRequestを使用して、証明書に指定されたデータに署名します。
SDK.FiscalRegisterServiceFrance
SDK です。FiscalRegisterServiceFranceプロジェクトには、多数の新しい要求を処理するFiscalRegistrationServiceが含まれています。
-
GetFiscalRegistrationSequenceTypeServiceRequestは、販売トランザクション タイプから会計のシーケンスの種類を決定したり、監査イベントの種類に新しい要求です。
-
GetLastRegisteredFiscalDataServiceRequestは、指定した会計年度のシーケンス型の最後の保存されている会計データを取得するために新しい要求です。
-
GetFiscalRegistrationSequenceServiceRequestは、端末とシーケンスを入力、特定の店舗の現在のシーケンス番号を取得するために新しい要求です。
-
GetSalesOrderFiscalRegistrationInfoRequestは、販売注文から会計データを取得するために新しい要求です。
-
ParseFiscalRegisterDataRequestでは、シリアル化を解析するための新しい要求オブジェクトを JSON 形式の応答を登録します。
-
SaveSalesTransactionDataRequestは、オーバーライドされた要求は、営業トランザクションの登録を実行し、トランザクションを保存するのには元の要求ハンドラーを呼び出します。
-
RegisterAuditEventServiceRequestは、監査イベントを登録するのには新しい要求です。
-
RegisterShiftCloseAuditEventRequestは、シフトの終了のイベントを登録するのには新しい要求です。
最新の POS
最新の POS のローカリゼーションには、いくつかのビューとビュー モデルの小売 SDK\ POS Clients\Framework 内にある変更が含まれています。
操作前のハンドラー
IPreOperationHandlerの新しいインターフェイスが導入されました。それには、次の方法について説明します。
executeHandler(operationId: Commerce.Operations.operationTypeEnum): IAsyncResult < ICancelableResult > は
メソッドの目的では、最新の POS の操作を実行する前に追加のチェックを実装します。ExecuteHandlerメソッドでは、現在の操作の種類を受信し、適切なICancelableResultを非同期的に返すことで、操作をブロックすることができます。
OperationsManagerのregisterPreOperationHandlerメソッドを呼び出すことによってIPreOperationHandlerインターフェイスのインスタンスを登録するとします。
Shift キーの状態のチェック
Shift キーの状態のチェックは、 ShiftClosingManagerFrance 、 IShiftClosingManagerインターフェイスを実装することによって管理されます。ShiftClosingManagerFactoryでは、 IShiftClosingManagerの適切なインスタンスの作成を担当し、フランスの国のコンテキストでShiftClosingManagerFranceを作成します。
ShiftClosingManagerFranceはまたIPreOperationHandlerインターフェイスを実装し、シフトの最後の指定した時間よりも長い場合は、いくつかの操作をブロックするために使用します。OperationsManagerクラス フランスの国のコンテキストでの操作前のハンドラーとして登録されます。
ShiftClosingManagerFranceの要求は、それぞれの支払額とGetShiftClosingStateInfoの製品版のサーバー要求を使用して販売の操作の前に状態を移動します。
登録プロセス
販売トランザクションおよびイベントの監査の登録は、 IFiscalRegistrationManagerインターフェイスを実装するFiscalRegistrationManagerFranceクラスによって管理されます。FiscalRegistrationManagerFactoryクラスがIFiscalRegistrationManagerの適切な実装の作成を担当する、フランスの国/地域] の下のFiscalRegistrationManagerFranceの作成コンテキスト。
販売トランザクションの登録は、 checkOutCartメソッドではCartViewModelクラスで開始します。CartViewModelでは、 FiscalRegistrationManagerFranceを使用して、チェック アウトの前後には、登録のロジックを実行します。
最後の登録をしているローカルの記憶域からの販売のトランザクション (存在する場合、前のチェック アウト ロジックが (register 応答) の登録情報を抽出し、 GetLastRegisteredFiscalDataの要求を使用して製品版のサーバーからの要求または。最後には、チェック アウトに Cart オブジェクトの拡張プロパティとして渡された応答を登録します。最後の登録応答を格納する、拡張プロパティは、Commerce の実行時にSaveSalesTransactionDataRequestを処理する際に抽出しと、現在のトランザクションのデジタル署名を生成するために使用します。
現在の登録応答をローカル ストレージにポスト チェック アウト ロジックの保存以降に要求で使用します。
監査イベントの登録は、 FiscalRegistrationManagerFranceクラスのregisterAuditEventメソッドによって実行され、さまざまなポイントから開始されます。
-
ログオン監査イベントの登録は、演算子の成功したログオンの後、 LoginViewModelから開始されます。
-
LogoffOperationHandler.からログオフの監査イベントの登録を開始しました。
-
パージの監査イベントの登録は、 BlindCloseShiftOperationHandlerおよびCloseShiftOperationHandlerのクラスから開始されます。
-
ChainedRequestFactoryクラスから開始し、オフライン モードの終了のイベントの登録が開始されます。
-
ReceiptViewModel.からの受領書のコピーの印刷イベントの登録を開始しました。
最新の POS では、製品版のサーバーにRegisterAuditEvent要求を送信することによって監査イベントを登録します。要求は、[Commerce ランタイム サービスFiscalRegistrationServiceに渡されます。
修正プログラムの情報
Microsoft Dynamics AX を入手する方法は、ファイルを更新します。
この更新プログラムは、Microsoft ダウンロード センターから手動のダウンロードしインストールすることできます。
必要条件
この修正プログラムを適用するのにはインストールされている製品は次のいずれかが必要です。
-
Microsoft Dynamics AX 2012 R3
再起動の必要性
修正プログラムを適用した後、アプリケーション オブジェクト サーバー (AOS) サービスを再起動する必要があります。
発生している問題をダウンロードする、この修正プログラムをインストールするか、またはその他の技術の質問をサポート、パートナーに相談するか、マイクロソフトとサポート プランを直接に登録すると場合、は、Microsoft Dynamics のテクニカル サポートにお問い合わせくださいし、作成する場合、新しいサポート要求します。これを行うには、次のマイクロソフト web サイトを参照してください。
https://mbs.microsoft.com/support/newstart.aspx
これらのリンクを使用して、国の特定の電話番号を電話で Microsoft Dynamics のテクニカル サポートに連絡することができます。これを行うには、次のマイクロソフト web サイトのいずれかを参照してください。
パートナー
https://mbs.microsoft.com/partnersource/resources/support/supportinformation/Global+Support+Contacts
お客様
https://mbs.microsoft.com/customersource/northamerica/help/help/contactus
かかる料金が免除されるテクニカル サポート担当者 Microsoft Dynamics および関連製品のことは、通常は特別な場合は、特定の更新プログラムは、問題を解決するにを決定します。追加の質問および問題の特定の更新プログラムの対象とならない問題は、通常のサポート料金が適用されます。
メモこれは、マイクロソフト サポートの組織内から直接作成した「高速公開」の資料です。としてでは、ここに含まれる情報が提供されている-は、新たな問題に対応します。速やかに利用できるようにした結果として、内容には誤植が含まれている可能性があり、事前告知なしで改訂する場合があります。その他の考慮事項については、使用条件を参照してください。