Technické detaily¶
Struktura modulu¶
Modul dodržuje standardní strukturu EspoCRM extenzí.
src/backend/Entities- Definice tříd entit.src/backend/Services- Business logika (často dědí zTaskBasepro realizační úkoly).src/backend/Tools- Pomocné třídy pro komunikaci s Heliosem.src/backend/Jobs- Třídy pro Cron úlohy.
Třída HeliosConnector¶
Třída Espo\Modules\LamarkHelios\Tools\HeliosConnector zapouzdřuje komunikaci.
* Získává konfiguraci z entity Integration.
* Provádí autentizaci (Session ID).
* Volá runExternalAction nad Helios DataSnap REST API.
* Loguje requesty a response (úroveň DEBUG).
Synchronizační logika (Tools)¶
Pro každou hlavní entitu existuje "Sync Tool" (např. OrderSync, QuoteSync), který:
1. Mapuje pole EspoCRM <-> Helios.
2. Řeší transformace dat (datum, boolean).
3. Volá HeliosConnector.
4. Ukládá výsledky (Helios ID) zpět do databáze.