Lumipat sa pangunahing nilalaman

Google Sheets

Ang B1 Export ang opisyal na add-on ng Google Sheets para sa B1.church. Naglalagay ito ng sidebar sa alinmang spreadsheet para i-export ang People, Donations, Groups, o Attendance mula sa iyong B1 church papunta sa mga pinangalanang tab — kapag kailangan, sa isang click lang. Ganap na tumatakbo ang add-on sa loob ng Google account ng user; walang ginagawa ito sa mga server ng ChurchApps maliban sa mga read-only na API call na ginagawa ng bawat export.

Hindi pa available

Hindi pa nailalathala ang B1 Export add-on sa Google Workspace Marketplace, kaya hindi mo pa ito maii-install ngayon. Hanggang sa maging available ito, i-export ang mga tao mula sa B1Admin (tingnan ang Exporting Data) at i-import ang CSV sa Google Sheets. Inilalarawan ng lahat ng nasa ibaba kung paano gagana ang add-on kapag nailabas na ito.

Bago Ka Magsimula

  • Isang Google account na may edit access sa spreadsheet na gusto mong pagexport-an
  • Isang church admin (o sinumang may read access sa datos na gusto mong i-export) na kayang gumawa ng B1 API key
  • Ang B1 Export add-on na naka-install mula sa Google Workspace Marketplace

Ano ang Ine-export Nito​

Menu itemTab ng sheetDatos
Export PeopleB1 PeopleID, Display Name, First, Last, Email, Membership Status
Export DonationsB1 DonationsID, Person ID, Date, Amount, Method, Batch ID
Export GroupsB1 GroupsID, Name, Category, Member Count
Export AttendanceB1 AttendanceID, Person ID, Visit Date, Service ID, Group ID

Bawat export ay pumapalit sa laman ng pinangalanang tab nito — ang pag-ulit ng export ay nagbibigay ng bagong snapshot, hindi dinadagdag na mga row. Hindi naaapektuhan ang ibang tab sa spreadsheet.

Setup​

1. Gumawa ng B1 API key na may tamang scope​

  1. Sa B1Admin, pumunta sa Settings → Developer → API Keys.
  2. I-click ang New API Key, pangalanan itong "Sheets Export", at bigyan ng read scope ang anumang ie-export mo:
    • people:read para sa People export
    • donations:read para sa Donations
    • groups:read para sa Groups
    • attendance:read para sa Attendance
  3. Hindi kailangan ng key na para lang sa export ang settings:write — para lang ito sa mga connector na nagrerehistro ng webhook (Zapier / Make). Panatilihing makitid ang key na ito.
  4. I-save at i-copy ang cak_… key.

2. I-install ang add-on​

  1. Buksan ang spreadsheet na gusto mong pagexport-an.
  2. Extensions → Add-ons → Get add-ons.
  3. Maghanap ng B1 Export at i-install ito. Hihingi ang Google ng pahintulot na i-access ang iyong mga sheet at ang external HTTP (para matawag ng add-on ang B1 API).

Pagkatapos ng install, lalabas ang entry na B1 Export sa ilalim ng menu na Extensions ng bawat spreadsheet na bubuksan mo gamit ang Google account na ito.

3. Ikonekta ang key​

  1. Extensions → B1 Export → Connect… (o B1 Export → Connect… mula sa menu bar pagkatapos ng unang pagbukas).
  2. I-paste ang API key sa sidebar, iwanang https://api.churchapps.org ang Base URL (maliban kung nagte-test ka sa staging), at i-click ang Save.
  3. I-click ang Test Connection — kinukumpirma ng berdeng "Connection OK" na gumagana ang key.

Nakaimbak ang key sa per-user properties (PropertiesService.getUserProperties()) — nakatali ito sa iyong Google account, hindi kailanman isinusulat sa sheet, at hindi nakikita ng ibang editor ng spreadsheet.

Pagpapatakbo ng Export​

Alinman sa:

  • Mula sa menu — Extensions → B1 Export → Export People (o Donations / Groups / Attendance)
  • Mula sa sidebar — buksan ang sidebar (Connect…) at i-click ang angkop na dataset button

Kinukumpirma ng toast kapag tapos na — "N row(s) written to 'B1 People'."

Paggawa ng Mga Ulat Gamit Ito​

Ang mga na-export na tab ay simpleng datos ng Google Sheets. Gumawa ng sarili mong analytics sa pamamagitan ng pag-reference sa mga tab:

  • Isang summary tab na may =SUMIF('B1 Donations'!E:E, "card", 'B1 Donations'!D:D) para i-total ang mga regalong card
  • Isang filtered view ng mga miyembro lang gamit ang =FILTER('B1 People'!A:F, 'B1 People'!F:F = "Member")
  • Isang chart ng mga trend ng attendance na kumukuha mula sa B1 Attendance

Kapag inulit mo ang export, nare-refresh ang pinagbabatayang tab; awtomatikong nag-a-update ang iyong mga formula.

Pag-iskedyul ng Paulit-ulit na Export​

Ang add-on ay on-demand bilang default. Para sa lingguhan o buwanang export, gamitin ang mga built-in na time-driven trigger ng Apps Script:

  1. Extensions → Apps Script sa spreadsheet (magbubukas ito ng naka-bind na script ng add-on).
  2. I-click ang icon na ⏰ Triggers sa kaliwang sidebar.
  3. Add Trigger para sa exportPeople (o anumang export function) — piliin ang Time-driven, Week timer, hal. Every Monday 6am.

Tumatakbo ang export sa background sa ilalim ng iyong Google account. Kung napalitan o nabawi ang API key, magpapadala sa iyo ng email ang trigger sa susunod na pagkabigo nito.

Pahintulot at Privacy​

  • Humihingi lang ang add-on ng spreadsheets.currentonly (ang spreadsheet lang na bukas dito ang puwede nitong galawin) at script.external_request (para matawag ng UrlFetchApp ang B1 API). Hindi nito nakikita ang iyong Drive, Gmail, o iba pang datos ng Google.
  • Naka-imbak ang B1 API key kada user — hindi ito makikita ng ibang editor ng parehong spreadsheet.
  • Lahat ng tawag sa B1 API ay ginagawa sa HTTPS gamit ang Authorization: Bearer cak_….

Troubleshooting​

  • "No API key set" — buksan ang Extensions → B1 Export → Connect… at i-paste ang key.
  • "B1 rejected the API key (401)" — nabura ang key o mali ito. Gumawa ng bagong key at i-paste ito.
  • "This API key lacks permission for /giving/donations (403)" — walang donations:read ang key. Hindi mababago ang scope ng umiiral na key, kaya gumawa ng bagong key na may tamang scope sa B1Admin.
  • Hindi nagre-refresh ang sheet pagkatapos tumakbo — siguraduhing tinitingnan mo ang tamang pangalan ng tab (B1 People atbp.). Ginagawa ng export ang tab kung wala pa ito.
  • "Quota exceeded" — nagpapataw ang Apps Script ng araw-araw na quota kada user sa UrlFetchApp (karaniwang libu-libong tawag kada araw). Maaaring kailangang hatiin ng malaking simbahan na maraming record ang mga export sa maraming araw, o gumamit ng Make / custom na integration para sa high-volume na sync.

Kulang ang Isang Column?​

Kung gusto mo ng column na hindi namin ine-export, dagdag na dataset, o ibang output format, mag-email sa support@churchapps.org.

Tingnan Din​