Changesety: Bezpečné koncepty pre vaše dáta

Changeset je izolovaná kópia vášho pracovného priestoru, kde môžete voľne vykonávať zmeny – bez toho, aby ste sa dotkli vašich živých dát. Predstavte si to ako režim konceptu pre celý váš katalóg. Môžete upravovať, vytvárať a odstraňovať záznamy, zobraziť náhľad výsledku a zmeny prenesiete do produkcie až keď ste spokojní.

Prečo Changesety Existujú

Najdôležitejším prípadom použitia je práca s AI. Keď požiadate AI o prepísanie popisov, preklad polí alebo spustenie hromadnej aktualizácie tisícov produktov, výsledok vás niekedy môže prekvapiť. Changesety vám poskytujú záchrannú sieť:

• AI zapisuje svoje výsledky do changesetu, nie priamo do vašich živých dát.
• Môžete skontrolovať každú zmenu predtým, ako sa rozhodnete, čo s ňou urobíte.
• Ak sa vám výsledky nepáčia, jednoducho changeset zamietnete – nič vo vašich reálnych dátach sa nikdy nedotkne.
• Ak sa vám páčia, použijete changeset a zmeny sa stanú trvalými.

To isté platí pre akékoľvek hromadné alebo automatizované operácie – hromadné aktualizácie, úlohy na pozadí, integrácie API alebo vaše vlastné experimenty.

Ako Changesety Fungujú

Changesety fungujú ako vetvy v Gite. Keď prepnete na changeset a upravíte záznam, pôvodný záznam zostane nedotknutý a upravená kópia sa uloží do changesetu. Počas práce v changesete vidíte dáta presne tak, ako keby boli všetky vaše úpravy už uložené – filtre, triedenie, agregácie a zobrazenia zoznamov odrážajú vaše zmeny. Živé dáta sa však nezmenia, kým explicitne nepoužijete changeset.

Kľúčové charakteristiky:

• Všetko funguje v changesete. Filtrovanie, triedenie, agregácie, úpravy a zobrazenia zoznamov sa správajú presne tak, ako v hlavných dátach.
• Upravené záznamy sú zvýraznené. Každý záznam, ktorý bol zmenený v aktuálnom changesete, zobrazuje malú žltú bodku, aby ste ho mohli na prvý pohľad spozorovať.
• Odstránené záznamy zmiznú zo zoznamov počas práce v changesete (ako sa očakáva), ale sú stále viditeľné v detaile changesetu.
• Úložisko je efektívne. Duplikujú sa iba upravené záznamy. Dodatočné úložisko spotrebované changesetom je zvyčajne veľmi malé.

Vytvorenie Changesetu

1. Kliknite na tlačidlo **Hlavné dáta (Live)** v hornom paneli s nástrojmi (alebo na názov aktuálne aktívneho changesetu).
2. Vyberte **Changesety (Bezpečné testovanie)** z rozbaľovacieho zoznamu.
3. Kliknite na tlačidlo **Pridať changeset**.
4. Zadajte **Názov**, ktorý popisuje účel (napr. "AI-preložené popisy – marec").
5. Kliknite na **Uložiť**.
6. Vyberte svoj nový changeset zo zoznamu, aby ste sa doň prepnuli.

[badge:Changeset active|warning] Keď prepnete na changeset, všetky úpravy, ktoré vykonáte, sa uložia iba do tohto changesetu. Živé dáta zostanú nedotknuté.

Práca v Changesete

Keď ste v changesete, systém sa správa presne ako zvyčajne. Môžete:

• Prehliadať, filtrovať a triediť záznamy.
• Otvárať a upravovať jednotlivé záznamy.
• Vytvárať nové záznamy alebo odstraňovať existujúce.
• Spúšťať úpravy pomocou AI a hromadné aktualizácie – zapíšu svoje výsledky do changesetu.

Zobrazenie Iba Upravených Záznamov

Ak sa chcete zamerať na to, čo sa zmenilo:

1. Otvorte ľubovoľný zoznam entít (napr. Produkty).
2. Použite filter **"Zobraziť iba upravené"**, aby ste zúžili zoznam na záznamy, ktoré boli zmenené v aktuálnom changesete.
3. Každý upravený záznam je označený malou **žltou bodkou** vedľa jeho riadku.

