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.
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 @.
Przykladselect Wartosc from Dane where id=@DocumentId@
Przed wykonaniem zapytania parametr @DocumentId@ zostanie zamieniony na wartość kontrolki.
UwagaNie jest zalecane użycie parametru “wartość” kontrolki, jeżeli wartość kontrolki użytej, jako parametr została zainicjowana poprzez zapytanie SQL!