📞 👍🏼 🙌 Organización de la intranet (automatización de la producción de TI). Parte 1

Tarde o temprano, cualquier empresa de TI (outsourcing o supermercados) desea organizar su propio espacio donde puede almacenar información sobre proyectos, empleados y ventas. Mantener correspondencia de trabajo y discutir tareas / estrategias / documentos. Muy a menudo, tales compañías comienzan a codificar todo por sí mismas o vieron algo para Bitrix24, etc. En esta serie de artículos hablaré sobre nuestro~~una bicicleta~~- Experiencia en automatización de procesos. Como era de esperar, casi todos son autohospedados, de código abierto e intentan hacerlo casi sin codificación.

Descargo de responsabilidad

Una serie de artículos describe un ejemplo de implementación de infraestructura: el autor no insta a repetir y no pretende ser "correcto" en tales enfoques. Algunas partes del sistema descrito se utilizan en realidad y con éxito en varias organizaciones durante 3 años. El autor acepta con gusto sugerencias para mejorar el sistema o sugerir soluciones alternativas. Por favor, no genere discusiones como "quién necesita esto" y "qué muletas", quién no necesita, no lea ni interfiera con los comentaristas

Entonces, ¿qué puede querer una empresa de outsourcing promedio de un sistema similar?

Base de datos de empleados con distribución de derechos de acceso a la información.
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 .
.

Preguntas frecuentes:
P: ¿Por qué es Node-RED en absoluto, si la solicitud se puede hacer directamente desde PHP a Yandex?
R: Al tener integración en el lado Node-RED, podemos cambiar la configuración, agregar nuevos servicios y enlaces, a los cambios del usuario, sin codificación adicional (sin contar las pequeñas funciones en Node-RED). El proceso de implementación de actualizaciones se reduce a un botón.

Organización de la intranet (automatización de la producción de TI). Parte 1 - Usuarios y correo

Descargo de responsabilidad

.

Node-RED

Node-RED + .

EspoCRM Node-RED

More articles: