Konfigurere dataimport fra SharePoint

Artikel
03/08/2023

Hvis du vil importere data fra en indgående fil ved hjælp af strukturen til elektronisk rapportering (ER), skal du konfigurere et ER-format, der understøtter importen og derefter køre en modeltilknytning af typen Til destination, der bruger dette format som datakilde. Du importerer data ved at navigere til den fil, du vil importere. Den indgående fil kan vælges manuelt af brugeren. Denne proces kan konfigureres som automatiseret med den nye ER-funktionalitet, der understøtter import af data fra Microsoft SharePoint. Du kan bruge ER-konfigurationer til at udføre dataimport fra filer, der er gemt i Microsoft SharePoint-mapper. Denne artikel beskriver, hvordan du udfører importen fra SharePoint. I eksemplerne bruges kreditorposteringer som forretningsdata.

Forudsætninger

Før du kan følge eksemplerne i denne artikel, skal du have følgende adgang:

Få adgang til en af følgende roller:
- Udvikler til elektronisk rapportering
- Funktionel konsulent i elektronisk rapportering
- Systemadministrator
Adgang til den forekomst af Microsoft SharePoint Server, der er konfigureret til brug sammen med programmet.
ER-format og -modelkonfigurationer til 1099-betalinger.

Oprette de nødvendige ER-konfigurationer

Afspil opgaveguiderne ER Import af data fra en Microsoft Excel-fil, der er en del af forretningsprocessen 7.5.4.3 Anskaffe/udarbejde IT-tjeneste/løsningskomponenter (10677). Disse opgaveguider gennemgår processen med at designe og bruge ER-konfigurationer til at importere kreditorposteringer interaktivt fra Microsoft Excel-filer. Du kan finde flere oplysninger i Analysere indgående dokumenter i Excel-format. Når du har fuldført opgavevejledningerne, har du følgende konfiguration.

ER-konfigurationer

ER-modelkonfigurationen 1099-betalingsmodel
ER-formatkonfigurationen Format til import af kreditorposteringer fra Excel

ER-konfigurationer til import af data fra SharePoint.

Eksempel på den indgående fil til import af data

Excel-filen 1099import-data.xlsx med kreditorposteringer, der skal importeres.

Excel-eksempelfil til import fra SharePoint.

Bemærk!

Formatet til import af kreditorposteringer er valgt som standardmodeltilknytningen. Hvis du derfor kører en modeltilknytning af 1099-betalingsmodellen, og modeltilknytningen er af typen Til destination, kører modeltilknytningen dette format ved import af data fra eksterne filer. Derefter bruges disse data til at opdatere programtabeller.

Konfigurere adgang til SharePoint for at gemme filer

Du kan gemme elektroniske rapportfiler på en SharePoint-placering ved at konfigurere adgang til den SharePoint Server-forekomst, der skal bruges af den aktuelle virksomhed. I dette eksempel er firmaet USMF. Du kan finde flere oplysninger i Konfigurere SharePoint-lager.

Udfør trinnene i Konfigurere SharePoint-lager.
Åbn det konfigurerede SharePoint-websted.
Opret følgende mapper, hvor indgående elektroniske rapporteringsfiler kan gemmes:
- Filimportkilde (hoved) (eksempel vises på skærmbilledet nedenfor)
- Filimportkilde (alternativ)
(Valgfrit) Opret følgende mapper, hvor filerne kan gemmes efter import.
- Filarkivmappe – Denne mappe bruges til filer, der er importeret.
- Mappe til filer med advarsler - Denne mappe er til filer, der er importeret med en advarsel.
- Mappe til fejlslagne filer – Denne mappe bruges til filer, der ikke blev importeret.
Gå til Virksomhedsadministration > Dokumentstyring > Dokumenttyper.
Opret følgende dokumenttyper, der skal bruges til at få adgang til de SharePoint-mapper, du har oprettet. Yderligere oplysninger finder du i Konfigurere dokumenttyper.

Dokumenttype	Multi	Placering	SharePoint-mappe
SP-hoved	Fil	SharePoint	Filimportkilde (hoved)
SP-alternativ	Fil	SharePoint	Filimportkilde (alternativ)
SP-arkiv	Fil	SharePoint	Filarkivmappe
SP-advarsel	Fil	SharePoint	Mappe til filer med advarsler
SP-fejl	Filer	SharePoint	Mappe til fejlslagne filer

SharePoint-indstilling – ny dokumenttype.

Konfigurere ER-kilder for ER-formatet

