O FileMaker Pro Advanced pode importar dados XML para um arquivo existente do FileMaker Pro Advanced ou converter o XML em um novo arquivo do FileMaker Pro Advanced.
O XML pode ser um arquivo ou o resultado de uma solicitação HTTP enviada a um servidor Web. Por exemplo, é possível configurar um banco de dados Ordens para enviar números de acompanhamento a uma empresa de fornecimento de embalagens na forma de uma solicitação HTTP, e o seu servidor Web poderá retornar as informações de acompanhamento do pacote mais recentes no formato XML, prontas para serem importadas no banco de dados Ordens.
O XML importado deve estar em conformidade com a definição de tipo de documento (DTD) do FileMaker FMPXMLRESULT. Caso o XML esteja em um formato diferente, você poderá aplicar uma folha de estilo Extensible Stylesheet Language (XSLT) durante a importação para transformar o XML na gramática FMPXMLRESULT. Consulte Formato XML.
1. O que você faz primeiro depende de estar importando XML para um arquivo existente do FileMaker Pro Advanced ou convertendo XML em um novo arquivo do FileMaker Pro Advanced.
Para importar XML | Faça isso |
Para um arquivo existente do FileMaker Pro Advanced | Avance para a etapa 2. |
Ao converter o XML em um novo arquivo do FileMaker Pro Advanced | Vá para a etapa 8. |
2. Ao atualizar registros correspondentes ou substituir registros existentes, faça uma cópia de backup do arquivo de destino.
Importante A atualização de registros correspondentes ou a substituição de registros existentes substitui os dados no arquivo de destino e não pode ser desfeita. Para proteger seus dados, escolha o menu Arquivo > Salvar cópia como para criar uma cópia em backup do arquivo de destino do FileMaker Pro Advanced. Você pode fazer isso apenas para um arquivo local (localizado no seu computador). Certifique-se de entender como a atualização ou substituição de registros funciona. Consulte Importação de dados no FileMaker Pro Advanced.
3. No FileMaker Pro Advanced, abra o arquivo de destino.
4. Se o arquivo de destino tiver várias tabelas, use o menu pop-up Layout para exibir um layout que mostra registros da tabela na qual deseja importar os dados.
5. Ao atualizar registros correspondentes ou substituir registros existentes, proceda da seguinte forma antes de importar. (se estiver adicionando novos registros, vá para a próxima etapa.)
•Se estiver atualizando registros correspondentes, verifique se o conjunto encontrado tem somente os registros que deseja atualizar. Os registros fora do conjunto encontrado não serão atualizados, mesmo se os dados do campo correspondente corresponderem.
•Se estiver substituindo registros existentes no arquivo, verifique se o conjunto encontrado tem somente os registros que deseja alterar. Se necessário, classifique os registros de forma que os dados do registro correto no arquivo de origem substituam os dados de cada registro no arquivo de destino.
6. Escolha o menu Arquivo > Importar registros > Fonte de dados XML.
A caixa de diálogo Especificar opções de XML e XSL é exibida.
7. Vá para a etapa 10.
Você deve seguir apenas as etapas de 8 a 9 se estiver convertendo XML em um novo arquivo do FileMaker Pro Advanced.
8. Escolha o menu Arquivo > Abrir.
9. Na caixa de diálogo Abrir arquivo, para Arquivos do tipo (Windows) ou Mostrar (macOS), escolha Fonte de dados XML.
A caixa de diálogo Especificar opções de XML e XSL é exibida.
10. Para Especificar fonte de dados XML, escolha a fonte dos dados XML a serem importados.
A fonte XML pode ser um arquivo ou o resultado de uma solicitação HTTP.
11. Para aplicar uma folha de estilo XSLT ao XML antes da importação, selecione Usar folha de estilo XSL e especifique a fonte da folha de estilo XSLT.
Quando o XML sendo importado não estiver em conformidade com a DTD FMPXMLRESULT, você deverá aplicar uma folha de estilo XSLT que transforma o XML na gramática correta. A fonte XSLT pode ser um arquivo ou o resultado de uma solicitação HTTP.
12. Clique em Continuar.
Usando um analisador XML baseado em Xerces e um analisador XSLT baseado em Xalan, o FileMaker Pro Advanced aplica uma folha de estilo XSLT (caso uma seja especificada) para transformar os dados XML. Se uma mensagem de erro aparecer, corrija o erro e tente importar novamente.
13. Escolha a ação de importação para execução e associe os campos no arquivo de destino aos dados que deseja importar do arquivo de origem. (Consulte Configuração da ação de importação e mapeamento de campos durante a importação.) Escolha opções na caixa de diálogo e depois clique em Importar.
Ao converter o XML em um novo arquivo do FileMaker Pro Advanced, digite um nome para o novo arquivo, escolha um local e clique em Salvar.
•Para obter detalhes sobre os requisitos para um XML bem formado, consulte a especificação XML, que está disponível em www.w3.org/XML/.
•O FileMaker Pro Advanced usa o analisador XML Xerces-C++, que é compatível com dados XML nas seguintes codificações de caracteres:
•ASCII
•UTF-8
•UTF-16 (Big/Small Endian)
•UCS4 (Big/Small Endian)
•EBCDIC nas codificações IBM037 e IBM1140
•ISO-8859-1 (Latin1)
•Windows-1252
Embora Windows-1252 seja a codificação de caracteres padrão no Windows, essa codificação de caracteres não é amplamente reconhecida por outras ferramentas de processamento XML. Se estiver usando uma ferramenta de edição baseada em Windows para gerar XML, verifique a declaração encoding="..." para ver qual conjunto de caracteres ela gera. Consulte as perguntas frequentes sobre Xerces C++ no site da Apache: xerces.apache.org/xerces-c/.
•Na Etapa de script Importar registros, ao especificar Dados XML como a fonte de dados, você pode especificar caminhos para os dados XML e a folha de estilo XLS de duas formas:
•Em Arquivo, o caminho deve estar no formato do FileMaker (consulte Criação de caminhos de arquivo).
•Em Cálculo, o caminho deve ser o caminho completo no formato do sistema operacional. Por exemplo:
Windows: letradaunidade:\NomeDoDiretório\NomeDoArquivo
macOS: /NomeDoDiretório/NomeDoArquivo
Se você estiver fornecendo uma solução entre multi-plataformas, poderá usar a Função Get (SystemPlatform) para identificar a plataforma atual e usar o formato correto para cada plataforma.