钉钉的QuickStart，使用Java语言开发

1. 创建审批模板
①登录OA管理后台，点击工作台-点击审批，进入审批管理后台

②点击【创建新审批】，进入创建新审批页面，点击【自定义模板】

③按照如下的表单样式，从控件库拖入对应的控件，最后点击【保存并启用】。
注意，在浏览器url中查找process_code参数，服务端开发需用到。
表单样式见下图：

【行程明细】是明细控件，
【出差地点】是单行输入框，
【图片】是图片控件，
【开始时间，结束时间】是日期区间控件，
【出差人数】是数字控件，
【出差金额】是金额控件，
【出差同伴】是单选框控件（添加的时候，把选项改为A,B,C），
【交通工具】是单行输入框，
【出差事由】是多行输入框。
一定要是对应的组件，不然会出错。

④设置完成保存，进入流程设计模块，设计审批流程。

目前发起审批实例接口支持两种模式，本篇quickstart采用“复用审批后台设置的审批流程模式”

服务端开发

服务端代码下载

git clone https://github.com/opendingtalk/eapp-corp-project.git

导入服务端代码并修改配置

更改服务端Java代码com.config.Constant.java文件

/**
     * 企业corpid, 需要修改成开发者所在企业
     */
    public static final String CORP_ID = "***";
    /**
     * 应用的AppKey，登录开发者后台，点击应用管理，进入应用详情可见
     */
    public static final String APPKEY = "***";
    /**
     * 应用的AppSecret，登录开发者后台，点击应用管理，进入应用详情可见
     */
    public static final String APPSECRET = "***";

    /**
     * 数据加密密钥。用于回调数据的加密，长度固定为43个字符，从a-z, A-Z, 0-9共62个字符中选取,您可以随机生成
     */
    public static final String ENCODING_AES_KEY = "***";

    /**
     * 加解密需要用到的token，企业可以随机填写。如 "12345"
     */
    public static final String TOKEN = "***";

    /**
     * 应用的agentdId，登录开发者后台可查看
     */
    public static final Long AGENTID = 111L;

    /**
     * 审批模板唯一标识，可以在审批管理后台找到
     */
    public static final String PROCESS_CODE = "***";

参数获取方法，请参考以下：

（1）CORP_ID可以在开发者后台-首页中获取到
（2）APPKEY、APPSECRET、AGENTID可在开发者后台-企业内部开发-小程序获取到
（3）ENCODING_AES_KEY和TOKEN可以按照注释来设置。
（4）PROCESS_CODE可以在【钉钉管理后台-审批-编辑表单-顶部URL】中找到。

前端开发

前端代码下载

git clone https://github.com/opendingtalk/eapp-corp-project-fe

无需进行任何的修改直接运行就好。

整个流程下来，如果启动实例，手机上能收到审批通知，就代表启动成功！

关于钉钉企业内部小程序的开发

写在前面，一些踩过的坑

• 网上没有很多适用于钉钉小程序的ui组件库，能找到的可以用的大概是dingui-mini,但是没有说明文档，需要自己看源码
• 如果使用的是双屏，将开发工具放到副屏上后，切换回单屏，会显示不出开发工具，最好只放在主屏。(当然我不知道是不是只有我的电脑是这样的)
• 我向官方提过问题，关于是否可以点击工作通知跳转到钉钉小程序。当时官方的回复是可以实现的，但是给我的链接我点进去是空白的

分类

钉钉小程序总共分为四类，企业内部应用、第三方企业应用、第三方个人应用和移动应用接入。根据需求自己选择创建。附上链接钉钉开发平台

企业内部应用

面向企业内部开发人员和定制服务商，自主开发内部应用或工作台，供企业或组织内部使用。

1. 创建应用
   登录公司的开发者后台，选择后台开发。左侧有不同的类别，选择企业内部开发中的小程序，然后创建应用，填好一些必填项。例如，名称，图标，地址等。
2. 管理
   创建好应用之后，可以在后台设置好一些接口权限，开发人员设置等。例如手机号获取userid，手机号码信息等。不开权限，调用接口会获取不到数据。
3. 开发者工具
   钉钉开发者工具和支付宝小程序是同一个，每次打开都要登录钉钉，然后在右上角选好企业内部应用和自己的项目。
   钉钉开发者工具基本和微信开发者工具类似，项目中的文件也基本一致。不过微信的页面后缀是.wxml,样式文件后缀是.wxss。而钉钉的是.axml和.acss
4. 部分代码

• 封装request

