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 resultado; incluyendo 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 XML basado en Xerces y un procesador XSLT basado en Xalan para realizar las comprobaciones siguientes y encontrar errores en el XML (y en cualquier XSL):
  •
Verifica que el XML tenga un formato correcto. Para obtener más información, consulte la especificación XML, disponible en http://www.w3.org/XML/.
  •
Valida la fuente de datos XML entrante con respecto a su definición de tipo de documento (DTD), en caso de especificarse una.
  •
Si especifica una hoja de estilo XSLT, se aplica para transformar el XML.
  •
Valida el XML con respecto a la DTD FMPXMLRESULT que publica FileMaker.
Cuando el XML está en formato FMPXMLRESULT y se valida contra la DTD de FileMaker, XML no puede contener una DTD interna. Cualquier DTD interna (incluso DTD FMPXMLRESULT) hará que el analizador genere un mensaje de error y el proceso de importación se detendrá. El XML puede contener una referencia a cualquier DTD externa, que pasará por alto el analizador para favorecer la DTD FMPXMLRESULT.
  •
Aunque el XML que importa debe ajustarse a la gramática FMPXMLRESULT, durante la importación no se utilizarán ciertos elementos y atributos. Estos elementos y atributos son necesarios para que el XML se valide correctamente. 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 los atributos pueden ser nulos (como TIMEFORMAT=""), pero los atributos TYPE y EMPTYOK requieren un valor. Asimismo, el elemento FMPXMLRESULT deberìa declarar siempre el espacio de nombre FileMaker para la gramática.
 
Elemento
Atributos
Utilizado 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ì
 
Ejemplo de datos XML en la gramática FMPXMLRESULT
El siguiente es un ejemplo de datos XML en la gramática FMPXMLRESULT. Para obtener más detalles sobre la definición del tipo de documento (DTD) para la gramática, consulte el archivo fmpxmlresult_dtd.htm, que se encuentra en la carpeta Extras del idioma donde se ha instalado la aplicación FileMaker Pro.
<?xml version="1.0" encoding="UTF-8"?>
<FMPXMLRESULT xmlns="http://www.filemaker.com/fmpxmlresult">
<ERRORCODE>0</ERRORCODE>
<PRODUCT BUILD="5/23/2002" NAME="FileMaker Pro"
VERSION="7.0"/>
<DATABASE DATEFORMAT="MM/dd/yy" LAYOUT="summary"
NAME="Employees.fp7" RECORDS="23" TIMEFORMAT="hh:mm:ss"/>
<METADATA>
<FIELD EMPTYOK="NO" MAXREPEAT="1" NAME="Nombre" TYPE="TEXT"/>
<FIELD EMPTYOK="NO" MAXREPEAT="1" NAME="Apellidos" TYPE="TEXT"/>
<FIELD EMPTYOK="YES" MAXREPEAT="1" NAME="Departamento" TYPE="TEXT"/>
</METADATA>
<RESULTSET FOUND="2">
<ROW MODID="47" RECORDID="34">
<COL>
<DATA>Joe</DATA>
</COL>
<COL>
<DATA>Smith</DATA>
</COL>
<COL>
<DATA>Ingenierìa</DATA>
</COL>
</ROW>
<ROW MODID="89" RECORDID="78">
<COL>
<DATA>Susan</DATA>
</COL>
<COL>
<DATA>Jones</DATA>
</COL>
<COL>
<DATA>Marketing</DATA>
</COL>
</ROW>
</RESULTSET>
</FMPXMLRESULT>