Spreadsheetexports

1. Welke u kiest

Ze doen hetzelfde werk. Het verschil is welk account uw bedrijf al gebruikt.

	Google Sheets	Microsoft SharePoint
Een rij wordt	een rij die aan een werkblad wordt toegevoegd	een item in een lijst
U geeft op	een sleutel voor een serviceaccount en de spreadsheet-ID	tenant, client-ID, clientgeheim, site-ID en lijst-ID
Kolommen	vaste volgorde, acht kolommen	de kolommen die uw lijst heeft; we vragen ze eerst op
Configuratiewerk	een serviceaccount maken en het werkblad ermee delen	een app registreren en toegang tot één site geven

2. Google Sheets: de deelstap die iedereen vergeet

Een serviceaccount is een zelfstandige gebruiker, met een eigen e-mailadres dat eindigt op .iam.gserviceaccount.com. De sleutel maken is niet voldoende: u moet de spreadsheet met dat adres delen, net zoals u dat met een collega zou doen.

Slaat u dit over, dan levert elke schrijfactie 403 op. We noemen deze oorzaak expliciet in de foutmelding, omdat Google die zelf niet vermeldt en mensen anders een middag aan de sleutel besteden.

Plak de volledige URL als dat eenvoudiger is

De spreadsheet-ID is het deel tussen /d/ en /edit. Plak het volledige adres in het veld; we halen het benodigde deel eruit.

Waarden worden bewust zonder interpretatie geschreven

Niet als “door gebruiker ingevoerd”. Anders zou Google een klant-ID zoals 00123 als getal lezen en de voorloopnullen verwijderen, en zou een waarde die begint met = een formule worden.

3. SharePoint: we lezen uw kolommen voordat we schrijven

SharePoint weigert een item dat een kolom noemt die niet in de lijst bestaat. De interne kolomnamen zijn wat u bij het maken van de lijst hebt gekozen. Een vaste set aannemen zou een gok zijn die bij de helft van de klanten verkeerd uitpakt.

Daarom halen we de kolommen van de lijst eenmaal per uur op en schrijven we alleen naar bestaande kolommen die niet alleen-lezen zijn. Een lijst met alleen de standaardkolom Title krijgt uitsluitend de doelnaam, in plaats van bij elk doel te mislukken.

De optionele kolommen, als u ze aanmaakt: MPSession, MPChannel, MPUser, MPValue, MPCurrency, MPUrl, MPTime.

De door Microsoft aanbevolen machtiging is niet wat u wilt

Voor deze aanroep noemt de documentatie van Microsoft Sites.ReadWrite.All als machtiging met de minste rechten. Dat geeft schrijftoegang tot elke site in uw tenant, voor een integratie die één lijst vult.

Gebruik in plaats daarvan Sites.Selected : een app met die machtiging heeft standaard helemaal geen toegang, en een beheerder geeft deze schrijftoegang tot precies één site. Beide machtigingen verlenen heft de beperking op ; de beperkte machtiging werkt alleen zolang de app geen andere heeft.

4. Wat er in de rij komt

Tijdstempel, project, sessie, klant-ID, doelnaam, waarde, valuta en de link om de opname af te spelen. In SharePoint gaan dezelfde waarden naar de bestaande kolommen, in de vorm die het kolomtype vereist: een hyperlinkkolom krijgt een linkobject, een tekstkolom hetzelfde adres als tekst.

Een lege cel betekent “geen waarde afgesproken”, niet nul

Een doel zonder geldwaarde laat de cel leeg. Een nul zou in een spreadsheet meetellen in een totaal dat nooit heeft bestaan.

De klant-ID wordt bij aflevering opgezocht

Niet wanneer het doel wordt geactiveerd. Identificatie vindt meestal bij het inloggen plaats, dus vaak na het doel. Enkele seconden later opvragen is zowel goedkoper voor onze gebeurtenisverwerking als kansrijker om een naam te vinden.