Importar registros

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

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 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 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 de 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.

Originada na versão 

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.

Notas 

• No FileMaker Go:
  • Somente a importação de um arquivo do FileMaker Pro para outro arquivo do FileMaker Pro é 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, 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 de 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
  • com a 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.

• Na opção Especificar fonte de dados, se você especificar uma variável,
• Para especificar um caminho de arquivo de variável ao escolher a opção Especificar fonte de dados e a opção Especificar ordem de importação, coloque primeiro a variável na lista de caminho, seguida pelo caminho até um arquivo local no formato que deseja importar. Ao escolher a opção Especificar ordem de importação, a etapa de script usará o primeiro caminho de arquivo que ela conseguir localizar. Como a etapa de script não pode avaliar a variável até que o script seja executado, ela usa o próximo arquivo de script na lista (o arquivo local), que permite escolher opções. No entanto, quando o script é executado, a etapa de script usará o caminho definido pela variável se a variável puder ser avaliada.

  Se você especificar somente uma variável e não quiser usar as opções Especificar ordem de importação, a caixa de diálogo Opção da primeira linha será exibida e permitirá escolher se a primeira linha apresentará os nomes de campo.

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