Documents AI pildistamisliides. Väljade eraldamine on kavandatud.
Documents AI pildistamisliides. Väljade eraldamine on kavandatud.
← Kõik natiivrakenduste juhendid

Xodera Plugins · Bubble Native

Xodera Documents AI Native

Muuda kviitungi või kohaletoimetamise foto mustandvormiks. Lase AI-l soovitada kuupäeva, summat ja muid nõutud välju, seejärel lase inimesel need enne salvestamist üle vaadata.

Public beta guides · Haptics instructions are in its Bubble listing

Public beta offer: free Bubble install · 7-day card trial, then US$1.50/month per plugin/project.

Dokumentatsioon üle vaadatud 6 novembris 2026

Praktilised näited

Eeltäida kulukirje mustand kviitungipildilt

Müüja, kuupäeva ja summa korduv sisestamine aeglustab kuluandmete lisamist; eraldatud väljad võivad olla ülevaatamiseks mõeldud mustand.

`fields_json = ["merchant","date","total","currency"]`; kasutaja teeb kviitungi pildi ja annab eraldi nõusoleku töötlemiseks. Testimisel kasuta ainult näidiskviitungeid.

Kavandatud: `analysis_requested` → Analyze Captured Document, kasutades piiratud eksporditud baite, MIME-tüüpi, väljanimesid, nõusolekut ja päringu ID-d → näita tagastatud välju muudetavas Expense vormis.

Toiming tagastab `status`, `operation_id`, `fields_json` ja `review_required`. Kasutaja parandab või kinnitab väljad enne, kui töövoog loob Expense kirje.

Teadmata tulemuse korral kasuta Read Analysis sama `operation_id` väärtusega; ära käivita automaatselt uut analüüsi. Nõusoleku tagasivõtmine eemaldab alleshoitud pildi ja ekspordi; ära kunagi talleta toorest base64 sisu avalikus Thing kirjes ega logides.

Kavandatud. Isik peab iga soovitatud väärtuse üle vaatama enne salvestamist.

Loe tarnekirja viidet personali ülevaatuse vormi jaoks

Laokasutaja peaks saama soovitatud viite ja kuupäeva üle vaadata, mitte neid pildistatud paberdokumendilt käsitsi sisestama.

`fields_json = ["delivery_reference","supplier","delivery_date"]`; testimise ajal pildista näidissaatelehe asjakohast külge.

Pärast eraldi pildistamise ja töötlemise nõusolekut pakub Analyze Captured Document valitud väljade väärtusi. Näita fotot muudetavate väljade kõrval ja palu töötajal kinnitada vastav Delivery kirje.

Säilita tagastatud `operation_id` tulemuse uuesti kontrollimiseks ja `fields_json` ettepanekuna. Töövoog otsib või uuendab tegelikku Delivery kirjet alles pärast töötaja ülevaatust.

Puuduvad, ebaselged või valed väljad tuleb käsitsi parandada. Teenusepakkuja viga jätab algse Delivery kirje muutmata; kasuta Read Analysis teadmata tulemusega toimingu oleku kontrollimiseks.

Kavandatud. Isik peab iga soovitatud väärtuse üle vaatama enne salvestamist.

Soovita seadme seerianumbrit sildi fotolt

Hooldusvorm võib pakkuda ülevaatamiseks mõeldud mudeli/seeria ettepanekut, kui vara sildi sisestamine on tülikas.

`fields_json = ["manufacturer","model","serial_number"]`; pildista näidisseadme silti; vali projekti seadetes oma AI-teenuse pakkuja.

Kavandatud Analyze Captured Document toiming tagastab pakutud tekstiväärtused. Kuva need foto kõrval ja lase kasutajal need parandada enne Asset kirje otsingut või hoolduse töövoogu.

Kasuta tagastatud `fields_json`, `review_required` ja `operation_id` väärtusi. Käsitle identifikaatoreid tekstina, et rakendus säilitaks algusnullid.

Kui pilti ei saa lugeda või mudel pakub vale tekstiväärtust, luba käsitsi sisestamine. Pärast ebakindlat vastust loe sama toimingu tulemust, selle asemel et käivitada uus tasuline mudelipäring.

Kavandatud. Isik peab iga soovitatud väärtuse üle vaatama enne salvestamist.

Mis töötab praegu

Privaatne beetaversioon. Foto pildistamine on testimiseks saadaval. Fotost väljade ekstraheerimine on plaanis ja pole veel teie rakenduses kasutamiseks valmis.

Loo töövoog

Planeeritud

Planeeritud töövoog. Pole praeguses beetaversioonis veel saadaval.

Need näited kasutavad rakenduse kirjeid, nagu Lesson, Message ja Order. Asenda need oma andmetüüpide ja elementide nimedega. Näidismeedia aadresse tuleb asendada oma failidega.

  1. Planeeritud: vali vormi vajaminevad väljad, näiteks fields_json=["title","date","total"]. Luba enable_analysis_export ja määra analysis_context valitud kontole või kirjele. Need analüüsi seaded ei ole praeguses pildistamisversioonis saadaval.

  2. Luba kasutajal teha foto ja nõustuda eraldi töötlemisega. analysis_requested korral käivita Analyze Captured Document, kasutades selle elemendi analysis_image_base64, analysis_mime_type, analysis_fields_json ja analysis_consent. Kasuta analysis_request_id kui idempotency_key.

  3. Salvesta tagastatud operation_id, request_id ja status. Kui status on processing, kasuta sama operation_id väärtusega Read Analysis toimingut tulemuse hilisemaks lugemiseks.

  4. Kuva tagastatud fields_json muudetavas ülevaatusvormis. Salvesta kinnitatud väärtused alles pärast seda, kui kasutaja on need üle kontrollinud ja vajutanud Confirm. Säilita algne kirje kuni selle kinnituseni.

Töövoodiagramm — mitte rakenduse ekraanipilt

Seadista üks kord

Loo või vali oma Bubble rakenduse projekt BestPlugins → Dashboard → Plugins. Vali Xodera Documents AI Native, kopeeri selle võti, seejärel ava Bubble → Plugins → Xodera Documents AI Native ja kleebi see project_api_key. Salvesta üks kord; seejärel kasuta allolevaid tegevusi. Igal pistikprogrammil igas projektis on oma võti.

Küsi kaameraluba ja selgita, miks fotot on vaja. Töötlemiseks on vaja kasutaja eraldi nõusolekut. Vali projekti seadetes AI-teenuse pakkuja; kasutuse eest esitab arve see teenusepakkuja.

Seadista üks kord
  1. Loo või vali oma Bubble rakenduse projekt BestPlugins → Dashboard → Plugins.
  2. Vali see pistikprogramm ja kopeeri selle projekti võti.
  3. Ava Bubble → Plugins → Xodera Documents AI Native; kleebi võti project_api_key ja salvesta.
  4. Lisa element, vali oma rakenduse andmed ja loo allpool toodud töövoog.
  5. Praegu ainult privaatne beetakättesaadavus. Avalik paigaldamine ja tasuline aktiveerimine ei ole veel avatud.
Paigaldus ja tellimus

For Audio Player, Video Player, Photo Editor, Audio Recorder, Files Kit and Haptics: free Bubble installation, a 7-day trial with a card, then US$1.50 per month per plugin and app project. Development and production are included, with no operation cap. File-size and feature limits still apply. Review billing and cancellation before confirming. Other plugins remain unavailable for purchase.

Salvesta tulemus oma rakendusse

Näide ExpenseDraft: owner, operation_id, request_id, status ja proposed_fields_json. Pärast ülevaatamist salvesta kinnitatud kuupäev, summa ja muud väljad ning reviewed_by ja reviewed_at. Seo ainult vormi küsitud väljad. Ära pane kogu pildisisu logidesse ega tavalistesse tekstikirjetesse.

Tõrge, tühistamine ja taastamine

