Gegevens importeren

Importeer gegevens die ergens anders zijn opgeslagen in uw modelgestuurde app met behulp van de importfunctie in Power Apps.

Elke tabel heeft vereiste kolommen die in uw invoerbestand aanwezig moeten zijn. Download een Excel-sjabloon, voeg uw gegevens toe en importeer het bestand vervolgens in uw app. De sjabloon bespaart tijd en moeite. Voeg geen kolommen aan de sjabloon toe of wijzig deze niet om problemen tijdens het importeren te voorkomen.

Voordat u een bestand importeert, moet u ervoor zorgen dat de kolomkoppen overeenkomen met de kolomnamen in uw app. Tijdens het importproces wordt geprobeerd de kolomnamen uit uw invoerbestand toe te wijzen aan de kolomnamen in de app. Als ze niet overeenkomen, moet u de velden handmatig toewijzen of kunnen er problemen optreden tijdens het importproces.

Als u een geavanceerde gebruiker bent en de vereiste kolommen voor een bepaalde Dataverse-tabel kent, definieert u uw eigen Excel-, CSV- of XML-bronbestand. Volg vervolgens de stappen in dit artikel over het importeren van gegevens naar uw app. Deze indelingen worden ondersteund:

  • Excel-werkmap (.xlsx)
  • Door komma's gescheiden waarden (.csv)
  • XML-werkblad 2003 (.xml)

De maximumbestandsgrootte voor zip-bestanden is 32 MB. Voor de andere indelingen is de maximale toegestane bestandsgrootte 8 MB.

Een Excel-sjabloon downloaden

Om toewijzingsproblemen te voorkomen, kunt u het beste gebruikmaken van een Excel-sjabloon die u vanuit uw app kunt downloaden. Nadat de sjabloon is gedownload, voegt u uw gegevens toe en importeert u het bestand vervolgens weer in uw app. Voeg geen kolommen aan de sjabloon toe of wijzig deze niet om problemen tijdens het importproces te voorkomen.

  1. Open uw app en selecteer in de linkernavigatie een tabel.

  2. Selecteer op de opdrachtbalk Excel-sjablonen>Sjabloon downloaden.

  3. Selecteer het tabeltype en de weergave om te downloaden of selecteer Kolommen bewerken en kies de rijen die u in de sjabloon wilt opnemen.

  4. Selecteer Downloaden.

    Hoe u een Excel-sjabloon downloadt vanuit uw app.

Uw gegevens importeren

Gebruik de sjabloon die u in de vorige stap hebt gedownload (aangepast met uw gegevens) en importeer het bestand in uw app.

  1. Open een app en selecteer in de linkernavigatie een tabel.

    In het siteoverzicht een tabel selecteren.

  2. Selecteer op de opdrachtbalk het bestandstype waaruit u wilt importeren:

    • Importeer vanuit Excel : Selecteer Importeren vanuit Excel als u een Excel-sjabloon gebruikt.
    • Importeren vanuit CSV
    • Importeren vanuit XML

    Toont de drie importopties in Power Apps.

  3. Selecteer Bestand kiezen en blader naar de map om het bestand te vinden. Selecteer het bestand, selecteer Openen en selecteer daarna Volgende.

    Fooi

    U kunt slechts één bestand tegelijk importeren. Als u meer bestanden wilt importeren, voert u de wizard nogmaals uit.

  4. Selecteer of u duplicaten wilt toestaan of niet. Zie Dubbele detectieregels instellen om uw gegevens schoon te houden voor meer informatie.

  5. Voor CSV- en XML-bestanden (sla deze stap over als u een Excel-bestand importeert):

    • Voor een CSV-bestand: selecteer de vervolgkeuzelijst en selecteer het gegevensscheidingsteken en veldscheidingsteken dat wordt gebruikt voor het CSV-bestand.

    • Voor een CSV- of XML-bestand: als u een alternatieve sleutel hebt gedefinieerd, selecteert u deze in de vervolgkeuzelijst Alternatieve sleutel. De alternatieve sleutel wordt gebruikt om rijen tijdens het importeren uniek te identificeren en bij te werken. Zie Alternatieve sleutels definiëren om naar rijen te verwijzen voor meer informatie.

      De alternatieve sleutel selecteren.

  6. Selecteer Toewijzingen controleren en controleer of de kolommen (velden) correct zijn toegewezen. Als alles er goed uitziet, selecteert u Importeren voltooien.

    Het geselecteerde Excel-bestand importeren en de toewijzing controleren.

  7. Selecteer Voortgang bijhouden om de voortgang van de import te zien.

    De voortgang bijhouden van het bestand dat u importeert.

