Del via

Bruge JOIN-datakilder til at hente data fra flere programtabeller i ER-modeltilknytninger (elektronisk rapportering)

  • Artikel

Under konfiguration af ER-modeltilknytninger eller -formater kan du tilføje nødvendige datakilder af Join-typen. På designtidspunktet konfigureres en Join-datakilde som et sæt af flere datakilder, der hver især returnerer en liste over poster. For hver datakilde med undtagelse af den første skal du definere de nødvendige betingelser for at sammenføje poster af aktuelle og tidligere datakilder. På kørselstidspunktet vil en konfigureret datakilde af typen Joinreturnere en enkelt join-forbundet liste over poster, der indeholder felter fra posterne i indlejrede datakilder.

Følgende typer af joinforbindelser understøttes i øjeblikket:

  • Ydre (venstre) join:
    • Forbind alle poster fra den første (længst til venstre) datakilde og derefter eventuelle matcher i overensstemmelse med konfigurerede betingelsesposter for den anden (længst til højre) datakilde.
  • Indre (højre) join:
    • Forbind kun poster fra den første (længst til venstre) datakilde og kun poster for den anden (længst til højre) datakilde, der matcher hinanden i overensstemmelse med konfigurerede betingelser.

Når alle datakilder er af typen Tabelposter i den konfigurerede Join-datakilde, kan kørslen af Join-datakilden udføres på databaseniveau ved hjælp af en enkelt SQL-sætning. Denne sætning reducerer antallet af databasekald, hvilket forbedrer modeltilknytningens ydeevne. Ellers foretages der en kørsel af Join-datakilden i hukommelsen.

Bemærk!

Brug af funktionen VALUEIN i ER-udtryk, der angiver betingelser for sammenkædning af poster i datakilder af typen Join, er ikke understøttet endnu. Besøg siden Formeldesigner i elektronisk rapportering for at få flere oplysninger om denne funktion.

Hvis du vil vide mere om denne funktion, skal du fuldføre eksemplet i denne artikel.

Eksempel: Bruge JOIN-datakilder i ER-modeltilknytninger

I følgende fremgangsmåde forklares det, hvordan systemadministratoren eller den elektroniske rapporteringsudvikler kan konfigurere en ER-modeltilknytning af elektronisk rapportering til at hente data fra flere programtabeller på én gang ved at bruge datakilder af typen Join til at forbedre ydeevnen af dataadgang. Disse trin kan udføres for ethvert firma i Dynamics 365 Finance eller Regulatory Configuration Services (RCS).

Forudsætninger

Hvis du vil udføre eksemplerne i denne artikel, skal du have adgang til en af følgende, afhængigt af hvilken tjeneste der bruges til at udføre disse trin:

Adgang til Finance for en af følgende roller:

  • Udvikler til elektronisk rapportering
  • Funktionel konsulent i elektronisk rapportering
  • Systemadministrator

Adgang til RCS for en af følgende roller:

  • Udvikler til elektronisk rapportering
  • Funktionel konsulent i elektronisk rapportering
  • Systemadministrator

Du skal også først fuldføre trinnene i proceduren: Opret en konfigurationsudbyder, og markér den som aktiv.

På forhånd skal du også hente og gemme følgende eksempel på ER-konfigurationsfiler:

Indholdsbeskrivelse Filnavn
Eksempelkonfigurationsfil til ER-datamodel, der bruges som datakilde til eksemplerne. Model til at lære JOIN-datakilder.version.1.1.xml
Eksempelkonfigurationsfil til ER-modeltilknytning, der implementerer ER-datamodellen for eksemplerne. Tilknytning til at lære JOIN-datakilder.version.1.1.xml
Eksempelkonfigurationsfil til ER-format. I denne fil beskrives de data, der skal udfylde ER-formatkomponenten til eksemplerne. Format til at lære JOIN-datakilder.version.1.1.xml

Aktivere en konfigurationsudbyder

  1. Få adgang til enten Finance eller RCS i den første session i din webbrowser.

  2. Gå til Virksomhedsadministration > Arbejdsområder > Elektronisk rapportering.

  3. På siden Lokaliseringskonfigurationer i sektionen Konfigurationsudbydere skal du kontrollere, at konfigurationsudbyderen for eksempelfirmaet Litware, Inc. er vist, og at det er markeret som Aktivt. Hvis du ikke ser denne konfigurationsudbyder, skal du følge trinnene i proceduren Opret en konfigurationsudbyder, og markér den som aktiv.

    Arbejdsområde til elektronisk rapportering.