Kui tulemus viibib, säilita sama päring ja kasuta teadaoleva operation_id jaoks Read Analysis. Ära tee automaatselt uut fotot ega loo uut päringut. Kui kasutaja võtab nõusoleku tagasi, eemalda foto ja lõpeta tulemuse pakkumine; juba saadetud või salvestatud koopiat ei saa sellega tagasi kutsuda.

Võimekused ja piirangud

Planeeritud pildi sisend: PNG, JPEG või WebP, kuni 5 MiB; nõua 1–32 eraldi väljade nimesid. Alati vaata ekstraheeritud väärtused üle. See ei ole isiku tuvastamine, dokumendi autentsuse kontroll ega meditsiiniline otsustustööriist. AI-pakkuja tasud on eraldi.

Seaded, toimingud ja tulemused

Kasuta neid nimesid Bubble-s. Planeeritud funktsioonid on märgitud eraldi.

Saadaolevad beetaversiooni seaded

Elemendi seaded

document_side · textbutton_label · textconsent_text · textdisabled · yes/nofields_json · textprocessing_consent_text · textanalyze_button_label · textcheck_button_label · textlanguage · textui_text_json · text

Olekud

capture_status · textlocal_uri · textmime_type · textdocument_side · textimage_width · numberimage_height · numbererror_code · textis_capturing · yes/noanalysis_status · textanalysis_operation_id · textanalysis_fields_json · textanalysis_error_code · textreview_required · yes/nois_analyzing · yes/no

Sündmused

capture_startedcapture_succeededcapture_cancelledpermission_deniedcapture_erroranalysis_startedanalysis_readyanalysis_pendinganalysis_error

Toimingud ja nende sisendid

Elemendi seaded · 12

Planeeritud töövoog. Pole praeguses beetaversioonis veel saadaval.

document_sidetext · Vaikimisi: "front"
Näidisväärtusfront
Bubble avaldise näideCapture Side Dropdown's value
Kasutage praeguse ärirekordi väärtust; kontrollige seda allpool toodud piiride suhtes.
button_labeltext · Vaikimisi: ""
Näidisväärtus""
Bubble avaldise näideApp Texts' capture_label
Nähtav rakenduse tekst; tühja väärtuse korral kasutatakse toetatud juhtudel sisseehitatud tõlgitud teksti. Ära sisesta siia juurdepääsuandmeid.
consent_texttext · Vaikimisi: ""
NäidisväärtusI agree to capture this non-sensitive receipt.
Bubble avaldise näideApp Texts' capture_consent
Selgita konkreetset pildistamise/töötlemise eesmärki ja saajat. Nõusoleku tagasivõtmine kustutab säilitatud baidid, mitte varasemad rakenduse koopiad.
disabledyes/no · Vaikimisi: false
Näidisväärtusno
Bubble avaldise näideGuideHost's is_busy (your yes/no custom state)
Keela element, kui teie rakendus on hõivatud või see toiming pole saadaval.
processing_consent_texttext · Vaikimisi: ""
NäidisväärtusI agree to send this image to the configured AI provider for draft fields.
Bubble avaldise näideApp Texts' processing_consent
Selgita konkreetset pildistamise/töötlemise eesmärki ja saajat. Nõusoleku tagasivõtmine kustutab säilitatud baidid, mitte varasemad rakenduse koopiad.
analyze_button_labeltext · Vaikimisi: ""
Näidisväärtus""
Bubble avaldise näideApp Texts' analyze_label
Nähtav rakenduse tekst; tühja väärtuse korral kasutatakse toetatud juhtudel sisseehitatud tõlgitud teksti. Ära sisesta siia juurdepääsuandmeid.
languagetext · Vaikimisi: "auto"
Näidisväärtusuk
Bubble avaldise näideCurrent User's preferred_language
Määra language=auto, et kasutada seadme või brauseri keelt, kui see keel on toetatud. Kindla keele valimiseks sisesta toetatud keelekood.
ui_text_jsontext · Vaikimisi: ""
Näidisväärtus{}
Bubble avaldise näideApp Settings' player_labels_json (supported keys only)
Valikuline JSON toetatud nuppude siltidega. Jäta tühjaks, et kasutada sisseehitatud teksti.
enable_analysis_exportyes/no · Vaikimisi: false
Näidisväärtusyes
Bubble avaldise näideApp Settings' enable_reviewed_extraction
Kavandatud: luba analüüsitoimingul fotot kasutada pärast kasutaja mõlema nõusoleku saamist. Vaikimisi välja lülitatud.
analysis_contexttext · Vaikimisi: ""
Näidisväärtus<current-user-id>
Bubble avaldise näideCurrent User's unique id
Stabiilne väärtus selle konto või kirje jaoks. Selle muutmine eemaldab elemendist eelmise foto.
is_activeyes/no · Vaikimisi: true
Näidisväärtusyes
Bubble avaldise näideGuideHost's view_is_active (your yes/no custom state)
Määra yes, kui see vaade on avatud. Vaate sulgemisel määra no, et taasesitus või pooleliolev töö saaks peatuda.
fields_jsontext · Vaikimisi: "[\"title\",\"date\",\"total\"]"
Näidisväärtus["title","date","total"]
Bubble avaldise näideExpense Settings' extraction_fields_json
JSON massiiv nõutud ekstraheerimisväljade nimedest; väljund on ettepanekandmed inimeste ülevaatamiseks.
Toimingud ja nende sisendid · 2

