Referência > Referências de etapas de script > Etapas de script de registros > Importar registros
 

Importar registros

Importa os registros de uma fonte de dados ou um arquivo especificado.

Consulte também 

Opções 

Com diálogo especifica se as caixas de diálogo relacionadas a importação serão exibidas quando a etapa de script for realizada. 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.

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 Advanced usará o primeiro caminho que localizar como o arquivo a ser importado. Consulte Criação de caminhos de arquivo.

Se a caixa de diálogo Opção da primeira linha aparecer depois que você especificar uma fonte de dados, será possível escolher se a primeira linha deverá ser usada como nomes de campo. No entanto, se você usar a opção Especificar ordem de importação, poderá escolher qualquer registro para ser usado como nomes de campo ao importar de certos formatos de arquivo indicados em Formatos de arquivo de importação/exportação suportados.

Se você especificar um arquivo com um delimitador de campo personalizado na caixa de diálogo Especificar arquivo, em Tipo de arquivo, escolha Valores separados de personalização e especifique o delimitador de campo.

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 Advanced usará o primeiro caminho que localizar como a pasta a ser importada. Consulte Importação de uma pasta de arquivos de uma vez e Criação de caminhos de arquivo. Essa opção não é compatível com o FileMaker WebDirect e com scripts do lado do servidor.

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, o resultado de uma solicitação HTTP ou um cálculo que gera um caminho de arquivo ou uma solicitação HTTP. 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. 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 define se os registros devem ser adicionados, atualizados ou substituídos no conjunto encontrado atual e como os campos de origem são mapeados para os campos de destino quando a etapa de script é executada. Consulte Configuração da ação de importação e mapeamento de campos durante a importação.

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.

Verificar certificados SSL verifica o certificado SSL do servidor especificado em uma solicitação HTTP para dados XML. Se o certificado não puder ser verificado, o usuário poderá optar por conectar-se mesmo assim ou cancelar para ignorar esta etapa de script. Se o certificado não puder ser verificado e a Etapa de script Definir captura de erro estiver definida como Ativado, essa etapa de script se comportará como se o servidor estivesse indisponível.

Compatibilidade 

 

Produto 

Suportado 

FileMaker Pro Advanced 

Sim 

FileMaker Go 

Parcial 

FileMaker WebDirect 

Parcial 

FileMaker Server 

Parcial 

Produto FileMaker Cloud 

Parcial 

FileMaker Data API 

Não 

Publicação na Web personalizada 

Não 

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.

Se você incluir essa etapa de script em um script no lado do servidor e definir Com diálogo como Ativado, a opção ficará esmaecida. No entanto, essa etapa de script será executada. O comportamento será equivalente a se Com diálogo estiver definido como Desativado. Consulte Função Get (DocumentsPathListing) para obter mais informações.

Se você executar um script no lado do servidor para realizar qualquer um dos procedimentos a seguir, um erro será retornado:

importar registros para uma nova tabela

importar registros de uma pasta

importar imagens para um campo de container

Consulte Importação de dados no FileMaker Pro Advanced.

Notas 

No FileMaker Go:

Somente a importação de um arquivo do FileMaker Pro Advanced para outro arquivo do FileMaker Pro Advanced é compatível.

A importação para uma nova tabela não é compatível.

No FileMaker WebDirect:

Esta etapa de script não é compatível com navegadores móveis.

A opção Especificar fonte de dados não é compatível. Os usuários devem especificar um arquivo acessível pelo navegador.

Somente a importação de formatos de arquivos do FileMaker Pro Advanced, valores separados por vírgula, valores separados por tabulação, DBF, mesclagem e Excel é compatível.

Os scripts no lado do servidor podem acessar somente determinadas pastas. Consulte Caminhos em scripts no lado do servidor.

Os scripts do lado do servidor, o FileMaker Go e o FileMaker WebDirect serão compatíveis com as opções a seguir somente se Com diálogo estiver configurado como Desativado:

arquivos de origem no formato valores separados de personalização

qualquer linha como nomes de campo; se Com diálogo estiver configurado como Ativado, somente a primeira linha poderá ser especificada

execução de opções para inserir automaticamente em campos individuais

No FileMaker WebDirect, se essas opções estiverem predefinidas nessa etapa de script e Com diálogo estiver configurado como Ativado, as opções que os usuários escolherem quando o script for executado substituirão as opções predefinidas.

Exemplo 1 

Importa informações de Novo catálogo de produtos.xlsx como novos registros sem perguntar ao usuário.

Ir para layout [ "Produtos" (Produtos) ; Animação: Nenhum ]
Importar registros [ Com diálogo: Desativado ; Tabela: Produtos ; Origem: "Novo catálogo de produtos.xlsx" ; Planilha: "Estoque" ; Adicionar ; Mac Romano]

Exemplo 2 

Substitui os registros existentes com informações de Novo catálogo de produtos.xlsx.

Ir para layout [ "Produtos" (Produtos) ; Animação: Nenhum ]
Classificar registros [ Restaurar ; Com diálogo: Desativado ]
Ir para registro/solicitação/página [Primeiro]
Importar registros [ Com diálogo: Desativado ; Tabela: Produtos ; Origem: "Novo catálogo de produtos.xlsx" ; Planilha: "Estoque" ; Substituir ; Mac Romano ]

Exemplo 3 

Define o próximo valor de série após a importação de registros. Isso é útil quando Executar opções de inserção automática ao importar não está selecionado para preservar datas e outras entradas automáticas.

Ir para layout [ "Produtos" (Produtos) ; Animação: Nenhum ]
Importar registros [ Com diálogo: Desativado ; Tabela: Produtos ; Origem: "Novo catálogo de produtos.xlsx" ; Planilha: "Estoque" ; Adicionar ; Mac Romano]
Definir próximo valor de série [ Produtos::ID do produto; Get ( TotalRecordCount ) + 1 ]
Classificar registros [ Restaurar ; Com diálogo: Desativado ]
Ir para registro/solicitação/página [Primeiro]

Tópicos relacionados 

Etapa de script Definir próximo valor de série

Etapa de script Exportar registros

Referência de etapas de script (lista em ordem alfabética)

Referência de etapas de script (lista de categoria)