Integraties
Wat koppelingen en mappings zijn, en hoe je een Space aan een administratie koppelt.
Integraties verbinden Tibata met je boekhoud- en documentsystemen. Een koppeling is de verbinding van je organisatie met zo'n systeem; een mapping verbindt een Space met één administratie, map of bestand daarin.
Koppeling
Een koppeling (connection) is de verbinding van je organisatie met Exact Online, Twinfield of SharePoint. Je legt koppelingen aan in Tibata zelf; de API toont ze met hun provider en externalId.
Mapping
Een mapping verbindt een Space met een administratie, map of bestand binnen een koppeling:
externalType | Waar de Space aan gekoppeld wordt |
|---|---|
exact_division | Een divisie in Exact Online |
twinfield_office | Een office in Twinfield |
sharepoint_folder | Een map in SharePoint |
sharepoint_file | Eén los bestand in SharePoint |
Meerdere Spaces mogen dezelfde administratie delen, bijvoorbeeld een Space voor de jaarrekening en een voor de belastingaangifte van dezelfde onderneming.
PUT op de mappings van een koppeling vervangt alle mappings van die koppeling. Haal eerst de bestaande op met GET en stuur de volledige lijst terug.
Een mapping van een Space die niet elk lid kan bewerken toevoegen of verwijderen vraagt de rol Kan bewerken of Kan beheren in die Space, en mislukt anders met 403; zie Spaces die niet elk lid kan bewerken. Een mapping die de PUT ongewijzigd herhaalt, vraagt geen rol.
SharePoint-mappings
Een SharePoint-mapping verbindt een Space met een map of met één los bestand. De externalId is het drive-ID van de documentbibliotheek en het ID van het item in Microsoft Graph, met een dubbele punt ertussen: {driveId}:{itemId}.
- Een
sharepoint_folder-mapping geeft de Space de bestanden die direct in die map staan. Of hij ook alles in de submappen meeneemt (Met submappen in Tibata), stel je in Tibata in, niet via de API.GETtoont de map in beide gevallen alssharepoint_folder. - Een
sharepoint_file-mapping geeft de Space dat ene bestand. - Een
PUTdie een mapping herhaalt, laat die zoals hij is, met wat er in Tibata voor is ingesteld: of hij de submappen meeneemt, de bestanden die eronder zijn weggelaten, en de stand van het bijwerken. Een mapping die dePUTweglaat, verdwijnt, met de bestanden die eronder waren weggelaten. - Een map of bestand dat de Space al via een andere koppeling heeft, zoals het Microsoft-account van een collega, wordt niet twee keer opgeslagen. Het antwoord noemt de mapping wel, omdat het de aanvraag herhaalt.
- De API-sleutel leest SharePoint nooit. Tibata leest de bestanden van een mapping met het Microsoft-account van iemand die de Space gebruikt en er een heeft verbonden, net als bij een mapping die in Tibata is gemaakt. Zie SharePoint koppelen.
Een Space aan een administratie koppelen
- Vraag de koppelingen van je organisatie op met List Connections en noteer de
idvan de koppeling. - Maak een Space aan met Create Space, of zoek hem op met List Spaces, en noteer de
idvan de Space. - Koppel de Space met Update Mappings:
internalTypeisspace,internalIdis deidvan de Space enexternalIdis het ID van de administratie, zoals het divisienummer in Exact Online.