Google Dokumenti

A1Connection architecture

The connection uses OAuth 2.0 against the vendor's own consent screen. The authorisation request names the minimum scopes the features need — the exact scope list is shown in the security-flow panel below, pulled from the same provider registry the application uses. The code-for-token exchange happens entirely server-side (poverilnice stranke v telesu zahteve za žeton, per the vendor's token endpoint contract); tokens are stored encrypted at rest and are never rendered back to any screen — connection pages show presence, not values.

Življenjski cikel žetonov se obravnava na eni sami ozki točki: preteče sproži samodejno osvežitev, rotirani žetoni za osvežitev se shranijo, osvežitev, ki jo ponudnik zavrne, pa se prikaže kot viden poziv za ponovno povezavo – nikoli kot tiho pokvarjene funkcije. Preklic deluje z obeh strani: prekinite povezavo tukaj ali prekličite v lastnih varnostnih nastavitvah ponudnika.

A2Pisanje semantike in pretoka podatkov

Vsak prenos podatkov je izrecno dejanje z zabeleženim rezultatom. Pisanje se zgodi ob vašem kliku — ali samodejno le tam, kjer ste omogočili pravilo (samodejno potiskanje ob zaposlitvi je privzeto izklopljeno, glede na ponudnika). Branja — uvozi oseb, računov ali datotek — se zaženejo, ko pritisnete Uvozi, odstranijo podlage glede na to, kar že imate (stranke po imenu, osebe po e-pošti), preskočijo namesto prepišejo in pošteno poročajo o ustvarjenih v primerjavi s preskočenimi, zato je ponovni zagon katere koli uvoza varno z zasnovo.

Vsako dejanje zapisuje vrstico v dnevnik dejavnosti aplikacije (ats_app_activity): kaj se je izvedlo, kdaj, za katero evidenco in izid – vključno s ponudnikovim besedilom napake dobesedno, ko nekaj ne uspe. Poročanje o uporabi znotraj ATS združuje ta isti dnevnik, zato se poročanje o integraciji in realnost integracije ne moreta raziti.

Vse, kar zapusti zahtevek – razširjanje obvestil, dostava spletnih kljukic (webhook), beleženje dejavnosti, e-pošta – se izvaja v vzporednih opravilih v ozadju (fire-and-forget). Počasna zunanja končna točka nikoli ne more povzročiti zamrznitve vmesnika, neuspešen stranski učinek pa se zabeleži v dnevnik, namesto da bi se tiho ponovno poskušal izvesti in povzročil neskladnost.

A3Operativni vidiki

Povezave so na ravni organizacije in so omejene na vloge lastnika in skrbnika; kadrovniki uporabljajo funkcije, ki jih omogoča povezava, vendar ne morejo povezovati, prekiniti povezave ali ponovno konfigurirati. Prekinitev povezave takoj odstrani shranjene poverilnice in vidno ustavi odvisne funkcije, ne tiho. Podatki, ki so že uvoženi, ostanejo vaši in jih je mogoče urejati.

Uvožene osebe so označene kot uvožene s konzervativnimi privzetimi nastavitvami zasebnosti – za nikogar, ki nikoli ni izpolnil vašega prijavnega obrazca, se ne predvideva privolitev, veljajo pa tudi privzete nastavitve hrambe.Vse napisano je vaše: izvozi CSV in aplikacija Data Export pokrivajo iste hrambe, kot jih bere sam izdelek. Izhod je tako odprt kot vhod – po zasnovi, ne iz koncesije.

A4Položaj v topologiji integracij

Ta integracija deluje v živo v registru že danes. One connection per provider unlocks every feature it powers, and the topology grid below shows the neighbouring connectors in the same capability area — statuses come from the same registry that drives the in-app hub, so this page can never claim more than the product does. For anything the catalogue does not cover, Webhooks and Zapier are the generic, documented escape hatch.