https(options) {
  dd.showLoading();
  const { url,method, data, headers } = options
  return new Promise((resolve,reject) => {
    dd.httpRequest({
      url: this.globaldata.serverurl + url || '',
      dataType: method || 'POST',
      data: data || {},
      headers: headers || {},
      success:function(res) {
        resolve (res)
      },
      fail:function(res) {
        reject(res)
      },
      complete: (res) =>{
        dd.hideLoading()
      }
    })
  })

• 处理时间戳

function timestampToTime(timestamp) {
  var date = new Date(timestamp );//时间戳为10位需*1000，时间戳为13位的话不需乘1000
  var Y = date.getFullYear() + '-';
  var M = (date.getMonth() + 1 < 10 ? '0' + (date.getMonth() + 1) : date.getMonth() + 1) + '-';
  var D = (date.getDate() < 10 ? '0' + date.getDate() : date.getDate()) + ' ';
  var h = (date.getHours() < 10 ? '0' + date.getHours() : date.getHours()) + ':';
  var m = (date.getMinutes() < 10 ? '0' + date.getMinutes() : date.getMinutes()) + ':';
  var s = (date.getSeconds() < 10 ? '0' + date.getSeconds() : date.getSeconds());
  return Y + M + D + h + m + s;
}

• 获取免登录码(小程序很多api都需要用到免登录码)

 // 获取免登录码
    dd.getAuthCode({
      success:function(res){
        // console.log(res.authCode)
        app.https({
          url:'xxx.xxxx.xx',  //接口地址
          data:{
            code:res.authCode, 
            //下面两项是从开发者后台获取到的，该企业内部项目固定的AppKey和AppSecret
            appKey:'xxxxxxxxxxxxxxxxxxxxxxx',
            appSecret:'xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx',
            status:0
          }
        }).then(res => {
          console.log(res)
        })
      },
      fail:function(err){
        // console.log(err)
      } 
    });

• 获取元素高度

// 获取高度，动态赋值给scroll-view
dd.createSelectorQuery().select('#sw').boundingClientRect().exec((res) => {
  this.setData({
    height:res[0].height - 10
  })
})

5. 项目的发布
   代码完成之后，可以直接在开发者工具右上角点击发布，就可以上传代码了。然后需要登录到开发者后台，选择刚发布的版本。这样，在手机端钉钉上就可以看到这个小程序

钉钉小程序学习记录

学习记录

前言

小程序开发优点

1 轻量 便捷
2 开发成本低
3 用户集群大
4 封装好的小程序语言，语法简单
由于开发时，发现钉钉小程序教程较少，因此在开发过程中作为纪录。适用于小白。

一、钉钉小程序

采用钉钉小程序的原因：
1 钉钉作为一中国企业管理而生的企业应用，用户集群大
2 钉钉拥有完整的企业组织架构，无需其他应用人员导入
3 钉钉提供丰富的API接口供开发者使用
4 拥有监控平台更好管控API和数据的调用，实现实时监控，及时发现问题

二、使用步骤

1.搭建应用环境

本次将钉钉小程序作为前端
下载工具：
1 java
2 小程序开发者工具为开发工具小程序开发者工具下载地址

此外钉钉开发者，提供接口调试工具，方便开发者调用API调参。

钉钉小程序在线调参工具地址

1. 登陆钉钉后台钉钉后台
   
   创建一个钉钉组织或者成为钉钉组织管理员

2.

3. 在弹出的创建应用页面中填写基本信息，然后单击确定创建。

应用类型：选择小程序。

开发方式：选择企业自助开发。

4. 应用创建完成后，在基础信息页面，复制应用的AppKey和AppSecret备用。
   5.
   单击开发管理进入开发管理页面，然后单击修改，并根据以下内容配置开发信息。

服务器出口IP：输入调用钉钉服务端API时使用的IP即企业服务器的公网IP，多个IP请以英文逗号","隔开，支持带一个*号通配符的IP格式。

本教程设置为本机的公网IP：30.40.xx.xx。

PC端首页地址（可选）：输入在PC端钉钉工作台上打开本应用的地址。链接地址必须以http或https开头。

本教程设置为：https://ding-doc.dingtalk.com/。

管理后台地址（可选）：输入组织管理员在钉钉管理后台访问该应用的地址。

6 单击人员管理，然后单击添加人员添加开发人员。

单击安全中心，然后单击添加添加一个HTTP安全域名。

当小程序的前端与服务端需要进行网络通信时，需要设置安全域名。小程序前端只能通过已设置的安全域名（或IP）与服务端进行网络通信。当安全域名更新时，需要在小程序开发工具重新打包上传版本，设置的域名才会生效。

安全域名是后端服务部署的服务器的公网IP或域名，本教程输入127.0.0.1。

单击权限管理进入权限管理页面，然后根据以下配置添加接口调用权限。
权限范围选择全部员工，然后选择通讯录管理。

选择通讯录部门信息读权限和通讯录部门成员读权限，然后单击申请权限。

之后可以在小程序开发者工具中创建一个简单的demo

创建好后的目录

模拟器效果：
1 app.js全文逻辑
用来设置全局变量，以及页面配置


配置路由，创建一个新的页面必须，在这配置相对路径

页面导航栏的设置

存放照片

页面，主要在这编写代码

每个页面由这几个组成


公共资源存放