Spore kjøringen av ER-formater for å feilsøke ytelsesproblemer

Som en del av prosessen med å utforme konfigurasjoner for elektronisk rapportering (ER) for å generere elektroniske dokumenter, definerer du metoden som brukes til å hente data ut av programmet, og angir den i utdataene som genereres. Funksjonen ytelsessporing i ER bidrar til å redusere tiden og kostnadene betydelig ved innsamling av detaljer om ER-formatutførelsen og bruke dem til å feilsøke ytelsesproblemer. Denne opplæringen inneholder retningslinjer om hvordan du kan utføre ytelsessporinger for utførte ER-formater, og hvordan du bruker informasjonen fra disse sporingene for å forbedre ytelsen.

Forutsetninger

Hvis du vil fullføre eksemplene i denne opplæringen, må du ha følgende tilgang:

• Tilgang til én av følgende roller:

  • Utvikler av elektronisk rapportering
  • Funksjonell konsulent for elektronisk rapportering
  • Systemansvarlig

• Tilgang til forekomsten av Regulatory Configuration Service (RCS) som er klargjort for samme leietaker som programmet, for én av følgende roller:

  • Utvikler av elektronisk rapportering
  • Funksjonell konsulent for elektronisk rapportering
  • Systemansvarlig

Du må også laste ned og lagre følgende filer lokalt.

Fil	Innhold
Ytelsessporingsmodell.versjon.1	Eksempel ER-datamodellkonfigurasjon
Ytelsessporingsmetadata.versjon.1	Eksempel ER-metadatakonfigurasjon
Ytelsessporingstilordning.versjon.1.1	Eksempel ER-modelltilordningskonfigurasjon
Ytelsessporingsformat.versjon.1.1	Eksempel ER-formatkonfigurasjon

Konfigurere ER-parametere

Hver ER-ytelsessporing som genereres i programmet, lagres som et vedlegg til utførelsesloggposten. Dokumentbehandlingsrammeverket (DM) brukes til å administrere disse vedleggene. Du må konfigurere ER-parameterne på forhånd for å angi DM-dokumenttypen som skal brukes til å knytte ytelsesspor. I arbeidsområdet Elektronisk rapportering velger du Parametere for elektronisk rapportering. På siden Parametere for elektronisk rapportering i kategorien Vedlegg på siden Andre velger du deretter DM-dokumenttypen som skal brukes for ytelsessporinger.

For å være tilgjengelig i Andre-oppslagsfeltet må en DM-dokumenttype konfigureres på følgende måte på siden Dokumenttyper (Organisasjonsstyring > Dokumentstyring > Dokumenttyper):

• Klasse: Tilknytt fil
• Gruppe: Fil

Notat

Den valgte dokumenttypen må være tilgjengelig i alle firmaer av gjeldende forekomst, fordi DM-vedlegg er firmaspesifikke.

Konfigurere RCS-parametere

ER-ytelsessporinger som genereres, importeres til RCS for analyse ved hjelp av ER-formatdesigneren og ER-tilordningsdesigneren. Fordi ER-ytelsesspor lagres som vedlegg i utførelsesloggposten som er relatert til ER-formatet, må du konfigurere RCS-parametere på forhånd, for å angi DM-dokumenttypen som skal brukes for å knytte til ytelsessporinger. For RCS-forekomsten som er klargjort for ditt firma, går du til Elektronisk rapportering og velger Parametere for elektronisk rapportering. På siden Parametere for elektronisk rapportering i kategorien Vedlegg på siden Andre velger du deretter DM-dokumenttypen som skal brukes for ytelsessporinger.

For å være tilgjengelig i Andre-oppslagsfeltet må en DM-dokumenttype konfigureres på følgende måte på siden Dokumenttyper (Organisasjonsstyring > Dokumentstyring > Dokumenttyper):

• Klasse: Tilknytt fil
• Gruppe: Fil

Utforme en ER-løsning

