Metadata-Version: 2.1
Name: xmes-dingtalk-connectflow-sdk
Version: 1.0.1
Summary: DingTalk Connection Platform Connection Flow SDK
License: MIT
Author: leslieliang
Author-email: zwliang98@163.com
Requires-Python: >=3.9
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Dist: requests (>=2.32.3,<3.0.0)
Description-Content-Type: text/markdown

## 概述
![Version](https://img.shields.io/badge/Version-v1.0.1-green)
![Python Version](https://img.shields.io/badge/Python-%E2%89%A53.9-blue)

`xmes-dingtalk-connectflow-sdk` 是钉钉连接平台自建连接流SDK（向美而生），通过该工具可以方便快捷的调用钉钉的连接流。

## 安装使用
```bash
pip install xmes-dingtalk-connectflow-sdk
```

## 功能特征
- 支持连接流 `多维表CURD_241217`

## 使用方法
### ComplexTable
该工具提供了连接流 `多维表CURD_241217` 的操作调用工具。
```python
from DingtalkConnectflowSDK import ComplexTable, GetterFilter, Updater

# 初始化ComplexTable对象
complextable = ComplexTable(flow_url='<连接流的同步协调URL>')

# 获取 Table 对象
table = complextable.get_table(did='<文档ID>', tid='<数据表ID>')

# 查询数据
filters = [
    GetterFilter(field='来源', operator='equal', value=['SDK', 'API'])
]
resp = table.get(size=10, fillters=filters)

# 新增数据
records = [
    {'标题': 'Test Record 1', '来源': 'SDK},
    {'标题': 'Test Record 2', '来源': 'SDK},
]
resp = table.add(records)

# 更新数据
records = [
    Updater(record_id='<记录ID>', fields={'来源': 'API'}),
    Updater(record_id='<记录ID>', fields={'来源': 'API'}),
]
resp = table.update(records)

# 删除数据
record_ids = ['<记录ID>', '<记录ID>']
resp = table.delete(record_ids)
```