Kontrola Changesetu

Stránka s podrobnosťami o changesete vám poskytne úplný prehľad o všetkom, čo sa zmenilo.

1. Otvorte zoznam **Changesety**.
2. Kliknite na changeset, ktorý chcete skontrolovať.

Na stránke s podrobnosťami uvidíte:

• Súhrn pre každú entitu – pre každý typ entity (napr. Produkty, Kategórie) sa zobrazuje počet vytvorených, aktualizovaných a odstránených záznamov.
• Prechod do entity – kliknutím na názov entity sa presuniete priamo do zoznamu tejto entity, ktorý je filtrovaný tak, aby zobrazoval iba upravené záznamy v tomto changesete.

Udržiavanie Vášho Changesetu Aktuálneho

Počas práce na changesete môžu ostatní používatelia aktualizovať živé dáta. Tieto zmeny môžete kedykoľvek stiahnuť do svojho changesetu.

1. Otvorte stránku s podrobnosťami o changesete.
2. Kliknite na **Synchronizovať z hlavných dát**.
3. Systém zlúči najnovšie živé zmeny do vášho changesetu a označí všetky **kolízie** (to isté pole bolo zmenené na oboch miestach).
4. Použite vstavaný **nástroj na zlúčenie** na vyriešenie kolízií – vyberiete, ktorú verziu si ponecháte pre každé konfliktné pole.
5. Po vyriešení všetkých konfliktov kliknite na **Uložiť** na dokončenie zlúčenia.

**Tip:** Nástroj na zlúčenie sa snaží automaticky zachovať všetky zmeny. Manuálne musíte vyriešiť iba prípady, keď bolo to isté pole upravené v živých dátach aj v changesete.

Použitie alebo Zamietnutie Changesetu

Po dokončení kontroly máte dve možnosti:

Použiť (zmeny sa prejavia v produkcii)

1. Otvorte stránku s podrobnosťami o changesete.
2. Kliknite na **Použiť**.
3. Systém zlúči changeset do živých dát. Ak sa od poslednej synchronizácie objavili nové kolízie, znova sa zobrazí nástroj na zlúčenie, aby ste ich mohli vyriešiť.
4. Po vyriešení všetkých konfliktov sa zmeny zapíšu do živého katalógu a changeset sa označí ako použitý.

Zamietnuť (zahodiť všetky zmeny)

1. Otvorte stránku s podrobnosťami o changesete.
2. Kliknite na **Zamietnuť**.
3. Potvrďte akciu. Všetky zmeny uložené v changesete sa natrvalo zahodia. Živé dáta zostanú presne tak, ako boli.

**Upozornenie:** Zamietnutie changesetu je nezvratné. Všetky úpravy uložené v changesete sa stratia.

Výber Cieľového Changesetu Počas Úprav

Kedykoľvek spustíte úpravu pomocou AI alebo hromadnú aktualizáciu, môžete si vybrať, do ktorého changesetu sa majú zapísať výsledky – aj keď sa momentálne nenachádzate v danom changesete.

1. Otvorte dialógové okno **Úprava pomocou AI** alebo **Hromadná aktualizácia**.
2. V rozbaľovacom zozname **Uložiť do** vyberte cieľový changeset (alebo "Hlavné dáta" na priame použitie).
3. Dokončite operáciu ako zvyčajne.

To vám umožní spúšťať viacero experimentov paralelne, každý vo svojom vlastnom pomenovanom changesete.

Používanie Changesetov v API a Úlohách na Pozadí

Changesety sú prvoradý koncept v celom systéme. Akékoľvek volanie API alebo úloha na pozadí môže cieliť na konkrétny changeset zahrnutím identifikátora changesetu do požiadavky. To znamená, že automatizované pracovné postupy – importy, plánované úlohy, integrácie – môžu bezpečne zapisovať do changesetu na kontrolu človekom predtým, ako sa zmeny prejavia v produkcii.

Koľko Changesetov Môžem Mať?

Môžete mať toľko changesetov, koľko potrebujete, a tak dlho, ako ich potrebujete. Systém je navrhnutý tak, aby pohodlne zvládol až približne 100 aktívnych changesetov. Dajte každému z nich zmysluplný názov, aby váš tím vedel, čo obsahuje.

Rýchly Prehľad