Anta at du har begynt å utforme en ny ER-løsning for å generere en ny rapport som presenterer leverandørtransaksjoner. For øyeblikket kan du finne transaksjonene for en valgt leverandør på siden Leverandørtransaksjoner (gå til Leverandører > Leverandører > Alle leverandør, velg en leverandør, og deretter, i handlingsruten i kategorien Leverandør i gruppen Transaksjoner, velger du Transaksjoner). Du vil imidlertid ha alle leverandørtransaksjoner samtidig i ett elektronisk dokument i XML-format. Denne løsningen vil bestå av flere ER-konfigurasjoner som inneholder den nødvendige datamodellen, metadataene, modelltilordningen og formatkomponentene.

1. Logg deg på forekomsten av RCS som er klargjort for firmaet ditt.

2. I denne opplæringen skal du opprette og endre konfigurasjoner for eksempelfirmaet Litware, Inc. Kontroller derfor at denne konfigurasjonsleverandøren er lagt til RCS og valgt som aktiv. Hvis du ha instruksjoner, se fremgangsmåten Opprette konfigurasjonsleverandører og merke dem som aktive.

3. I arbeidsområdet Elektronisk rapportering velger du flisen Rapporteringskonfigurasjoner.

4. På siden Konfigurasjoner importerer du ER-konfigurasjoner som du lastet ned som en forutsetning til RCS, i denne rekkefølgen: datamodell, metadata, modelltilordning, format. For hver konfigurasjon følger du disse trinnene:

   1. På siden Handling velger du Exchange > Last fra XML-fil.
   2. Velg Bla gjennom for å velge den riktige filen for den nødvendige ER-konfigurasjonen i XML-format.
   3. Velg OK.

   

Kjør ER-løsningen for å spore kjøring

Anta at du er ferdig med å utforme den første versjonen av ER-løsningen. Nå skal du teste forekomsten og analysere kjøringsytelsen.

Importere en ER-konfigurasjon fra RCS til økonomi og drift

1. Logg på programforekomsten.

2. I denne opplæringen skal du importere konfigurasjonene fra RCS-forekomsten (der du utformer ER-komponentene) i forekomsten (der du tester og til slutt bruker dem). Du må derfor kontrollere at alle de nødvendige artefaktene er forberedt. Hvis du vil ha instruksjoner, kan du se fremgangsmåten Importere ER-konfigurasjoner (Electronic Reporting) fra Regulatory Configuration Service (RCS).

3. Følg disse trinnene for å importere konfigurasjonene fra RCS til programmet:

   1. I arbeidsområdet Elektronisk rapportering, på flisen for konfigurasjonsleverandøren Litware, Inc., velger du Repositorier.
   2. På Konfigurasjonsrepositorium-siden velger du repositoriet for RCS-typen, og deretter velger du Åpne.
   3. I hurtigfanen Konfigurasjoner velger du Ytelsessporingsformat- konfigurasjonen.
   4. I Versjoner-hurtigkategorien velger du versjon 1.1 av den valgte konfigurasjonen, og deretter velger du Importer.

   

De tilsvarende versjonene av konfigurasjonene for datamodell og modelltilordning importeres automatisk som forutsetninger for den importerte ER-formatkonfigurasjonen.

Aktivere ER-ytelsessporing

1. Gå til Organisasjonsstyring > Elektronisk rapportering > Konfigurasjoner.

2. På Konfigurasjoner-siden, i handlingsruten i kategorien Konfigurasjoner i gruppen Avanserte innstillinger, velger du Brukerparametere.

