تنظيم إنترانت (أتمتة إنتاج تكنولوجيا المعلومات). الجزء 1 - المستخدمون والبريد

عاجلاً أم آجلاً ، أي شركة تكنولوجيا معلومات (الاستعانة بمصادر خارجية أو بقالة) لديها رغبة في تنظيم مساحتها الخاصة حيث يمكنك تخزين المعلومات حول المشاريع والموظفين والمبيعات. الحفاظ على المراسلات العاملة ومناقشة المهام / الاستراتيجيات / الوثائق. في معظم الأحيان ، تبدأ هذه الشركات في ترميز كل شيء بنفسها أو رؤية شيء لـ Bitrix24 ، إلخ. في هذه السلسلة من المقالات سأتحدث عندراجة- خبرة في أتمتة العمليات. كما هو متوقع ، فإن جميع المصادر المفتوحة تقريبًا ، مفتوحة المصدر وتحاول القيام تقريبًا بدون ترميز.

تنويه

تصف سلسلة من المقالات مثالاً على تنفيذ البنية التحتية ، ولا يحث المؤلف على التكرار ولا يدعي أنه "صحيح" في مثل هذه الأساليب. يتم استخدام بعض أجزاء النظام الموصوف بالفعل وبنجاح في العديد من المنظمات لمدة 3 سنوات. يقبل المؤلف بكل سرور اقتراحات لتحسين النظام أو اقتراح حلول بديلة. من فضلك لا تولد مناقشات مثل "من يحتاج هذا" و "ما هي العكازات" ، الذين لا يحتاجون ، لا تقرأ ولا تتدخل مع المعلقين

لذا ، ما الذي يمكن لشركة متوسط ​​الاستعانة بمصادر خارجية تريده من نظام مماثل:

1. قاعدة بيانات للموظفين مع توزيع حقوق الوصول إلى المعلومات
2. GIT , , 1
3. Chat-Server (Messenger ) 1
4. , 1
5. / HR
9. -
10. ( )

– . - , - .

, " GIT ?", " ?" . .

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

, RESTapi. , LDAP .

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

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

.

, Espo :

3. HR
5. -
6. (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 .
• .

الأسئلة الشائعة:
س: لماذا Node-RED على الإطلاق ، إذا كان يمكن تقديم الطلب مباشرة من PHP إلى Yandex؟
ج: من خلال التكامل على جانب Node-RED ، يمكننا تغيير التكوين وإضافة خدمات وخطافات جديدة إلى تغييرات المستخدم ، بدون ترميز إضافي (لا يتم حساب الوظائف الصغيرة على Node-RED). تأتي عملية نشر التحديثات إلى زر واحد.