Template carta alir: petakan keputusan, tanggungjawab dan pengecualian

Template carta alir menukarkan tugas berskop terhad kepada tindakan bernama, keputusan yang boleh dijawab dan hasil yang jelas. Isi label cabang dan peranan yang bertanggungjawab sebelum menyambungkan nod boleh laksana. Contoh templat di bawah memetakan saringan import CSV: tentukan profil penghuraian, kuarantin fail yang strukturnya tidak konsisten atau sediakan manifest pemetaan tanpa menulis rekod destinasi.

Oleh Ai Flowi · Diterbitkan 2026-10-11

Pilih sempadan proses dan outputnya

Peta ini bermula dengan salinan fail CSV sintetik yang dibekukan dan berakhir dengan satu daripada tiga artifak: manifest pemetaan yang disediakan, laporan kuarantin atau nota profil yang belum diselesaikan. Pengimportan rekod tergolong dalam proses berasingan. Oleh itu, manifest bermaksud pemetaan yang dicadangkan sedia diperiksa, bukan bahawa mana-mana baris telah dimasukkan.

Peta penerimaan permintaan terdahulu meliputi pembetulan dan semakan manusia; templat ini mengasingkan tafsiran fail daripada penerimaan struktur dan pemetaan destinasi.

Sebelum melukis, tulis keputusan sebagai soalan dengan jawapan yang boleh diperhatikan. “Fail nampak baik” tidak dapat mengenal pasti semakan yang memilih sesuatu laluan. “Adakah setiap rekod yang dihuraikan mempunyai bilangan lajur yang diisytiharkan?” boleh berbuat demikian. Bekukan rujukan fail bersama profil penghuraian: mengubah pembatas di pertengahan proses menghasilkan tafsiran berbeza bagi bait yang sama dan membatalkan semakan lebar terdahulu.

Salin rajah aliran kerja yang boleh disunting

Salin sumber Mermaid ini ke dalam editor sedia ada yang menyokong Mermaid. Segi empat tepat ialah tindakan, bentuk berlian ialah soalan dan titik akhir berbucu bulat menamakan artifak yang dihasilkan. Label ini menerangkan proses yang direka; ia bukan dakwaan tentang kawalan import CSV terbina dalam AI Flowi Workflow.

flowchart TD
    A([Frozen file copy]) --> B[Identify parsing profile]
    B --> C{Exactly one profile established?}
    C -- Yes --> D[Inspect parsed record widths]
    C -- No --> F[Profile analyst resolves interpretation]
    F --> G{Explicit profile established?}
    G -- Yes --> D
    G -- No --> H([Held: unresolved profile note])
    D --> E{All record widths consistent?}
    E -- No --> Q([Quarantine report])
    E -- Yes --> M[Record explicit column mapping]
    M --> P([Mapping manifest prepared])

Laluan penganalisis mempunyai had: jika profil tidak dapat ditetapkan semasa saringan ini, catat ketidakpastian dan berhenti. Jangan terus meneka sehingga salah satu penghurai menerima fail. Kuarantin mengekalkan input yang dibekukan dan lokasi percanggahan struktur; ia bukan arahan untuk memadam rekod atau membuang fail asal.

Isi jadual keputusan dan tanggungjawab

Pemetaan lajur memerlukan artifak berasingan kerana lebar yang sama tidak membuktikan makna yang sama. Fail tiga lajur dengan susunan reference, message, version tidak boleh menggunakan manifest yang ditulis untuk reference, version, message. Kekalkan kedudukan sumber serta label pengepala; jika tidak, label pendua menjadikan pemetaan berdasarkan nama sahaja kabur.

Baiki cabang tanpa destinasi dan tanggungjawab yang tiada

BEFORE
Identify profile -> Inspect widths -> Map columns [role missing] -> End
Identify profile -> Ambiguous -> [no destination]

AFTER
Ambiguous profile -> Profile analyst -> Explicit profile or held note
Established profile -> Inspect every record -> Quarantine or column mapping
Consistent structure -> Mapping maintainer -> Prepared manifest

Cabang kabur dalam draf berhenti tanpa mengekalkan tafsiran calon. Baikinya dengan menamakan penganalisis profil dan hasil yang ditahan. Gantikan juga kotak akhir umum dengan artifak manifest dan tugaskan penciptaannya kepada penyelenggara pemetaan. Kini pembaca dapat mengenal pasti kerja yang masih berbaki apabila penghuraian berjaya tetapi pemetaan belum direkodkan.