3. Følg disse trinnene i dialogboksen Brukerparametere i delen Kjøringssporing:

   1. I feltet Sporingsformat for kjøring angir du formatet på den genererte ytelsessporingen som kjøringsdetaljene er lagret i for ER-format og tilordningselementer:

      • Feilsøk sporingsformat – Velg denne verdien hvis du planlegger å kjøre et ER-format interaktivt med kort kjøretid. Samlingen med detaljer om utførelsen av ER-format startes deretter. Når denne verdien er valgt, vil ytelsessporingen samle inn informasjon om tiden som brukes på følgende handlinger:

        • Kjøre hver datakilde i modelltilordningen som kalles for å hente data
        • Behandler hver formatvare for å angi data i utdataene som genereres

        Hvis du velger verdien Feilsøk sporingsformat, kan du analysere innholdet i sporingen i ER-operasjonsutforming. Der kan du vise ER-formatet eller tilordningselementene som er nevnt i sporingen.

      • Aggregert sporingsformat – Velg denne verdien hvis du planlegger å kjøre et ER-format med lang kjøretid i satsvis modus. Samlingen med aggregerte detaljer om utførelsen av ER-format startes deretter. Når denne verdien er valgt, vil ytelsessporingen samle inn informasjon om tiden som brukes på følgende handlinger:

        • Kjøre hver datakilde i modelltilordningen som kalles for å hente data
        • Kjøre hver datakilde i formattilordningen som kalles for å hente data
        • Behandler hver formatvare for å angi data i utdataene som genereres

        Verdien Aggregert sporingsformat er tilgjengelig i Microsoft Dynamics 365 Finance-versjon 10.0.20 og senere.

        I ER-formatdesigneren og ER-modelltilordningsdesigneren kan du vise den totale utførelsestiden for en enkelt komponent. I tillegg inneholder sporingen detaljer om utførelsen, for eksempel antall utførelser og minimums- og maksimumstiden for én enkelt utførelse.

        Notat

        Denne sporingen samles inn basert på banen til de sporede komponentene. Derfor kan statistikken være feil når en enkelt overordnet komponent inneholder flere ikke-navngitte underordnede komponenter, eller når flere underordnede komponenter har samme navn.

   2. Angi følgende alternativer til Ja for å samle inn bestemte detaljer for utførelsen av ER-modelltilordningen og ER-formatkomponentene:

      • Samle inn spørringsstatistikk – Når dette alternativet er aktivert, vil ytelsessporingen samle inn følgende informasjon:

        • Antall databasekall som er utført av datakilder
        • Antall dupliserte kall til databasen
        • Detaljer for SQL-setningene som ble brukt til å opprette databasekall

      • SSpor tilgang for hurtigbufring – Når dette alternativet er aktivert, samler ytelsessporingsinformasjon inn informasjon om ER-modelltilordningens hurtigbufferbruk.

      • Spor datatilgang – Når dette alternativet er aktivert, samler ytelsessporingeninformasjon inn informajson om antall kall til databasen for utførte datakilder av typen postliste.

      • Sporingslisteopplisting – Når dette alternativet er aktivert, samler ytelsessporingeninformasjon inn informajson om antall poster som forespørres fra datakilder av typen postliste.

   Notat

   Parameterne i dialogboksen Brukerparametere er spesifikke for brukeren og det gjeldende firmaet.

   

Kjør ER-formatet

1. Velg DEMF-firmaet.
2. Gå til Organisasjonsstyring > Elektronisk rapportering > Konfigurasjoner.
3. På siden Konfigurasjoner i konfigurasjonstreet, velger du elementet Ytelsessporingsformat.
4. Velg Kjør i handlingsruten.

Legg merke til at filen som genereres, presenterer informasjon om 265 transaksjoner for seks leverandører.

Se gjennom utførelsessporing

Eksportere den genererte sporingen fra programmet

Ytelsessporinger kobles fra kilde-ER-formatet og kan serialiseres til en ekstern zip-fil.

1. Gå til Organisasjonsstyring > Elektronisk rapportering > Feilsøkingslogger for konfigurasjon.

2. På siden Kjøringslogger for elektronisk rapportering, i venstre rute i feltet Konfigurasjonsnavn, velger du Ytelsessporingsformat for å finne loggpostene som er generert ved å utføre Ytelsessporingsformat.

3. Velg Vedlegg-knappen (bindersikonet) i øvre høyre hjørne på siden, eller trykk på Ctrl+Skift+A.

   

4. På siden Vedlegg for Kjøringslogger for elektronisk rapportering velger du Åpne for å hente ytelsessporing som en zip-fil og lagre den lokalt.

   

Notat