Planeeritud töövoog. Pole praeguses beetaversioonis veel saadaval.

Analyze Captured Document
image_base64text · Vaikimisi: —
Näidisväärtus<canonical bytes from consented export>
Bubble avaldise näideDocument Capture's analysis_image_base64
Kasutage praeguse ärirekordi väärtust; kontrollige seda allpool toodud piiride suhtes.
mime_typetext · Vaikimisi: —
Näidisväärtusimage/jpeg
Bubble avaldise näideDocument Capture's analysis_mime_type
Kasutage praeguse ärirekordi väärtust; kontrollige seda allpool toodud piiride suhtes.
fields_jsontext · Vaikimisi: —
Näidisväärtus["title","date","total"]
Bubble avaldise näideDocument Capture's analysis_fields_json
JSON massiiv nõutud ekstraheerimisväljade nimedest; väljund on ettepanekandmed inimeste ülevaatamiseks.
consentyes/no · Vaikimisi: —
Näidisväärtusyes — current processing consent
Bubble avaldise näideDocument Capture's analysis_consent
Kasutage praeguse ärirekordi väärtust; kontrollige seda allpool toodud piiride suhtes.
idempotency_keytext · Vaikimisi: —
Näidisväärtus<unchanged analysis_request_id>
Bubble avaldise näideDocument Capture's analysis_request_id
Kasutage praeguse ärirekordi väärtust; kontrollige seda allpool toodud piiride suhtes.
environmenttext · Vaikimisi: —
Näidisväärtusdevelopment
Bubble avaldise näideApp Settings' selected_environment
Kasutage praeguse ärirekordi väärtust; kontrollige seda allpool toodud piiride suhtes.

Tagastatavad väärtused

ok · yes/nostatus · textoperation_id · textrequest_id · textfields_json · texterror_code · textreview_required · yes/no
Read Analysis
operation_idtext · Vaikimisi: —
Näidisväärtus<returned operation_id>
Bubble avaldise näideCurrent ExpenseDraft's operation_id
Kasutage praeguse ärirekordi väärtust; kontrollige seda allpool toodud piiride suhtes.
environmenttext · Vaikimisi: —
Näidisväärtusdevelopment
Bubble avaldise näideApp Settings' selected_environment
Kasutage praeguse ärirekordi väärtust; kontrollige seda allpool toodud piiride suhtes.

Tagastatavad väärtused

ok · yes/nostatus · textoperation_id · textrequest_id · textfields_json · texterror_code · textreview_required · yes/no
Olekud ja sündmused

