Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Importe dados armazenados em outro lugar em seu aplicativo baseado em modelo usando o recurso de importação no Power Apps.
Cada tabela requer colunas obrigatórias que devem existir no arquivo de entrada. Baixe um modelo de Excel, adicione seus dados e importe o arquivo para seu aplicativo. O modelo economiza tempo e esforço. Não adicione ou modifique colunas no modelo para evitar problemas durante a importação.
Antes de importar um arquivo, verifique se os títulos de coluna correspondem aos nomes de coluna em seu aplicativo. Durante o processo de importação, o sistema tenta mapear os nomes das colunas do seu arquivo de entrada para os nomes das colunas no aplicativo. Se eles não corresponderem, você precisará mapear manualmente os campos ou poderá encontrar problemas durante o processo de importação.
Se você for um usuário avançado e souber as colunas necessárias para uma determinada tabela do Dataverse, defina seu próprio arquivo de origem Excel, CSV ou XML. Em seguida, siga as etapas neste artigo sobre como importar dados para seu aplicativo. Esses formatos de arquivo com suporte são:
- Pasta de trabalho do Excel (.xlsx)
- Valores Separados por Vírgulas (.csv)
- Planilha XML 2003 (.xml)
O tamanho máximo do arquivo .zip permitido é de 32 MB. Para outros formatos de arquivo, o tamanho máximo do arquivo permitido é 8 MB.
Baixar um modelo do Excel
Para evitar problemas de mapeamento, você deve usar um modelo do Excel que pode ser baixado do seu aplicativo. Assim que o modelo for baixado, adicione seus dados e importe o arquivo novamente para o aplicativo. Lembre-se de não adicionar ou modificar colunas no modelo para evitar problemas durante o processo de importação.
Abra o aplicativo e selecione uma tabela no painel de navegação esquerdo.
Na barra de comandos, selecione Modelos do Excel>Baixar Modelo.
Selecione o tipo de tabela e a exibição a serem baixados ou selecione Editar Colunas e escolha as linhas a serem incluídas no modelo.
Selecione Baixar.
Importar os dados
Use o modelo baixado na etapa anterior (modificado com os dados) e importe o arquivo para o aplicativo.
Abra um aplicativo e selecione uma tabela no painel de navegação esquerdo.
Na barra de comando, selecione o tipo de arquivo do qual importar:
- Importar do Excel: selecione Importar do Excel se você estiver usando um modelo do Excel.
- Importar de CSV
- Importar de XML
Selecione Escolher arquivo e navegue até a pasta em que o arquivo foi salvo. Selecione o arquivo, escolha Abrir e, em seguida, Avançar.
Gorjeta
É possível importar apenas um arquivo por vez. Para importar mais arquivos, execute o assistente novamente.
Selecione se deseja Permitir Duplicidades ou não. Para obter mais informações, consulte Configurar regras de detecção de duplicidade para manter seus dados limpos.
Para arquivos CSV e XML (pule esta etapa se estiver importando um arquivo do Excel):
Para um arquivo CSV: selecione a lista suspensa, selecione o delimitador de dados e o delimitador de campo usado para o arquivo CSV.
Para arquivo CSV ou XML: se você tiver uma chave alternativa definida, selecione-a na lista suspensa Chave alternativa. A chave alternativa é usada para identificar e atualizar linhas de maneira exclusiva durante a importação. Para obter mais informações, consulte Definir chaves alternativas para referenciar linhas.
Selecione Examinar Mapeamento e verifique se as colunas (campos) estão mapeadas corretamente. Se tudo estiver correto, selecione Concluir Importação.
Selecione Acompanhar o Andamento para ver o progresso da importação.
Examinar mapeamento
Ao importar um arquivo, examine os títulos de coluna e verifique se eles correspondem às colunas (campos) em seu aplicativo.
Legenda:
Campos Primários: mostra todas as colunas necessárias para a tabela que você deve mapear para que os dados sejam importados com êxito. Se os cabeçalhos das colunas do arquivo de origem corresponderem aos nomes para exibição da coluna, as colunas são mapeadas automaticamente.
Colunas mapeadas: as colunas mapeadas corretamente são mostradas com uma marca de seleção verde.
Campos opcionais: esses títulos de coluna são opcionais no arquivo de origem. Se os títulos das colunas corresponderem aos nomes para exibição da coluna, as colunas são automaticamente selecionadas nas listas suspensas correspondentes.
Colunas sem correspondência: se os cabeçalhos das colunas não corresponderem, as colunas não mapeadas são exibidas com um ponto de exclamação vermelho. Para mapear a coluna corretamente, selecione uma coluna a ser mapeada para o cabeçalho da coluna não mapeada do arquivo.
Ignorar (apenas para Campos Opcionais): escolha Ignorar na lista suspensa. Os dados de colunas ignoradas não são importados para seu aplicativo.
Conjunto de opções
Se qualquer coluna no arquivo de origem incluir um conjunto fixo de valores, mapeie a coluna para uma coluna do tipo Conjunto de Opções. Uma coluna desse tipo possui valores como Sim e Não ou Baixo e Alto.
Para fazer isso, selecione o 
botão ao lado da coluna do conjunto de opções, selecione os valores e escolha OK.
A lista suspensa de valores de opção combina os valores disponíveis no arquivo de entrada com aqueles que já estão no aplicativo. Por exemplo:
- Valores no arquivo de importação: Baixo, Alto
- Valores já existentes no aplicativo: Sem Interesse, Interessado, Muito Interessado
- Valores de destino resultantes: Sem Interesse, Interessado, Muito Interessado, Baixo, Alto
Após a importação, o assistente de importação adiciona todos os valores mapeados em seu aplicativo, mas descarta valores não mapeados do arquivo de importação que ainda não estão em seu aplicativo. Por exemplo, você poderia mapear o valor de origem "Baixo" para o valor de destino "Sem Interesse", mas mapear o valor de origem "Alto" para o (novo) valor de destino "Alto". Com base nesses mapeamentos, o assistente de importação cria "Alto" como um valor de destino do aplicativo. Ele não cria "Baixo" como um valor de destino do aplicativo, pois você não mapeou nenhuma origem para este valor de destino.
Nota
Você pode mapear uma coluna no arquivo de origem para uma coluna "Duas Opções" ou "Conjunto de Opções Multisseleção". Ao mapear para um "Conjunto de Opções Multiseleção", se o arquivo de origem incluir valores não disponíveis em seu aplicativo, novos valores poderão ser criados no Dataverse se o mapeamento de importação estiver definido como NotMapped. Se o mapeamento for definido como Ignorar, o registro poderá ser importado com êxito. Para campos "Conjunto de Opções multisseleção", os valores não são importados e nenhum novo valor é criado no ambiente de destino.
Mapear colunas de pesquisa
Se o arquivo de origem contiver dados que fazem referência a outras linhas existentes em seu aplicativo, mapeie a coluna no arquivo de origem para uma coluna de pesquisa em seu aplicativo.
Por exemplo, talvez você queira importar um arquivo nomeado Leads.csv, que contém linhas de cliente. A coluna Cliente em Leads.csv contém a conta associada ou os dados de contato. Para mapear esta coluna, selecione o botão Lookup Reference ao lado da coluna de pesquisa. A seção Pesquisar Referência será aberta e listará as tabelas relacionadas à tabela atual.
Para cada tabela, selecione as colunas a serem pesquisadas durante a importação para reter os relacionamentos entre as linhas e, em seguida, selecione OK.
Salvar configurações de mapeamento
Para salvar as configurações de mapeamento, insira um nome na caixa Dê um nome ao seu mapa de dados. Ao importar um conjunto de dados semelhante, você pode usar o mesmo mapeamento.
Abra o log de importação
Depois de iniciar uma importação, você pode monitorar o status do trabalho de importação e visualizar os resultados no log de importação.
Na última etapa do assistente de importação, selecione Acompanhar o Andamento para exibir o andamento do trabalho de importação.
Se você perdeu esta etapa, anexe o seguinte código à URL do seu aplicativo: &newWindow=true&pagetype=entitylist&etn=importfile&viewid=a2927069-e4dc-4e8f-8fb1-d2f6c40c427e&viewType=1039.
Por exemplo, se a URL do aplicativo for https://org12345.crm.dynamics.com/main.aspx?appid=00001111-aaaa-2222-bbbb-3333cccc4444, a URL para exibir o log de importação será 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.
Veja o status de uma importação e corrija os erros
Quando a importação for concluída, você poderá exibir os registros que foram importados com êxito, cuja importação falhou ou que foram parcialmente importados.
Em Minhas Importações, monitore o progresso da importação.
A coluna Status mostra o status da importação. O status avança por estes valores:
- Enviado
- Análise
- Transformando
- Importando
- Concluído
Nota
Para tabelas que incluam uma consulta autorreferente, as relações são resolvidas em duas fases durante o estágio Importação. Na primeira fase, os registros base são criados. Na segunda fase, as auto-referências são atualizadas para garantir a integridade dos dados.
Quando a importação é concluída, as colunas Êxito, Falhas e Falhas parciais mostram o número de registros que foram importados com êxito, não foram importados ou foram parcialmente importados.
Selecione um job de importação para ver os registros que não foram importados ou que foram parcialmente importados.
Selecione as guias apropriadas para ver informações sobre falhas, êxito ou falha parcial de registros durante a importação.
Na guia Falhas, exporte linhas que falharam na importação para um novo arquivo CSV. Selecione Exportar Linhas de Erro.
Corrija os erros neste arquivo e depois importe-o.
Excluir registros importados
Você pode excluir o arquivo de importação e os registros importados se quiser reimportar os dados ou se não precisar dos dados por algum motivo.
Selecione o arquivo de importação que deseja excluir e execute uma destas ações:
Excluir arquivo de origem da importação. Essa opção exclui o arquivo de log de importação e seus detalhes.
Excluir registros importados. Essa opção exclui todos os registros que foram importados do arquivo selecionado.
Excluir tudo. Essa opção exclui o arquivo de importação juntamente com os registros que foram importados do arquivo de importação.
Limitações
- A Importação do Excel não é compatível com tabelas virtuais ou tabelas elásticas
- A importação do Excel atualiza os campos da tabela primária, mas ignora os campos das tabelas relacionadas.
- Os trabalhos de importação do Excel são executados em paralelo somente quando o tamanho do arquivo está abaixo de 1 MB. Arquivos maiores que 1 MB são processados sequencialmente para evitar o esgotamento de recursos.
Nota
Para habilitar o processamento paralelo, mantenha cada arquivo abaixo de 1 MB. Para .zip arquivos, o tamanho descompactado também deve ter menos de 1 MB. Arquivos com caracteres especiais podem ter um tamanho calculado que excede 1 MB mesmo se o arquivo original aparecer menor.