Parametry dynamiczne w kontrolkach

Parametry typu @nazwa@ można zastosować do poniższych typów operacji:

  • Inicjowanie kontrolki,
  • Zmiana wartości kontrolki na podstawie wartości innej kontrolki,
  • Kontrolka własna akcja.

Rodzaje parametrów:

  • Predefiniowane:
    • @^UserId@ – ID operatora,
    • @^DocumentId@ – ID/nr dokumentu,
    • @^WorkflowId@ – ID typu obiegu,
    • @^StageId@ – ID etapu,
    • @^DocumentCompanyId@ – ID spółki (w trybie wielospółkowym)
  • @Nazwa (identyfikator) kontrolki@ – identyfikator kontrolki. Parametr zwraca wartość kontrolki, za wyjątkiem kontrolek: Dokument elektroniczny, Kontrahent, Towar, Dokument ERP XL, dla których zwraca GidTyp:GidNumer.
  • Identyfikator obiektu ERP XL (dotyczy kontrolek: Dokument elektroniczny, Kontrahent, Towar, Dokument ERP XL, Dane tabelaryczne):
    • @nazwa (identyfikator)@ – zwraca GidTyp:GidNumer obiektu,
    • @nazwa (identyfikator)_Id@ – zwraca GidNumer obiektu,
    • @nazwa (identyfikator)_IdType@ – zwraca GidTyp obiektu.
  • W edytorze zapytań SQL dla wszystkich kontrolek jest dostępny parametr @^SenderControlName@, który dla każdego zdarzenia przyjmuje nazwę identyfikatora kontrolki, która znajduje się na najniższym poziomie obserwacji w grupie kontrolek, w której nastąpiła zdarzenie.
    • W edytorze kodu C# parametr ten jest dostępny jako Globals.Common.SenderControlName.
  • W edytorze zapytań SQL dla wszystkich kontrolek jest dostępny parametr @^InitSenderControlName@, który dla każdego zdarzenia przyjmuje nazwę identyfikatora kontrolki, która zdarzenie wygenerowała. Wyjątkiem jest zdarzenie inicjowania wartości kontrolki podczas otwierania formatki, wtedy wartość tego parametru wynosi NULL.

 

Parametr „@^UserId@” w przykładowym zapytaniu

 

Możliwa jest obsługa parametrów w mechanizmie inicjowania kontrolki poprzez zapytanie SQL. W zapytaniu SQL inicjującym wartość kontrolki możliwe jest wprowadzenie nazwy identyfikatora kontrolki poprzedzonej i zakończonej znakiem @.

 

Przyklad
select Wartosc from Dane where id=@DocumentId@

 

Przed wykonaniem zapytania parametr @DocumentId@ zostanie zamieniony na wartość kontrolki.

 

Uwaga
Nie jest zalecane użycie parametru “wartość” kontrolki, jeżeli wartość kontrolki użytej, jako parametr została zainicjowana poprzez zapytanie SQL!