Importar registros
 
Propósito 
Importa os registros de uma fonte de dados ou um arquivo especificado.
Consulte também 
Importação de dados em um arquivo existente
Criação de scripts para automatizar tarefas
Formato 
Importar registros [Sem caixa de diálogo; "<fonte ou nomedoarquivo>"; Adicionar/Atualizar existentes/Atualizar correspondência; <plataforma e conjunto de caracteres>]
Opções 
 •
Realizar sem caixa de diálogo impede a exibição de caixas de diálogo relacionadas à importação quando a etapa de script é executada. No entanto, se um arquivo de fonte de dados não tiver sido especificado, a caixa de diálogo Abrir arquivo será exibida quando um script for executado no FileMaker Pro.
 •
Especificar fonte de dados especifica o arquivo ou a fonte dos dados a serem importados. Dependendo do arquivo ou da fonte escolhido, possivelmente uma caixa de diálogo será exibida para especificar as seguintes opções adicionais:
 
Quando escolher este arquivo ou fonte
Faça isso
Arquivo
Na caixa de diálogo Especificar, escolha o arquivo a ser importado ou digite os caminhos de arquivo diretamente na lista. Especifique um caminho por linha. O FileMaker Pro usará o primeiro caminho que localizar como o arquivo a ser importado. Consulte Criação de caminhos de arquivo.
Pasta
Na caixa de diálogo Importação de pasta de arquivos, escolha a pasta de arquivos de imagem ou texto a ser importada, ou digite os caminhos de pasta diretamente na lista. Especifique um caminho por linha. O FileMaker Pro usará o primeiro caminho que localizar como a pasta a ser importada. Para obter informações, consulte Importação de uma pasta de arquivos de uma vez e Criação de caminhos de arquivo. Esta opção não é aceita nos scripts em execução no FileMaker Server.
Dados XML
Na caixa de diálogo Especificar opções de XML e XSL, escolha a fonte dos dados XML a ser importada e escolha uma folha de estilo XSLT caso queira aplicar uma antes da importação. A fonte XML e XSLT pode ser um arquivo ou o resultado de uma solicitação HTTP, ou um cálculo que gera um caminho de arquivo ou uma solicitação HTTP. Para obter mais informações, consulte Importação de dados XML.
Dados de ODBC
Especifique o nome e o local da fonte de dados, a ID do usuário e a senha (se houver), e a consulta SQL a ser executada. Insira uma consulta diretamente ou especifique um cálculo para gerar a consulta. Para obter mais informações, consulte Automatização da importação de ODBC usando a etapa de script Importar registros.
As instruções SQL têm o limite máximo de 256 K caracteres (512 KB).
Nota  Se você usar a etapa de script Importar registros para importar dados ODBC que contêm cadeias Unicode, o driver de ODBC deverá aceitar Unicode. Do contrário, os resultados possivelmente serão inconsistentes.
 •
Especificar ordem de importação instrui o FileMaker Pro a usar uma ordem de importação predefinida. A última ordem de importação usada no arquivo aparece como valor padrão e pode ser editada. Esta opção também permite que você especifique se manterá os dados do campo repetido juntos ou se dividirá os campos repetidos em registros separados, bem como se adicionará novos registros, substituirá dados no conjunto encontrado atual ou importará os dados como uma nova tabela.
Nota  Quando os campos de origem e destino de importação são mapeados através de nomes correspondentes, a correspondência de nome de campo é feita dinamicamente cada vez que a etapa de script e executada.
Compatibilidade 
 
Onde a etapa de script é executada 
Formato 
FileMaker Pro 
Sim 
Script programado do FileMaker Server 
Parcial 
FileMaker Go 
Parcial 
Publicação na Web personalizada 
Não 
FileMaker WebDirect 
Parcial 
Solução runtime 
Sim 
Originado em 
FileMaker Pro 6.0 ou anterior
Descrição 
É possível definir a ordem de importação e usar a opção Especificar ordem de importação, ou executar esta etapa de script com a caixa de diálogo, para que o usuário possa definir novos critérios, como importar dados como uma nova tabela.
Se o arquivo de origem for aberto, o conjunto encontrado será importado; se não for, todos os registros da tabela de origem serão importados.
Quando você incluir esta etapa de script em um script programado do FileMaker Server e não selecionar Realizar sem caixa de diálogo, o texto (NÃO compatível) aparecerá depois da etapa de script. No entanto, o script será executado. O comportamento será equivalente à seleção de Realizar sem caixa de diálogo. Consulte Get(DocumentsPathListing) função para obter mais informações.
Se você programar um script do FileMaker Server para realizar qualquer um dos procedimentos a seguir, um erro será emitido:
 •
