Un site rar stă singur. În spatele celor mai multe site-uri de firmă există un sistem de facturare, un CRM, o bază de date de stocuri, un instrument de newsletter, un calendar de programări sau un program de contabilitate, iar valoarea site-ului se multiplică atunci când vorbește cu ele. Un formular care creează un lead în CRM în loc de un e-mail. O pagină de produs care arată stocul real. O comandă care devine factură fără ca cineva s-o rescrie. Anul acesta, în România, extinderea e-Factura a făcut-o pe ultima concretă pentru zeci de mii de firme mici: din iulie, aproape fiecare factură trebuie să ajungă în sistemul național ca date structurate în cinci zile lucrătoare. Integrarea a încetat să fie un lucru plăcut și a devenit parte din a conduce o afacere. Articolul e despre cum conectăm un site Drupal la sistemele pe care le rulezi deja și de ce acele conexiuni rămân de încredere.
Formele pe care le iau integrările
Cele mai multe integrări sunt de unul din patru feluri, și a ști de care ai nevoie e jumătate din proiectare.
Site-ul trimite. O trimitere de formular devine un lead în CRM, un tichet într-un helpdesk, un abonat într-o listă de e-mail, un rând într-un tabel. Site-ul e sursa; celălalt sistem primește.
Site-ul primește. Produsele, prețurile, stocul, programul sau anunțurile de angajare se află în alt sistem și apar pe site. Site-ul e un afișaj pentru date pe care nu le deține, reîmprospătate după un program sau când se schimbă sursa.
Site-ul orchestrează. O comandă plasată pe site rezervă stoc într-un sistem, încasează plata prin altul, creează o factură într-un al treilea și o trimite în e-Factura, apoi anunță clientul. Site-ul coordonează o secvență între mai multe părți.
Site-ul expune. O aplicație mobilă, un partener sau un instrument de raportare citește conținutul site-ului printr-un API. Site-ul e sursa pentru alții.
De ce se simte Drupal confortabil aici
Drupal a fost construit ca framework în aceeași măsură ca CMS, și integrarea e locul în care se vede asta. Conținutul lui e structurat, așa că maparea unei înregistrări de produs dintr-un sistem extern pe un produs de pe site e un exercițiu câmp-la-câmp, nu o problemă de parsare. Sistemul lui de cozi lasă munca care vorbește cu alte servicii să ruleze în fundal, să reîncerce la eșec și să nu încetinească niciodată un vizitator. Stratul lui de API expune orice tip de conținut altor sisteme, cu permisiunile aplicate. Iar sistemul lui de module înseamnă că fiecare integrare e o piesă de sine stătătoare, cu propria configurație, teste și jurnale, care poate fi actualizată sau înlocuită fără să atingi restul site-ului.
Ultima proprietate e cea care contează de-a lungul anilor. Sistemele externe se schimbă: o versiune de API e retrasă, un furnizor e înlocuit, un câmp e redenumit. O integrare construită ca modul e un lucru mic de actualizat. Una țesută prin șabloane și cod personalizat e un proiect.
Proiectarea pentru ziua în care celălalt sistem e căzut
Fiecare integrare implică un sistem pe care nu-l controlezi, și fiecare dintre ele va fi indisponibil la un moment dat. Integrările bune sunt proiectate pentru ziua aceea de la început. Dacă CRM-ul nu răspunde, formularul se trimite oricum, lead-ul e pus în coadă și e livrat când CRM-ul revine; vizitatorul nu află niciodată. Dacă serviciul de stoc expiră, pagina de produs arată ultimul stoc cunoscut cu o oră, nu o eroare. Dacă sistemul de facturare respinge o trimitere, o persoană e anunțată cu motivul, iar comanda nu se pierde. Regula e simplă: experiența vizitatorului nu trebuie să depindă niciodată de un terț care răspunde la timp.
Același principiu guvernează securitatea. Credențialele pentru sistemele externe sunt stocate ca secrete în afara codului, limitate la mediu, astfel că staging-ul nu poate ajunge niciodată la un cont de facturare real. Fiecare apel e înregistrat. Datele trimise altui sistem sunt minimul de care acel sistem are nevoie. Iar conexiunea e monitorizată ca orice altă parte a site-ului, astfel că o integrare care eșuează e observată înainte ca un client să observe o factură lipsă.
Exemplul e-Factura
Cerința românească de facturare electronică e o bună ilustrare, pentru că atinge fiecare parte a tiparului. O factură trebuie generată ca XML structurat într-un format anume, semnată, trimisă în sistemul național, iar răspunsul înregistrat, cu un termen atașat. Pentru o firmă ale cărei comenzi pornesc de pe site, locul firesc în care să se întâmple asta e momentul confirmării comenzii, în fundal, cu rezultatul vizibil pentru echipa financiară și pentru client.
Fie că factura e produsă de site-ul însuși sau de un program de contabilitate pe care site-ul îl alimentează, integrarea are aceeași structură: o coadă, o mapare, o trimitere idempotentă care poate fi reîncercată în siguranță, o înregistrare a răspunsului și o alertă când ceva e respins. O construim astfel încât echipa financiară să vadă starea fiecărei facturi într-un singur loc, iar o schimbare de format, care s-a întâmplat de mai multe ori, să fie o schimbare într-un singur modul.
Integrări în interiorul unui portal
Acolo unde o firmă are un portal de client, integrările devin conținutul lui principal. Comenzile din magazin, facturile din contabilitate, tichetele din suport și documentele dintr-un sistem de fișiere apar unele lângă altele, fiecare preluat din propria sursă și arătat sub aceleași permisiuni. Propriul nostru portal funcționează așa, trăgând din mai multe sisteme interne, iar tiparul funcționează la fel de bine pentru o zonă de client cu un singur sistem conectat.
Cum începe un proiect de integrare
Începem cu datele, nu cu tehnologia: ce înregistrări trebuie să circule, în ce direcție, cât de des și ce ar trebui să se întâmple când eșuează. Apoi ne uităm la ce oferă celălalt sistem, îi citim documentația și construim o mică dovadă care mută o înregistrare reală de la un capăt la altul. Cele mai multe integrări sunt live în câteva săptămâni; cele care implică plăți sau facturare durează mai mult, pentru că implică certificare și testare pe un mediu de probă. Pe tot parcursul, munca e vizibilă în portal și testabilă pe staging cu date curățate, niciodată pe conturi reale.
Dacă echipa ta rescrie informații de pe site în alt sistem, sau din alt sistem pe site, aceea e o integrare care așteaptă să fie construită. Spune-ne ce sisteme sunt implicate, și îți vom spune ce ar presupune conectarea lor.
