fmkr 2022.9.28

需求

此版本已与以下需求和依赖项进行测试（其他版本可能也有效）

• CPython 3.8.10, 3.9.13, 3.10.7, 3.11.0rc2

• Lxml 4.9.1

• FileMaker™ Server 8 Advanced

修订

2022.9.28

• 使用 Sphinx 指令将文档字符串转换为 Google 风格。

2022.3.24

• 添加类型提示。

• 改进对象字符串表示。

• 向 FMPXMLResult 添加不可变序列接口。

• 移除对 Python 3.6 和 3.7 的支持（NEP 29）。

2021.3.6

• 更新版权和格式。

2020.1.1

• 移除对 Python 3.5 的支持。

• 更新版权。

2018.8.15

• 将 fmkr.py 移入 fmkr 包。

2018.5.25

• 使用 lxml 替代 minidom 解析 FMPXMLResult。

• 改进 FMPXMLResult 和 FMField 的字符串表示。

• 更新错误代码。

• 移除对 Python 2 的支持。

2006.10.30

• 初始发布。

参考

1. http://www.filemaker.com/downloads/documentation/fmsa8_custom_web_guide.pdf

示例

>>> from fmkr import FM, FMError
>>> fmi = FM('filemaker.domain.com', 80, 'http')
>>> fmi.set_db_data('database', 'layout', maxret=5)
>>> fmi.set_db_password('fmuser', 'password')
>>> # create a new record
>>> fmi.add_db_param('FIRST', 'John')
>>> fmi.add_db_param('LAST', 'Doe')
>>> fmi.fm_new()
>>> # find and sort records
>>> fmi.add_db_param('LAST', 'Doe', 'bw')
>>> fmi.add_sort_param('LAST', 'ascend', 1)
>>> fmi.add_sort_param('FIRST', 'ascend', 2)
>>> result = fmi.fm_find()
>>> for record in result:
...     print(record['FIRST'], record['LAST'])
John Doe
>>> # delete record
>>> recid = result[0]['RECORDID']
>>> fmi.set_record_id(recid)
>>> fmi.fm_delete()
>>> # catch an exception
>>> try:
...    fmi.add_db_param('LAST', 'Doe', 'cn')
...    fmi.fm_find()
... except FMError as exc:
...    print(exc)
FileMaker Error 401: No records match the request