importar registros para uma nova tabela
 •
importar registros de uma pasta
 •
importar imagens para um campo de container
Notas
 •
Saiba que há possíveis problemas de segurança que advêm do uso de https, httpspost e ftps. O FileMaker não pode executar uma verificação certificada para verificar se o servidor especificado é o servidor que responde. Se esses problemas de segurança não forem aceitáveis em sua situação, não utilize esta etapa de script.
 •
Ao usar as etapas de script Importar registros ou Exportar registros em um script programado do FileMaker Server, tenha em mente que:
 •
Qualquer arquivo especificado deve estar na pasta Documentos do FileMaker Server, na pasta temporária ou em uma pasta filho da pasta Documentos ou temporária do FileMaker Server. Por exemplo, estes são os caminhos válidos para o arquivo .csv:
<Documentos>/arquivo.csv
<Caminho temporário>/arquivo.csv
<Documentos>/Pasta1/arquivo.csv
<Caminho temporário>/Pasta1/Pasta2/Pasta3/Pasta4/arquivo.csv
 •
Qualquer caminho especificado que não seja um caminho completo para o arquivo (por exemplo, qualquer caminho diferente de /Macintosh HD/Library/FileMaker Server/Data/Documents/<0 ou mais diretórios>/<nomedoarquivo>) será avaliado como relativo ao caminho temporário.
 •
Qualquer caminho que inclua ".." será considerado inválido.
 •
Para o FileMaker Pro, se um caminho absoluto não for especificado em um script que será executado, o caminho será assumido como relativo ao local do arquivo de banco de dados em que o script foi executado. Por exemplo, se um script contendo a etapa de script Exportar registros for executado com o caminho arquivo:/export.tab, e o arquivo que está executando o script for /MyFiles/Library/Books.fmp12, o arquivo exportado será criado como /MyFiles/Library/export.tab.
 •
O suporte à importação de fotos de uma câmera digital ou dispositivo foi removido do FileMaker Pro.
 •
Se um script criado em uma versão anterior do FileMaker Pro contiver uma etapa de script Importar registros [câmera digital], a etapa será comentada como obsoleta. Você pode remover a etapa, mas não pode editá-la.
 •
Se um botão fizer referência à etapa de script Importar registros [câmera digital], o botão será desativado e a etapa Importar registros será comentada como obsoleta na caixa de diálogo Configuração de botão.
 •
O FileMaker Go aceitará somente a importação de um arquivo do FileMaker Pro para outro arquivo do FileMaker Pro.
 •
O FileMaker Go não é compatível com a importação para uma nova tabela.
 •
Ao usar esta etapa de script no FileMaker WebDirect, lembre-se do seguinte:
 •
O FileMaker WebDirect não é compatível com esta etapa de script em navegadores móveis.
 •
O FileMaker WebDirect não é compatível com as opções Realizar sem caixa de diálogo ou Especificar arquivo de origem.
 •
O FileMaker WebDirect é compatível apenas com a importação dos seguintes formatos de arquivo: Texto separado por vírgula, Texto separado por tabulação, DBF, Mesclagem e Excel.
Exemplo 1 
Importa informações de Novo catálogo de produtos.xlsx como novos registros sem perguntar ao usuário.
Ir para layout ["Produtos"]
Importar registros [Sem caixa de diálogo; Fonte: "Novo catálogo de produtos.xlsx"; Planilha: "Estoque"; Adicionar; Mac Romano]
Exemplo 2 
Atualiza os registros existentes com informações de Novo catálogo de produtos.xlsx.
Ir para layout ["Produtos"]
Classificar registros [Restaurar; Sem diálogo]
Ir para registro/solicitação/página [Primeiro]
Importar registros [Sem caixa de diálogo; Fonte: "Novo catálogo de produtos.xlsx"; Planilha: "Estoque"; Atualizar correspondente; Mac Romano]
Exemplo 3 
Define o próximo valor de série após a importação de registros. Útil quando Realizar opções de inserção automática durante importação não está selecionada para preservar datas e outras entradas automáticas.
Ir para layout ["Produtos"]
Importar registros [Sem caixa de diálogo; Fonte: "Novo catálogo de produtos.xlsx"; Planilha: "Estoque"; Adicionar; Mac Romano]
Definir próximo valor de série [Faturas::ID da fatura; Get(TotalRecordCount) + 1]
Classificar registros [Restaurar; Sem diálogo]
Ir para registro/solicitação/página [Primeiro]
Tópicos relacionados 
Definir próximo valor de série etapa de script
Exportar registros etapa de script
Referência de etapas de script (lista em ordem alfabética)
Referência de etapas de script (lista de categorias)