Formato XML

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 Atualizações e notas de versão. Para obter informações gerais sobre XML e links para recursos XML, consulte o Site da Claris.

Importação de XML

O FileMaker Pro é 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.

Exportação para XML

O FileMaker Pro 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 usam um analisador XML chamado libxml2 e um processador de folha de estilo XSLT chamado libxslt. Ao desenvolver XML e XSL, você pode querer testar seu XML e XSLT com analisadores e processadores baseados em libxml2- e libxslt, como as ferramentas de linha de comando xmllint e xsltproc, respectivamente, disponíveis no macOS. Para obter mais informações, consulte os repositórios libxml2 e libxslt ou outros locais de terceiros.

Gramática XML FMPDSORESULT

A gramática FMPDSORESULT é útil para exportar bancos de dados que deseja formatar com folhas de estilo em cascata ou XSL.

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.

Gramática XML FMPXMLRESULT

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

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)
Month	mm (2 dígitos)	M (1 ou 2 dígitos)
Day	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, CARIMBO DE DATA/HORA 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).