Introdution

Denne oppdateringen er en binær del av den kombinerte som gjør at Microsoft Dynamics AX 2012 R3 for detaljhandel lokalisering funksjonalitet for Frankrike. Med denne kombinerte oppdateringen er Microsoft Dynamics AX 2012 R3 for detaljhandel sertifisert per sertifiseringskrav for NF 525. Se KB 4058329 for program-delen av oppdateringen.

Denne artikkelen gir en oversikt over trinnene som kreves for å konfigurere Microsoft Dynamics AX 2012 R3 for detaljhandel punkt-av-salg (POS) som skal brukes i butikker i Frankrike, i tillegg til en oversikt over komponentene i Retail lokalisering løsningen for Frankrike er inkludert i detaljhandelen SDK.

Se KB 4058329 for mer informasjon om Microsoft Dynamics AX 2012 R3 for detaljhandel lokalisering for Frankrike og nødvendige lokalisering konfigurasjonstrinnene.

Konfigurere POS for Frankrike

Den under avsnittene beskriver fremgangsmåtene som er nødvendige for å konfigurere salgsstedet (POS) for Frankrike.

Konfigurer Enterprise POS for Frankrike

For å aktivere digital signering av salgstransaksjoner i Enterprise-POS, må du installere et sertifikat og legge til de nødvendige innstillingene i konfigurasjonsfilen for programmet POS.exe.config:

  1. Installere et gyldig digital sertifikat til lokale sertifikatlager på Enterprise POS-maskin.

  1. Kopier koden nedenfor til configSections -delen av filen POS.exe.config:

<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>  

  1. Kopier koden nedenfor til applicationSettings -delen av filen POS.exe.config:

<Microsoft.Dynamics.Retail.FiscalRegistrationServices.Properties.Settings>

< innstillingen navn = "FiscalRegisterAssembly_FR" serializeAs = "Streng" >

<value>DigitalSignatureFiscalRegister.dll</value>

</setting>

< innstillingen navn = "FiscalRegisterClass_FR" serializeAs = "Streng" >

<value>Microsoft.Dynamics.Retail.FiscalRegistrationServices.DigitalSignatureFiscalRegister.DigitalSignatureFiscalRegister</value>

</setting>

</Microsoft.Dynamics.Retail.FiscalRegistrationServices.Properties.Settings>

<Microsoft.Dynamics.Retail.FiscalRegistrationServices.DigitalSignatureFiscalRegister.Properties.Settings>

< innstillingen navn = "CertificateStoreName" serializeAs = "Streng" >

< verdi > Min < / verdi >

</setting>

< innstillingen navn = "CertificateStoreLocation" serializeAs = "Streng" >

< verdi > LocalMachine < / verdi >

</setting>

< innstillingen navn = "EncodingName" serializeAs = "Streng" >

<value>UTF-8</value>

</setting>

< innstillingen navn = "DataHashAlgorithm" serializeAs = "Streng" >

<value>SHA1</value>

</setting>

< innstillingen navn = "CertificateThumbprint" serializeAs = "Streng" >

<value></value>

</setting>

</Microsoft.Dynamics.Retail.FiscalRegistrationServices.DigitalSignatureFiscalRegister.Properties.Settings>

  1. Installere riktige verdier for CertificateStoreName, CertificateStoreLocation og CertificateThumbprint for sertifikatet installert i applicationSettings -delen av filen POS.exe.config.

Konfigurere moderne POS for Frankrike

Hvis du vil aktivere funksjonen for digital signatur i moderne POS, må du installere et sertifikat og legge til de nødvendige innstillingene i Commerce kjøring konfigurasjon filen commerceRuntime.config.

  1. Installere et gyldig digital sertifikat til lokale sertifikatlager på moderne POS-maskin.

  1. Legg til følgende kode i tekstjustering i filen commerceRuntime.config i installasjonsmappen for Retail-Server :

< Legg til kilde = "samling" verdi = "Microsoft.Dynamics.Commerce.Runtime.Services.FiscalRegisterServiceFrance, versjon = 6.3.0.0, Culture = nøytral, PublicKeyToken = 31bf3856ad364e35, processorArchitecture = MSIL" / >

< Legg til kilde = "samling" verdi = "Microsoft.Dynamics.Commerce.Runtime.Services.DigitalSignature, versjon = 6.3.0.0, Culture = nøytral, PublicKeyToken = 31bf3856ad364e35, processorArchitecture = MSIL" / >

  1. Gjøre de samme endringene i filen commerceRuntime.config i installasjonsmappen for klienten Broker støtte for frakoblet modus.

  1. Installere riktige verdier for certificateStoreName, certificateStoreLocation og certificateThumbprint for det installerte sertifikatet i filen Microsoft.Dynamics.Commerce.Runtime.Services.FiscalRegisterServiceFrance.dll.config.

SDK-oversikt

Den gir en oversikt over komponentene i Retail lokalisering løsningen nedenfor delene for Frankrike er inkludert i Retail SDK. Du kan endre disse komponentene for å tilpasse eller utvide funksjonaliteten for lokalisering.

Enterprise POS

Løsningen består av tre nye prosjekter, to nye grensesnitt og tre nye databasetabeller. I tillegg til at er flere eksisterende grensesnitt utvidet med nye metoder.

  • DigitalSignatureFiscalRegister -prosjektet er i Retail SDK\POS Plugins\FiscalRegistrationServices og er en del av løsningen FiscalRegistrationServices.

  • FranceTriggers -prosjektet ligger i mappen SDK\POS for detaljhandel Plug-ins\Triggers og er en del av løsningen utløsere.

  • De nye grensesnittene av IAuditEventTrigger og IBatchOperationTrigger er deler av samlingen kontrakter.

  • Det eksisterende IApplicationTrigger -grensesnittet er utvidet med to metoder:

    • ApplicationSettingChanged er kalt opp etter en programinnstilling som opplæringsmodus eller frakoblet modus er endret.

    • PostPurgeChannelData kalles etter rengjøring transaksjoner fra kanal-databasen.

  • Det eksisterende IPrintingTrigger -grensesnittet er utvidet med to metoder:

    • GetReceiptFieldInfo kalles før du skriver ut et felt i et mottak;

    • PostPrintReceiptCopy kalles etter at du skriver ut en kopi av et mottak.

  • Tabellen RetailLogTransactionReference brukes til å lagre referanser mellom og overvåkingshendelser Logg tilsvarende handelstransaksjoner som referanse mellom hendelsen for utskrift av en kopi av et mottak og den opprinnelige transaksjonen for detaljhandel.

  • Tabellen RetailLogFiscalTransaction brukes til å lagre registreringsinformasjonen for logghendelser for sporing av endringer.

  • Tabellen RetailFiscalRegistrationSequence brukes til å lagre siste sekvensielle tall for flere typer signerte objekter, for eksempel handelstransaksjoner og overvåke hendelser.

Hendelsesutløser for sporing av endringer

Den nye utløseren i AuditEvent blir lagt til aktivere tilpassing av overvåkingspolicy oppretting av hendelsesprosessen. Denne utløseren fungerer på samme måte som andre utløsere og er lastet inn av MEF. Den har to metoder for PreLogEvent og PostLogEvent, som kalles før og etter å ha logget en hendelse, henholdsvis.

Det nye grensesnittet IAuditEventTrigger ble lagt til biblioteket kontrakter . Dette grensesnittet beskriver den PreLogEventog PostLogEvent metoder.

Metoden PreLogEvent kan avbryte prosessen logging og vise meldinger via standard PreTriggerResult -objektet. Hvis du vil bruke AuditEvent -utløser, må en ny klasse som skal opprettes. Denne klassen må implementere grensesnittet IAuditEventTrigger . I dette tilfellet laster MEF klassen under oppstart av programmet.

