Istruzioni per importare i dati

Importare i dati archiviati altrove nell'app basata su modello usando la funzionalità di importazione in Power Apps.

Ogni tabella richiede colonne che devono esistere nel file di input. Scaricare un modello di Excel, aggiungere i dati e quindi importare il file nell'app. Il modello consente di risparmiare tempo e risorse. Non aggiungere o modificare colonne nel modello per evitare problemi durante l'importazione.

Prima di importare un file, verificare che le intestazioni di colonna corrispondano ai nomi di colonna nell'app. Durante il processo di importazione, il sistema proverà a mappare i nomi delle colonne dal file di input ai nomi delle colonne nell'app. Se non corrispondono, è necessario eseguire manualmente il mapping dei campi o potrebbero verificarsi problemi durante il processo di importazione.

Se si è un utente avanzato e si conoscono le colonne necessarie per una determinata tabella Dataverse, definire il proprio file di origine Excel, CSV o XML. Seguire quindi i passaggi descritti in questo articolo su come importare i dati nell'app. Questi formati di file sono supportati:

  • Cartella di lavoro di Excel (.xlsx)
  • Valori separati da virgole (.csv)
  • Foglio di calcolo XML 2003 (.xml)

La dimensione file massima consentita per i file con estensione zip è 32 MB. Per gli altri formati di file, la dimensione file massima consentita è 8 MB.

Scarica un modello di Excel

Per evitare problemi di mappatura, dovresti utilizzare un modello di Excel che puoi scaricare dalla tua app. Una volta scaricato il modello, aggiungi i tuoi dati e poi importa di nuovo il file nell'app. Ricordati di non aggiungere o modificare colonne nel modello per evitare problemi durante il processo di importazione.

  1. Apri la tua app e dalla barra di navigazione sinistra seleziona una tabella.

  2. Nella barra dei comandi, seleziona Modelli di Excel>Scarica modello.

  3. Seleziona il tipo di tabella e la vista per scaricare o selezionare Modifica colonne e scegli le righe da includere nel modello.

  4. Seleziona Scarica.

    Come scaricare un modello Excel dalla tua app.

Importa i dati

Usa il modello che hai scaricato nel passaggio precedente (modificato con i tuoi dati) e importa il file nella tua app.

  1. Apri un'app e dalla barra di navigazione sinistra seleziona una tabella.

    Dalla mappa del sito, seleziona una tabella.

  2. Sulla barra dei comandi, seleziona il tipo di file da cui importare:

    • Importa da Excel: seleziona Importa da Excel se stai usando un modello Excel.
    • Importa da file CSV
    • Importa da file XML

    Mostra le tre opzioni di importazione in Power Apps.

  3. Seleziona Scegli file e accedi alla cartella in cui è salvato il file. Seleziona il file, quindi scegli Apri e infine Avanti.

    Suggerimento

    È possibile importare un solo file alla volta. Per importare più file, esegui di nuovo la procedura guidata.

  4. Scegli se Consenti duplicati oppure no. Per altre informazioni, vedere Configurare regole di rilevamento duplicate per mantenere puliti i dati.

  5. Per i file CSV e XML (ignora questo passaggio se stai importando un file Excel):

    • Per un file CSV: seleziona l'elenco a discesa e seleziona il delimitatore di dati e il delimitatore di campo utilizzati per il file CSV.

    • Per un file CSV o XML: se disponi di una chiave alternativa già definita, selezionala nell'elenco a discesa Chiave alternativa. La chiave alternativa viene utilizzata per identificare e aggiornare in modo univoco le righe durante l'importazione. Per altre informazioni, vedere Definire chiavi alternative per fare riferimento alle righe.

      Seleziona la chiave alternativa.

  6. Seleziona Rivedi mapping e verifica che le colonne (campi) siano mappate correttamente. Se è tutto corretto, seleziona Termina importazione.

    Importazione del file Excel selezionato e verifica della mappatura.

  7. Seleziona Monitora avanzamento per vedere lo stato di avanzamento dell'importazione.

    Tieni traccia dell'avanzamento del file che stai importando.