Importere ER-eksempelkonfigurationsfiler

  1. Vælg Rapporteringskonfigurationer.

  2. Importér konfigurationsfilen for ER-datamodellen.

    1. Vælg Udveksling.
    2. Vælg Indlæs fra XML-fil.
    3. Vælg Gennemse for at finde filen Model til at lære JOIN-datakilder.version.1.1.xml.
    4. Vælg OK.

  3. Importér konfigurationsfilen for ER-modeltilknytningen.

    1. Vælg Udveksling.
    2. Vælg Indlæs fra XML-fil.
    3. Vælg Gennemse for at finde filen Tilknytning til at lære JOIN-datakilder.version.1.1.xml.
    4. Vælg OK.

  4. Importér ER-formatkonfigurationsfilen.

    1. Vælg Udveksling.
    2. Vælg Indlæs fra XML-fil.
    3. Vælg Gennemse for at finde filen Format til at lære JOIN-datakilder.version.1.1.xml.
    4. Vælg OK.

  5. I konfigurationstræet skal du udvide elementet Model til at lære JOIN-datakilder og andre modelelementer (når de er tilgængelige).

  6. Se listen over ER-konfigurationer i træet samt versionsoplysninger i oversigtspanelet Versioner – de bruges som datakilden til eksempelrapporten.

    Siden med konfigurationer for elektronisk rapportering.

Aktivere indstillinger for udførelsessporing

  1. Vælg KONFIGURATIONER.

  2. Vælg Brugerparametre.

  3. Angiv parametre for udførelsessporing som vist på skærmbilledet nedenfor.

    Siden med brugerparametre til elektronisk rapportering.

    Når disse parametre er aktiveret, vil udførelsessporing blive genereret for hver kørsel af den importerede ER-formatfil. Hvis du bruger detaljer om genereret udførelsessporing, kan du analysere udførelsen af ER-format og ER-modeltilknytningskomponenter. Besøg siden Spore kørsel af ER-format for at foretage fejlfinding af problemer med ydeevnen for at få flere oplysninger om funktionen til ER-udførelsessporing.

Gennemgå ER-modeltilknytning (del 1)

Gennemgå indstillingerne for komponenten til ER-modeltilknytning. Komponenten er konfigureret til at få adgang til oplysninger om versioner af ER-konfigurationer, detaljer om konfigurationer og konfigurationsudbydere uden brug af datakilder af typen Join.

  1. Vælg konfigurationen Tilknytning til at lære JOIN-datakilder.

  2. Vælg Designer for at åbne listen over tilknytninger.

  3. Vælg Designer for at gennemgå tilknytningsdetaljerne.

  4. Vælg Vis detaljer.

  5. Udvid datamodelelementerne Set1 og Set1.Details i konfigurationstræet:

    1. Bindingen Details: Record list = Versions angiver, at Set1.Details er bundet til Versions-datakilden, der returnerer poster i tabellen ERSolutionVersionTable. Hver post i denne tabel repræsenterer en enkelt version af en ER-konfiguration. Indholdet af denne tabel vises på oversigtspanelet Versioner på siden Konfigurationer.
    2. Bindingen ConfigurationVersion: String = @.PublicVersionNumber betyder, at værdien af den offentlige version af hver ER-konfigurationsversion hentes fra feltet PublicVersionNumber i tabellen ERSolutionVersionTable og placeres i elementet ConfigurationVersion.
    3. Bindingen ConfigurationTitle: String = @.'>Relations'.Solution.Name angiver, at navnet på en ER-konfiguration hentes fra feltet Name i tabellen ERSolutionTable via mange til én-relationen ('>Relations') mellem tabellerne ERSolutionVersionTable og ERSolutionTable. Navne på ER-konfigurationer af den aktuelle programforekomst vises i konfigurationstræet på siden Konfigurationer.
    4. Bindingen @.'>Relations'.Solution.'>Relations'.SolutionVendor.Name angiver, at navnet på konfigurationsudbyderen, der ejer den aktuelle konfiguration, hentes fra feltet Name i tabellen ERVendorTable via mange til én-relationen mellem tabellerne ERSolutionTable og ERVendorTable. Navne på ER-konfigurationsudbydere vises i konfigurationstræet på siden Konfigurationer i sidehovedet for hver konfiguration. Hele listen over ER-konfigurationsudbydere findes på tabel siden Organisationsadministration > Elektronisk rapportering > Konfigurationsudbyder.

    Side for ER-modeltilknytningdesigner, liste over bundne datamodelelementer.

  6. Udvid datamodelelementet Set1.Summary i konfigurationstræet:

    1. Bindingen VersionsNumber: Integer = VersionsSummary.aggregated.VersionsNumber angiver, at elementet Set1.Summary.VersionsNumber er bundet til aggregeringsfeltet VersionsNumber i datakilden VersionsSummary af typen GroupBy, der blev konfigureret til at returnere antallet af poster i tabellen ERSolutionVersionTable via datakilden Versions.

    Side for redigering af parametre for

  7. Luk siden.

