IObjectMoveAutoAction

Implementací rozhraní IObjectMoveAutoAction ve skriptu aplikace můžete definovat vlastní akce, které se automaticky provedou při přesunu objektu na jiné místo ve stromu objektů, včetně odstranění objektu do Koše.

Poznámka:

Metody rozhraní se volají také v metodách Alvao.API.AM.Object.Move a Alvao.API.AM.Object.Delete.
Při automatickém odstranění komponent počítače do Koše na základě detekce hw se metody nevolají.

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
OnObjectMoving	Objekt bude přesunut ve stromu.
OnObjectMoved	Objekt byl přesunut.

OnObjectMoving

Tato metoda se volá před přesunutím objektu ve stromu na jiné místo, např. v rámci příkazu Přesunout.

Syntaxe: Tuple<bool, string> OnObjectMoving(SqlConnection con, int objectId, int newParentObjectId, int personId)
Parametry:
- con – SqlConnection do databáze.
- objectId – ID objektu (tblNode.intNodeId), který má být přesunut.
- newParentObjectId – ID objektu (tblNode.intNodeId), do kterého bude objekt přesunut. Hodnota 0 znamená, že objekt bude přesunut do kořene stromu.
- personId – ID uživatele (tPerson.iPersonId), který akci vyvolal.
Návratové hodnoty:
- bool – pokud metoda vrátí hodnotu true, objekt se v databázi přesune na novou pozici. Pokud metoda vrátí false, operace se neprovede a chystaný přesun objektu bude zrušen.
- string – zpráva, která se uživateli zobrazí, pokud je návratová hodnota false.

Příklad použití najdete v šabloně aplikace CheckObjectMandatoryProperties.

OnObjectMoved

Tato metoda se volá po přesunutí objektu ve stromu.

Syntaxe: void OnObjectMoved(SqlConnection con, int objectId, int oldParentObjectId, int personId)
Parametry:
- con – SqlConnection do databáze.
- objectId – ID objektu (tblNode.intNodeId), který má být přesunut.
- oldParentObjectId – ID objektu (tblNode.intNodeId), který byl otcem (nadřazeným objektem) objektu s objectId před jeho přesunutím. Hodnota 0 znamená, že objekt byl přesunut z kořene stromu.
- personId – ID uživatele (tPerson.iPersonId), který akci vyvolal.
Návratová hodnota: žádná.

Příklad použití najdete v šabloně aplikace SetComputerDetectionProfile.

Nenašli jste co jste hledali? Zeptejte se našeho týmu technické podpory.