Operasi JSON: komponen JSON Operations (AI Flowi Workflow)
Operasi JSON melalui JSON Operations mengubah atau memilih data dalam objek JSON. Letakkannya selepas sumber Data atau JSON dan sebelum langkah yang memerlukan objek distruktur semula, ditapis atau diperiksa.
Rujukan input di bawah diambil daripada katalog AI Flowi Workflow 1.9.2. Templat pengesahan yang digunakan secara langsung merekodkan ujian dalam persekitaran produksi untuk konfigurasi JQ-nya; bukti itu tidak meliputi setiap operasi.
Oleh Ai Flowi · Diterbitkan
Input
| Nama | Jenis | Wajib | Jenis input yang diterima | Penjelasan ringkas |
|---|---|---|---|---|
append_update_data | dict | Tidak | Tidak disenaraikan | Kamus untuk operasi Append or Update. |
data | other | Ya | Data, JSON | Objek yang hendak diproses. Input wajib ini menerima sambungan Data atau JSON. |
filter_key | str | Tidak | Message | Kunci yang digunakan untuk penapisan. Eksport tidak mentakrifkan sintaks laluan kunci. |
filter_values | dict | Tidak | Tidak disenaraikan | Kamus nilai untuk operasi Filter Values. |
mapped_json_display | str | Tidak | Message | Medan teks yang dinamakan untuk paparan JSON yang dipetakan; format yang boleh ditulis dan peranannya semasa pelaksanaan tidak diterangkan dalam katalog. |
operations | sortableList | Tidak | Tidak disenaraikan | Pilihan operasi JSON yang disenaraikan di bawah, dengan susunan yang boleh diubah. |
operator | str | Tidak | Tidak disenaraikan | Pilihan perbandingan: equals, not equals, contains, starts with atau ends with. |
query | str | Tidak | Message | Ungkapan JQ dalam templat yang diuji. Pastikan medan ini kelihatan apabila menggunakan JQ Expression. |
remove_keys_input | str | Tidak | Message | Teks yang menentukan kunci untuk Remove Keys; tiada format pembatas diberikan dalam eksport ini. |
rename_keys_input | dict | Tidak | Tidak disenaraikan | Kamus untuk Rename Keys. Katalog tidak mentakrifkan arah pemetaan. |
select_keys_input | str | Tidak | Message | Teks yang menentukan kunci untuk Select Keys; sintaks senarai yang tepat tidak didokumentasikan di sini. |
selected_key | str | Tidak | Tidak disenaraikan | Medan pemilihan kunci. Senarai pilihan yang dieksport adalah kosong. |
Pilihan operations ialah Select Keys, Literal Eval, Combine, Filter Values, Append or Update, Remove Keys, Rename Keys, Path Selection dan JQ Expression. Penanda pilihan dalam katalog ialah metadata, bukan jaminan bahawa sesuatu operasi berfungsi tanpa tetapannya sendiri: kegagalan JQ yang direkodkan memerlukan query yang tidak kosong.
Output
| Nama | Nama paparan | Jenis | Tujuan |
|---|---|---|---|
data_output | JSON | JSON | Objek yang terhasil, disediakan melalui output JSON. Periksa strukturnya sebelum menyambungkan tindakan pada langkah seterusnya. |
Bila perlu menggunakan JSON Operations
Gunakan komponen ini untuk objek sedia ada yang kunci atau nilainya perlu diproses. JQ digunakan untuk pengesahan dalam templat yang dipautkan. Apabila input ialah JSON yang dikodkan sebagai teks, JSON String Parser mendokumentasikan penukaran rentetan yang mengandungi objek kepada JSON.
Bila perlu memilih komponen lain
Untuk menggabungkan nilai daripada sambungan berasingan di bawah kunci yang boleh dikonfigurasi, semak JSON Object Builder. Untuk mengekstrak teks menggunakan templat, pilih Parser. Untuk memilih antara Verified dan Rejected selepas pengesahan, gunakan Verification Router; penerangan dalam katalognya menyatakan bahawa komponen ini menghalakan keseluruhan hasil pengesahan tanpa mengubah medan.
Templat yang diuji dan hasil yang direkodkan
Templat yang diuji: sahkan input webhook dan pulangkan 200 atau 422. Statusnya merekodkan 28 daripada 28 kes lulus
dalam persekitaran produksi pada 9 Oktober 2026, menggunakan AI Flowi Workflow 1.9.2.
Pelaksanaan dalam persekitaran produksi memulangkan respons 200 yang mengandungi gema input yang dinormalkan atau respons 422 berserta sebab.
Templat ini menyambungkan data permintaan Universal Webhook kepada data, memilih JQ Expression melalui operations dan menyediakan ungkapan pengesahan yang diterbitkan dalam query. Output JSON-nya disambungkan kepada Verification Router. Ikuti templat yang dipautkan untuk query lengkap dan cabang respons; tiada konfigurasi baharu dikemukakan di sini sebagai hasil ujian.
Templat itu mengesahkan empat medan teks wajib, membuang ruang putih pada awal dan akhir teks dan menukar huruf ASCII dalam alamat e-mel kepada huruf kecil. Buktinya tidak merekodkan pengesahan salinan yang diimport atau pengukuran caj nod, dan respons 200 hanya mengesahkan pengesahan input.
Batasan
- Pastikan medan JQ kelihatan. Tutorial webhook ke Google Sheets yang dibekalkan merekodkan HTTP 500 dengan mesej “JSON Query is required and cannot be blank” (JSON Query wajib diisi dan tidak boleh kosong) apabila query disembunyikan.
- Untuk pemetaan Sheets dalam tutorial itu, hasil senarai tanpa pembungkus dibungkus sebagai {"result": …} dan gagal pada Append Rows dalam ujian editor terdahulu. Objek dengan medan values diteruskan tanpa pembungkus; padankan kontrak langkah seterusnya dan jangan menganggap senarai akan kekal tanpa pembungkus.
- Katalog menyenaraikan nama operasi, tetapi bukan format argumen terperinci untuk setiap operasi. Jangan meneka pembatas senarai kunci atau arah pemetaan penamaan semula berdasarkan nama medan.
- Hasil 28 kes itu meliputi ungkapan JQ dan laluan yang dikonfigurasi dalam templat pengesahan. Hasil itu tidak membuktikan bahawa Literal Eval, Combine atau operasi lain telah diuji dalam persekitaran produksi.
- Verification Router menghalakan hasil pengesahan; komponen ini tidak menangkap pengecualian semasa pelaksanaan dalam templat pengesahan yang diuji. Kegagalan akaun dan tamat masa masih boleh memulangkan ralat platform.
Sumber bagi kegagalan akibat medan JQ yang disembunyikan dan pembungkusan senarai yang direkodkan: batasan tutorial Sheets dan ujian editor terdahulu.
Komponen berkaitan
JSON String Parser · JSON Object Builder · Verification Router · Parser
Penggunaan nod
Pelan: Go dari USD8/bulan dengan bil tahunan (USD10 bulanan), Plus dari USD16 (USD20 bulanan), Pro 100 dari USD80 (USD100 bulanan), Pro 200 dari USD160 (USD200 bulanan) dan Pro 500 dari USD400 (USD500 bulanan), dengan 5,000 hingga 250,000 Flowi Tokens sebulan dan pilihan tambah nilai; 1 token bagi setiap pelaksanaan nod; penggunaan API dan model pihak ketiga tidak termasuk.
Sumber rujukan
Katalog komponen: processing.DataOperations, AI Flowi Workflow 1.9.2, dieksport pada 9 Oktober 2026.