Skip Navigation LinksALVAO 11.0Rozšiřující modulyALVAO Asset Management Custom AppsAplikaceIObjectPropertyAutoAction Skip Navigation Links.


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.
Tip:
Předpokladem pro vytvoření funkční automatické akce je dobrá znalost databáze Alvao, Service Desk WebService API a Alvao.API.
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í

Metoda Popis
OnObjectPropertyModifying Hodnota vlastnosti bude změněna.
OnObjectPropertyModified Hodnota vlastnosti byla změněna.

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.