🤚🏽 🧑🏿‍🤝‍🧑🏼 🤥 内部网的组织（IT生产的自动化）。第1部分-用户和邮件 ➕ 🗓️ 👃🏾

任何IT公司（外包或杂货店）迟早都希望组织自己的空间，您可以在其中存储有关项目，员工和销售的信息。保持工作往来并讨论任务/策略/文件。大多数情况下，此类公司开始自己编写所有代码，或者看到Bitrix24等产品。在本系列文章中，我将讨论我们的~~一辆自行车~~-流程自动化方面的经验。不出所料，几乎所有的自托管开放源代码都尝试几乎不用编码。

免责声明

一系列文章描述了基础结构实现的示例；作者并不敦促重复，也不假装在这种方法中是“正确的”。所描述系统的某些部分已在多个组织中实际成功地使用了3年。作者很乐意接受有关改进系统或提出替代解决方案的建议。请不要滋生那些不需要，不阅读且不干扰评论员的讨论，例如“谁需要这个”和“拐杖什么”

因此，一般的外包公司可以从类似的系统中获得什么：

分配了信息访问权的员工数据库
GIT , , 1
Chat-Server (Messenger ) 1
, 1
/ HR
-
( )

– . - , - .

, " GIT ?", " ?" . .

, . , , LDAP . LDAP , , . 3 LDAP OpenLDAP , , , .

, RESTapi. , LDAP .

, OpenSource ERP/CRM (Odoo, Axellor ), OpenProject . , . - PHP, .

, EspoCRM. , " " , . , , CMS, .

.

, Espo :

HR
-
(CRM :))

PHP .

CRM. .
( , ).

-> -> User ().
. ( ) :

, Skype, Telegram, VK, Facebook . (, ), , , , , ( ).

, .
/ .

-> -> -> .

- :

, , . , .
, - " " .

EspoCRM, . , - , - .

, . .

— . , . , — email.

— self-hosted . , , . .. 1000 , web- RESTapi. , — .

, , espo.

, , Node-RED.

Node-RED

, , .
Node-RED , : , - . , , , , .

Node-RED . , , API ..

API Token.

"-" - " URL ".

, .

. Directory API, , , :

( )

- :

, . , .
https://oauth.yandex.ru/authorize?response_type=token&client_id=<ID>,

, , Node-RED.

http://localhost:1880, Flow 1
inject function
inject "Inject once after 0.1 seconds, then"
function

global.set('YaConnectToken', 'AgAAAA......');
return msg;

global.get() .

Inject , Flow 1. , . ,

Node-RED + .

Flow : inject, function, http request

inject, , , JSON

{
"userName":"testuser",
"firstName":"Test",
"lastName":"User",
"emailAddress":"testuser@mydomain.ru",
"dob":"1988-01-01",
"gender":"male",
"passwordConfirm":"12345678Eiru",
"isActive":true
}

function :

const TOKEN = global.get('YaConnectToken');
const user = msg.payload; //       
const body = {
'department_id': 1, // ID   .,    1
'is_admin': false, //    
'nickname': user.userName,
'name': {
'first': user.firstName,
'last': user.lastName
},
'birthday': user.dob, // 'YYYY-MM-DD',
'gender': user.gender, //'male/female/null'
'password': user.passwordConfirm,
'is_dismissed': user.isActive,
'position': user.title // 
}
return {
headers: {
'Authorization': 'OAuth ' + TOKEN,
//'X-Org-ID': 1234 //       .  : https://wilix.org/l/wlwrtj
},
payload: body
}

http request, POST, url https://api.directory.yandex.net/v6/users/
Deploy inject ( JSON inject function )
, http request , msg statusCode 200 201 payload:

! !

EspoCRM Node-RED

( CRM) Node-RED .
PHP, .
UserSaved.php EspoCRM custom/Espo/Custom/Hooks/User :

<?php
namespace Espo\Custom\Hooks\User;

use Espo\ORM\Entity;

class UserSaved extends \Espo\Core\Hooks\Base {
  public function afterSave(Entity $entity, array $options = []) {
    $entityValues = $entity->getValues();
    unset($entityValues['password']);
    $entityValues['isNew'] = $entity->isNew();
    $data = array(
      'event' => 'afterSave',
      'entity' => $entityValues,
    );
    $this->_callRed($data);
  }

  public function afterRemove(Entity $entity, array $options = []) {
    $entityValues = $entity->getValues();
    unset($entityValues['password']);
    $data = array(
      'event' => 'afterRemove',
      'entity' => $entityValues
    );
    $this->_callRed($data);
  }

  private function _callRed($data) {
    $data_string = json_encode($data);
    $ch = curl_init('__NODE_RED_ENDPOINT__');
    curl_setopt($ch, CURLOPT_POST, 1);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_POSTFIELDS, $data_string);
    curl_setopt($ch, CURLOPT_HTTPHEADER, array(
        'Content-Type: application/json',
        'Content-Length: ' . strlen($data_string))
    );
    $response = curl_exec($ch);
    curl_close($ch);
    return $response;
  }
}

Hook . ( ) , - // Espo, Node-RED. , Node-RED EspoCRM ( ) , localhost .
NODE_RED_ENDPOINT — .

Node-RED : http in, http response, debug
http in
UserSaved.php NODE_RED_ENDPOINT _NODE_RED/user-event
Deploy Node-RED
EspoCRM ->
EspoCRM, ""

, Node-RED ( ) JSON

{
id: "5e430b3c59783cb41"
name: "User Test"
deleted: false
isAdmin: false
userName: "usertest"
type: "regular"
password: "GVhrB......"
passwordConfirm: "oRM1..."
authMethod: null
salutationName: "Mr."
firstName: "User"
lastName: "Test"
isActive: true
isPortalUser: false
isSuperAdmin: false
title: "Frontend developer"
emailAddress: null
phoneNumber: null
sendAccessInfo: false
gender: "Male"
createdAt: "2020-02-11 20:14:52"
modifiedAt: "2020-02-11 20:14:52"
dob: null
inn: null
emailAddressIsOptedOut: null
phoneNumberIsOptedOut: null
emailAddressData: array[0]
phoneNumberData: array[0]
defaultTeamId: null
defaultTeamName: null
teamsIds: array[0]
teamsNames: object
teamsColumns: object
rolesIds: array[0]
rolesNames: object
portalsIds: array[0]
portalsNames: object
portalRolesIds: array[0]
portalRolesNames: object
createdById: "1"
isNew: true
}

isNew ,
passwordConfirm , .
, .

( 2 )

function 2

const user = msg.payload.entity;
if (msg.payload.event != 'afterSave') { //      ,   
return null
}

Deploy
Espo ( )
, Node-RED JSON
:)

Node-RED. , . Flow, . ( ).

EspoCRM , , , .

self-hosted GIT ( GitLab :))
self-hosted Slack
HR .
.

常见问题解答：
问：如果可以直接从PHP向Yandex发出请求，为什么要使用Node-RED？
答：在Node-RED方面具有集成性，我们可以更改配置，添加新服务和挂钩，以适应用户更改，而无需进行其他编码（不计算Node-RED上的小功能）。部署更新的过程归结为一个按钮。

内部网的组织（IT生产的自动化）。第1部分-用户和邮件

免责声明

.

Node-RED

Node-RED + .

EspoCRM Node-RED

More articles: