Formato XML

El lenguaje Extensible Markup Language (XML) (lenguaje extensible de marcas) se utiliza para el intercambio de datos estructurados. Más que un formato de archivos rígido, XML es un lenguaje que define los formatos aceptados que pueden utilizar los grupos para intercambiar información. Numerosas personas, organizaciones y empresas utilizan XML para transferir información de productos, transacciones, datos de inventario y otros tipos de información empresarial.

Puede descargar archivos de ejemplo para la importación y la exportación de XML en la página Actualizaciones y notas de la versión. Para obtener información general sobre XML y enlaces a los recursos XML, consulte el sitio Web de Claris.

Importar XML

FileMaker Pro es compatible con la gramática FMPXMLRESULT para la importación XML. Si el material XML está en un formato diferente, puede aplicar una hoja de estilo Extensible Stylesheet Language for Transformations (XSLT) durante la importación para transformar el material XML a la gramática FMPXMLRESULT.

Exportar XML

FileMaker Pro puede exportar XML en dos gramáticas: FMPXMLRESULT y FMPDSORESULT. Puede aplicar una hoja de estilo XSLT durante la exportación para transformar cualquiera de las dos gramáticas en un formato XML diferente, o en un formato diferente como HTML o texto común. Por ejemplo, al exportar XML, puede crear una página Web controlada por datos o un archivo de texto de datos que utilice un delimitador de campo personalizado.

Nota  Las funciones de importación y exportación XML de FileMaker Pro utilizan un analizador XML llamado Xerces y un procesador de hoja de estilo XSLT llamado Xalan. Al desarrollar material XML y XSL, puede que le interese probar XML y XSLT con los analizadores y procesadores basados en Xerces y Xalan, disponibles en www.apache.org y otros sitios de otros fabricantes.

Gramática XML FMPDSORESULT

La gramática FMPDSORESULT es útil para exportar bases de datos con un formato de hojas de estilo en cascada o XSL. Esta gramática es compatible con el Objeto de origen de datos XML de Microsoft utilizado por Internet Explorer.

Nota  No asigne un nombre a los campos de datos con números al principio o caracteres kana de un solo byte (por ejemplo, "7"). La gramática FMPDSORESULT no permite caracteres numéricos kana de un solo byte como etiquetas de nombres de campo y no mostrará el archivo XML resultante en un navegador.

Cada elemento ROW en la gramática FMPDSORESULT exportada contiene un número de elementos FIELD que corresponde a los nombres de campo que exporta.

Los espacios o los dos puntos en los nombres de campo se convierten en caracteres de subrayado en los nombres de elemento (por ejemplo, <FIRST_NAME>). Los dos puntos dobles en los campos de portal se convierten en puntos (por ejemplo, <PHONE.PHONE_NUMBER>). Esto sucede porque los dos puntos se reservan para XML, ya que la especificación de los espacios de nombres y espacios no se permite en los nombres de elementos XML.

Para los campos repetidos y relacionados, cada elemento FIELD contendrá un elemento DATA que corresponde a cada registro de repetición o de portal.

La exportación XML no admite datos de campos contenedor.

Debido a las limitaciones de XML, sólo se exporta un registro de cada campo relacionado.

Gramática XML FMPXMLRESULT

La gramática FMPXMLRESULT contiene información adicional acerca de la base de datos que no se encuentra en la gramática FMPDSORESULT, como el número de registros, los tipos de campo y los formatos de campo. Estos elementos y atributos son necesarios para que el XML se valide correctamente.

Utilice la gramática FMPXMLRESULT si necesita la información METADATA ofrecida por la gramática. Debido a que FileMaker Pro admite la importación y exportación en la gramática FMPXMLRESULT, puede resultar un formato útil para transferir datos entre archivos de FileMaker Pro.

Nota  La gramática FMPXMLRESULT no es la más apropiada para las hojas de estilo en cascada (CSS). Utilice la gramática FMPDSORESULT si desea utilizar CSS con los datos XML.

En la gramática FMPXMLRESULT, el elemento DATABASE contiene los atributos NAME, RECORDS, DATEFORMAT, LAYOUT y TIMEFORMAT.