Rivedi il mapping

Quando si importa un file, esaminare le intestazioni di colonna e verificare che corrispondano alle colonne (campi) nell'app.

Rivedere il mapping.

Legenda:

  1. Campi primari: mostra tutte le colonne necessarie per la tabella di cui è necessario eseguire il mapping per l'importazione corretta dei dati. Se le intestazioni di colonna del file di origine corrispondono ai nomi visualizzati delle colonne, queste colonne verranno mappate automaticamente.

  2. Colonne mappate: le colonne mappate correttamente verranno visualizzate con un segno di spunta verde.

  3. Campi facoltativi: queste intestazioni di colonna sono facoltative nel file di origine. Se le intestazioni di colonna corrispondono ai nomi visualizzati delle colonne, le colonne verranno selezionate automaticamente negli elenchi a discesa corrispondenti.

  4. Colonne non corrispondenti: se le intestazioni di colonna non corrispondono, le colonne non mappate verranno visualizzate con un punto esclamativo rosso. Per mappare correttamente la colonna, seleziona una colonna da mappare all'intestazione di colonna non mappata del file.

  5. Ignora (solo per Campi facoltativi): scegli Ignora dall'elenco a discesa. I dati delle colonne ignorate non vengono importati nell'app.

Set di opzioni

Se una colonna nel file di origine include un set fisso di valori, eseguire il mapping della colonna a una colonna di tipo Set di opzioni. Una colonna di questo tipo dispone di valori come Sì e No oppure Basso e Alto.

Per fare ciò, seleziona il pulsante pulsante Option Set. accanto alla colonna del set di opzioni, seleziona i valori, quindi seleziona OK.

Menu di mapping del valore del set di opzioni.

L'elenco a discesa dei valori delle opzioni combina i valori disponibili nel file in arrivo con quelli già presenti nella tua app. Ad esempio:

  • Valori nel file di importazione: Basso, Alto
  • Valori già nell'app: Freddo, Tiepido, Caldo
  • Valori di destinazione risultanti: Freddo, Tiepido, Caldo, Basso, Alto

Dopo l'importazione, l'importazione guidata aggiunge tutti i valori mappati nell'app, ma elimina i valori non mappati dal file di importazione che non sono ancora presenti nell'app. Ad esempio, puoi mappare il valore di origine "Basso" al valore di destinazione "Freddo", ma mappare il valore di origine "Elevato" al (nuovo) valore di destinazione "Elevato". In base a queste mappature, la procedura guidata per l'importazione crea "Elevato" come valore di destinazione nell'app. Non crea "Low" come valore di destinazione nell'app perché non hai mappato alcuna origine a questo valore di destinazione.

Nota

È possibile associare una colonna nel file di origine a una colonna "Due Opzioni" o "Set di Opzioni Multiselezione". Quando si esegue il mapping a un "Set di opzioni di selezione multipla", se il file di origine include valori non disponibili nell'app, potrebbero essere creati nuovi valori in Dataverse se il mapping di importazione è impostato su NotMapped. Se il mapping è impostato su Ignora, il record può essere importato correttamente. Per i campi "Set di opzioni di selezione multipla", i valori non vengono importati e non vengono creati nuovi valori nell'ambiente di destinazione.

Colonne di ricerca della mappa

Se il file di origine contiene dati che fanno riferimento ad altre righe esistenti nell'app, eseguire il mapping della colonna nel file di origine a una colonna di ricerca nell'app.

Ad esempio, è possibile importare un file denominato Leads.csv, che contiene le righe dei clienti. La colonna Customer in Leads.csv contiene i dati associati dell'account o del contatto. Per eseguire il mapping di questa colonna, selezionare il pulsante Lookup Reference accanto alla colonna di ricerca. Si apre la sezione Riferimento di ricerca in cui sono elencate le tabelle correlate alla tabella corrente.

La sezione Riferimento di ricerca.

Per ciascuna tabella, seleziona le colonne da cercare durante l'importazione per mantenere le relazioni tra le righe, quindi seleziona OK.