Toewijzingen controleren

Wanneer u een bestand importeert, controleert u de kolomkoppen en controleert u of deze overeenkomen met de kolommen (velden) in uw app.

Toewijzingen controleren.

Legenda:

  1. Primaire velden: geeft alle vereiste kolommen weer voor de tabel die u moet toewijzen zodat de gegevens succesvol kunnen worden geïmporteerd. Als de kolomkoppen van het bronbestand overeenkomen met de weergavenamen van de kolommen, worden deze kolommen automatisch toegewezen.

  2. Toegewezen kolommen: Correct toegewezen kolommen worden weergegeven met een groen vinkje.

  3. Optionele velden: deze kolomkoppen zijn optioneel in het bronbestand. Als de kolomkoppen overeenkomen met de weergavenamen van de kolommen, worden de kolommen automatisch geselecteerd in de corresponderende vervolgkeuzelijsten.

  4. Niet-toegewezen kolommen: als de kolomkoppen niet overeenkomen, worden de niet-toegewezen kolommen weergegeven met een rood uitroepteken. Om de kolom correct toe te wijzen, selecteert u een kolom om toe te wijzen aan de niet-toegewezen kolomkop van uw bestand.

  5. Negeren (alleen voor Optionele velden): kies Negeren in de vervolgkeuzelijst. Gegevens uit genegeerde kolommen worden niet geïmporteerd in uw app.

Optieset

Als een kolom in het bronbestand een vaste set waarden bevat, wijst u de kolom toe aan een kolom van het type Option Set. Een kolom van dit type heeft waarden zoals Ja en Nee of Laag en Hoog.

Selecteer hiervoor de knop De knop Optieset. naast de optiesetkolom, selecteer de waarden en selecteer vervolgens OK.

Het menu voor toewijzing van de optiesetwaarde.

In de vervolgkeuzelijst optiewaarden worden de beschikbare waarden in het inkomende bestand gecombineerd met de waarden die al aanwezig zijn in uw app. Bijvoorbeeld:

  • Waarden in importbestand: Laag, Hoog
  • Waarden die al aanwezig zijn in uw app: Koud, Warm, Heet
  • Resulterende doelwaarden: Koud, Warm, Heet, Laag, Hoog

Na het importeren voegt de wizard Importeren alle toegewezen waarden in uw app toe, maar worden niet-toegewezen waarden die nog niet in uw app staan uit het importbestand verwijderd. U kunt de bronwaarde Laag bijvoorbeeld toewijzen aan de doelwaarde Koud en de bronwaarde Hoog aan de (nieuwe) doelwaarde Hoog. Op basis van deze toewijzingen wordt Hoog als doelwaarde in uw app gemaakt. Laag wordt niet als doelwaarde in uw app gemaakt omdat u geen bron aan deze doelwaarde hebt toegewezen.

Opmerking

U kunt een kolom in uw bronbestand toewijzen aan de kolom 'Twee opties' of 'Multiselect Option Set'. Bij toewijzing aan een "Multiselect Option Set", worden er mogelijk nieuwe waarden gemaakt in Dataverse als het bronbestand waarden bevat die niet beschikbaar zijn in uw app en de importtoewijzing is ingesteld op NotMapped. Als de toewijzing is ingesteld op Negeren, kan de record zonder problemen worden geïmporteerd. Voor velden met optieset met meerdere selecties worden de waarden niet geïmporteerd en worden er geen nieuwe waarden gemaakt in de doelomgeving.

Opzoekkolommen toewijzen

Als uw bronbestand gegevens bevat die verwijzen naar andere bestaande rijen in uw app, wijst u de kolom in het bronbestand toe aan een opzoekkolom in uw app.

U kunt bijvoorbeeld een bestand met de naam Leads.csvimporteren, dat klantrijen bevat. De kolom Klant in Leads.csv bevat het bijbehorende account of de bijbehorende contactgegevens. Als u deze kolom wilt toewijzen, selecteert u de knop Lookup Reference naast de opzoekkolom. De sectie Opzoekverwijzing wordt geopend en bevat de gerelateerde tabellen voor de huidige tabel.

De sectie Opzoekverwijzing.

Selecteer voor elke tabel de kolommen die tijdens het importeren moeten worden doorzocht om de relaties tussen de rijen te behouden. Selecteer vervolgens OK.

Instellingen voor toewijzen opslaan

Als u de toewijzingsinstellingen wilt opslaan, voert u een naam in het vak Geef uw gegevenstoewijzing een naam in. Wanneer u een vergelijkbare set gegevens importeert, kunt u dezelfde toewijzing gebruiken.

Uw gegevenstoewijzing hier een naam geven.

