IObjectPropertyAutoAction
Implementací rozhraní IObjectPropertyAutoAction ve
skriptu aplikace můžete definovat vlastní akce, které se automaticky provedou při ruční úpravě hodnoty vlastnosti objektu uživatelem.
Poznámka:
Metody rozhraní se volají také v obou variantách metody Alvao.API.AM.ObjectProperty.Update.
Příkaz
AM Console - záložka
Vlastnosti -
Vygenerovat hodnotu nevolá metodu
OnObjectPropertyModifying.
Volá pouze
OnObjectPropertyModified.
Tip:
Pro uložení vlastností a nastavení akce doporučujeme definovat třídu
Settings v samostatném skriptu, který vytvoříte ze šablony
Knihovna tříd.
Upozornění:
Pokud v rámci automatické akce chcete použít jen některé z metod
implementovaného rozhraní, tak v těle ostatních metod z rozhraní ponechte výjimku:
throw new NotImplementedException();.
Metody rozhraní
OnObjectPropertyModifying
Tato metoda se volá před uložením upravené hodnoty vlastnosti do databáze, např. v rámci příkazu
Upravit (vlastnost).
- Syntaxe: Tuple<bool, string> OnObjectPropertyModifying(SqlConnection con, int propertyId, int personId, string newValue)
- Parametry:
- con – SqlConnection do databáze.
- propertyId – ID vlastnosti (tblProperty.intPropertyId), která je měněna.
- personId – ID uživatele (tPerson.iPersonId), který akci vyvolal.
- newValue – nová hodnota vlastnosti.
- Návratové hodnoty:
- bool – pokud metoda vrátí hodnotu true, nová hodnota se zapíše do databáze. Pokud metoda vrátí false, operace se neprovede a chystaná změna hodnoty vlastnosti je zrušena.
- string – zpráva, která se uživateli zobrazí, pokud je návratová hodnota false.
Příklad použití najdete v šabloně aplikace
CheckPhoneNumberFormat.
OnObjectPropertyModified
Tato metoda se volá po zápisu nové hodnoty vlastnosti do databáze, např. příkazem
Upravit (vlastnost).
- Syntaxe: void OnPropertyModified(SqlConnection con, int propertyId, int personId)
- Parametry:
- con – SqlConnection do databáze.
- propertyId – ID vlastnosti (tblProperty.intPropertyId), která byla změněna.
- personId – ID uživatele (tPerson.iPersonId), který akci vyvolal.
- Návratová hodnota: žádná.
Příklad použití najdete v šabloně aplikace
CopyNewPropertyValueToAnotherProperty.
Nenašli jste co jste hledali? Zeptejte se našeho týmu technické podpory.