Sporingen som genereres, har en referanse til kilde-ER-rapporten via en unik rapport-ID bare i GUID-format. Versjonsnummereringen for formatet vurderes ikke.

Legg merke til at tilknytningen mellom ytelsessporingen som er generert for det utførte ER-formatet og ER-modelltilordningen, er basert på rotbeskrivelsen som ble brukt og den felles datamodellen. Versjonsnummereringen for formatet og modelltilordningen vurderes ikke. Innstillingen til Standard for modelltilordning-flagget for modelltilordningen blir heller ikke vurdert.

Importere den genererte sporingen til RCS

1. I RCS, i arbeidsområdet Elektronisk rapportering, velger du flisen Rapporteringskonfigurasjoner.

2. På siden Konfigurasjoner, i konfigurasjonstreet, utvider du elementet Ytelsessporingsmodell, og velg elementet Ytelsessporingsformat.

3. Velg Utforming i handlingsruten.

4. På siden Formatutforming, i handlingsruten, velger du Ytelsessporing.

5. I dialogboksen Resultatinnstillinger for ytelsessporing velg Importer ytelsessporing.

6. Velg Bla gjennom for å velge ZIP-filen du eksporterte tidligere.

7. Velg OK.

   

Bruke ytelsessporing for analyse i RCS – Formatutførelse

1. Velg Vis/Skjul på Formatutforming-siden i RCS for å utvide innholdet for alle formatvarer.

   Legg merke til at tilleggsinformasjon vises for noen varer i gjeldende format:

   • Den faktiske tiden som ble brukt på å legge inn data i de genererte utdataene ved hjelp av formatvaren
   • Den samme tiden som prosent av den totale tiden som ble brukt til å generere hele utdataene

   

2. Lukk siden Formatutforming.

Bruke ytelsessporing for analyse i RCS – modelltilordning

1. I RCS, på siden Konfigurasjoner i konfigurasjonstreet, velger du elementet Ytelsessporingstilordning.
2. Velg Utforming i handlingsruten.
3. Velg Utforming.
4. På siden Modelltilordningsutforming, i handlingsruten, velger du Ytelsessporing.
5. Velg sporingen du importerte tidligere.
6. Velg OK.

Legg merke til at ny informasjon blir tilgjengelig for noen datakildeelementer av gjeldende modelltilordning:

• Den faktiske tiden som ble brukt til å hente data ved hjelp av datakilden
• Den samme tiden som prosent av den totale tiden som ble brukt til å kjøre hele modelltilordningen

Legg merke til at ER informerer deg om at gjeldende modelltilordning dupliserer databaseforespørsler når VendTable/<Relasjoner/VendTrans.VendTableAccountNum-datakilden kjøres. Denne dupliseringen forekommer fordi listen over leverandørtransaksjoner kalles to ganger for hver leverandørpost som gjentas:

• Det blir laget ett kall for å angi detaljer for hver transaksjon i datamodellen, basert på konfigurerte bindinger.
• Det blir laget ett kall for å angi det beregnede antallet transaksjoner per leverandør i datamodellen.

Verdien [Q:530] angir at VendTrans-tabellen ble kalt 530 ganger for å returnere en post fra denne tabellen til VendTable/<Relasjoner/VendTrans.VendTable‑AccountNum-datakilden. Verdien [530] angir at datakilden VendTable/<Relasjoner/VendTrans.VendTable‑AccountNum ble kalt 530 ganger for å returnere en post fra den datakilden og angi detaljer fra den i datamodellen.

Vi anbefaler at du bruker hurtigbufring for datakilden VendTable/<Relasjoner/VendTrans.VendTableAccountNum for å redusere antallet kall som gjøres for å hente detaljene for 265 transaksjoner og bidra til å forbedre ytelsen til modelltilordningen.

Det kan også være nyttig å redusere antall kall som gjøres til datakilden for LedgerTransTypeList-datakilden. Denne datakilden brukes til å knytte hver verdi for LedgerTransType-opplistingen til etiketten. Ved hjelp av denne datakilden kan du finne en passende etikett og angi den i datamodellen for hver leverandørtransaksjon. Gjeldende antall kall til denne datakilden (9027) er ganske høy for 265 transaksjoner.