El atributo DATEFORMAT especifica el formato de fechas en el documento XML.

Campo

Completo

Abreviado

Año

aaaa (4 dígitos)

aa (2 dígitos)

Mes

mm (2 dígitos)

M (1 ó 2 dígitos)

Día

dd (2 dígitos)

d (1 ó 2 dígitos)

El atributo TIMEFORMAT especifica el formato de horas en el documento XML.

Campo

Completo

Abreviado

Hora (1 a 12)

hh (2 dígitos)

h (1 ó 2 dígitos)

Hora (1 a 24)

kk (2 dígitos)

k (1 ó 2 dígitos)

Minuto

mm

 

Segundo

ss

 

a.m./p.m.

a.

 

El elemento METADATA contiene uno o varios elementos FIELD y cada uno contiene información para uno de los campos/columnas, incluido el nombre del campo definido en la base de datos, el tipo de campo, existencia o no de campos vacíos (atributo EMPTYOK) y el número máximo de valores repetidos (atributo MAXREPEAT). Los valores válidos para los tipos de campo son TEXT, NUMBER, DATE, TIME, TIMESTAMP y CONTAINER.

El elemento RESULTSET contiene todos los elementos ROW que especifican los datos de registro en el XML. Cada elemento ROW contiene los datos de campo/columna de una fila en el conjunto de resultados, incluido el ID de registro de la fila, el ID de modificación de la fila y el elemento COL que contiene los datos de un campo/columna en la fila (donde varios elementos DATA representan uno de los valores en un campo repetido o de portal).

La exportación XML no admite datos de campos contenedor.

Debido a las limitaciones de XML, sólo se exporta un registro de cada campo relacionado.

El orden de los elementos COL corresponde al orden de los elementos FIELD en el elemento METADATA; por ejemplo, en el lugar donde se enumeran los elementos de "Nombre", "Apellido" y "Departamento" en METADATA, los elementos "Joe", "Smith" y "Ingeniería" se enumeran en el mismo orden en RESULTSET ROW.

Notas 

  • Antes de importar los datos con formato XML, FileMaker Pro utiliza un analizador de XML basado en Xerces y un procesador XSLT basado en Xalan para aplicar una hoja de estilo XSLT (si especificó una) para transformar los datos XML. Si aparece un mensaje de error, corrija el error y vuelva a importar.
  • Aunque el XML que importa debe ajustarse a la gramática FMPXMLRESULT, durante la importación no se utilizarán ciertos elementos y atributos. En esta tabla se definen los elementos y atributos que se utilizan durante la importación XML y muestra los valores predeterminados permitidos para los atributos. En la mayoría de los casos, los valores de atributo pueden ser nulos (como TIMEFORMAT=""). Asimismo, el elemento FMPXMLRESULT debería declarar siempre el espacio de nombre FileMaker para la gramática.
  • Elemento

    Atributos

    Usado durante la importación XML

    Valor predeterminado

    FMPXMLRESULT

     

    xmlns="http://www.filemaker.com/ fmpxmlresult"

    ERRORCODE

     

    No

     

    PRODUCT

     

    No

    " "

     

    NAME

    No

    " "

     

    VERSION

    No

    " "

     

    BUILD

    No

    " "

    DATABASE

     

    No

     

     

    NAME

    No

    " "

     

    RECORDS

    No

    " "

     

    DATEFORMAT

    No

    " "

     

    TIMEFORMAT

    No

    " "

     

    LAYOUT

    No

    " "

    METADATA

     

     

        FIELD

     

     

     

    NAME

    " "

     

    TYPE

    "TEXT", "DATE", "NUMBER", "TIME", "TIMESTAMP" o "CONTAINER"

     

    EMPTYOK

    No

    "YES" o "NO"

     

    MAXREPEAT

    No

    " "

    RESULTSET

     

     

     

    FOUND

    No

    " "

        ROW

     

     

     

    RECORDID

    No

    " "

     

    MODID

    No

    " "

        COL

     

     

          DATA