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

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.

Notas

  • 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 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", "CARIMBO DE DATA/HORA" 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