Forbedre modelltilordningen basert på informasjon fra kjøringssporingen

Endre logikken til modelltilordningen

1. Følg denne fremgangsmåten for å bruke bufring til å forhindre dupliserte kall til databasen:

   1. I RCS-ruten, på siden Modelltilordningsutforming i ruten Datakilder, velger du VendTable-elementet.
   2. Velg Hurtigbuffer.
   3. Utvid elementet VendTable, utvid listen med en-til-mange-relasjoner for datakilden VendTable (<Relasjoner-elementet), og velg elementet VendTrans.VendTableAccountNum.
   4. Velg Hurtigbuffer.

   

2. Følg disse trinnene for å hente LedgerTransTypeList-datakilden til området for VendTable-datakilden:

   1. I ruten Datakildetyper utvider du Funksjoner-elementet og velger Beregnet felt-elementet.
   2. I Datakilder-ruten velger du VendTable-elementet.
   3. Velg Legg til.
   4. I feltet Navn angir du $TransType.
   5. Velg Rediger formel.
   6. I feltet Formel angir du LedgerTransTypeList.
   7. Velg Lagre.
   8. Lukk siden Formelredigering.
   9. Klikk på OK.

3. Følg disse trinnene for å utføre bufring av feltet $TransType:

   1. Velg elementet LedgerTransTypeList.
   2. Velg Hurtigbuffer.
   3. Velg VendTable.$TransType-elementet.
   4. Velg Hurtigbuffer.

   

4. Følg disse trinnene for å endre feltet $TransTypeRecord, slik at det begynner å bruke det hurtigbufrede feltet $TransType:

   1. I Datakilder-ruten utvider du VendTable-elementet, utvider <Relasjoner-elementet, utvider elementet VendTrans.VendTable_AccountNum og velger VendTable. VendTrans.VendTable_AccountNum.$TransTypeRecord-elementet.

   2. Velg Rediger.

   3. Velg Rediger formel.

   4. I Formel-feltet finner du følgende uttrykk:

      FIRSTORNULL (WHERE (LedgerTransTypeList, LedgerTransTypeList.Enum = @.TransType))

   5. I Formel-feltet angir du følgende uttrykk:

      FIRSTORNULL (WHERE (VendTable.'$TransType', VendTable.'$TransType'.Enum = @.TransType)).

   6. Velg Lagre.

   7. Lukk siden Formelredigering.

   8. Velg OK.

5. Velg Lagre.

6. Lukk siden Modelltilordningsutforming.

7. Lukk siden Modelltilordninger.

Fullføre den endrede versjonen av ER-modelltilordningen

1. I RCS, på siden Konfigurasjoner i hurtigfanen Versjoner, velger du versjon 1.2 av konfigurasjonen Ytelsessporingstilordning.
2. Velg Endre status.
3. Velg Fullfør.

Importere den endrede ER-modelltilordningskonfigurasjonen fra RCS til programmet

Gjenta trinnene i delen Importere en ER-konfigurasjon fra RCS til Finance and Operations tidligere i denne artikkelen for å importere versjon 1.2 av konfigurasjonen Ytelsessporingstilordning.

Kjøre den endrede ER-løsningen for å spore kjøring

Kjøre ER-formatet

Gjenta trinnene i delen Kjør ER-formatet tidligere i denne artikkelen for å generere en ny ytelsessporing.

Arbeide med utføringsporingen

Eksportere den genererte sporingen fra programmet

Gjenta trinnene i delen Eksportere den genererte sporingen fra programmet tidligere i denne artikkelen for å lagre en ny ytelsessporing lokalt.

Importere den genererte sporingen til RCS

Gjenta trinnene i delen Importere den genererte sporingen til RCS tidligere i denne artikkelen for å importere den nye ytelsessporingen til RCS.

Bruke ytelsessporing for analyse i RCS – modelltilordning

Gjenta trinnene i delen Bruke ytelsessporing for analyse i RCS – modelltilordning tidligere i denne artikkelen for å analysere den siste ytelsessporingen.