Het logboek voor importeren openen

Nadat u een importactie hebt gestart, kunt u de status van de importtaak volgen en de resultaten bekijken in het logboek voor importeren.

Selecteer in de laatste stap van de importwizard de optie Voortgang bijhouden om de voortgang van de importtaak te bekijken.

Schermopname van de laatste stap in de wizard voor importeren.

Als u deze stap hebt gemist, voegt u de volgende code toe aan uw app-URL: &newWindow=true&pagetype=entitylist&etn=importfile&viewid=a2927069-e4dc-4e8f-8fb1-d2f6c40c427e&viewType=1039.

Als uw app-URL bijvoorbeeld https://org12345.crm.dynamics.com/main.aspx?appid=00001111-aaaa-2222-bbbb-3333cccc4444 is, is de URL waarmee u het logboek voor importeren kunt bekijken https://org12345.crm.dynamics.com/main.aspx?appid=00001111-aaaa-2222-bbbb-3333cccc4444&newWindow=true&pagetype=entitylist&etn=importfile&viewid=a2927069-e4dc-4e8f-8fb1-d2f6c40c427e&viewType=1039.

De status van een import weergeven en fouten corrigeren

Wanneer het importeren is voltooid, kunt u de records bekijken die zijn geïmporteerd, niet zijn geïmporteerd of gedeeltelijk zijn geïmporteerd.

  1. Open het logboek voor importeren.

  2. Controleer bij Mijn importen de voortgang van het importeren.

    De kolom Status geeft de reden aan voor de status van de import. De voortgang wordt met een van de volgende waarden aangeduid:

    • Ingediend
    • Parseren
    • Transformatie
    • Importeren
    • Voltooid

    Opmerking

    Voor tabellen die een zelfverwijzende zoekactie bevatten, worden relaties in twee fasen tijdens de importfase opgelost. In de eerste fase worden de basisrecords gemaakt. In de tweede fase worden de zelfverwijzingen bijgewerkt om de gegevensintegriteit te waarborgen.

  3. Wanneer het importeren is voltooid, worden in de kolommen Geslaagd, Mislukkingen en Gedeeltelijke fouten het aantal records weergegeven dat is geïmporteerd, niet zijn geïmporteerd of gedeeltelijk zijn geïmporteerd.

  4. Selecteer een importtaak om te controleren welke records niet zijn geïmporteerd of gedeeltelijk zijn geïmporteerd. Schermopname van de importrecord met de kolommen **Geslaagd**, **Mislukt** en **Gedeeltelijk mislukt**.

  5. Selecteer de juiste tabbladen om informatie te bekijken over fouten, successen of gedeeltelijke fouten in records tijdens het importeren.

  6. Exporteer op het tabblad Mislukt rijen die niet zijn geïmporteerd, naar een nieuw bestand. Selecteer Rijen met fouten exporteren.

  7. Corrigeer de fouten in dit bestand en importeer het vervolgens.

Geïmporteerde records verwijderen

U kunt het importbestand en de geïmporteerde records verwijderen als u de gegevens opnieuw wilt importeren of als u de gegevens om een of andere reden niet nodig hebt.

  1. Open het logboek voor importeren.

  2. Selecteer het importbestand dat u wilt verwijderen en voer een van de volgende handelingen uit:

    • Bronimportbestand verwijderen. Met deze optie wordt het logboekbestand voor de import met alle details verwijderd.

    • Geïmporteerde records verwijderen. Met deze optie worden alle records verwijderd die zijn geïmporteerd uit het geselecteerde bestand.

    • Alles verwijderen. Met deze optie wordt het importbestand verwijderd met de records die uit het importbestand zijn geïmporteerd.

Beperkingen

  • Excel-import wordt niet ondersteund met Virtuele tabellen of Elastische tabellen
  • Bij het importeren van Excel worden velden uit de primaire tabel bijgewerkt, maar worden velden uit gerelateerde tabellen genegeerd.
  • Excel-importtaken worden alleen parallel uitgevoerd wanneer de bestandsgrootte kleiner is dan 1 MB. Bestanden die groter zijn dan 1 MB, worden opeenvolgend verwerkt om uitputting van resources te voorkomen.

Opmerking

Als u parallelle verwerking wilt inschakelen, houdt u elk bestand onder de 1 MB. Voor .zip bestanden moet de gedecomprimeerde grootte ook kleiner zijn dan 1 MB. Bestanden met speciale tekens hebben mogelijk een berekende grootte die groter is dan 1 MB, zelfs als het oorspronkelijke bestand kleiner wordt weergegeven.

Zie ook

Een sjabloon voor het importeren van gegevens downloaden