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 em http://www.filemaker.com/downloads. Para obter informações gerais sobre XML e links para recursos XML, consulte o site do FileMaker em http://www.filemaker.com.

O FileMaker Pro oferece suporte à 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 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 Xerces e um processador de folha de estilo XSLT chamado Xalan. Conforme 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 locais 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 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 oferece suporte à importação e à exportação na gramática FMPXMLRESULT, esse poderá 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.

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)

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 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 usa um analisador XML baseado em Xerces e um processador XSLT baseado em Xalan para aplicar uma folha de estilo XSLT (se 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