Group API

Objekt skupiny (přístupný přes tisa.form.group.GroupId) poskytuje API pro práci se skupinami formuláře — skrývání, sbalování a změnu názvu skupiny.

Skupiny jsou dostupné pouze pokud mají definovaný atribut Id v JSON konfiguraci formuláře.

Přístup ke skupině

const { form } = tisa;
const { G_Supplier, G_Details } = form.group;

// Nebo přímo
const supplierGroup = form.group.G_Supplier;

Vlastnosti

id

Jedinečný identifikátor skupiny definovaný v konfiguraci formuláře. Vlastnost je pouze pro čtení.

console.log(supplierGroup.id); // "G_Supplier"

name

Zobrazovaný název skupiny v UI. Lze dynamicky měnit.

supplierGroup.name = "Dodavatel (upraveno)";

hidden

Skryje skupinu včetně všech jejích polí na formuláři.

supplierGroup.hidden = true;

collapsed

Sbalí skupinu — zobrazí se pouze hlavička skupiny. Uživatel může skupinu rozbalit kliknutím.

supplierGroup.collapsed = true;

Příklady

Příklad: Podmíněné zobrazení skupiny

async function onFormInit() {
  const { form } = tisa;
  const { DocumentType } = form.field;
  const { G_ExternalInfo } = form.group;

  // Skrytí skupiny pro interní dokumenty
  if (DocumentType.value !== "External") {
    G_ExternalInfo.hidden = true;
  }

  DocumentType.onChange((value) => {
    G_ExternalInfo.hidden = value !== "External";
  });
}

Příklad: Sbalení detailní skupiny na zobrazovacím formuláři

async function onFormInit() {
  const { form } = tisa;

  if (form.isDisplayForm) {
    form.group.G_TechnicalDetails.collapsed = true;
  }
}

Konfigurace v JSON

Aby byla skupina přístupná přes Group API, musí mít definovaný atribut Id:

{
  "Groups": [
    {
      "Id": "G_Supplier",
      "Name": "Dodavatel",
      "Fields": [
        { "InternalName": "s_supplierId" },
        { "InternalName": "s_supplierName" }
      ]
    }
  ]
}

Pokud Id není zadáno, skupina se nevytvoří v objektu form.group.