dingtalktool 1.0.0 → 1.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bab772daeafd5d6452b208713111534c455fd08381b6a216af9d706c6ab648e7
-  data.tar.gz: 32bf9ac444875ad818d039ea698dd8719c1ae4019cfb3b3a678a8d6894d0a4e1
+  metadata.gz: f1b9b3942121d0cb7e7bdb65e79d6a1d3a1907cf8bd8b2bc14dd0ef84ecd16af
+  data.tar.gz: 8ea670f66c33ea56d1db1cee589df263aadb142fbf6c515c80aa05b56ca85f4e
 SHA512:
-  metadata.gz: 235db52a704fbe09fea9429c253773dabfa23df12ad226344d32b56551fd8240dde9f3071166f5e79df18bf186db5e958bfc2e43f9e9f9b8cb9cbb637cd75db4
-  data.tar.gz: 3f1a583e062a743539795e553a23f9997831f3b8de1714eec4d5876dcd86e5322a9bdaa83ea7365c2931134373519112424b48924d211ef536f7bd36e3b57e70
+  metadata.gz: 39f88280cf3f13a7339d770bbe909add4951fed5d7d3734df40af6a01b28605dd8f079aa901897f41ba3e7e99a1e8dba1d9bf6000a47c9fb30e777933dba6835
+  data.tar.gz: 11af62d88cce0a5735d5dff9ee98a7b02f2824b08140f4ab3d7a12854c3b3520c306f7c943dcf275a14e2121e5bcd3be28bb56012b9223a5510b1cf25b88e5e1

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    dingtalktool (1.0.0)
+    dingtalktool (1.0.2)
       rest-client
 
 GEM
@@ -15,9 +15,9 @@ GEM
     http-cookie (1.0.3)
       domain_name (~> 0.5)
     method_source (0.9.2)
-    mime-types (3.3)
+    mime-types (3.3.1)
       mime-types-data (~> 3.2015)
-    mime-types-data (3.2019.1009)
+    mime-types-data (3.2020.0512)
     netrc (0.11.0)
     pry (0.11.3)
       coderay (~> 1.1.0)
@@ -43,7 +43,7 @@ GEM
     rspec-support (3.7.1)
     unf (0.1.4)
       unf_ext
-    unf_ext (0.0.7.6)
+    unf_ext (0.0.7.7)
 
 PLATFORMS
   ruby

data/README.md

@@ -1,8 +1,26 @@
 # Dingtalktool
 
-Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/dingtalktool`. To experiment with that code, run `bin/console` for an interactive prompt.
+钉钉企业内部应用服务端API，现在已经实现接口：
+
++ 获取access_token
++ 通讯录管理
+    - 部门管理
+        + 创建部门
+        + 获取子部门ID列表
+        + 获取部门列表
+        + 获取部门详情
+        + 删除部门
+    + 用户管理
+        + 获取用户详情
+        + 获取部门用户
++ 消息通知
+    + 创建会话
+    + 发送群消息
+    + ~bindChat(钉钉文档中找不到)~
++ 考勤
+    + 获取打卡详情
+    + 获取打卡结果
 
-TODO: Delete this and the text above, and describe your gem
 
 ## Installation
 
@@ -22,7 +40,170 @@ Or install it yourself as:
 
 ## Usage
 
-TODO: Write usage instructions here
+1.添加config/initializers/dingtalktool.rb
+
+```ruby
+Dingtalktool.configure do |configuration|
+  configuration.corpid = "" # 必填, 企业自用账号信息中CorpId
+  configuration.secret = "" # 必填, 开发体验账号管理里面的CorpSecret
+  configuration.agentid = "" #必填，在创建微应用的时候会分配
+end
+```
+2.添加配置之后就能直接使用gem提供的功能
+
++ 获取token
+```ruby
+token = Dingtalktool::AuthService.getAccessToken  # 返回token字符串
+```
++ 获取部门列表
+```ruby
+department_res = Dingtalktool::DepartmentService.listDept(token)
+```
++ 获取部门下所有员工
+```ruby
+# 获取当个部门员工
+department_users = Dingtalktool::UserService.list(token, department_id)
+```
++ 获取员工打卡详情
+```ruby
+userIds = User.all.map(&:userid).uniq
+user_ids = Array(userIds.each_slice(50)) # 每次最多查询50位员工,所以这里要把所有员工id分开
+result = []
+user_ids.each do |users|
+    data = {
+      userIds: users,
+      checkDateFrom: Time.now.beginning_of_day.strftime("%Y-%m-%d %H:%M:%S"),
+      checkDateTo: Time.now.end_of_day.strftime("%Y-%m-%d %H:%M:%S"),
+      isI18n: 'false'
+    }
+    listRecord = Dingtalktool::AttendanceService.listRecord(token, data)
+    if listRecord['errcode'] == 0 && listRecord['errmsg'] == 'ok'
+      result += listRecord['recordresult']
+    end
+end
+```
+
+更多方法请查看下面文件结构
+
+## 文件结构, 类, 方法
+├── dingtalktool  
+│        ├── attendance_service.rb  
+│        ├── auth_service.rb  
+│        ├── cache_service.rb  
+│        ├── chat_service.rb  
+│        ├── configuration.rb  
+│        ├── department_service.rb  
+│        ├── http_service.rb  
+│        ├── log_service.rb  
+│        ├── message_service.rb  
+│        ├── user_service.rb  
+│        └── version.rb  
+└── dingtalktool.rb  
+
+<table>
+  <tr>
+    <td>类名</td>
+    <td>方法</td>
+    <td>备注</td>
+  </tr>
+  <tr>
+    <td rowspan='2'>AttendanceService</td>
+    <td>listRecord</td>
+    <td></td>
+  </tr>
+  <tr>
+    <td>list</td>
+    <td></td>
+  </tr>
+  <tr>
+    <td rowspan='2'>AuthService</td>
+    <td>getAccessToken</td>
+    <td></td>
+  </tr>
+  <tr>
+    <td>getTicket</td>
+    <td></td>
+  </tr>
+  <tr>
+    <td rowspan='3'>ChatService</td>
+    <td>createChat</td>
+    <td></td>
+  </tr>
+  <tr>
+    <td>bindChat</td>
+    <td></td>
+  </tr>
+  <tr>
+    <td>sendmsg</td>
+    <td></td>
+  </tr>
+  <tr>
+    <td rowspan='5'>DepartmentService</td>
+    <td>createDept</td>
+    <td></td>
+  </tr>
+  <tr>
+    <td>listDept</td>
+    <td></td>
+  </tr>
+  <tr>
+    <td>list_ids</td>
+    <td></td>
+  </tr>
+  <tr>
+    <td>department_info</td>
+    <td></td>
+  </tr>
+  <tr>
+    <td>deleteDept</td>
+    <td></td>
+  </tr>
+  <tr>
+    <td rowspan='3'>MessageService</td>
+    <td>sendToConversation</td>
+    <td></td>
+  </tr>
+  <tr>
+    <td>send</td>
+    <td></td>
+  </tr>
+  <tr>
+    <td>send_chat</td>
+    <td></td>
+  </tr>
+  <tr>
+    <td rowspan='4'>UserService</td>
+    <td>getUserInfo</td>
+    <td></td>
+  </tr>
+  <tr>
+    <td>get</td>
+    <td></td>
+  </tr>
+  <tr>
+    <td>simplelist</td>
+    <td></td>
+  </tr>
+  <tr>
+    <td>list</td>
+    <td></td>
+  </tr>
+</table>
+
+## 未完待续
++ 添加所有服务端API
++ 优化调用方式
+
+## 联系方式
+有任何问题都联系我 
++ 邮箱: liu_xiaodao@163.com
++ 微信/QQ: 957419420
+
+## 修改记录
+1.0.2  缓存文件和日至文件位置修改
+
+## 其他
+以上功能是为了满足我自己一个项目写的,所以只包含了钉钉服务端API的一小部分,后面我会持续优化,谢谢,这也是我写的第一个正式的gem
 
 ## Development
 
@@ -32,7 +213,7 @@ To install this gem onto your local machine, run `bundle exec rake install`. To
 
 ## Contributing
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/dingtalktool. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
+Bug reports and pull requests are welcome on GitHub at https://github.com/Liu-XiaoDao/dingtalktool. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
 
 ## License
 
@@ -40,4 +221,4 @@ The gem is available as open source under the terms of the [MIT License](https:/
 
 ## Code of Conduct
 
-Everyone interacting in the Dingtalktool project’s codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/[USERNAME]/dingtalktool/blob/master/CODE_OF_CONDUCT.md).
+Everyone interacting in the Dingtalktool project’s codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/Liu-XiaoDao/dingtalktool/blob/master/CODE_OF_CONDUCT.md).

data/lib/dingtalktool/cache_service.rb

@@ -1,7 +1,6 @@
 require 'yaml'
 module Dingtalktool
   class CacheService
-
     def self.setJsTicket(ticket)
       set("js_ticket", ticket, ex: 7000); # js ticket有效期为7200秒，这里设置为7000秒
     end
@@ -30,7 +29,7 @@ module Dingtalktool
     def self.set(key,value,options = {})
       ex = options[:ex] ? Time.now.to_i + options[:ex] : 0
       if key && value
-        data = get_file("./filecache.yml")
+        data = get_file("tmp/cache/filecache.yml")
 
         item = {}
         item["#{key}"] = value
@@ -43,7 +42,7 @@ module Dingtalktool
 
     def self.get(key)
       if key && key.is_a?(String)
-        data = get_file("./filecache.yml")
+        data = get_file("tmp/cache/filecache.yml")
         if !data.empty? && data.has_key?(key)
             item = data["#{key}"]
             return false  if !item
@@ -71,6 +70,5 @@ module Dingtalktool
       file.write(content)
       file.close unless file.nil?
     end
-
   end
 end

data/lib/dingtalktool/log_service.rb

@@ -10,7 +10,7 @@ module Dingtalktool
 
     def self.write(level,msg)
       # TODO: 日志保存位置要修改
-      filename = "./my.log"
+      filename = "log/dingtalktool.log"
       file = File.open(filename, "a")
       file.write("#{level}/#{Time.now}  #{msg}\n")
       file.close

data/lib/dingtalktool/version.rb

@@ -1,3 +1,3 @@
 module Dingtalktool
-  VERSION = "1.0.0"
+  VERSION = "1.0.2"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: dingtalktool
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.0.2
 platform: ruby
 authors:
 - liuchunliang
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2019-10-17 00:00:00.000000000 Z
+date: 2020-09-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -99,7 +99,6 @@ files:
 - bin/console
 - bin/setup
 - dingtalktool.gemspec
-- filecache.yml
 - lib/dingtalktool.rb
 - lib/dingtalktool/attendance_service.rb
 - lib/dingtalktool/auth_service.rb
@@ -112,7 +111,6 @@ files:
 - lib/dingtalktool/message_service.rb
 - lib/dingtalktool/user_service.rb
 - lib/dingtalktool/version.rb
-- my.log
 homepage: http://www.liuxiaodao.top
 licenses:
 - MIT

data/filecache.yml

@@ -1 +0,0 @@
-{"corp_access_token":{"corp_access_token":"8190da179494368db97e76265852856b","expire_time":1571198008,"create_time":1571191008}}

data/my.log

@@ -1 +0,0 @@
-E/2019-10-15 12:43:17 +0800  FAIL: {"errcode":40035,"errmsg":"缺少参数 corpid or appkey"}