Vlastní skript

Ve složce Config může být uložen soubor EpCustomScript.js s uživatelským skriptem v jazyce JavaScript. Složku Config naleznete ve složce, kde je nainstalována ALVAO Asset Management Console (standardně C:\Program Files\ALVAO\Asset Management Console\Config), pokud tam není, vytvořte ji a vložte do ní skript. Po restartu AM Console se skript sám aktivuje.

Ve skriptu mohou být definovány obslužné funkce, které se automaticky volají z AM Console při provádění různých operací.

Příklad 1. Příklad souboru EpCustomScript.js

function OnNodeMoving(nNodeId,nDestNodeId,nUserId)
{
    return true;
}

function OnNodeRemoving(nNodeId,nUserId)
{
    MessageBox("Objekt nelze odstranit",0x30);
    return false;
}

Skript v příkladu obsahuje funkce OnNodeMoving a OnNodeRemoving. Funkce OnNodeMoving slouží k povolení přesunu objektu ve stromu. Funkce se volá před provedením přesunu a návratová hodnota true znamená, že je přesun povolen. Funkce OnNodeRemoving se volá před odstraněním objektu ze stromu a její návratová hodnota povoluje odstranění. V uvedeném příkladu je tedy přesun objektu vždy povolen a odstranění je vždy zakázáno. Při pokusu o odstranění objektu se navíc zobrazí okno s hlášením "Objekt nelze odstranit".

Obslužné funkce

OnNodeCopying

Tato funkce se volá před zkopírováním objektu ve stromu, tj. také v případě vytvoření nového objektu podle šablony.

• Syntaxe - bool OnNodeCopying(nNodeId, nDestNodeId, nUserId)
• Parametry
  • nNodeId - hodnota atributu (v databázi) tblNode.intNodeId objektu, který je kopírován, tj. vzorový objekt.
  • nDestNodeId - hodnota atributu tblNode.intNodeId objektu, do kterého bude jako podřazený objekt vložena kopie. Hodnota 0 znamená , že kopie bude vytvořena v kořeni stromu.
  • nUserId - hodnota atributu tblUser.intUserId určující právě přihlášeného uživatele.
• Návratová hodnota - pokud funkce vrátí hodnotu true, objekt bude zkopírován. Pokud funkce vrátí false, kopírování se neprovede. V tom případě je vhodné zobrazit chybové hlášení metodou MessageBox.
• Příklady

  Příklad 2. Příklad - zákaz kopírovat objekty pro vybraného uživatele

  Následující příklad funkce OnNodeCopying zakazuje uživateli s identifikačním číslem 15 kopírování objektů. Identifikační číslo uživatele záleží na konkrétní databázi a je třeba jej nejprve najít v tabulce tblUser - atribut intUserId.

  function OnNodeCopying(nNodeId,nDestNodeId,nUserId)
  {
      if ( nUserId == 15 )
      {
          MessageBox("Objekt je zakázáno kopírovat.",0x30);
          return false;
      }
      return true;
  }

  Příklad 3. Příklad - volání uložené procedury na SQL serveru

  V následujícím příkladu je pro vyhodnocení události použita uložená procedura (stored procedure) spOnNodeCopying na SQL serveru. Kopírování objektu je povoleno, pokud uložená procedura vrací nenulovou hodnotu.

  function OnNodeCopying(nNodeId,nDestNodeId,nUserId)
  {
      var Con=new ActiveXObject("ADODB.Connection");
      Con.Open(ConnectionString);
      var Cmd=new ActiveXObject("ADODB.Command");
      Cmd.ActiveConnection=Con;
      Cmd.CommandText="spOnNodeCopying";
      Cmd.CommandType=4;
      Cmd.Parameters.Refresh();
      Cmd.Parameters.Item("@nNodeId").Value=nNodeId;
      Cmd.Parameters.Item("@nDestNodeId").Value=nDestNodeId;
      Cmd.Parameters.Item("@nUserId").Value=nUserId;
      var Rs=Cmd.Execute();
      if ( Rs.Fields.Item(0)==1 )
          return true;
      MessageBox("Objekt nelze zkopírovat.",0x30);
      return false;
  }

  Uložená procedura je definována takto:

  CREATE PROCEDURE [dbo].[OnNodeCopying]
      @nNodeId int, @nDestNodeId int, @nUserId int
  AS
  BEGIN
      SET NOCOUNT ON;
      SELECT 1
  END

OnNodeCopied

Tato funkce se volá po zkopírování objektu resp. po vytvoření nového objektu podle šablony.

• Syntaxe - void OnNodeCopied(nNodeId, nNewNodeId, nUserId)
• Parametry
  • nNodeId - hodnota atributu (v databázi) tblNode.intNodeId objektu, který byl kopírován, tj. vzorový objekt.
  • nNewNodeId - hodnota atributu tblNode.intNodeId nového objektu, který vznikl zkopírováním.
  • nUserId - hodnota atributu tblUser.intUserId určující právě přihlášeného uživatele.
• Návratová hodnota - žádná
• Příklady - viz OnNodeCopying

var Con=new ActiveXObject("ADODB.Connection");
Con.Open(ConnectionString);