FranceTriggers

FranceTriggers -prosjektet inneholder standard POS-utløsere som lastes inn hvis feltet ISO-koden for funksjonalitetsprofilen for POS er satt til no.

  • BatchOperationTrigger implementerer grensesnittet IBatchOperationTrigger og overstyrer SaveCloseBatch -metoden. Metoden logger en hendelse for lukking av et SKIFT.

  • FranceApplicationTrigger implementerer grensesnittet IApplicationTrigger og overstyrer metodene ApplicationStart og PostLogon .

    • ApplicationStart -metoden starter registrering status for RegistrationManager ved å kalle metoden ActualizeRegistrationState ;

    • PostLogon -metoden kontrollerer du SKIFT-tilstand ved å kalle metoden CheckShiftClosing for ShiftClosingChecker -klassen Hvis en pålogging-operasjonen var vellykket. Metoden viser en advarsel hvis gjeldende SKIFT som varer lenger enn angitt tid.

  • FranceAuditEventTrigger implementerer grensesnittet IAuditEventTrigger og overstyrer metodene PreLogEvent og PostLogEvent .

    • PreLogEvent -metoden mottar objektet IAuditEvent og utfører registrering av hendelsen Overvåk hvis overvåking er aktivert.

    • PostLogEvent -metoden mottar objektet IAuditEvent og fullfører registreringen av hendelsen Overvåk hvis overvåking er aktivert ved å lagre økonomiske registreringsinformasjon.

  • FranceOperationTrigger implementerer grensesnittet IOperationTrigger og overstyrer PreProcessOperation -metoden. Metoden kontrollerer SKIFT-tilstand ved å kalle metoden CheckShiftClosing i ShiftClosingChecker -klassen. Metoden blokkerer operasjonen om gjeldende SKIFT varer lenger enn forhåndsdefinert tidspunkt, og viser en advarsel.

  • FrancePaymentTrigger implementerer grensesnittet IPaymentTrigger og overstyrer metoden forskuddsbetaling . Metoden fungerer på samme måte som metoden PreProcessOperation og blokkerer betalingen om gjeldende SKIFT som varer lenger enn angitt tid.

  • FrancePrintingTrigger implementerer grensesnittet IPrintingTrigger og overstyrer GetReceiptFieldInfo -metoden. Metoden mottar IReceiptField og IReceiptPrintingContext -objekter og beregner verdien i feltet mottak som skrives ut.

  • FranceTransactionTrigger implementerer ITransactionTrigger , og overstyrer metodene PreEndTransaction og SaveTransaction .

    • PreEndTransaction -metoden mottar objektet IPosTransaction og utfører registrering av retail transaksjonen. I tillegg den kontrollerer tilstanden SKIFT og blokkerer transaksjonen om gjeldende SKIFT som varer lenger enn angitt tid.

    • SaveTransaction -metoden mottar objektet IPosTransaction og fullfører registreringen av retail-transaksjon ved å lagre økonomiske registreringsinformasjonen.

DigitalSignatureFiscalRegister

DigitalSignatureFiscalRegister -prosjektet gir funksjonalitet til å digitalt signere handelstransaksjoner og overvåke hendelser.

  • Klassen CertificateHelper inneholder metoder for å laste inn sertifikater fra sertifikatlageret.

  • DigitalSignatureFiscalRegister -klassen implementerer grensesnittet IFiscalRegisterDriver og overstyrer metodene initialisere og RegisterFiscalData .

    • Initialisere metoden laster inn innstillinger for digital signatur som sertifikatavtrykk og plassering fra konfigurasjonsfilen.

    • RegisterFiscalData -metoden mottar serialisert regnskapsinformasjon og beregner den digitale signaturen.

  • Klassen DigitalSignatureFiscalRegisterResponse representerer digital signatur Registrer svaret.

Registreringsprosessen

