Skip to main content

Python Object Wrapper for FileMaker Server XML Interface

Project description

Latest version of documentation and code is available at

PyFileMaker module is designed for both script and interactive use. Any command used during interactive session is possible to type in a script.

Short introduction

For the full and up to date reference go to

run python interactively (or better run ipython):

$ ipython

Setting of database and layout

In the beginnig you have to set the server, database and layout:

>> from PyFileMaker import FMServer

>> fm = FMServer('')
>> fm.
[and press Tab to see available methods and variables]
>> help fm.getDbNames
[displays help for the method]

>> fm.getDbNames()
>> fm.setDb('dbname')

>> fm.getLayoutNames()
>> fm.setLayout('layoutname')

You can also type directly:

>> fm = FMServer('','dbname','layoutname')

List fieldnames

Get the list of fields from the active layout:

>> fm.doView()
['column1', 'column2']

Find records

To search records:

>> fm.doFind(column1='abc')
<FMProResult instance with 2 records>
column2'='some data'
column2='another data'

You’ve got list of 2 records, usually you need to work only with one record:

>> a = fm.doFind(column1='abc')
>> len(a)
>> r = a[0]
>> r.
[press Tab for available layout variables or for completition of variable name]

>> r.column1
>> r['column1']
>> print r.column1
>> r.column.related

>> fm.doFind( column1='abc', column__related='abc', LOP='OR', SKIP=1, MAX=1)

Get latest record if documentID field is autoincremented during insertion in FileMaker:

>> fm.doFind( SORT=['documentID':'<'], MAX=1)

Or more low level access using dict - for operators, and non-ascii fields:

>> fm.doFind( {'documentID.op':'lt', '-max':1})

Any combination of attributes is allowed…

BTW For query empty record:

>> fm.doFind( column1='==')

Editing records

It’s enought when you change some variables inside of previosly returned record:

>> r = fm.doFindAny()[0]
>> r.column = 'NEWVALUE'
>> fm.doEdit(r)

This will update only changed column ‘column’ in table. You can use changed old record in other functions too - doDup, doNew, doDelete. doFind(r) will find record with the same RECORDID, but MODID is updated.

New records can be specified as arguments of doNew() like:

fm.doNew(column1='newvalue', column2='old')


The structure of returned data is suitable for use with Cheetah Templates. It is really easy to write a template:

import Cheetah.Template
t = Cheetah.Template.Template('''
Document Template
DocumentID: $documentID
DocumentType: $DocumentType.documentType

Item descriptions:
#for $l in $DocumentLine
 - $l.description
#end for
''', searchList=[r[0]])

Debugging connection

Best way howto debug what’s wrong:

>> fm._debug = True

then check printed url request by external tools (like curl, xmlstarlet):

$ curl '' | xmlstarlet fo

Error reporting

In case something is not running the way it should, please report an Issue on the the GitHub project New contributions to the code are welcomed.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for PyFileMaker, version 3.3
Filename, size File type Python version Upload date Hashes
Filename, size PyFileMaker-3.3.tar.gz (19.8 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page