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:
- 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.
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. |
Compatibilidade
Produto | Compatível |
FileMaker Pro | Sim |
FileMaker Go | Parcial |
FileMaker WebDirect | Parcial |
FileMaker Server | Parcial |
FileMaker Cloud | Parcial |
FileMaker Data API | Não |
Publicação na Web personalizada | Não |
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]