Klik på Virksomhedsadministration>Elektronisk rapportering>Kilde til elektronisk rapportering.
På siden Kilde til elektronisk rapportering skal du konfigurere kildefilerne til import af data ved hjælp af det konfigurerede ER-format.
Definer en filnavnsmaske, så kun filer med filtypenavnet .xlsx importeres. Filnavnsmasken er valgfri og bruges kun, når den er defineret. Du kan kun definere én maske for hvert ER-format.
Skift Sortér filer før import til Sortér ikke, hvis der er mange filer til import, og importrækkefølgen ikke er vigtig
Vælg alle de SharePoint-mapper, du oprettede tidligere.

Bemærk!

ER kilde defineres individuelt for hvert firma i programmet. Derimod deles ER konfigurationer på tværs af firmaer.
Når du sletter en ER-kildeindstilling for et ER-format, slettes også alle tilknyttede filtilstande (se nedenfor) efter bekræftelse.

Gennemse filtilstande for ER-formatet

På siden Kilde til elektronisk rapportering skal du vælge Filtilstande for kilderne for at gennemse indholdet af de konfigurerede filkilder for det aktuelle ER-format.
I sektionen Filer skal du gennemse listen over filer. Denne liste viser følgende:
- Kildefiler, der er relevante, baseret på filnavnsmasken (hvis der er defineret en maske), og som er klar til dataimport. For disse filer er sektionen Kildelogfiler for importformatet tom.
- Tidligere importerede filer. For hver af disse filer i sektionen Kildelogfiler for importformatet kan du gennemse oversigten over import af filen.

Du kan også åbne siden Filtilstande for kilderne ved at vælge Virksomhedsadministration>Elektronisk rapportering>Filtilstande for kilderne. I så fald indeholder siden oplysninger om filkilder for alle ER-formater, som filkilder er konfigureret for i det firma, du aktuelt er logget på.

Importere data fra Excel-filer, der findes i en SharePoint-mappe

I SharePoint skal du overføre Microsoft Excel-filen 1099import-data.xlsx, der indeholder kreditorposter, til den Filimportkilde (hoved) SharePoint-mappe, du oprettede tidligere.
På siden Filtilstande for kilderne skal du vælge Opdater for at opdatere siden. Den Excel-fil, der blev overført til SharePoint, blev vist på denne side med status Klar. Følgende statusser understøttes i øjeblikket:
- Klar – Tildeles automatisk til hver ny fil i en SharePoint-mappe. Denne status betyder, at filen er klar til import.
- Importerer – Tildeles automatisk af en ER-rapport, når filen låses af importen for at forhindre, at den bruges af andre processer (hvis mange af dem kører samtidigt).
- Importeret – Tildeles automatisk af en ER-rapport, når filimporten er fuldført. Denne status betyder, at den importerede fil er blevet slettet fra den konfigurerede filkilde (SharePoint-mappe).
- Mislykkedes – Tildeles automatisk af en ER-rapport, når filimporten blev fuldført med fejl eller undtagelser.
- På hold – Tildeles manuelt af brugeren på denne side. Denne status betyder, at filen ikke importeres på nuværende tidspunkt. Denne status kan bruges til at udskyde importen af visse filer.

Importere data fra SharePoint-filer

Åbn ER-konfigurationstræet, vælg 1099-betalingsmodel, og udvid listen over ER-modelkomponenter.
Vælg navnet på modeltilknytningen for at åbne listen over modeltilknytninger for den valgte ER-modelkonfiguration.
Vælg Kør for at køre den valgte modeltilknytning. Da du har konfigureret filkilder for ER-formatet, kan du ændre indstillingen Filkilde, hvis der er brug for det. Hvis du lader denne indstilling være uændret, importeres .xslx-filerne fra de konfigurerede kilder (SharePoint-mapperne i dette eksempel).

I dette eksempel skal du kun importere én fil. Hvis der er flere filer, vælges de til import i samme rækkefølge, som de blev tilføjet i SharePoint-mappen. Hver kørsel af et ER-format importerer en enkelt valgt fil.
Modeltilknytningen kan køre automatisk i batchtilstand. I så fald importeres en enkelt fil fra de konfigurerede filkilder, hver gang en batch kører dette ER-format.