Salva le impostazioni di mapping

Per salvare le impostazioni di mapping, immettere un nome nella casella Assegna un nome alla mappa dati. Quando si importa un set di dati simile, è possibile usare lo stesso mapping.

Denominare il mapping dei dati qui.

Apri il log di importazione

Dopo aver avviato un'importazione, puoi monitorare lo stato del processo di importazione e visualizzare i risultati nel registro dell'importazione.

Nell'ultimo passaggio della procedura guidata di importazione, seleziona Monitora avanzamento per visualizzare l'avanzamento del processo di importazione.

Screenshot dell'ultimo passaggio nella procedura guidata di importazione.

Se hai perso questo passaggio, aggiungi il seguente codice all'URL dell'app: &newWindow=true&pagetype=entitylist&etn=importfile&viewid=a2927069-e4dc-4e8f-8fb1-d2f6c40c427e&viewType=1039.

Ad esempio, se l'URL della tua app è https://org12345.crm.dynamics.com/main.aspx?appid=00001111-aaaa-2222-bbbb-3333cccc4444, l'URL per visualizzare il log di importazione sarà 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.

Visualizzare lo stato di un'importazione e correggere gli errori

Al termine dell'importazione, è possibile visualizzare i record importati correttamente, non importati o parzialmente importati.

  1. Aprire il log di importazione.

  2. In My Imports, monitora lo stato di avanzamento dell'importazione.

    La colonna Stato indica lo stato dell'importazione. Lo stato passa attraverso i seguenti valori:

    • Inviato
    • Parsing
    • In trasformazione
    • Importazione...
    • Completato

    Nota

    Per le tabelle che includono una ricerca auto-referenziale, le relazioni vengono risolte in due fasi nella fase di Importazione. Nella prima fase vengono creati i record di base. Nella seconda fase, i riferimenti self-reference vengono aggiornati per garantire l'integrità dei dati.

  3. Al termine dell'importazione, le colonne Successo, Errori e Errori parziali mostrano il numero di record che sono stati importati correttamente, la cui importazione non è riuscita o che sono stati parzialmente importati.

  4. Seleziona un processo di importazione per visualizzare i record non importati o parzialmente importati. Screenshot del record di importazione con le colonne **Successo**, **Fallimenti** e **Errori parziali**.

  5. Selezionare le schede appropriate per visualizzare informazioni sugli errori, l'esito positivo o l'errore parziale dei record durante l'importazione.

  6. Nella scheda Operazioni non riuscite, esporta le righe che non sono state importate in un nuovo file. Seleziona Esporta righe con errori.

  7. Correggere gli errori in questo file e quindi importarlo.

Elimina record importati

Puoi eliminare il file di importazione e i record importati se desideri reimportare i dati o se per qualche motivo non ti servono i dati.

  1. Aprire il log di importazione.

  2. Seleziona il file di importazione che desideri eliminare, quindi scegli una delle azioni seguenti:

    • Elimina il file di origine dell'importazione. Questa opzione elimina il file di registro dell'importazione e i relativi dettagli.

    • Elimina i record importati. Questa opzione elimina tutti i record importati dal file selezionato.

    • Elimina tutto. Questa opzione elimina il file di importazione insieme ai record importati dal file di importazione.

Limitazioni

  • L'importazione in Excel non è supportata con le Tabelle virtuali o le Tabelle elastiche
  • L'importazione in Excel aggiorna i campi della tabella primaria ma ignora i campi delle tabelle correlate.
  • I processi di importazione di Excel vengono eseguiti in parallelo solo quando le dimensioni del file sono minori di 1 MB. I file di dimensioni superiori a 1 MB vengono elaborati in sequenza per evitare l'esaurimento delle risorse.

Nota

Per abilitare l'elaborazione parallela, mantenere ogni file inferiore a 1 MB. Per .zip i file, anche le dimensioni decompresse devono essere minori di 1 MB. I file con caratteri speciali possono avere una dimensione calcolata superiore a 1 MB anche se il file originale appare più piccolo.

Vedi anche

Scaricare un modello per l'importazione dei dati