Det ligner registreringsprosesser for og overvåkingshendelser handelstransaksjoner. Det er kort klassene implementere grensesnittet IRegistrableEvent for hver objekttype som kan registreres i FranceTriggers -prosjektet:

  • RegistrableEventAuditEventAdapter -klassen til å støtte overvåking Hendelsesregistrering

  • RegistrableEventRetailTransactionAdapter til å støtte retail transaksjonen registrering

  • RegistrableEventShiftTransactionEventAdapter støtte for registrering av hendelsen for lukking av et SKIFT

Kortene som er ansvarlig for å trekke ut og serialisering av informasjon som brukes for registrering fra objektene kan registreres. En kort av den aktuelle typen opprettes i utløser metoder som PreEndTransaction, PreLogEvent og SaveCloseBatch av RegistrableEventFactory -klassen.

Registrering av en hvilken som helst kan registreres hendelsesobjekt utføres av klassen RegistrationManager ligger i FranceTriggers-prosjektet. RegistrationManager bruker DefaultFiscalRegistrationService -tjenesten som implementerer grensesnittet IFiscalRegister og er lastet inn av MEF.

DefaultFiscalRegistrationService oppretter og angir en forekomst av IFiscalRegisterDriver. Den bruker FiscalRegisterFactory -klassen til å opprette en passende forekomst av IFiscalRegisterDriver og lage en forekomst for DigitalSignatureFiscalRegister -klassen under landet Frankrike / område-konteksten.

Serialisert økonomiske registreringsdata lagres i JSON-formatet i databasetabellene for RetailTransactionFiscalTransaction og RetailLogFiscalTransaction for detaljhandelstransaksjoner og overvåkingshendelser, henholdsvis.

Retail-Server

Fire nye Retail-serveren, forespørsler ble lagt til støtte for Retail-lokalisering for Frankrike:

  • GetFiscalRegistrationSequenceTypeValue for å få økonomisk registrering sekvenstype for en angitt transaksjon eller overvåking av hendelsestypen.

  • GetLastRegisteredFiscalData forespørsel om å få siste registrert økonomiske data for en angitt transaksjonstype eller en hendelsestype for sporing av endringer.

  • RegisterAuditEvent forespørsel til å registrere overvåkingshendelser.

  • GetShiftClosingStateInfo forespørsel om å få status for SKIFT og tidspunktet for lukking av SKIFT-tasten.

Finner tilsvarende metoder i ShiftManager og StoreOperationsManager retail proxy kortene i Retail-SDK\Proxies\RetailProxy\Adapters.

Commerce kjøretid

Commerce kjøring lokalisering består av to nye prosjekter, en ny forespørsel og handlers:

  • SDK. DigitalSignature prosjektet er i SDK\Commerce for detaljhandel Run-time\SDK. DigitalSignature og er en del av løsningen Sdk.CommerceRuntime .

  • SDK. FiscalRegisterServiceFrance prosjektet er i SDK\Commerce for detaljhandel Run-time\SDK. DigitalSignature og er en del av løsningen Sdk.CommerceRuntime .

SDK.DigitalSignature

Prosjektet er lik den Enterprise POS DigitalSignatureFiscalRegister prosjektet. Den gir funksjonalitet til å digitalt signere handelstransaksjoner og overvåke hendelser.

  • Klassen CertificateHelper inneholder metoder for å laste inn sertifikater fra sertifikatlageret.

  • DataSignatureRequestHandler -klassen implementerer grensesnittet IRequestHandler og håndterer forespørselen DigitalSignatureServiceRequest .

DigitalSignatureServiceRequest brukes til å signere den angitte data med sertifikatet.

SDK.FiscalRegisterServiceFrance

