Google Sheets
B1 Export er det offisielle Google Sheets-tillegget for B1.church. Det legger til en sidepanel i et hvilket som helst regneark, og eksporterer personer, gaver, grupper eller oppmøte fra kirken din i B1 til navngitte faner, på forespørsel, med ett klikk. Tillegget kjører helt inne i brukerens Google-konto. Det er ingen annen kontakt med ChurchApps' servere enn de skrivebeskyttede API-kallene hver eksport gjør.
B1 Export-tillegget er ikke publisert i Google Workspace Marketplace ennå, så du kan ikke installere det i dag. Inntil det er publisert, eksporter personer fra B1 Admin (se Eksportere data) og importer CSV-filen til Google Sheets. Alt nedenfor beskriver hvordan tillegget vil fungere når det er lansert.
Før du begynner
- En Google-konto med redigeringstilgang til regnearket du vil eksportere til
- En kirkeadministrator (eller noen med lesetilgang til dataene du vil eksportere) som kan lage en B1 API-nøkkel
- B1 Export-tillegget installert fra Google Workspace Marketplace
Hva det eksporterer
| Menyelement | Regnearkfane | Data |
|---|---|---|
| Eksporter personer | B1 People | ID, visningsnavn, fornavn, etternavn, e-post, medlemsstatus |
| Eksporter gaver | B1 Donations | ID, person-ID, dato, beløp, metode, batch-ID |
| Eksporter grupper | B1 Groups | ID, navn, kategori, antall medlemmer |
| Eksporter oppmøte | B1 Attendance | ID, person-ID, besøksdato, gudstjeneste-ID, gruppe-ID |
Hver eksport erstatter innholdet i den navngitte fanen. Kjører du eksporten på nytt, får du et nytt øyeblikksbilde, ikke nye rader lagt til under. Andre faner i regnearket blir ikke berørt.
Oppsett
1. Lag en B1 API-nøkkel med riktige omfang
- I B1 Admin går du til Innstillinger → Utvikler → API-nøkler.
- Klikk på Ny API-nøkkel, gi den navnet «Sheets Export», og gi lese-omfang for det du planlegger å eksportere:
people:readfor eksport av personerdonations:readfor gavergroups:readfor grupperattendance:readfor oppmøte
- En nøkkel som bare brukes til eksport trenger ikke
settings:write. Det omfanget er bare for connectorer som registrerer webhooks (Zapier / Make). Hold denne nøkkelen smal. - Lagre og kopier
cak_…-nøkkelen.
2. Installer tillegget
- Åpne regnearket du vil eksportere til.
- Utvidelser → Tillegg → Hent tillegg.
- Søk etter B1 Export og installer det. Google ber deg gi tilgang til regnearkene dine og til eksterne HTTP-kall (slik at tillegget kan kalle B1 API-et).
Etter installasjonen vises et B1 Export-punkt under menyen Utvidelser i alle regneark du åpner med denne Google-kontoen.
3. Koble til nøkkelen
- Utvidelser → B1 Export → Koble til… (eller B1 Export → Koble til… i menylinjen etter første åpning).
- Lim inn API-nøkkelen i sidepanelet, la basis-URL-en stå som
https://api.churchapps.org(med mindre du tester mot staging), og klikk på Lagre. - Klikk på Test tilkobling. En grønn «Tilkobling OK» bekrefter at nøkkelen fungerer.
Nøkkelen lagres i brukerspesifikke egenskaper (PropertiesService.getUserProperties()). Den er knyttet til Google-kontoen din, skrives aldri inn i regnearket, og er aldri synlig for andre redigerere av regnearket.
Kjøre en eksport
Enten:
- Fra menyen: Utvidelser → B1 Export → Eksporter personer (eller gaver / grupper / oppmøte)
- Fra sidepanelet: åpne sidepanelet (Koble til…) og klikk på riktig datasettknapp
En melding bekrefter når det er ferdig: «N rad(er) skrevet til "B1 People"».
Bygge rapporter oppå
De eksporterte fanene er vanlige Google Sheets-data. Bygg egne analyser ved å referere til fanene:
- En oppsummeringsfane med
=SUMIF('B1 Donations'!E:E, "card", 'B1 Donations'!D:D)for å summere kortgaver - En filtrert visning som bare viser medlemmer med
=FILTER('B1 People'!A:F, 'B1 People'!F:F = "Member") - Et diagram over oppmøtetrender som henter data fra
B1 Attendance
Kjører du eksporten på nytt, oppdateres den underliggende fanen. Formlene dine oppdateres automatisk.
Planlegge gjentakende eksporter
Tillegget kjøres på forespørsel som standard. For ukentlige eller månedlige eksporter bruker du Apps Scripts innebygde tidsstyrte utløsere:
- Utvidelser → Apps Script i regnearket (dette åpner tilleggets tilknyttede skript).
- Klikk på ⏰ Utløsere-ikonet i venstre sidepanel.
- Legg til utløser for
exportPeople(eller en annen eksportfunksjon). Velg Tidsstyrt, Ukentlig timer, f.eks. Hver mandag kl. 06.
Eksporten kjører i bakgrunnen under Google-kontoen din. Hvis API-nøkkelen byttes ut eller trekkes tilbake, sender utløseren deg en e-post neste gang den mislykkes.
Tillatelser og personvern
- Tillegget ber bare om
spreadsheets.currentonly(det kan bare røre regnearket det er åpnet i) ogscript.external_request(slik atUrlFetchAppkan kalle B1 API-et). Det ser ikke Drive, Gmail eller andre Google-data dine. - B1 API-nøkkelen lagres per bruker. Andre redigerere av samme regneark kan ikke se den.
- Alle B1 API-kall gjøres over HTTPS med
Authorization: Bearer cak_….
Feilsøking
- «Ingen API-nøkkel er satt»: åpne Utvidelser → B1 Export → Koble til… og lim inn nøkkelen.
- «B1 avviste API-nøkkelen (401)»: nøkkelen er slettet eller feil. Lag en ny nøkkel og lim den inn.
- «Denne API-nøkkelen mangler tillatelse for /giving/donations (403)»: nøkkelen har ikke
donations:read. Omfang kan ikke endres på en eksisterende nøkkel, så lag en ny nøkkel med riktige omfang i B1 Admin. - Regnearket oppdateres ikke etter kjøring: sjekk at du ser på riktig fanenavn (
B1 Peopleosv.). Eksporten oppretter fanen hvis den ikke finnes. - «Kvote overskredet»: Apps Script setter daglige kvoter per bruker for
UrlFetchApp(vanligvis tusenvis av kall per dag). En stor kirke med mange registreringer kan trenge å dele eksportene over flere dager, eller bruke Make / en egen integrasjon for synkronisering med høyt volum.
Mangler en kolonne?
Hvis du vil ha en kolonne vi ikke eksporterer, et ekstra datasett eller et annet utdataformat, send e-post til support@churchapps.org.
Se også
- Zapier for synkronisering i sanntid i stedet for eksport på forespørsel
- Make for synkronisering med mer kompliserte transformasjoner
- API-nøkler (referanse for utviklere)