Planeeritud töövoog. Pole praeguses beetaversioonis veel saadaval.

Olekud

capture_status · text

Selle toimingu praegune tulemus. Kasuta sobivat lõpetamise sündmust enne edu salvestamist.

local_uri · text

Faili asukoht selles seadmes. Salvesta või laadi fail eraldi üles, kui see peab olema internetis.

mime_type · text

Valitud üksuse praegune väärtus. Loe seda pärast seotud sündmust.

document_side · text

Valitud üksuse praegune väärtus. Loe seda pärast seotud sündmust.

image_width · number

Valitud üksuse praegune väärtus. Loe seda pärast seotud sündmust.

image_height · number

Valitud üksuse praegune väärtus. Loe seda pärast seotud sündmust.

error_code · text

Vea teave viimase toimingu kohta. Kuva abistav sõnum ja paku asjakohast kordamist.

is_capturing · yes/no

Valitud üksuse praegune väärtus. Loe seda pärast seotud sündmust.

analysis_image_base64 · text

Valitud üksuse praegune väärtus. Loe seda pärast seotud sündmust.

analysis_mime_type · text

Valitud üksuse praegune väärtus. Loe seda pärast seotud sündmust.

analysis_fields_json · text

Soovitatud väärtused nõutud väljadele. Kuvage need ülevaatamiseks enne salvestamist.

analysis_request_id · text

Selle üksuse või tegevuse identifikaator. Säilita see vastava rakenduse kirje juures. Kasuta sama päringu identifikaatorit ebakindla tulemuse kordamisel.

analysis_consent · yes/no

Valitud üksuse praegune väärtus. Loe seda pärast seotud sündmust.

analysis_export_status · text

Selle toimingu praegune tulemus. Kasuta sobivat lõpetamise sündmust enne edu salvestamist.

analysis_export_error · text

Vea teave viimase toimingu kohta. Kuva abistav sõnum ja paku asjakohast kordamist.

analysis_image_bytes · number

Valitud üksuse praegune väärtus. Loe seda pärast seotud sündmust.

Sündmused

capture_started

Kui see sündmus toimub, loe seotud olekuid samast elemendist.

capture_succeeded

Kui see sündmus toimub, loe seotud olekuid samast elemendist.

capture_cancelled

Kui see sündmus toimub, loe seotud olekuid samast elemendist.

permission_denied

Kui see sündmus toimub, loe seotud olekuid samast elemendist.

capture_error

Kui see sündmus toimub, loe seotud olekuid samast elemendist.

analysis_requested

Kui see sündmus toimub, loe seotud olekuid samast elemendist.

analysis_export_error

Kui see sündmus toimub, loe seotud olekuid samast elemendist.

analysis_cleared

Kui see sündmus toimub, loe seotud olekuid samast elemendist.

Küsimused, mida arendajad esitavad

Kas see kinnitab isikut või dokumente?

Ei. See pakub tekstivälju ülevaatamiseks. Pildistatud dokumendi pilt ei tõesta isikut, autentsust ega anna meditsiinilist/finantsilist järeldust.

Kuidas tellimus töötab?

Planeeritud hinnakujundus: plugina paigaldamine Bubble-s on tasuta. BestPlugins ligipääs on eraldi tellimus iga plugina jaoks iga Bubble rakenduse projekti juures: 7 päeva tasuta, seejärel US$1.50 kuus. Development ja Live on kaasas. Operatsioonide arvule ei ole kindlat limiiti; failisuuruse ja funktsioonide piirangud kehtivad endiselt. Kassa pole veel avatud. Aktiveerimisekraan näitab esimest arvelduskuupäeva ja tühistamistingimusi.

Seotud juhendid

Marketplace väljalase ootel

Foorumi juhend pole postitatud

Abi saamiseks andke meile teada, millist pistikprogrammi ja seadet kasutate, millist toimingut proovisite ning mis juhtus. Kasutage näidet ilma isikuandmeteta. Ärge kunagi jagage oma võtit ega privaatfaile.