Legg merke til at justeringene du har gjort i modelltilordningen, har eliminert duplikate spørringer til databasen. Antall kall til databasetabeller og datakilder for denne modelltilordningen er også redusert. Derfor har ytelsen til hele ER-løsningen blitt forbedret.

I sporingsinformasjonen angir verdien [12] for VendTable-datakilden at denne datakilden ble kalt 12 ganger. Verdien [Q:6] angir at seks samtaler ble oversatt til databasekall til tabellen VendTable. Verdien [C:6] angir at postene som ble hentet fra databasen, ble bufret, og at seks andre kall ble behandlet ved hjelp av hurtigbufferen.

Legg merke til at antall kall til LedgerTransTypeList-datakilden er redusert fra 9027 til 240.

Se gjennom utførelsessporingen i programmet

I tillegg til RCS kan enkelte versjoner tilby funksjoner for en ER-rammeverkutformingsopplevelse. Disse versjonene har alternativet Aktiver utformingsmodus som kan aktiveres. Du finner dette alternativet i kategorien Generelt på siden Parametere for elektronisk rapportering, som du kan åpne fra arbeidsområdet Elektronisk rapportering.

Hvis du bruker en av disse versjonene, kan du analysere detaljene for genererte ytelsessporinger direkte i programmet. Du trenger ikke å eksportere dem fra programmet og importere dem til RCS.

Se gjennom utførelsessporingen ved hjelp av eksterne verktøy

Konfigurere brukerparametere

1. Gå til Organisasjonsstyring > Elektronisk rapportering > Konfigurasjoner.
2. På Konfigurasjoner-siden, i handlingsruten i kategorien Konfigurasjoner i gruppen Avanserte innstillinger, velger du Brukerparametere.
3. I dialogboksen Brukerparametere i delen Kjøringssporing i feltet Sporingsformat for kjøring velger du PerfView XML.

Kjøre ER-formatet

Gjenta trinnene i delen Kjør ER-formatet tidligere i denne artikkelen for å generere en ny ytelsessporing.

Legg merke til at nettleseren tilbyr en zip-fil for nedlasting. Denne filen inneholder ytelsessporingen i PerfView-format. Du kan deretter bruke verktøyet for PerfView-ytelsesanalyse til å analysere detaljene i ER-formatkjøringen.

Bruke eksterne verktøy til å se gjennom en utførelsessporing som inneholder databasespørringer

På grunn av forbedringer i ER-rammeverket gir ytelsessporingen som genereres i PerfView-formatet, nå flere detaljer om ER-formatutførelsen. I Microsoft Dynamics 365 Finance versjon 10.0.4 (juli 2019) kan denne sporingen også inneholde detaljer om utførte SQL-spørringer til programdatabasen.

Konfigurere brukerparametere

1. Gå til Organisasjonsstyring>Elektronisk rapportering>Konfigurasjoner.

2. På Konfigurasjoner-siden, i handlingsruten i kategorien Konfigurasjoner i gruppen Avanserte innstillinger, velger du Brukerparametere.

3. I delen Kjøringssporing i dialogboksen Brukerparametere angir du følgende parametere:

   • I feltet Sporingsformat for kjøring velger du PerfView XML.
   • Sett alternativet Samle inn spørringsstatistikk til Ja.
   • Sett alternativet Spor spørring til Ja.

   

Kjøre ER-formatet

Gjenta trinnene i delen Kjør ER-formatet tidligere i denne artikkelen for å generere en ny ytelsessporing.

Legg merke til at nettleseren tilbyr en zip-fil for nedlasting. Denne filen inneholder ytelsessporingen i PerfView-format. Du kan deretter bruke verktøyet for PerfView-ytelsesanalyse til å analysere detaljene i ER-formatkjøringen. Denne sporingen inneholder nå detaljene for tilgang til SQL-database under utførelsen av ER-formatet.

Tilleggsressurser

• Oversikt over elektronisk rapportering
• Forbedre ytelse for ER-løsninger ved å legge til datakilder med parameterisert BEREGNET FELT