XML-format

XML (Extensible Markup Language) är ett språk för strukturerat datautbyte. Istället för ett statiskt filformat är XML ett språk som kan användas för att definiera överenskomna format för datautbyte mellan grupper. Många individer, organisationer och företag använder XML för överföring av produktinformation, transaktioner, lagerinformation och annan affärsinformation.

Du kan hämta exempelfiler för XML-import och -export från sidan Uppdateringar och viktig information. Mer allmän information om XML och länkar till XML-resurser finns på Claris webbplats.

Importera XML

FileMaker Pro stöder syntaxen FMPXMLRESULT för XML-import. Om XML-informationen har ett annat format kan du använda en XSLT-formatmall (Extensible Stylesheet Language for Transformations) vid importen för att transformera XML-koden till FMPXMLRESULT-syntax.

Exportera XML

FileMaker Pro kan exportera XML-data i två typer av syntax: FMPXMLRESULT och FMPDSORESULT. Du kan använda en XSLT-formatmall under exporten om du vill omvandla en syntax till ett annat XML-format eller till andra format, t ex HTML eller oformaterad text. Vid XML-export kan du t ex skapa databaserade webbsidor eller textfiler med data som använder egna fältavgränsare.

Obs!  Funktionerna för import och export av XML-data i FileMaker Pro använder XML-tolken libxml2 och XSLT-formatmallsprocessorn libxslt. När du utvecklar XML och XSL kanske du vill testa din XML och XSLT med libxml2- och libxslt-baserade tolkning- och bearbetningsverktyg, till exempel kommandoradsverktygen xmllint och xsltproc, respektive, som finns i macOS. Mer information finns på kodförråden libxml2 och libxslt eller andra platser hos tredje part.

FMPDSORESULT-grammatik för xml

Syntaxen FMPDSORESULT är användbar om du vill exportera databaser som du vill utforma med överlappande formatmallar eller XSL.

Obs!  Datafältnamn bör inte innehålla inledande siffror eller enbytes katakana-tecken (t ex "7"). FMPDSORESULT-syntaxen tillåter inte numeriska eller enbytes katakana-tecken som fältnamnsetiketter, och XML-filen kan därför inte visas i en webbläsare.

Varje ROW-element i den exporterade FMPDSORESULT-syntaxen innehåller ett antal FIELD-element som motsvarar fältnamnen som du har exporterat.

Blanksteg eller ett kolon i fältnamn omvandlas till understreck i elementnamnen (t.ex.<FIRST_NAME>). Två kolon i portalfält omvandlas till punkter (t.ex. <PHONE.PHONE_NUMBER>). Detta beror på att kolon är reserverade för namnuttryck i XML-kod och blanksteg inte är tillåtna i XML-elementnamn.

För repeterade fält och relaterade fält kommer alla FIELD-element att innehålla ett DATA-element som motsvarar varje repetition eller portalpost.

Export av data i containerfält stöds inte vid XML-export.

Beroende på XML-begränsningar exporteras endast en post från varje relaterat fält.

FMPXMLRESULT-grammatik för xml

FMPXMLRESULT-syntaxen innehåller ytterligare information om databasen utöver den information som finns i FMPDSORESULT-syntaxen, t ex antalet poster, fälttyper och fältformat. Dessa element och attribut krävs för att XML ska kunna kontrolleras ordentligt.

Använd FMPXMLRESULT-syntaxen om du har behov av den metadatainformation som ingår i den här syntaxen. Eftersom FileMaker Pro stöder både import och export i FMPXMLRESULT-syntax är detta ett användbart format för dataöverföring mellan FileMaker Pro-filer.

Obs!  FMPXMLRESULT-syntaxen är inte särskilt väl lämpad för överlappande formatmallar (CSS). Använd FMPDSORESULT-syntaxen om du vill använda CSS-mallar tillsammans med XML-data.

I FMPXMLRESULT-syntaxen innehåller DATABASE-elementen attributen NAME, RECORDS, DATEFORMAT, LAYOUT och TIMEFORMAT.

