IObjectPropertyAutoakce

Implementací rozhraní IObjectPropertyAutoAction v aplikačním skriptu můžete definovat vlastní akce, které se automaticky provedou, když uživatel ručně změní hodnotu vlastnosti objektu.

Poznámka

Metody rozhraní jsou volány také v obou variantách metody Alvao.API.AM.ObjectProperty.Update. Tyto metody nelze volat v běžící transakci (pokud je jejich volání nutné, nastavte parametr callCustomAction na false). Příkaz AM Console - karta Properties - Generate Value nevolá metodu OnObjectPropertyModifying. Volá pouze metodu OnObjectPropertyModified.

Varování

Pokud chcete v automatické akci použít pouze některé metody implementovaného rozhraní, ponechte v těle ostatních metod z rozhraní výjimku:

hodit novou NotImplementedException();

.

Metody rozhraní

Metoda	L 343, 22.12.2009, s. 1).
Modifikace vlastnosti OnObjectPropertyification	Hodnota vlastnosti bude změněna.
OnObjectPropertyModifikováno	Hodnota vlastnosti byla změněna.

OnObjectPropertyModifikace

Tato metoda se volá před uložením změněné hodnoty vlastnosti do databáze, např. v příkazu Modify (property).

• Syntaxe: ObjectPropertyModifyResult OnObjectPropertyModifying(ObjectPropertyEventArgs e)
• Parametry:
  • e - parametry metody události vlastnosti
  • • ObjectId - ID objektu (tblNode.intNodeId), které se mění.
      • PropertyKindId - ID typu vlastnosti (tblKind.intKindId) předmětu, který se upravuje.
      • PersonId - ID uživatele (tPerson.iPersonId), který vyvolal akci.
      • NewValue - nová hodnota nemovitosti.
• Vrácená hodnota:
  • Úprava vlastnosti objektu
  • • Úspěch (bool) - pokud metoda vrátí true, nová hodnota je zapsána do databáze. Pokud metoda vrátí hodnotu false, operace není provedena a nadcházející změna hodnoty vlastnosti je zrušena.
      • Zpráva (string) - zpráva, která se zobrazí uživateli, pokud je návratová hodnota neplatná.

Příklad viz šablona aplikace CheckPhoneNumberFormat.

OnObjectPropertyModifikováno

Tato metoda se volá po zapsání nové hodnoty vlastnosti do databáze, např. pomocí *úpravy (vlastností)*prohlášení.

• Syntaxe: anulovat OnPropertyModified(ObjectPropertyEventArgs e)
• Parametry:
  • e - parametry metody události vlastnosti
  • • ObjectId - ID objektu (tblNode.intNodeId), které se mění.
      • PropertyKindId - ID typu vlastnosti (tblKind.intKindId) předmětu, který se upravuje.
      • PersonId - ID uživatele (tPerson.iPersonId), který vyvolal akci.
      • NewValue - nová hodnota nemovitosti.
• Vrátit hodnotu: žádný.

Příklad použití naleznete v šabloně aplikace CopyNewPropertyValueToAnotherProperty.