Extensible Markup Language (XML) é uma linguagem para intercâmbio de dados estruturado. Em vez de ser um formato de arquivo rígido, XML é uma linguagem para definir formatos definidos que grupos podem usar para trocar dados. Muitas pessoas, organizações e empresas usam XML para transferir informações sobre o produto, transações, inventário e outros dados de negócios.
Arquivos de exemplo para a importação e exportação de XML estão disponíveis para download na página de downloads e recursos. Para obter informações gerais sobre XML e links para recursos XML, consulte o site da FileMaker.
O FileMaker Pro Advanced é compatível com a gramática FMPXMLRESULT para importação de XML. Caso o XML esteja em um formato diferente, você poderá aplicar uma folha de estilo Extensible Stylesheet Language for Transformations (XSLT) durante a importação para transformar o XML na gramática FMPXMLRESULT.
O FileMaker Pro Advanced pode exportar XML em duas gramáticas: FMPXMLRESULT e FMPDSORESULT. Você pode aplicar uma folha de estilo XSLT durante a exportação para transformar uma das gramáticas em um formato XML diferente ou em um formato diferente como HTML ou texto simples. Por exemplo, com a exportação XML, você pode criar uma página da Web orientada a dados ou um arquivo de texto de dados que usa um delimitador de campo personalizado.
Nota Os recursos de importação e exportação de XML no FileMaker Pro Advanced usam um analisador XML chamado Xerces e um processador de folha de estilo XSLT chamado Xalan. Conforme você desenvolve XML e XSL, é possível testar o XML e o XSLT com analisadores e processadores baseados em Xerces e Xalan, disponíveis em http://www.apache.org e outros sites de terceiros.
A gramática FMPDSORESULT é útil para exportar bancos de dados que deseja formatar com folhas de estilo em cascata ou XSL. Essa gramática é compatível com o Microsoft XML Data Source Object usado pelo Internet Explorer.
Nota Não nomeie seus campos de dados com números à esquerda ou caracteres kana de byte único (por exemplo, "7"). A gramática FMPDSORESULT não permite caracteres kana de byte único ou numérico como etiquetas de nome de campo e não mostrará o arquivo XML resultante em um navegador.
Cada elemento ROW na gramática FMPDSORESULT exportada contém um número de elementos FIELD que correspondem aos nomes de campo exportados.
Espaços e dois-pontos únicos em nomes de campo são convertidos em sublinhados nos nomes de elemento (por exemplo, <PRIMEIRO_NOME>). Dois-pontos duplos em campos de portal são convertidos em pontos (por exemplo, TELEFONE.NÚMERO_DE_TELEFONE). Isso é feito porque os dois-pontos são reservados em XML para especificar namespaces, e espaços não são permitidos em nomes de elemento XML.
Para campos de repetição e relacionados, cada elemento FIELD ter um elemento DATA que corresponde a cada registro de repetição ou portal.
A exportação de XML não suporta a exportação de dados de campo de container.
Devido a limitações de XML, somente um registro de cada campo relacionado é exportado.
A gramática FMPXMLRESULT contém informações adicionais sobre o banco de dados que não está na gramática FMPDSORESULT, como o número de registros, tipos de campo e formatos de campo. Esses elementos e atributos são necessários para que o XML seja validado corretamente.
Use a gramática FMPXMLRESULT se você precisar das informações de METADATA fornecidas por essa gramática. Como o FileMaker Pro Advanced é compatível com a importação e a exportação com a gramática FMPXMLRESULT, esse pode ser um formato útil para transferir dados entre arquivos do FileMaker Pro Advanced.
Nota A gramática FMPXMLRESULT não é adequada para uso com folhas de estilo em cascata (CSS). Use a gramática FMPDSORESULT se quiser usar CSS com seus dados XML.
Na gramática FMPXMLRESULT, o elemento DATABASE contém os atributos NAME, RECORDS, DATEFORMAT, LAYOUT e TIMEFORMAT.
O atributo DATEFORMAT especifica o formato de datas no documento XML.
Campo | Formulário completo | Formulário curto |
Ano | aaaa (4 dígitos) | aa (2 dígitos) |
Mês | mm (2 dígitos) | M (1 ou 2 dígitos) |
Dia | de (2 dígitos) | d (1 ou 2 dígitos) |
O atributo TIMEFORMAT especifica o formato de horas no documento XML.
Campo | Formulário completo | Formulário curto |
Hora (1-12) | hh (2 dígitos) | h (1 ou 2 dígitos) |
Hora (1-24) | kk (2 dígitos) | k (1 ou 2 dígitos) |
Minuto | mm |
|
Segundo | ss |
|
AM/PM | a |
|
O elemento METADATA contém um ou mais elementos FIELD, cada um contendo informações sobre um campo/coluna, incluindo o nome do campo conforme definido no banco de dados, o tipo de campo, a permissão Sim ou Não para campos vazios (atributo EMPTYOK) e o número máximo de valores de repetição (atributo MAXREPEAT). Os valores válidos para tipos de repetição são TEXT, NUMBER, DATE, TIME, TIMESTAMP e CONTAINER.
O elemento RESULTSET contém todos os elementos ROW que especificam os dados de registro no XML. Cada elemento ROW contém os dados de campo/coluna de uma linha no conjunto de resultados, incluindo a ID de registro da linha, a ID de modificação da linha e o elemento COL que contém os dados de um campo/coluna na linha (em que vários elementos DATA representam um dos valores em um campo de repetição ou portal).
A exportação de XML não suporta a exportação de dados de campo de container.
Devido a limitações de XML, somente um registro de cada campo relacionado é exportado.
A ordem dos elementos COL corresponde à ordem dos elementos FIELD no elemento METADATA, por exemplo, em que os elementos "Nome", "Sobrenome" e "Departamento" estão listados em METADATA, e "Joe" "Smith" e "Engenharia" estão listados na mesma ordem de RESULTSET ROW.
•Antes de importar o XML, o FileMaker Pro Advanced usa um analisador XML baseado em Xerces e um processador XSLT baseado em Xalan para aplicar uma folha de estilo XSLT (se você tiver especificado uma) para transformar os dados XML. Se uma mensagem de erro aparecer, corrija o erro e tente importar novamente.
•Embora o XML importado deva estar em conformidade com a gramática FMPXMLRESULT, certos elementos e atributos não são usados durante a importação. A seguinte tabela define quais elementos e atributos são usados durante a importação XML e lista os valores padrão permitidos para atributos. Na maioria dos casos, os valores de atributo podem ser nulos (como TIMEFORMAT=""). Além disso, o elemento FMPXMLRESULT deve sempre declarar o namespace FileMaker para a gramática.
Elemento | Atributos | Usado durante a importação de XML | Valor padrão |
FMPXMLRESULT |
| Sim | xmlns="http://www.filemaker.com/ fmpxmlresult" |
ERRORCODE |
| Não |
|
PRODUCT |
| Não | " " |
| NAME | Não | " " |
| VERSION | Não | " " |
| BUILD | Não | " " |
DATABASE |
| Não |
|
| NAME | Não | " " |
| RECORDS | Não | " " |
| DATEFORMAT | Não | " " |
| TIMEFORMAT | Não | " " |
| LAYOUT | Não | " " |
METADATA |
| Sim |
|
FIELD |
| Sim |
|
| NAME | Sim | " " |
| TYPE | Sim | "TEXT", "DATE", "NUMBER", "TIME", "TIMESTAMP" ou "CONTAINER" |
| EMPTYOK | Não | "YES" ou "NO" |
| MAXREPEAT | Não | " " |
RESULTSET |
| Sim |
|
| FOUND | Não | " " |
ROW |
| Sim |
|
| RECORDID | Não | " " |
| MODID | Não | " " |
COL |
| Sim |
|
DATA |
| Sim |
|