Příklad, co dělat [badge:Úplný příklad|info]

Krok 1 – Odkaz uživatele na entitu [navigate:/products|Otevřít produkty|shopping-cart]

Otevřete sekci produktů: [navigate:/products|Produkty]

Přidat nový produkt: [navigate:/products/new|Nové produkty]

Navigace s vlastní ikonou: [navigate:/devdoc/test-where|Testovací filtry|play]

Přejít na obrazovku importu: [navigate:/devdoc/imports|Importy|upload]

Přejít na mapper: [navigate:/mapper|Mapper|mapper]

Přidat produkt: [navigate:/products/new|Přidat produkt|plus]

Krok 2 – Použít filtr

Filtrovat všechny viditelné produkty NIKE:

brand_id = 'code:NIKE' and visibility in ('visible')

Krok 3 – (Volitelné) Hromadná aktualizace filtrované sady

Před exportem můžete hromadně přiřadit exportní kanál všem odpovídajícím produktům:

{
  "export_channel": "eshop-de"
}

Krok 4 – (Volitelné) Použijte AI k obohacení popisů před exportem

{
  "prompt": "Napište krátký popis produktu vhodný pro německý trh.",
  "fields": ["description_de"]
}

Krok 5 – Spusťte dotaz pro kontrolu dat

{
  "fields": ["code", "name", "price", "visibility"],
  "where": "visibility = 'visible'",
  "limit": 10
}

Krok 5b – Prostý blok dotazu (žádná entita, pouze zobrazení pro kopírování)

products(where: "visibility = 'visible'", limit: 10) {
    id
    code
    name
    price
}

Krok 6 – Import produktů z CSV

{
  "columns": {
    "code": "PRODUCT_CODE",
    "name": "PRODUCT_NAME",
    "price": "PRICE_EUR"
  },
  "matchBy": "code"
}

Krok 6b – Prostý blok importu (žádná entita, pouze zobrazení pro kopírování)

{
  "columns": {
    "code": "PRODUCT_CODE",
    "name": "PRODUCT_NAME"
  },
  "matchBy": "code"
}

Krok 7 – Mapování dat feedu na produkty pomocí Mapperu

products = '$.items[*]' {
  code = 'CODE',
  name = 'NAME',
  price = 'PRICE'
}

Krok 7b – Prostý blok mapperu (žádná entita, pouze zobrazení pro kopírování)

products = '$.items[*]' {
  code = 'CODE',
  name = 'NAME'
}

Krok 8 – Vytvořte export s tímto filtrem

Přejít na konfiguraci exportu: [navigate:/exports/new|Konfigurace exportu]

Použijte stejný výraz filtru:

brand_id = 'code:NIKE' and visibility in ('visible')

Krok 8b – Prostý blok filtru (žádná entita, zobrazení pouze pro čtení)

brand_id = 'code:NIKE' and visibility in ('visible')

Zástupné symboly

Text článku může odkazovat na hodnoty za běhu pomocí zástupných symbolů.

Odešlete dotaz do API endpointu pro společnost {companyId}:

POST {HOSTNAME}/api/query
Authorization: Bearer <token>
X-Company-Id: {companyId}

Zástupný symbol {HOSTNAME} se přeloží na aktuální původ aplikace (např. https://app.productsync.com). Zástupný symbol {companyId} se přeloží na ID aktuální organizace.

Vložené úseky kódu

Použijte pole visibility k ovládání dostupnosti produktu. Nastavte jej na visible, hidden nebo catalog. Cesta endpointu je /api/v1/products a metoda je GET.

Popisné rámečky

Toto je **informační** popisný rámeček. Použijte jej pro tipy, poznámky a neutrální kontext.

**Upozornění:** Změna pole `matchBy` po prvním importu způsobí duplicity.

**Tip:** Můžete kombinovat více filtrů pomocí operátorů `and` / `or`.

**Nebezpečí:** Odstranění mapování feedu je nevratné. Ujistěte se, že máte zálohu.

GFM pipe tables

Vícejazyčné karty kódu

tab: JSON
{
  "code": "PROD-001",
  "name": "Běžecké boty",
  "price": 99.90
}
---
tab: XML
<product>
  <code>PROD-001</code>
  <name>Běžecké boty</name>
  <price>99.90</price>
</product>
---
tab: CSV
code,name,price
PROD-001,Běžecké boty,99.90

Číslované kroky

1. Otevřete **Produkty** v levé navigaci.
2. Klikněte na **Filtry** a přidejte `visibility = 'visible'`.
3. Zaškrtávacím políčkem vyberte všechny odpovídající produkty.
4. Z nabídky akcí vyberte **Hromadná aktualizace**.
5. Nastavte `export_channel` a potvrďte.

Karty mřížky funkcí

card: Synchronizace v reálném čase
icon: refresh-cw
Automaticky synchronizujte data produktů mezi vaším ERP a všemi připojenými kanály.

card: Flexibilní mapování
icon: workflow
Mapujte libovolné zdrojové pole na libovolné cílové pole pomocí vizuálního editoru Mapper.

card: Chytré filtrování
icon: filter
Použijte výkonné výrazy WHERE k cílení přesně na produkty, které potřebujete.

Tlačítko CTA “Vyzkoušet”

Vyzkoušejte filtr přímo: [try:/devdoc/test-where|Otevřít hřiště filtrů|play]

Importujte své první produkty nyní: [try:/imports/new|Spustit průvodce importem|upload]

Vložené odznaky

Pole visibility přijímá tři hodnoty: [badge:visible|success] [badge:hidden|warning] [badge:catalog|info]

Tato funkce je [badge:Beta|warning] a API je [badge:Stable|success].