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 libxml2 y un procesador de hoja de estilo XSLT llamado libxslt. A medida que desarrolle XML y XSL, es posible que desee probar sus XML y XSLT con analizadores y procesadores basados en libxml2- y libxslt, como las herramientas de línea de comandos xmllint y xsltproc, respectivamente, disponibles en macOS. Para obtener más información, consulte los repositorios libxml2 y libxslt u otras ubicaciones de terceros.
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.
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 el XML, FileMaker Pro utiliza un analizador de XML basado en libxml2 y un procesador XSLT basado en libxslt para aplicar una hoja de estilo XSLT (si ha especificado 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 |
|
Sí |
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 |
|
Sí |
|
FIELD |
|
Sí |
|
|
NAME |
Sí |
" " |
|
TYPE |
Sí |
"TEXT", "DATE", "NUMBER", "TIME", "TIMESTAMP" o "CONTAINER" |
|
EMPTYOK |
No |
"YES" o "NO" |
|
MAXREPEAT |
No |
" " |
RESULTSET |
|
Sí |
|
|
FOUND |
No |
" " |
ROW |
|
Sí |
|
|
RECORDID |
No |
" " |
|
MODID |
No |
" " |
COL |
|
Sí |
|
DATA |
|
Sí |
|