SDK. FiscalRegisterServiceFrance prosjektet inneholder FiscalRegistrationService som håndterer en rekke nye forespørsler:

  • GetFiscalRegistrationSequenceTypeServiceRequest er en ny forespørsel om å bestemme hvilken økonomisk sekvens fra en salgstransaksjonstype eller overvåking av hendelsestypen.

  • GetLastRegisteredFiscalDataServiceRequest er en ny forespørsel om å hente den siste økonomiske data som er lagret for en bestemt regnskapsperiode sekvenstype.

  • GetFiscalRegistrationSequenceServiceRequest er en ny forespørsel om å hente gjeldende serienummer for en bestemt butikk, terminal og sekvens.

  • GetSalesOrderFiscalRegistrationInfoRequest er en ny forespørsel om å hente økonomiske data fra en salgsordre.

  • ParseFiscalRegisterDataRequest er en ny forespørsel om å analysere en serialisert registrere svar i JSON-formatet til et objekt.

  • SaveSalesTransactionDataRequest er en overstyrte forespørsel som utfører registrering av mva-transaksjonen, og kaller deretter opprinnelige forespørselshåndtereren for å lagre transaksjonen.

  • RegisterAuditEventServiceRequest er en ny forespørsel om å registrere overvåkingshendelser.

  • RegisterShiftCloseAuditEventRequest er en ny forespørsel om å registrere hendelser for lukking av SKIFT.

Moderne POS

Lokalisering av moderne POS omfatter endringer i flere visninger og Vis modeller i Retail SDK\ POS Clients\Framework.

Før operasjon behandlingsprogrammer

Det nye grensesnittet IPreOperationHandler ble innført. Den beskriver følgende metode:

executeHandler(operationId: Commerce.Operations.operationTypeEnum): IAsyncResult < ICancelableResult >;

Formålet med metoden er å implementere tilleggskontroller før du utfører moderne POS-operasjoner. Metoden executeHandler mottar av gjeldende operasjon, og kan blokkere operasjonen ved å returnere en passende ICancelableResult asynkront.

En forekomst av IPreOperationHandler -grensesnitt er registrert ved å kalle metoden registerPreOperationHandler for OperationsManager.

SKIFT-state-kontroll

SKIFT-state-kontroll blir styrt av ShiftClosingManagerFrance som implementerer grensesnittet IShiftClosingManager . ShiftClosingManagerFactory er ansvarlig for oppretting av den aktuelle forekomsten av IShiftClosingManager og oppretter ShiftClosingManagerFrance i landet/området Frankrike-forbindelse.

ShiftClosingManagerFrance også implementerer grensesnittet IPreOperationHandler og brukes til å blokkere flere operasjoner Hvis SKIFT som varer lengre enn den angitte tiden. Det er registrert som et behandlingsprogram for før operasjon for OperationsManager -klassen i landet/området Frankrike-forbindelse.

ShiftClosingManagerFrance forespørsler skifter tilstand før hver betaling og salgssystem ved hjelp av GetShiftClosingStateInfo for detaljhandel serverforespørsel.

Registreringsprosessen

Registrering av salgstransaksjoner og overvåkingshendelser er styrt av FiscalRegistrationManagerFrance -klassen implementerer grensesnittet IFiscalRegistrationManager . Klassen FiscalRegistrationManagerFactory er ansvarlig for oppretting av riktig implementering av IFiscalRegistrationManager og oppretter FiscalRegistrationManagerFrance under landet/området Frankrike kontekst.

Registrering av salgstransaksjoner starter i CartViewModel -klassen i checkOutCart -metoden. CartViewModel bruker FiscalRegistrationManagerFrance til å utføre registreringen logikk før og etter utsjekkingen.

Før utsjekking logikken trekker ut registreringsinformasjonen (Registrer svar) for sist registrerte mva-transaksjonen fra det lokale lageret (Hvis den finnes) eller ber om det fra Retail-Server ved hjelp av GetLastRegisteredFiscalData -forespørselen. Sist registrere svar sendes som egenskaper for webtjenesteutvidelse for handlekurv-objektet til utsjekkingen. Egenskapen extension lagring av det siste svaret som journalen deretter pakkes ut under behandling av SaveSalesTransactionDataRequest i Commerce kjøring, og brukes til å produsere den digitale signaturen for gjeldende transaksjon.

