Refactor

Refactor transformă dovezile indexate pe surse într-un flux mai sigur de replacement în bulk. Pornește de la un full scan proaspăt, poate restrânge batch-ul după conținutul blocului înainte de preview, păstrează preview-ul read-only până la apply și reține Batch details astfel încât follow-up-ul și rollback-ul să rămână inspectabile.

Prerechizite #

Refactor este cel mai sigur când baseline-ul curent al indexului este proaspăt și operatorul are permisiunile necesare pentru scriere în conținut.

• Rulează un full scan proaspăt înainte să previzualizezi sau să aplici un batch.
• Confirmă că licența curentă și permisiunile utilizatorului permit fluxuri cu write.
• Stabilește o așteptare de backup potrivită cu scope-ul conținutului pe care urmează să îl schimbi.
• Folosește mai întâi filtrele de inventar, filtrele după conținutul blocului și source drill-down ca limita schimbării să fie clară înainte să înceapă configurarea batch-ului.

Moduri Refactor #

• block_instance: înlocuiește instanțe de bloc potrivite din conținutul surselor indexate atunci când varianta exactă de bloc este lucrul care trebuie schimbat.
• entity_reference: înlocuiește referințe potrivite către un pattern, template part sau navigation partajată fără să editeze definiția partajată peste tot.
• entity_definition: actualizează definiția entității partajate atunci când acea singură sursă de adevăr trebuie să se schimbe peste tot unde este referențiată.

Configure -> Preview -> Apply -> Rollback #

1. Configurează ținta, modul, scope-ul și orice filtre relevante după conținutul blocului pornind de la un baseline proaspăt.
2. Generează un preview read-only și inspectează rândurile care s-ar schimba.
3. Aplică doar după ce preview-ul corespunde exact limitei de replacement dorite.
4. Revizuiește Batch details, apoi fă rollback dacă validarea arată că batch-ul trebuie inversat.

Folosește conținutul blocului pentru a restrânge batch-ul #

Când numele blocului este prea larg, folosește filtrele după conținutul blocului pentru a restrânge batch-ul la varianta exactă de wording pe care vrei să o înlocuiești.

• Țintește, de exemplu, copy învechit pentru CTA-uri, disclaimere, placeholder text, o variantă specifică de campanie sau alt pattern de conținut dintr-un tip de bloc repetat.
• Confirmă aceleași rânduri filtrate după conținut în preview înainte să aplici orice schimbare cu write activ.
• Rulează din nou preview-ul dacă conținutul de bază s-a schimbat după ultimul baseline de scanare în care aveai încredere.

Fluxul de configurare și vederile cheie #

JSON mode #

JSON mode este varianta portabilă a aceluiași workflow Refactor. Folosește-l când definiția batch-ului trebuie copiată, revizuită sau stocată în afara sesiunii curente de admin.

• Păstrează JSON-ul aliniat cu același baseline proaspăt pe care îl consideri de încredere în UI.
• Revizuiește cu atenție ținta, modul, scope-ul și orice filtre după conținutul blocului înainte să generezi preview-ul.
• Tratează JSON-ul ca pe o configurație de batch, nu ca pe un substitut pentru validarea prin preview.

Batch details și operation history #

Batch details sunt jurnalul operațional pentru Refactor. Revizuiește-le după preview, după apply și din nou înainte de rollback dacă batch-ul are nevoie de follow-up.

• Snapshot-urile de preview arată ce rânduri ar trebui să se schimbe înainte să se scrie în conținut.
• Timestamp-urile de apply și rollback arată când a rulat efectiv operația.
• Rezultatele per rând te ajută să separi rândurile schimbate de cele skipped sau failed.
• Operation history păstrează fluxul inspectabil pentru QA, handoff sau incident review.

Ce înseamnă skipped, failed și rolled back #

• Skipped înseamnă de obicei că rândul nu mai corespundea presupunerilor din preview când a rulat apply sau rollback.
• Failed înseamnă că operația a încercat rândul, dar nu l-a putut finaliza în siguranță, deci este nevoie de follow-up.
• Rolled back înseamnă că schimbarea aplicată anterior a fost inversată pentru acel rând.
• Rândurile skipped sau failed sunt semnale pentru a inspecta Batch details, a verifica prospețimea și a regenera preview-ul dacă s-a schimbat conținutul.

Unde mergi mai departe #