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.
Para obtener más información, consulte la Knowledge Base de FileMaker, disponible en http://filemaker-es.custhelp.com.
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
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. Por ejemplo, FileMaker Pro > Extras español > Ejemplos > carpeta XML Documentation.
<?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.fmp12" 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>