Gennemgå ER-modeltilknytning (del 2)

Gennemgå indstillingerne for komponenten til ER-modeltilknytning. Komponenten er konfigureret til at få adgang til oplysninger om versioner af ER-konfigurationer, detaljer om konfigurationer og konfigurationsudbydere med brug af en datakilde af typen Join.

  1. Udvid datamodelelementerne Set2 og Set2.Details i konfigurationstræet: Bindingen Details: Record list = Detaljer angiver, at elementet Set2.Details er bundet til datakilden Detaljer, der er konfigureret som datakilden af typen Join.

    Side for ER-modeltilknytningsdesigner, der viser udvidede elementer i datamodellen Er2:Record.

    Join-datakilden kan tilføjes ved at vælge datakilden Functions\Join:

    Side for ER-modeltilknytningdesigner, Join-datakildetype.

  2. Vælg datakilden Details.

  3. Vælg Rediger i ruden Datakilder.

  4. Vælg Rediger join.

  5. Vælg Vis detaljer.

    Side med JOIN-parametre for datakilde.

    Denne side bruges til at designe den påkrævede datakilde for Join-typen. På kørselstidspunktet opretter denne datakilde en enkelt join-forbundet liste med poster fra datakilderne i gitteret Forenet liste. Sammenkædningen af poster vil starte fra den ConfigurationProviders-datakilde, der findes i gitteret som første (kolonnen Type er tom for den). Alle poster for alle andre datakilder vil derfor blive forenet med poster for den overordnede datakilde baseret på rækkefølgen i dette gitter. Alle join-datakilder skal være konfigureret som en datakilde, der er indlejret under en destinationsdatakilde (datakilden 1Versions er indlejret under 1Configurations én, datakilden 1Configurations er indlejret under ConfigurationProviders 1). Hver enkelt konfigureret datakilde skal indeholde betingelserne for join-forbindelsen. I datakilden for denne bestemte Join defineres følgende join-forbindelser:

    • Hver post i datakilden ConfigurationProviders (der henvises til tabellen ERVendorTable) er kun knyttet til poster af én 1Configurations (henvises til i tabellen ERSolutionTable), der har samme værdi i felterne SolutionVendor og RecId. Den Indre join-type bruges til denne join-forbindelse samt følgende betingelser for matchende poster:

    FILTER (Configurations, Configurations.SolutionVendor = ConfigurationProviders.RecId)

    • Hver post i datakilden 1Configurations (der henvises til tabellen ERSolutionTable) er kun knyttet til poster af én 1Versions (der henvises til tabellen ERSolutionVersionTable), der har samme værdi i felterne Solution og RecId. Den Indre join-type bruges til denne join-forbindelse samt følgende betingelser for matchende poster:

    FILTER (ConfigurationVersions, ConfigurationVersions.Solution = ConfigurationProviders.'1Configurations'.RecId)

    • IndstillingenUdfør er konfigureret som Forespørgsel, hvilket vil sige, at denne join-datakilde udføres ved kørsel på databaseniveau som et direkte SQL-kald.

    Ved sammenkædning af poster i datakilder, der repræsenterer programtabeller, kan du angive join-betingelser ved hjælp af et par andre felter end dem, der beskriver eksisterende AOT-relationer mellem disse tabeller. Denne type join kan også konfigureres til at køre på databaseniveau.

  6. Luk siden.

  7. Vælg Annuller.

  8. Udvid datamodelelementet Set2.Summary i konfigurationstræet:

    • Bindingen VersionsNumber: Integer = DetailsSummary.aggregated.VersionsNumber angiver, at elementet Set2.Summary.VersionsNumber er bundet til aggregeringsfeltet VersionsNumber i datakilden DetailsSummary af typen GroupBy, der blev konfigureret til at returnere antallet af join-poster i datakilden Details af typen Join.
    • Lokationsindstillingen Udførelse er konfigureret som Forespørgsel, hvilket vil sige, at denne GroupBy-datakilde køres på kørselstidspunktet som et direkte SQL-kald på databaseniveau. Denne funktionsmåde er mulig, fordi basisdatakilden Detaljer af typen Join er konfigureret som udført på databaseniveau.

    Siden med GROUPBY-parametre for datakilde.

  9. Luk siden.

  10. Vælg Annuller.

