Flutter企业云管理API插件k3cloud_api的使用

简介

k3cloud_api 是一个基于 Dart 编写的 Kingdee Cloud API 客户端。它可以帮助开发者通过 Flutter 应用程序与 Kingdee Cloud 进行交互，实现企业云管理功能。

示例

1. 登录

首先，您需要调用 KdApi.login 方法进行登录操作。该方法需要传入服务器地址、AppId、账号和密码作为参数。

// 登录到 Kingdee Cloud
var loginInfo = await KdApi.login(
    "http://Your Server IP", // 替换为您的服务器IP地址
    "60d19671dd1820",        // 替换为您的AppId
    "account",               // 替换为您在Kingdee Cloud中的账号
    "password"               // 替换为您在Kingdee Cloud中的密码
);

// 检查登录是否成功
if (!loginInfo.isLoginSuccess) {
    debugPrint("登录失败!"); // 如果登录失败，打印错误信息
    return;
}

2. 查询数据

登录成功后，您可以使用 KdApi.query 方法查询指定表单的数据。例如，查询销售订单表单 (SAL_SALEORDER) 中的单据编号 (FBillNo) 和客户编号 (FCustId)。

// 查询销售订单数据
var resp = await KdApi.query(
    formId: "SAL_SALEORDER", // 表单ID
    fieldKeys: ["FBillNo", "FCustId"] // 需要查询的字段
);

// 打印查询结果
debugPrint(resp.toString());

注意事项

参数替换：
- 在实际使用时，请将 "http://Your Server IP" 替换为您的 Kingdee Cloud 服务器的实际地址。
- 将 "60d19671dd1820" 替换为您的 AppId。
- 将 "account" 和 "password" 替换为您的 Kingdee Cloud 账号和密码。
依赖安装：
- 确保在 pubspec.yaml 文件中添加了 k3cloud_api 插件依赖。
```
dependencies:
  k3cloud_api: ^1.0.0
```

更多关于Flutter企业云管理API插件k3cloud_api的使用的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html

songsunli 1楼•12 天前

更多关于Flutter企业云管理API插件k3cloud_api的使用的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html

k3cloud_api 是一个用于与金蝶K/3 Cloud系统进行交互的Flutter插件。它提供了一组API，允许开发者在Flutter应用中调用K/3 Cloud的云管理功能，如数据查询、单据操作、用户认证等。

以下是使用 k3cloud_api 插件的基本步骤和示例：

1. 添加依赖

首先，在 pubspec.yaml 文件中添加 k3cloud_api 插件的依赖：

dependencies:
  flutter:
    sdk: flutter
  k3cloud_api: ^1.0.0  # 请使用最新版本

然后运行 flutter pub get 来获取依赖。

2. 初始化插件

在你的Flutter应用中，首先需要初始化 k3cloud_api 插件。通常你可以在 main.dart 中进行初始化：

import 'package:flutter/material.dart';
import 'package:k3cloud_api/k3cloud_api.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  
  // 初始化K3Cloud API
  await K3CloudApi.initialize(
    baseUrl: 'https://your-k3cloud-server.com',  // K/3 Cloud服务器的URL
    appId: 'your-app-id',                       // 应用ID
    appSecret: 'your-app-secret',               // 应用密钥
  );

  runApp(MyApp());
}

3. 用户认证

在调用K/3 Cloud的API之前，通常需要进行用户认证。你可以使用 login 方法进行认证：

bool isLoggedIn = await K3CloudApi.login(
  username: 'your-username',
  password: 'your-password',
);

if (isLoggedIn) {
  print('登录成功');
} else {
  print('登录失败');
}

4. 调用API

一旦认证成功，你就可以调用K/3 Cloud的各种API了。以下是一些常见的API调用示例：

查询数据

var result = await K3CloudApi.query(
  formId: 'BD_Material',  // 表单ID
  filter: 'FNumber like \'%MAT%\'',  // 过滤条件
  fieldKeys: ['FNumber', 'FName'],  // 查询字段
);

print(result);

创建单据

var result = await K3CloudApi.create(
  formId: 'SAL_SaleOrder',  // 表单ID
  data: {
    'FBillNo': 'SO20231001',
    'FCustomerID': 'CUST001',
    'FDate': '2023-10-01',
    'FEntity': [
      {
        'FMaterialID': 'MAT001',
        'FQty': 10,
        'FPrice': 100.0,
      }
    ],
  },
);

print(result);

更新单据

var result = await K3CloudApi.update(
  formId: 'SAL_SaleOrder',  // 表单ID
  data: {
    'FID': 'SO20231001',
    'FEntity': [
      {
        'FEntryID': 1,
        'FQty': 15,
      }
    ],
  },
);

print(result);

删除单据

var result = await K3CloudApi.delete(
  formId: 'SAL_SaleOrder',  // 表单ID
  ids: ['SO20231001'],      // 单据ID列表
);

print(result);

5. 处理响应

API调用通常会返回一个包含操作结果的JSON对象。你可以根据需要解析和处理这些响应数据。

6. 错误处理

在实际使用中，建议对所有API调用进行错误处理，以捕获和处理可能的异常：

try {
  var result = await K3CloudApi.query(
    formId: 'BD_Material',
    filter: 'FNumber like \'%MAT%\'',
    fieldKeys: ['FNumber', 'FName'],
  );
  print(result);
} catch (e) {
  print('发生错误: $e');
}

7. 注销

在应用退出或用户注销时，可以调用 logout 方法来注销当前会话：

await K3CloudApi.logout();