Bokfør utsjekking logikk lagrer gjeldende registrere svar på det lokale lageret skal brukes i fremtidige forespørsler.

Registrering av overvåkingshendelser er utført av registerAuditEvent -metoden for FiscalRegistrationManagerFrance -klassen og startes fra ulike punkter:

  • Registrering av overvåkingspolicy påloggingshendelse startes fra LoginViewModel etter en vellykket operator pålogginger.

  • Registrering av overvåkingspolicy avloggingshendelse startes fra LogoffOperationHandler.

  • Registrering av hendelsen fjerning overvåking startes fra BlindCloseShiftOperationHandler og CloseShiftOperationHandler -klasser.

  • Registrering av hendelser av Start- og sluttdato for frakoblet modus er startet fra klassen ChainedRequestFactory .

  • Registrering av hendelsen for utskrift av en kopi av en kvittering startes fra ReceiptViewModel.

Moderne POS registrerer Overvåkingshendelser ved å sende RegisterAuditEvent -forespørsel til Server for detaljhandel. Forespørselen sendes deretter til Commerce Run-time-tjenesten FiscalRegistrationService.

Informasjon om hurtigreparasjon

Hvordan du får tak i Microsoft Dynamics AX oppdaterer filer

Denne oppdateringen er tilgjengelig for manuell nedlasting og installasjon fra Microsoft Download Center.

Forutsetninger

Du må ha én av de følgende programmene installert for å bruke denne hurtigreparasjonen:

  • Microsoft Dynamics AX 2012 R3

Krav om omstart

Når du har installert hurtigreparasjonen, må du starte tjenesten Application Object Server (AOS).

Hvis du oppstår et problem å laste ned, installere denne hurtigreparasjonen, eller har andre tekniske støtte spørsmål, kontakter du-partneren, eller hvis det er registrert i en støtteplan direkte med Microsoft, kan du kontakte kundestøtte for Microsoft Dynamics og opprette en Ny kundestøtteforespørsel. Hvis du vil gjøre dette, kan du gå til følgende Microsoft-webområde:

https://mbs.microsoft.com/support/newstart.aspx

Du kan også kontakte kundestøtte for Microsoft Dynamics via telefon ved hjelp av disse koblingene for bestemte telefonnumre i landet. Hvis du vil gjøre dette, kan du gå til følgende Microsoft-webområder:

Partnere

https://mbs.microsoft.com/partnersource/resources/support/supportinformation/Global+Support+Contacts

Kunder

https://mbs.microsoft.com/customersource/northamerica/help/help/contactus

I spesielle tilfeller avgifter som vanligvis påløper for støtte samtaler kan avbrytes hvis en kundestøttemedarbeider for Microsoft Dynamics og beslektede produkter avgjør at en bestemt oppdatering løser problemet. Vanlige kundestøttekostnader gjelder for alle ytterligere kundestøttespørsmål og problemer som ikke dekkes av den gjeldende oppdateringen.

Obs! Dette er en "RASKT PUBLISERT"-artikkel opprettet direkte fra innenfor organisasjonen Microsoft Kundestøtte. Informasjonen som finnes her i leveres som-er som svar på nye problemer. Som et resultat av hastigheten i å gjøre den tilgjengelig, kan materialene inkludere typografiske feil, og den kan bli revidert når som helst uten varsel. Se Vilkårene for Brukfor andre hensyn.

Trenger du mer hjelp?

Utvid ferdighetene dine
Utforsk opplæring
Vær først ute med de nye funksjonene
Bli med i Microsoft Insiders

Var denne informasjonen nyttig?

Hvor fornøyd er du med kvaliteten på oversettelsen?
Hva påvirket opplevelsen din?

Takk for tilbakemeldingen!

×