Når en fil er importeret fra SharePoint-mappen, slettes den fra den pågældende mappe og flyttes til mappen med importerede filer eller til mappen til importerede filer med advarsler. Ellers flyttes den til mappen for fejlslagne filer eller forbliver i denne mappe, hvis mappen med fejlslagne filer ikke er konfigureret.
Angiv bilags-id'et, f.eks. V-00001, og vælg derefter OK.
På siden Filtilstande for kilderne skal du vælge Opdater for at opdatere siden.
I sektionen Filer skal du gennemse listen over filer. Sektionen Kildelogfiler for importformatet indeholder en oversigt over Excel-filimporten. Da denne fil blev importeret korrekt, er den markeret som Slettet i SharePoint-mappen.
Gennemse SharePoint-mappen Filimportkilde (hoved). Excel-filer, der blev importeret, er blevet slettet fra denne mappe.
Vælg Kreditor>Periodiske opgaver>1099-skat>Kreditorudligning for 1099.
I felterne Fra dato og Til dato skal du angive relevante værdier. Vælg derefter Manuelle 1099-transaktioner.

De kreditorposteringer, der blev importeret fra Excel-filerne i SharePoint for bilag V-00001, vises på siden.

Forberede en Excel-fil til import

Åbn den Excel-fil, du tidligere brugte. I række 3, kolonne 1 skal du tilføje en kreditorkode, der ikke findes i programmet. Føj yderligere falske kreditoroplysninger til rækken.
Overfør den opdaterede Excel-fil, der indeholder kreditorposteringer til SharePoint-mappen Filimportkilde (hoved).
Åbn ER-konfigurationstræet, vælg 1099-betalingsmodel, og udvid listen over ER-modelkomponenter.
Vælg navnet på modeltilknytningen for at opdatere modeltilknytningen, så den forkerte kreditorkode betragtes som en fejl under dataimporten.
Vælg Designer.
Under fanen Valideringer skal du ændre efter-valideringshandlingen for den valideringsregel, der blev konfigureret, for at vurdere, om den kreditorkonto, der importeres, findes i programmet. Opdater værdien i feltet Efter-valideringshandling for at Stop udførelse, gemme ændringerne og lukke siden.
Gem ændringerne, og luk ER-modeltilknytningsdesigneren.
Vælg Kør for at køre den ændrede ER-modeltilknytning.
Angiv bilags-id'et, f.eks. V-00002, og vælg derefter OK.

Infologgen indeholder en besked om, at der er en fil i SharePoint-mappen, der indeholder en forkert kreditorkonto, som ikke kan importeres.
På siden Filtilstande for kilderne skal du vælge Opdater og derefter i sektionen Filer gennemgå listen over filer.

Sektionen Kildelogfiler for importformatet angiver, at importen mislykkedes, og at filen er i SharePoint-mappen til fejlslagne filer (afkrydsningsfeltet Er slettet er ikke markeret). Hvis du reparerer denne fil på SharePoint ved at tilføje den korrekte kreditorkode og derefter flytter den til SharePoint-mappen Filimportkilde (hoved), kan du importere filen igen.

Vælg Kreditor>Periodiske opgaver>1099-skat>Kreditorudligning for 1099, angiv de relevante værdier i Fra dato og Til dato-felterne, og vælg derefter Manuelle 1099-transaktioner.

Kun posteringer for bilag V-00001 er tilgængelige. Ingen posteringer for bilag V-00002 er tilgængelige, selvom fejlen for den sidste importerede transaktion blev fundet i Excel-filen.

Begrænsninger

I versioner af Dynamics 365 Finance før version 10.0.25, giver brugergrænsefladen (UI) for ER-strukturen ikke mulighed for at starte et nyt batchjob, der udfører en modeltilknytning i uovervåget tilstand for dataimport. Du skal i stedet udvikle ny logik, så den konfigurerede ER-modeltilknytning kan kaldes fra brugergrænsefladen i programmet for at importere data fra indgående filer. For at kunne udvikle denne logik er det nødvendigt med teknikerarbejde.

Du kan få mere at vide om det relevante ER-API i afsnittet Kode til kørsel af en formattilknytning til dataimport i emnet Ændringer af API til ER-struktur til Application Update 7.3. Gennemse koden i BankImport_RU-klassen for Application Suite-modellen for at se, hvordan din brugerdefinerede logik kan implementeres. Klassen BankImport_RU udvider klassen RunBaseBatch. Du skal især gennemgå runER()-metoden, hvor ERIModelMappingDestinationRun-objektet oprettes som kørselsfunktion for en ER-modeltilknytning.

In Finans version 10.0.25 og nyere giver ER-strukturens brugergrænseflade ikke mulighed for at starte et nyt batchjob, der kører en modeltilknytning i uovervåget tilstand for dataimport. Yderligere oplysninger om denne proces finder du i Importere data i batchtilstand fra manuelt valgte filer.