Udføre ER-format

  1. Få adgang til Finance eller RCS i den anden session af din webbrowser med samme legitimationsoplysninger og firma som i den første session.

  2. Gå til Virksomhedsadministration > Elektronisk rapportering > Konfigurationer.

  3. Udvid konfigurationen Model til at lære JOIN-datakilder.

  4. Vælg konfigurationen Format til at lære JOIN-datakilder.

  5. Vælg Designer.

  6. Vælg Vis detaljer.

  7. Vælg Tilknytning.

  8. Vælg Udvid/skjul.

    Dette format er beregnet til at udfylde en genereret tekstfil med en ny linje for hver version af en ER-konfiguration (Version-sekvens). Hver genereret linje indeholder navnet på en konfigurationsudbyder, der ejer den aktuelle konfiguration, konfigurationsnavnet og konfigurationsversionen adskilt af semikolon. Den sidste linje i den genererede fil vil indeholde antallet af registrerede versioner af ER-konfigurationer (Resume-sekvens).

    Side for ER-formatdesigner, fanen Format.

    Datakilderne Data og Resume bruges til at udfylde oplysninger om konfigurationsversionen til den genererede fil:

    • Oplysninger fra datamodellen Set1 bruges, når du vælger Nej for datakilden Vælger under kørsel på siden med brugerdialogboks, når der køres ER-format.
    • Oplysninger fra datamodellen Set2 bruges, når du vælger Ja for datakilden Vælger under kørsel på siden med brugerdialogboks.

    Side for ER-formatdesigner, fanen Tilknytning.

  9. Vælg Kør.

  10. Vælg Nej i feltet Brug JOIN-datakilde på dialogbokssiden.

  11. Vælg OK.

  12. Gennemgå den genererede fil.

    Genereret fil med elektroniske rapportparametre, der ikke bruger JOIN-datakilde.

Analysere udførelsessporing i ER-format

  1. Vælg Designer i den første Finance- eller RCS-session.

  2. Vælg Performancesporing.

  3. I gitteret Performancesporing skal du vælge den øverste post med den seneste udførelsessporing af et ER-format, der brugte den aktuelle modeltilknytningskomponent.

  4. Vælg OK.

    Udførelsesstatistik oplyser om dublerede kald til programtabeller:

    • ERSolutionTable er blevet kaldt så mange gange, som du har konfigurationsversionsposter i tabellen ERSolutionVersionTable, mens antallet af sådanne opkald kan reduceres i tider for at forbedre ydeevnen.
    • ERVendorTable er blevet kaldt to gange for hver konfigurationsversionspost, der er registreret i tabellen ERSolutionVersionTable, men antallet af sådanne opkald kan også reduceres.

    Udførelsesstatistik på side for ER-modeltilknytningdesigner.

  5. Luk siden.

Udføre ER-format

  1. Skift til fanen i webbrowseren med den anden session af Finance eller RCS.

  2. Vælg Kør.

  3. Vælg Ja i feltet Brug JOIN-datakilde på dialogbokssiden.

  4. Vælg OK.

  5. Gennemgå den genererede fil.

    Genereret fil med elektroniske rapportparametre, der bruger JOIN-datakilde.

