# kingdee-k3cloud-webapi

**Repository Path**: tsingtsi/kingdee-k3cloud-webapi

## Basic Information

- **Project Name**: kingdee-k3cloud-webapi
- **Description**: 金蝶云k3cloud-webapi sdk
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 13
- **Created**: 2022-03-22
- **Last Updated**: 2022-03-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# kingdee-k3cloud-webapi

#### 介绍
最近工作需要对接金蝶云，逛了一番金蝶社区一直没找到对应的java sdk，算了就自己写一个吧，也许对时间紧张难得动手的同学有所帮助，并且sdk已经内置了登录功能，只要提供相应的账号密码即可。基于金蝶云的webapi抽出了[K3CloudTemplate](https://gitee.com/phenixs/kingdee-k3cloud-webapi/blob/master/src/main/java/com/link/kingdee/k3cloud/K3CloudTemplate.java)，简化操作。但是目前主要提供了[表单数据查询服务](https://gitee.com/phenixs/kingdee-k3cloud-webapi/blob/master/src/main/java/com/link/kingdee/k3cloud/domain/RequestService.java)，有需求的同学可以fork后自己进行改造。

#### 软件架构
无特殊架构，只是一个简单的jar，但是需要基于java8+及spring环境，具体使用的框架大致如下：
| 框架         | 描述     |
|------------|--------|
| java       | java8+ |
| spring-web | 主要使用了RestTemplate进行http请求|
| lombok     | 对象简化工具|
| hutool     | java实用工具集|



#### 安装教程

- 源码安装 

  `git clone xxxx`

- jar安装

  `mvn clean package -Dmaven.test.skip=true`

#### 使用说明
- 需要替换对应的账套id，用户名，密码及对应的url

```java
package com.link.kingdee;

import java.util.ArrayList;
import java.util.List;

import com.fasterxml.jackson.annotation.JsonProperty;
import lombok.Data;
import lombok.extern.slf4j.Slf4j;
import org.junit.Test;
import org.springframework.util.StringUtils;

import com.link.kingdee.k3cloud.K3CloudTemplate;
import com.link.kingdee.k3cloud.domain.Authentication;
import com.link.kingdee.k3cloud.domain.BillQuery;

import junit.framework.TestCase;

@Slf4j
public class AppTest extends TestCase {
	
	@Test
	public void testBillQuery() {
		Authentication auth = new Authentication("${账套id}", "${用户名}", "${密码}", 2052);
		K3CloudTemplate template = new K3CloudTemplate("${url}", auth);
		List<BillQuery> params = new ArrayList<>();
		String[] fieldKeys = {
			      "FBOOKID","FNumber","FName"
			    };
	    String filter = "";
	    BillQuery query = new BillQuery("BD_AccountBook", StringUtils.arrayToDelimitedString(fieldKeys, ","), filter, 0, 0);
	    query.setTopRowCount(10000);
		List<?> dataList = template.executeBillQuery(query, AccountBook.class);
		log.info("AccountBookList = {}", dataList);
		assertNotNull(dataList);
	}

	/**
	 * 自定义账簿类用于接收返回数据
	 * <p>使用jackson @JsonProperty来对应金蝶返回字段</p>
	 */
	@Data
	public static class AccountBook {

		@JsonProperty("FBOOKID")
		private Integer bookId;

		@JsonProperty("FNumber")
		private Integer number;

		@JsonProperty("FName")
		private String name;

	}
	
}

```


#### 参与贡献

1.  Fork 本仓库
2.  新建 Feat_xxx 分支
3.  提交代码
4.  新建 Pull Request


#### 特技

1.  使用 Readme\_XXX.md 来支持不同的语言，例如 Readme\_en.md, Readme\_zh.md
2.  Gitee 官方博客 [blog.gitee.com](https://blog.gitee.com)
3.  你可以 [https://gitee.com/explore](https://gitee.com/explore) 这个地址来了解 Gitee 上的优秀开源项目
4.  [GVP](https://gitee.com/gvp) 全称是 Gitee 最有价值开源项目，是综合评定出的优秀开源项目
5.  Gitee 官方提供的使用手册 [https://gitee.com/help](https://gitee.com/help)
6.  Gitee 封面人物是一档用来展示 Gitee 会员风采的栏目 [https://gitee.com/gitee-stars/](https://gitee.com/gitee-stars/)