Pag-parse ng Schedule
Awtomatikong nag-iimport ang pag-parse ng schedule ng availability ng iyong facility mula sa mga external na booking platform. Kumonekta nang minsan lamang, at hayaang awtomatikong i-sync ng sistema ang iyong mga slot.
Ano ang Pag-parse ng Schedule?
Ikinokonekta ng pag-parse ng schedule ang iyong sports facility sa isang external na booking platform (tulad ng PickleHub o Rezerv) upang awtomatikong mag-sync ang availability ng iyong facility. Sa halip na manu-manong ilagay ang bawat time slot sa portal, direktang ini-import ang mga bukas na oras ng iyong facility mula sa platform kung saan mo na pinamamahalaan ang mga booking.
Nakakatipid ito ng oras at iniiwasan ang double entry: iisang lugar lang ang schedule na pinapanatili mo, at laging may pinakabagong availability ang portal.
| Konsepto | Kahulugan |
|---|---|
| Parser | Ang serbisyong bumabasa ng availability ng iyong facility mula sa external na platform |
| Source | Ang external na booking platform kung saan nakalista ang iyong facility |
| Sync | Awtomatiko at pana-panahong pag-update ng mga slot mula sa source |
Opsyonal ang pag-parse. Maaari mong pamahalaan nang buo ang schedule ng iyong facility sa loob ng portal kung mas gusto mo.
Kailan Gamitin ang Pag-parse
Gamitin ang pag-parse ng schedule kung:
- Nakalista ang iyong facility sa isang external na platform — May account ka at aktibong facility page sa isa sa mga sinusuportahang platform (PickleHub, Rezerv, Playtomic, XBook, Courtly, Skedna, CourtGrid, Dulaco, Kortos, SuperSaaS, Courtogo)
- Gusto mo ng iisang pinagmumulan ng katotohanan — Booking mo ay pinamamahalaan lamang (o pangunahin) sa external na platform at gusto mong ipakita ng portal ang schedule na iyon
- Gusto mong bawasan ang manwal na gawain — Hayaang mag-import ng mga slot ang sistema sa halip na i-type ang mga ito nang mano-mano
Huwag gamitin ang pag-parse kung:
- Ang schedule ng iyong facility ay nasa portal lamang
- Wala kang account sa alinmang sinusuportahang external na platform
- Pinamamahalaan mo ang mga booking sa maraming platform at kailangan ng custom na pagsasama-sama
Mga Sinusuportahang Source
| Source | URL | Status | Mga Tala |
|---|---|---|---|
| PickleHub | https://picklehub.ph | ✅ Handa | Buong suporta |
| Sports360 | https://app.sports360.ph | ⚠️ Limitado | Hindi nagbibigay ng presyo ang mga facility sa platform na ito, kaya hindi lumilitaw ang kanilang mga slot sa portal |
| Rezerv | https://<clubname>.rezerv.co | ✅ Handa | Buong suporta |
| Playtomic | https://playtomic.com/clubs/example | ⚠️ Limitado | Presyo ay nasa libreng oras lamang; hindi ipinapakita sa grid ang mga occupied na oras |
| XBook | https://<tenant-host>/<slug> | ✅ Handa | Multi-tenant na platform; nasa URL ang login at password (tingnan ang tala para sa XBook sa ibaba) |
| Courtly | https://www.courtly.cc/book/example | ✅ Handa | Buong suporta |
| Skedna | https://skedna.com/courts/example | ✅ Handa | Buong suporta |
| CourtGrid | https://courtgrid.ph | ✅ Handa | Buong suporta |
| Dulaco | https://<slug>.dulaco.net | ✅ Handa | Multi-tenant na platform; natatanging subdomain para sa bawat facility |
| Kortos | https://<tenant>.kortos.app/book | ✅ Handa | Multi-tenant na booking platform; palitan ang <tenant> ng pangalan ng iyong tenant |
| SuperSaaS | https://www.supersaas.com/schedule/<account>[/<schedule>] | ⚠️ Limitado | Hindi nagbibigay ng presyo ang source, kaya hindi ginagawa ang mga slot nito sa portal. Kailangan ng mga pribadong schedule ang parameter na ?email= |
| Courtogo | https://www.courtogo.com/venues/<venue> | ✅ Handa | Buong suporta |
Pag-setup ng Pag-parse
Sundin ang mga hakbang na ito upang paganahin ang pag-parse ng schedule para sa isang facility:
Buksan ang Facility Editor
Pumunta sa iyong facility management page at i-click ang edit icon sa facility card. Magbubukas sa kanan ang isang drawer panel.
I-expand ang Parsing Section
Hanapin ang “Parsing” accordion sa drawer. I-click ito upang ipalawak.
Paganahin ang Pag-parse
I-toggle ang “Enable Parsing” switch upang i-on ito. Lalabas ang mga karagdagang field sa ibaba.
Pumili ng Source
Sa dropdown menu, piliin ang external na platform kung saan nakalista ang iyong facility. Lalabas ang isang halimbawang URL sa ilalim ng field bilang gabay.
Ipasok ang Facility URL
I-paste ang buong URL ng facility page mo sa external na platform. Halimbawa:
- PickleHub:
https://picklehub.ph/club-name - Sports360:
https://app.sports360.ph/facility/xyz - Rezerv:
https://clubname.rezerv.co - Playtomic:
https://playtomic.com/clubs/example - XBook:
https://<host>/<path>?username=<login>&password=<password> - Courtly:
https://www.courtly.cc/book/example - Skedna:
https://skedna.com/courts/example - CourtGrid:
https://courtgrid.ph/explore/019f058e-8025-707c-91db-ad2fcdb8cb2b - Dulaco:
https://<your-club-slug>.dulaco.net - Kortos:
https://<tenant>.kortos.app/book - SuperSaaS:
https://www.supersaas.com/schedule/<account>/<schedule> - Courtogo:
https://www.courtogo.com/venues/<venue>
Tala para sa XBook: Nasa URL ang XBook login at password mo, kaya sine-save ang mga ito kasama ng URL sa oras na ilagay mo ito. Maaari silang lumitaw sa browser history at sa mga log ng mga proxy at server na dinadaanan ng URL. Nakikita sila ng mga user na may karapatang mag-edit ng parsing settings ng facility na ito, at ibinabalik ng API ng portal ang na-save na URL sa mga user na iyon. Tinatakpan ng application logs ang mga credential. Inirerekomenda namin ang hiwalay na XBook account na ginagamit lamang para basahin ang schedule, sa halip na ang pangunahing account mo.
Tala para sa SuperSaaS: Sa mga pampublikong schedule, sapat na ang link ng schedule. Para sa pribadong schedule, idagdag sa link ang ?email=<address na may access sa schedule>. Walang ibang query parameter na tinatanggap.
I-scan ang mga Court
I-click ang scan button (radar icon) sa kanang bahagi ng URL field. Kumokonekta ang sistema sa external na platform at kumukuha ng listahan ng lahat ng court sa venue na ito.
Piliin ang Iyong Court
Pagkatapos makumpleto ang scan, lalabas ang isang dropdown na nagpapakita ng lahat ng court na nahanap sa platform. Piliin ang isang court mula sa listahan na nais mong i-sync sa pamamagitan ng parser. Kung marami kang court at nais mong i-sync silang lahat, i-set up nang hiwalay ang pag-parse para sa bawat isa.
Subukan ang Koneksyon
I-click ang “Test parsing” button sa ibaba ng court dropdown. Sinisimulate ng sistema ang pag-import ng mga slot para sa sinubukang panahon at nagpapakita ng summary:
May 42 bakante at 10 naka-book na slot sa sinuring panahon, huling bakante 25.05 19:00I-click ang “Show Details” upang makita ang talahanayan ng lahat ng nahanap na slot (petsa, oras, court).
I-save
Kung matagumpay ang test, i-click ang “Save” sa drawer header. Aktibo na ngayon ang pag-parse.
Pamamahala ng Aktibong Pag-parse
Kapag naka-enable na ang pag-parse para sa isang facility:
Awtomatikong tumatakbo ang parser ayon sa schedule. Lumalabas sa iyong Facility Schedule ang mga na-import na slot. Nagaganap ang buong update ng lahat ng slot humigit-kumulang isang beses kada oras para sa bawat facility, habang ina-update ang pinakamalapit na mga araw sa bawat pagtakbo ng parser.
Sa paghahanap, ang nakikita lamang ng mga customer ay ang talagang iniulat ng source: ipinapakitang libre ang isang oras kung kinumpirma ito ng source. Hindi ipinapakitang libre ang mga oras na walang datos mula sa source (lampas sa na-update na saklaw o bago ang unang load). Kung isinara mo ang buong facility sa external na platform (halimbawa, para sa repair), ipapakita sa portal ang mga libre nitong oras bilang naka-book (sa dating presyo) pagkatapos ng susunod na load.
| Aksyon | Epekto |
|---|---|
| I-toggle off | Pansamantalang ihihinto ang pag-parse; nananatili ang mga naka-save na setting, kasama ang URL, ngunit walang bagong slot na ii-import |
| I-toggle on | Ipagpapatuloy ang pag-parse at muling mag-iimport ng mga slot |
| I-edit ang URL | I-scan muli ang mga court at i-test bago mag-save |
| Burahin ang configuration | Inaalis ang setup ng pag-parse; nananatili ang mga dati nang na-import na slot |
Ang Run history ng facility ay nagtatala ng dalawang uri ng event:
- Sync — pagtakbo na nagbago ng mga slot: ilan ang nadagdag, na-update, at isinara.
- Error — pagtakbo na nabigo, kasama ang error message at ang URL na tinakpan ang mga credential.
Hindi nakalista ang mga pagtakbong walang binagong slot. Para makita ang pinakahuling matagumpay na check, tingnan ang Last checked sa itaas ng Run history. Available ang button na Run history pagkatapos mong i-save ang facility, at nakikita ang Run history ng mga user na may karapatang tingnan ang facility.
Mga Presyo ng Slot
Kinukuha ng portal ang presyo ng bawat slot mula lamang sa data ng external na platform. Hindi gumagawa ng presyo ang portal at hindi ito gumagamit ng default na halaga.
- Nagbigay ang platform ng presyo — lalabas ang slot na may presyong iyon.
- Itinakda ng platform ang presyo sa 0 — lalabas ang slot na may presyong 0. Ito ang tunay na presyo mula sa source.
- Walang naibigay na presyo ang platform para sa oras (halimbawa, walang rate para sa mga oras sa gabi) o hindi mabasa ang rate — hindi ginagawa at hindi ipinapakita sa portal ang slot para sa oras na iyon. Hindi kailanman ginagamit ang 0 bilang kapalit ng nawawalang presyo.
- Nawala sa data ang libreng oras — kung ang oras na dating libre ay wala na sa pinakabagong data ng platform, isasara ito sa portal at ipapakitang naka-book sa dating presyo.
- Playtomic — ang presyo ay ibinibigay lamang para sa mga libreng oras. Ang mga naka-book na oras ay hindi ipinapakita sa grid — may bakanteng espasyo sa halip na “naka-book”. Ito ay sinadyang limitasyon.
- Sports360 at SuperSaas — hindi nagbibigay ng presyo ang mga platform na ito, kaya hindi ginagawa ang mga slot para sa kanila sa portal.
- Mga lumang slot na may presyong 0.00 — ang mga slot na may presyong 0.00 na ginawa noon at nasa labas ng period na ina-update ng parser ay hindi nababago.
Pareho ang panuntunan para sa mga naka-book na slot: kung hindi alam ang presyo ng naka-book na oras, hindi ginagawa ang slot na iyon sa portal.
Kung hindi lumalabas sa schedule ang inaasahang oras, tingnan sa external na platform kung may rate na nakatakda para sa oras na iyon.
Troubleshooting
Kung makakaranas ka ng error habang nag-setup o sumusubok ng pag-parse, tingnan ang talahanayang ito:
| Error Message | Dahilan | Solusyon |
|---|---|---|
| Ang URL ay hindi wasto o may maling format | Maling format ng URL | Tingnan ang URL sa address bar ng browser at kopyahin ito nang eksakto |
| Hindi nahanap ang pasilidad sa URL na ito | Tama ang URL, ngunit wala ang facility sa platform (o pansamantalang hindi sumasagot ang platform sa mga verification request) | Awtomatikong susubukan ulit ng sistema ang pagsusuring ito sa susunod na sync cycle. Kung patuloy ang error, i-verify na tugma ang pangalan ng facility sa external na platform, o makipag-ugnayan sa support ng platform |
| Pansamantalang hindi available ang pinagkukunan. Subukan ulit mamaya | Hindi sumasagot ang external na platform | Maghintay ng ilang minuto at subukan muli |
| Nag-timeout ang paghihintay ng tugon mula sa pinagkukunan | Masyadong matagal sumagot ang source | Maaaring mabagal ang platform; maghintay at subukan muli |
| Hindi ma-parse ang tugon ng pinagkukunan | Nagbalik ang source ng hindi inaasahang format | Maaaring hindi pa lubos na suportado ang source na ito; tingnan ang seksyong Sinusuportahang Source |
Naka-lock ang iskedyul sa likod ng login sa site ng pinagkukunan — pampublikong iskedyul lang ang nababasa ng parser. Idagdag sa link ang ?email=<email na may access sa iskedyul>, gawing pampubliko ang iskedyul sa mga setting ng pinagkukunan, o maglagay ng link sa pampublikong iskedyul | Pribado ang iskedyul at humihingi ng login ang source (SuperSaaS) | Idagdag sa link ang ?email= na may address na may access sa iskedyul, gawing pampubliko ang iskedyul, o gumamit ng link sa pampublikong iskedyul |
| Hindi tinanggap ng pinagkukunan ang email address mula sa link nang mag-sign in. Tiyaking may access ang email na ito sa iskedyul sa site ng pinagkukunan, o maglagay ng link na may tamang email | Walang access sa iskedyul ang address sa ?email= | Tiyaking may access ang address na ito sa iskedyul sa site ng source, o maglagay ng link na may address na may access |
| Pansamantalang hindi available ang serbisyo ng pag-parse. Makipag-ugnayan sa admin | Offline ang parsing service ng portal | Makipag-ugnayan sa admin |
| Hindi naka-configure ang pinagkukunan sa server. Makipag-ugnayan sa admin | Hindi naka-set up ang backend para sa source na ito | Makipag-ugnayan sa admin |
| Hindi na sinusuportahan ang pinagkukunan | Na-deprecate na ang source na ito | Pumili ng ibang source |
| Walang nahanap na pasilidad sa URL na ito | Tama ang URL, sumagot ang parser ngunit walang ibinalik na object | Tiyaking may nakalistang court o pasilidad talaga ang pahina ng club |
| Hindi wastong data ng kahilingan | May nangyaring mali sa panig ng portal | Makipag-ugnayan sa admin |
Susunod na mga Hakbang
Kapag aktibo na ang pag-parse:
- Awtomatikong lumalabas ang mga slot — Tingnan ang iyong Facility Schedule para sa mga na-import na time slot
- Nangyayari ang sync nang pana-panahon — Lumalabas sa portal ang mga bago at na-update na slot mula sa external na platform
- Pamahalaan ang mga slot gaya ng dati — Maaari ka pa ring gumawa, mag-edit, o magbura ng mga slot sa loob ng portal; hindi hinaharangan ng pag-parse ang manwal na pagsasaayos
- Tingnan ang mga pagtakbo — Buksan ang Run history para makita ang mga pagbabago sa slot at mga error
Kung i-disable mo ang pag-parse at pagkatapos ay muling i-enable ito, kukuha ulit ang parser ng mga slot mula sa kung saan ito tumigil. Hindi maaapektuhan ang mga dating portal-only na slot.
Mga Madalas na Itanong
Sinusuportahan ba ng parser ang mga facility na tumatakbo lampas hatinggabi?
Oo. Sinusuportahan ng parser ang mga schedule na lumalampas sa hatinggabi. Halimbawa, kung bukas ang facility mula 06:00 hanggang 01:00 (6 AM hanggang 1 AM ng susunod na araw), ini-import ng parser ang mga slot ng mga oras na iyon nang walang error. Hindi kailangan ng karagdagang configuration. Lalabas lamang ang slot sa portal kung nagbigay ang platform ng presyo para dito. Kung walang rate na nakatakda para sa mga oras sa gabi, hindi ipapakita sa portal ang mga oras na iyon.