Changesety: Bezpečné koncepty pro vaše data

Changeset je izolovaná kopie vašeho pracovního prostoru, kde můžete volně provádět změny – aniž byste se dotkli vašich živých dat. Představte si to jako režim konceptu pro celý váš katalog. Můžete upravovat, vytvářet a odstraňovat záznamy, zobrazit náhled výsledku a změny odeslat do produkce až poté, co jste spokojeni.

Proč Changesety existují

Nejdůležitějším případem použití je práce s AI. Když požádáte AI o přepsání popisů, překlad polí nebo spuštění hromadné aktualizace napříč tisíci produktů, výsledek vás někdy může překvapit. Changesety vám poskytují záchrannou síť:

• AI zapisuje své výsledky do changesetu, ne přímo do vašich živých dat.
• Můžete zkontrolovat každou změnu, než se rozhodnete, co s ní udělat.
• Pokud se vám výsledky nelíbí, jednoduše changeset odmítnete – nic ve vašich reálných datech se nikdy nedotkne.
• Pokud se vám líbí, aplikujete changeset a změny se stanou trvalými.

To platí stejně pro jakoukoli hromadnou nebo automatizovanou operaci – hromadné aktualizace, úlohy na pozadí, integrace API nebo vaše vlastní experimenty.

Jak Changesety fungují

Changesety fungují jako větve v Gitu. Když přepnete na changeset a upravíte záznam, původní záznam zůstane nedotčen a upravená kopie je uložena v changesetu. Během práce uvnitř changesetu vidíte data přesně tak, jako by byly všechny vaše úpravy již uloženy – filtry, řazení, agregace a zobrazení seznamů odrážejí vaše změny. Živá data se však nezmění, dokud explicitně neaplikujete changeset.

Klíčové vlastnosti:

• Vše funguje uvnitř changesetu. Filtrování, řazení, agregace, úpravy a zobrazení seznamů se chovají přesně tak, jak v hlavních datech.
• Upravené záznamy jsou zvýrazněny. Každý záznam, který byl změněn v aktuálním changesetu, zobrazuje malou žlutou tečku, abyste jej mohli na první pohled rozpoznat.
• Odstraněné záznamy zmizí ze seznamů uvnitř changesetu (jak se očekává), ale jsou stále viditelné v detailu changesetu.
• Úložiště je efektivní. Duplikovány jsou pouze upravené záznamy. Dodatečné úložiště spotřebované changesetem je obvykle velmi malé.

Vytvoření Changesetu

1. Klikněte na tlačítko **Hlavní data (Live)** v horním panelu nástrojů (nebo na název aktuálně aktivního changesetu).
2. Vyberte **Changesety (Bezpečné testování)** z rozevíracího seznamu.
3. Klikněte na tlačítko **Přidat changeset**.
4. Zadejte **Název**, který popisuje účel (např. „AI-přeložené popisy – březen“).
5. Klikněte na **Uložit**.
6. Vyberte svůj nový changeset ze seznamu a přepněte se do něj.

[badge:Changeset active|warning] Jakmile přepnete na changeset, všechny úpravy, které provedete, se uloží pouze do tohoto changesetu. Živá data zůstanou nedotčena.

Práce uvnitř Changesetu

Jakmile jste uvnitř changesetu, systém se chová přesně jako obvykle. Můžete:

• Procházet, filtrovat a řadit záznamy.
• Otevírat a upravovat jednotlivé záznamy.
• Vytvářet nové záznamy nebo odstraňovat stávající.
• Spouštět úpravy AI a hromadné aktualizace – zapíší své výsledky do changesetu.

Zobrazení pouze upravených záznamů

Když se chcete zaměřit na to, co se změnilo:

1. Otevřete libovolný seznam entit (např. Produkty).
2. Použijte filtr **"Zobrazit pouze upravené"** k zúžení seznamu na záznamy, které byly změněny v aktuálním changesetu.
3. Každý upravený záznam je označen malou **žlutou tečkou** vedle jeho řádku.

Kontrola Changesetu