Analysere udførelsessporing i ER-format

  1. Vælg Designer i den første Finance- eller RCS-session.

  2. Vælg Performancesporing.

  3. I gitteret Performancesporing skal du vælge den øverste post, der repræsenterer den seneste udførelsessporing af et ER-format, der brugte den aktuelle modeltilknytningskomponent.

  4. Vælg OK.

    Statistik oplyser om følgende:

    • Programdatabasen er kaldt én gang for at hente poster fra tabellerne ERVendorTable, ERSolutionTable og ERSolutionVersionTable for at få adgang til obligatoriske felter.

    Ydeevnestatistikdetaljer på side for ER-modeltilknytningdesigner.

    • Programdatabasen er blevet kaldt én gang for at beregne antallet af konfigurationsversioner ved hjælp af join-forbindelser, der er konfigureret i datakilden Detaljer.

    Side for ER-modeltilknytningsdesigner, der viser programdatabasekald.

Begrænsninger

Som du kan se fra eksemplet i denne artikel, kan JOIN-datakilden opbygges fra flere datakilder, der beskriver de enkelte datasæt for de poster, der skal sammenkædes. Du kan konfigurere disse datakilder ved at bruge ER-funktionen FILTER. Når du konfigurerer datakilden, så den kaldes ud over JOIN-datakilden, kan du bruge virksomhedsområder som en del af betingelsen for dataudvælgelse. Den første implementering af JOIN-datakilden understøtter ikke datakilder af denne type. Når du f.eks. kalder en FILTER-baseret datakilde inden for området for udførelsen af en JOIN-datakilde, hvis den kaldte datakilde indeholder firmaområder som en del af betingelsen for dataudvælgelse, indtræffer der en undtagelse.

I Microsoft Dynamics 365 Finance version 10.0.12 (august 2020), kan du bruge virksomhedsområder som en del af betingelsen for dataudvælgelse i FILTER-baserede datakilder, der kaldes inden for området for udførelsen af en JOIN-datakilde. På grund af begrænsningerne i programforespørgselsgeneratoren understøttes virksomhedsområderne kun for den første datakilde i en JOIN-datakilde.

Eksempel

Du skal f.eks. foretage et enkelt kald til programdatabasen for at få vist en oversigt over udenlandske handelstransaktioner for flere virksomheder og detaljerne for den lagervare, der refereres til i de pågældende transaktioner.

I dette tilfælde skal du konfigurere følgende artefakter i ER-modeltilknytningen:

  • Roddatakilden Intrastat, der repræsenterer Intrastat-tabellen.
  • Roddatakilden Varer, der repræsenterer InventTable-tabellen.
  • Roddatakilden Virksomheder, der returnerer listen over virksomheder (DEMF og GBSI i dette eksempel), hvor transaktionerne skal tilgås. Virksomhedskoden er tilgængelig fra feltet Companies.Code.
  • Roddatakilden X1, der har udtrykket FILTER (Intrastat, VALUEIN(Intrastat.dataAreaId, Companies, Companies.Code)). Som en del af betingelsen for dataudvælgelse indeholder dette udtryk definitionen af virksomhedsområder VALUEIN(Intrastat.dataAreaId, Companies, Companies.Code).
  • X2-datakilden som et indlejret element i X1-datakilden. Den omfatter udtrykket FILTER (Items, Items.ItemId = X1.ItemId).

Endelig kan du konfigurere en JOIN-datakilde, hvor X1 er den første datakilde, og X2 er den anden datakilde. Du kan angive Forespørgsel som indstillingen Udfør, hvis du vil tvinge ER til at køre denne datakilde på databaseniveauet som et direkte SQL-kald.

Når den konfigurerede datakilde køres, mens ER-udførelsen spores, vises følgende sætning i ER-modeltilknytningsdesigneren som en del af ER-performancesporingen.

SELECT ... FROM INTRASTAT T1 CROSS JOIN INVENTTABLE T2 WHERE ((T1.PARTITION=?) AND (T1.DATAAREAID IN (N'DEMF',N'GBSI') )) AND ((T2.PARTITION=?) AND (T2.ITEMID=T1.ITEMID AND (T2.DATAAREAID = T1.DATAAREAID) AND (T2.PARTITION = T1.PARTITION))) ORDER BY T1.DISPATCHID,T1.SEQNUM

Bemærk!

Der opstår en fejl, hvis du kører en JOIN-datakilde, der er konfigureret, så den indeholder dataudvælgelsesbetingelser, som har virksomhedsområder for yderligere datakilder for den udførte JOIN-datakilde.

Yderligere ressourcer

Formeldesigner i elektronisk rapportering

Spore kørsel af ER-format for at foretage fejlfinding af problemer med ydeevnen