Jejaki fail sintetik melalui peta yang dibaiki. Profil yang diisytiharkan menggunakan teks UTF-8, pembatas koma, medan dengan petikan berganda dan baris pengepala. Satu mesej mengandungi koma dalam petikan. Mengira koma dalam baris mentah akan tersalah melaporkan lajur tambahan; memeriksa rekod mengikut peraturan petikan yang dinyatakan mengekalkan tiga medan yang dimaksudkan. Rekod lain benar-benar mempunyai hanya dua medan, maka seluruh kelompok sampai ke laporan kuarantin sebelum pemetaan. Tiada penulisan separa ke destinasi dalam peta ini.

Selepas fail yang dibetulkan tiba, bekukannya sebagai input baharu dan ulang semakan. Jangan timpa bukti kuarantin terdahulu atau gunakan keputusannya untuk bait baharu. Jika fail gantian mempunyai struktur yang konsisten, penyelenggara pemetaan mencatat kedudukan sumber dan makna sasaran dalam manifest. Artifak itu boleh disalurkan kepada proses import yang direka secara berasingan.

Semak liputan cabang tanpa melaksanakan import

1. Jejak profil yang diisytiharkan dengan rekod konsisten hingga manifest yang disediakan; pastikan titik akhir menamakan artifak, bukan import yang telah selesai.
2. Jejak maklumat profil yang tiada atau bercanggah kepada penganalisis. Uji kedua-dua jawapan, iaitu profil ditetapkan dan belum diselesaikan.
3. Jejak satu rekod dihuraikan yang tidak konsisten ke kuarantin. Pastikan laporan mengekalkan lokasi rekod dan lebar yang dijangka.
4. Gunakan pembatas dalam petikan dan pemisah baris dalam petikan sebagai contoh: rekod tidak semestinya sepadan dengan baris fizikal.
5. Semak pengepala pendua dan susunan lajur yang berubah semasa pemetaan. Konsistensi struktur sahaja tidak boleh memilih pemetaan lama.

Ini ialah semakan liputan melalui simulasi di atas kertas. Rajah aliran data boleh menjejak secara berasingan medan fail yang memasuki stor; carta ini merekodkan hasil proses yang menyusuli setiap keputusan tafsiran.

Wakili satu keputusan penghalaan dalam AI Flowi Workflow

Status: didokumentasikan. Condition didokumentasikan dalam katalog; belum diuji dalam persekitaran pengeluaran oleh Ai Flowi.

Rujukan Condition memuatkan antara mukanya; latihan ini hanya mewakili cabang hasil struktur selepas pemeriksaan luaran mengesahkan hasil tersebut.

contoh konfigurasi, bukan ujian yang direkodkan

Sediakan akaun AI Flowi Workflow anda dan artifak pemeriksaan JSON sintetik. Tetapkan data_input untuk Condition kepada artifak tersebut, key_name kepada width_state, operator kepada equals dan compare_value kepada consistent. Periksa kedua-dua output penghalaan menggunakan satu sampel konsisten dan satu sampel tidak konsisten. Tiada akaun penyedia atau kunci API diperlukan untuk semakan penghalaan kendiri ini; penggunaan penyedia kemudian memerlukan kelayakan akses anda sendiri dan pengebilan berasingan.

Output yang dijangka ialah artifak pada cabang yang dipilih. Condition tidak menghuraikan CSV atau menjana laporan kuarantin di sini. Semak width_state yang tiada sebagai input belum diselesaikan yang berbeza sebelum menyambungkan tindakan; jangan anggap perbandingan itu mengesahkan sumber pemeriksaan.

Apakah had templat gambar rajah aliran kerja?

Gunakan templat ini untuk saringan pada peringkat fail sebelum import. Ia tidak menetapkan penerimaan separa, penghuraian selari, transaksi destinasi atau semantik BPMN formal. Jika perniagaan perlu menerima rekod yang baik sambil mengasingkan rekod yang bermasalah, tentukan cara identiti rekod, jumlah kelompok dan laporan rekod ditolak direkonsiliasi sebelum mengubah dasar kuarantin seluruh fail.