Stránka s podrobnostmi changesetu vám poskytne úplný přehled o všem, co bylo změněno.

1. Otevřete seznam **Changesety**.
2. Klikněte na changeset, který chcete zkontrolovat.

Na stránce s podrobnostmi uvidíte:

• Souhrn pro každou entitu – pro každý typ entity (např. Produkty, Kategorie) je zobrazen počet vytvořených, aktualizovaných a odstraněných záznamů.
• Prohlédněte si entitu – kliknutím na název entity se dostanete přímo do seznamu entit filtrovaného tak, aby zobrazoval pouze upravené záznamy v tomto changesetu.

Udržování vašeho Changesetu v aktuálním stavu

Zatímco pracujete na changesetu, ostatní uživatelé mohou aktualizovat živá data. Tyto změny můžete kdykoli stáhnout do svého changesetu.

1. Otevřete stránku s podrobnostmi changesetu.
2. Klikněte na **Synchronizovat z hlavních dat**.
3. Systém sloučí nejnovější živé změny do vašeho changesetu a označí všechny **kolize** (stejné pole bylo změněno na obou místech).
4. Použijte vestavěný **nástroj pro sloučení** k vyřešení kolizí – vyberete, kterou verzi si ponecháte pro každé konfliktní pole.
5. Po vyřešení všech konfliktů klikněte na **Uložit** pro dokončení sloučení.

**Tip:** Nástroj pro sloučení se pokouší automaticky zachovat všechny změny. Ručně musíte vyřešit pouze případy, kdy bylo stejné pole upraveno jak v živých datech, tak v changesetu.

Aplikace nebo odmítnutí Changesetu

Až budete s kontrolou hotovi, máte dvě možnosti:

Aplikovat (změny se projeví v produkci)

1. Otevřete stránku s podrobnostmi changesetu.
2. Klikněte na **Aplikovat**.
3. Systém sloučí changeset do živých dat. Pokud se od vaší poslední synchronizace objevily nové kolize, znovu se zobrazí nástroj pro sloučení, abyste je mohli vyřešit.
4. Po vyřešení všech konfliktů se změny zapíší do živého katalogu a changeset se označí jako aplikovaný.

Odmítnout (zahodit všechny změny)

1. Otevřete stránku s podrobnostmi changesetu.
2. Klikněte na **Odmítnout**.
3. Potvrďte akci. Všechny změny uložené v changesetu budou trvale zahozeny. Živá data zůstanou přesně tak, jak byla.

**Upozornění:** Odmítnutí changesetu je nevratné. Všechny úpravy uložené v changesetu budou ztraceny.

Výběr cílového Changesetu během úprav

Kdykoli spustíte úpravu AI nebo hromadnou aktualizaci, můžete si vybrat, do kterého changesetu by se měly výsledky zapsat – i když se v daném changesetu aktuálně nenacházíte.

1. Otevřete dialogové okno **Úprava AI** nebo **Hromadná aktualizace**.
2. V rozevíracím seznamu **Uložit do** vyberte cílový changeset (nebo "Hlavní data" pro přímé použití).
3. Dokončete operaci jako obvykle.

To vám umožní spouštět několik experimentů paralelně, každý ve svém vlastním pojmenovaném changesetu.

Používání Changesetů v API a úlohách na pozadí

Changesety jsou prvotřídní koncept v celém systému. Jakékoli volání API nebo úloha na pozadí může cílit na konkrétní changeset zahrnutím identifikátoru changesetu do požadavku. To znamená, že automatizované pracovní postupy – importy, plánované úlohy, integrace – mohou bezpečně zapisovat do changesetu ke kontrole člověkem předtím, než se změny projeví v produkci.

Kolik Changesetů mohu mít?

Můžete mít tolik changesetů, kolik potřebujete, a na jak dlouho je potřebujete. Systém je navržen tak, aby pohodlně zvládl až kolem 100 aktivních changesetů. Dejte každému smysluplný název, aby váš tým věděl, co obsahuje.

Rychlý přehled