Podłączenie akcji

Korzystanie z akcji jest możliwe po rejestracji triggera AppendBrowserTrigger w pliku qline.txt. Od tej pory można odwoływać się do akcji APPEND_BROWSER w plikach qcon.

Przykładowa treść pliku qline.txt:

record
{

  Sep = record
  {
     Host = "seplib" ;
     Port = 2507;
  };


  Application = record
  {

    Modules = recordarray
    {
      MODULE,         QCON,                        TRIGGER_SET;//,    TRANSLATION_FILE;
      "LARRANGER",    null,                        "qline.labelsarranger.LabelsArrangerTrigger";
      "QTENBERG",     "qtenberg/qtenberg.qcon",    "qline.qtenberg.QtTrigger";
      "QLINE",        null,                        "qline.tools.AppendBrowserTrigger";
      "QLINE",        null,                        "qline.export.ExportTrigger";
      "QLINE",        null,                        "qline.misc.TextImporterTrigger";
      "QLINE",        null,                        "qline.qlicense.LicenseTrigger";
      "QLINE",        null,                        "qline.misc.ColorMaskSelectorTrigger";
      "QLINE",        null,                        "qline.tools.TriggerNarrowBrowser";
      "QLINE",        null,                        "qline.backup.triggers.BackupTrigger";
      "QLINE",        null,                        "qline.misc.GroupStatisticsTrigger";
       //--------------------------------------------------------------------------------
      "QCRM",      "qcon/struct.qcon",          null;

        };
        BackgroundImage="pic/Qbslogo.jpg";
        DateEditFormat="YYYY.MM.DD";
        DefaultHtmlViewer = "explorer";
        BrowserColumns = "true";
    };

Składnia akcji

Treść akcji w menu:

APPEND_BROWSER TAB=<tab_okna> BROWSER_TAB=<tab_browsera> FLT0=<pole_zawężenia_0> {FLTk=<pole_zawężenia_k>}*

Parametry:

• TAB - nazwa taba okna zawierającego pola zawężenia
• BROWSER_TAB - nazwa taba browsera wykorzystywana przy zapamiętywaniu ustawień
• FLTk - nazwa k-tego pola zawężenia (kolejność nieistotna)

Przykładowa treść wywołania w menu:

MENU MenuKontrahent
   TITLE = "Klienci naszej firmy"
   POS   = 25 12
{
ID           ACTION                                   SHORTCUT   NAME;
REPR         APPEND_BROWSER
             TAB="REPR_MAIN"
             BROWSER_TAB="REPR_BROW"
             FLT0=STATUS
             FLT1=SEKTOR;                             R          "Reprezentanci klientów";

KLIENT       APPEND_BROWSER
             TAB="FIRMY_MAIN"
             BROWSER_TAB="KLIENT_BROW"
             FLT0=STATUS
             FLT1=KATEG_KK
             FLT2=SEKTOR;                             F          "Firmy klientów";
}    

Zdefiniowanie browsera

Na definicję browsera składają się:

• definicja głównego okn z zawężeniami
• definicja wklejonego browsera

Definiowanie okna

Tab okna zawiera

• pole wklejonego browsera
  • NAME=APPEND_BROWSER
  • MASK=BROWSER()
  • Relacja może być dowolną listą niezależną od pól zawężenia najczęściej EVH=GlobList().
• pole wklejonego browsera
  • nazwa pola musi być identyczna z nazwą pola w tabie browsera, po którym zawężamy
  • dla pól typu STRING łańcuch pusty oznacza brak zawężenia, każdy inny powoduje zawężenie
  • dla pól typu INT, MASK=LLIST, jako brak zawężenia przyjęto wartość 0 (interpretowane jako "Wszystkie"), pozostałe wartości są dekrementowane o 1 przed zawężeniem, aby dobrze reprezentowały wartości pola z tabeli
  • dla pól innego typu lub maski obsługa nie jest określona

Rozkład pól może być dowolny, ale pole browsera i pola zawężenia wymienione w akcji APPEND_BROWSER dotyczącej tego tab są obowiązkowe.

Definiowanie browsera

Tab browsera zachowuje się standardowo. Wszystkie ustawienia są respektowane tak, jak w przypadku browsera wklejonego.

Istotna jest wygoda definiowania uporzadkowań. Pozostają one zachowane bez różnicy na chwilowe zawężenie. Nie należy ich dodatkowo poprzedzać żadnym sztucznym prefiksem.

Poniewaz AppendBrowser ma charakter browsera pełnoekranowego, więc zapisywane są ostatnie ustawienia dotyczące okna i browsera. Są to parametry lokalne użytkownika.
Ustawienia kolumn są zachowywane pośród ustawień wszystkich kolumn browserów pod nazwą wklejonego browsera.
Ustawienia dotyczące ostatnich zawężeń, pozycji i uporządkowania są zapisywane w parametrze o nazwie podanej w BROWSER_TAB.

Uwagi implementacyjne

Podstawowe informacje

• okno główne i browser są inicjowane zaczytanymi parametrami
• zawężenie jest realizowane przez standardową obsługę tabel zawężonych, co gwarantuje efektywność
• wklejony browser jest w stanie append, pola zawężenia są doklejane z przodu dostępnych uporządkowań
• każda zmiana zawężenia powoduje odświeżenie browsera

Wady:

• żądanie zawężeń o uporządkowaniach, dla których nie ma jeszcze zbudowanych indeksów na sepie może zająć chwilę przy pierwszym odświeżeniu
• może prowadzic do zbudowania dużej liczby indeksów dla danej tabeli, co spowalnia akcje wstawiania i modyfikacji. Na szczęście użytkownicy używają najczęściej tylko kilku zawężeń