Attributet DATEFORMAT anger formatet för datum i XML-dokumentet.

Fält

Fullständigt format

Kortform

År

åååå (4 siffror)

åå (2 siffror)

Månad

mm (2 siffror)

M (1 eller 2 siffror)

Dag

dd (2 siffror)

d (1 eller 2 siffror)

Attributet TIMEFORMAT anger formatet för tid i XML-dokumentet.

Fält

Fullständigt format

Kortform

Timme (1-12)

tt (2 siffror)

t (1 eller 2 siffror)

Timme (1-24)

kk (2 siffror)

k (1 eller 2 siffror)

Minut

mm

 

Sekunder

ss

 

fm/em

a

 

Elementet METADATA innehåller ett eller flera FIELD-element där vart och ett innehåller information om ett fält eller en kolumn, inklusive fältets namn som det definieras i databasen, fälttypen, möjliga Ja/Nej-värden i tomma fält (EMPTYOK-attribut) och det maximala antalet upprepade värden (MAXREPEAT-attribut). Giltiga värden för fälttyper är TEXT, NUMBER, DATE, TIME, TIMESTAMP och CONTAINER.

RESULTSET-elementet innehåller alla ROW-element som specificerar informationen i posten i XML-koden. Varje ROW-element innehåller fält-/kolumndata för en rad i resultatet – inklusive post-ID för raden, ändrings-ID för raden och COL-elementet som innehåller data för ett fält/en kolumn i raden (där flera DATA-element motsvarar ett av värdena i ett repeterat fält eller ett portalfält).

Export av data i containerfält stöds inte vid XML-export.

Beroende på XML-begränsningar exporteras endast en post från varje relaterat fält.

Ordningen mellan COL-elementen motsvarar ordningen mellan FIELD-elementen i elementet METADATA, t.ex. där elementen "Förnamn", "Efternamn" och sedan "Avdelning" listas i METADATA. "Jan", "Svensson" och sedan "Utveckling" listas i samma ordning i RESULTSET ROW.

Kommentarer 

  • Innan XML-koden importeras använder FileMaker Pro en XSLT-formatmall (om du angett någon) med en libxml2-baserad XML-tolk och en libxslt-baserad XSLT-processor, för att transformera XML-data. Om ett felmeddelande visas åtgärdar du felet och importerar igen.

  • Även om XML-informationen som importeras måste följa FMPXMLRESULT-syntaxen används vissa element och attribut inte under importen. I följande tabell visas vilka element och attribut som används under XML-importen och de tillåtna standardvärdena för attributen. I de flesta fall är attributvärdena ett nollvärde (exempelvis TIMEFORMAT=""). FMPXMLRESULT-elementet ska också alltid innehålla FileMaker-namnuttrycket för syntaxen.

  • Element

    Attribut

    Används vid XML-import

    Standardvärde

    FMPXMLRESULT

     

    Ja

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

    ERRORCODE

     

    Nej

     

    PRODUCT

     

    Nej

    " "

     

    NAME

    Nej

    " "

     

    VERSION

    Nej

    " "

     

    BUILD

    Nej

    " "

    DATABASE

     

    Nej

     

     

    NAME

    Nej

    " "

     

    RECORDS

    Nej

    " "

     

    DATEFORMAT

    Nej

    " "

     

    TIMEFORMAT

    Nej

    " "

     

    LAYOUT

    Nej

    " "

    METADATA

     

    Ja

     

        FIELD

     

    Ja

     

     

    NAME

    Ja

    " "

     

    TYPE

    Ja

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

     

    EMPTYOK

    Nej

    "YES" eller "NO"

     

    MAXREPEAT

    Nej

    " "

    RESULTSET

     

    Ja

     

     

    FOUND

    Nej

    " "

        ROW

     

    Ja

     

     

    RECORDID

    Nej

    " "

     

    MODID

    Nej

    " "

        COL

     

    Ja

     

          DATA

     

    Ja