5. fejezet - Személyre szabás

Ez a példa egy ACL alapvető szerkezetét mutatja be. Először szüksége van egy névre. Ebben az esetben legyen ez „100-Pelda-ACL”. Vegye figyelembe, hogy az ACL-ek számszerűen rendezve lesznek a végrehajtás előtt, így körültekintéssel kell használnia a neveket.

Másodszor van egy „Tulajdonságok” („Properties”) szakasza, amely egy szűrő a jegyeihez. Az itt meghatározott összes feltétel alkalmazva lesz egy jegyen annak meghatározásához, hogy az ACL-t alkalmazni kell-e vagy sem. A mi példánkban egy jegy akkor fog illeszkedni, ha a „Nyers” várólistában van és „5 nagyon magas” prioritással rendelkezik. Ezt az űrlapon lévő változások is érinteni fogják (például ha a jegy a „Nyers” várólistában van és „3 normál” prioritással rendelkezik, akkor ebben a pillanatban az ACL nem fog illeszkedni, de ha ezután a prioritás lenyílót kiválasztják és a prioritást „5 nagyon magas” értékre változtatják, akkor is illeszkedni fog).

Végül a „Possible” szakasz módosításokat határoz meg a képernyőhöz. Ebben az esetben az elérhető várólisták közül csak a „Riasztás” várólistát lehet kiválasztani egy jegyképernyőn.

5.1. ábra - 100-Pelda-ACL ACL

# jegy ACL
$Self->{TicketAcl}->{'100-Pelda-ACL'} = {
    # illesztési tulajdonságok
    Properties => {
        # jelenlegi jegy illesztési tulajdonságai
        Ticket => {
            Queue => ['Nyers'],
            Priority => ['5 very high'],
        }
    },
    # lehetséges lehetőségek visszaadása (fehér lista)
    Possible => {
        # lehetséges jegylehetőségek (fehér lista)
        Ticket => {
            Queue => ['Riasztás'],
        },
    },
};
                

Ez a példa nagyon hasonló a legutóbbihoz, de ebben az esetben csak azok a jegyek fognak illeszkedni, amelyek a „Nyers” várólistában vannak és „5 nagyon magas” prioritással rendelkeznek, mindkettőt adatbázisban tárolva. Az ilyen fajta ACL-ek nem bírálják el az űrlapon lévő változásokat, mielőtt a jegy valóban frissítve lenne az adatbázisban.

5.2. ábra - 102-Pelda-ACL ACL

# jegy ACL
$Self->{TicketAcl}->{'102-Pelda-ACL'} = {
    # illesztési tulajdonságok
    PropertiesDatabase => {
        # jelenlegi jegy illesztési tulajdonságai
        Ticket => {
            Queue => ['Nyers'],
            Priority => ['5 very high'],
        }
    },
    # lehetséges lehetőségek visszaadása (fehér lista)
    Possible => {
        # lehetséges jegylehetőségek (fehér lista)
        Ticket => {
            Queue => ['Riasztás'],
        },
    },
};
                

Itt láthatja, hogy egy jegymező (állapot) hogyan szűrhető egynél több lehetséges értékből való választással. Lehetséges azon műveletek korlátozása is, amelyek egy bizonyos jegynél végrehajthatók. Ebben az esetben a jegyet nem lehet lezárni.

5.3. ábra - 102-Masodik-pelda-ACL ACL

$Self->{TicketAcl}->{'102-Masodik-pelda-ACL'} = {
    # illesztési tulajdonságok
    Properties => {
        # jelenlegi jegy illesztési tulajdonságai
        Ticket => {
            Queue => ['Nyers'],
        }
    },
    # lehetséges lehetőségek visszaadása (fehér lista)
    Possible => {
        # lehetséges jegylehetőségek (fehér lista)
        Ticket => {
            State => ['new', 'open', 'pending reminder'],
        },
    },
    # nem lehetséges lehetőségek visszaadása is (fekete lista)
    PossibleNot => {
        # nem lehetséges művelet-lehetőségek
        Action => [ 'AgentTicketClose' ],
    },
};
                

Ez a példa azt mutatja be, hogy hogyan lehetséges negatív szűrőket meghatározni (a „closed successful” állapot lesz eltávolítva). Azt is láthatja, hogy ha nem határozunk meg illesztési tulajdonságokat egy jegyhez, akkor bármely jegyre illeszkedni fog, azaz az ACL mindig alkalmazva lesz. Ez akkor lehet hasznos, ha alapértelmezetten el szeretne rejteni bizonyos értékeket, és csak speciális körülményeknél szeretné engedélyezni azokat (például ha az ügyintéző egy adott csoportban van).

5.4. ábra - 103-Harmadik-ACL-pelda ACL

$Self->{TicketAcl}->{'103-Harmadik-ACL-pelda'} = {
    # illesztési tulajdonságok
    Properties => {
        # jelenlegi jegy illesztési tulajdonságai (mindig illeszkedik)
    },
    # lehetséges lehetőségek visszaadása
    PossibleNot => {
        # lehetséges jegylehetőségek
        Ticket => {
            State => ['closed successful'],
        },
    },
};
                

Ez a példa azt is bemutatja, hogy hogyan használhat reguláris kifejezéseket a jegyek illesztéséhez és az elérhető lehetőségek szűréséhez.

5.5. ábra - 104-Csak-hardver-szolgaltatasok-a-HW-varolistaknal-ACL ACL

$Self->{TicketAcl}->{'104-Csak-hardver-szolgaltatasok-a-HW-varolistaknal-ACL'} = {
    # illesztési tulajdonságok
    # figyelje meg, hogy nincs "Ticket => {" ugyanis még nincsenek jegyek
    Properties => {
    Queue => {
        Name => ['[RegExp]HW'],
        }
    },
    # lehetséges lehetőségek visszaadása
    Possible => {
        # lehetséges jegylehetőségek
        Ticket => {
            Service => ['[RegExp]^(Hardver)'],
        },
    },
};
                

5.6. ábra - 105-Folyamat-letiltasa-az-ugyfel-azonositonal ACL

$Self->{TicketAcl}->{"105-Folyamat-letiltasa-az-ugyfel-azonositonal"} = {
    'Possible' => {},
    'PossibleNot' => {
        'Process' => [
            'F14'
        ]
    },
    'Properties' => {
        'CustomerUser' => {
            'UserCustomerID' => [
                'AzÜgyfélAzonosítója'
            ]
        }
    },
    'PropertiesDatabase' => {},
    'StopAfterMatch' => 0
};
                

# jegy ACL
$Self->{TicketAcl}->{'200-ACL-hivatkozas'} = {
    # illesztési tulajdonságok (jelenlegi értékek az űrlapról)
    Properties => {

        # a használt előtétprogram modul
        Frontend => {
            Action => ['AgentTicketPhone', 'AgentTicketEmail'],
        },

        # a bejelentkezett ügyintéző
        User => {
            UserLogin => ['felhasználónevek'],
            Group_rw => [
                'forródrót',
            ],
            Role => [
                'admin',
            ],
            # ...
        },

        # a bejelentkezett ügyfél
        CustomerUser => {
            UserLogin => ['felhasználónevek'],
            UserCustomerID => ['ügyfél-azonosítók'],
            Group_rw => [
                'forródrót',
            ],
            # ...
        },

        # folyamat tulajdonságok
        Process => {
            ProcessEntityID        => ['Process-9c378d7cc59f0fce4cee7bb9995ee3eb'],         # az a folyamat, amelynek a jelenlegi jegy a része
            ActivityEntityID       => ['Activity-f8b2fdebe54eeb7b147a5f8e1da5e35c'],        # a jegy jelenlegi tevékenysége
            ActivityDialogEntityID => ['ActivityDialog-aff0ae05fe6803f38de8fff6cf33b7ce'],  # a jelenlegi tevékenység párbeszéd, amelyet az ügyintéző/ügyfél használ
        },

        # jegy tulajdonságok
        Queue => {
            Name     => ['Nyers'],
            QueueID  => ['azonosítók'],
            GroupID  => ['azonosítók'],
            Email    => ['e-mail címek'],
            RealName => ['OTRS rendszer'],
            # ...
        },
        Service => {
            ServiceID => ['azonosítók'],
            Name      => ['nevek'],
            ParentID  => ['azonosítók'],
            # ...
        },
        Type => {
            ID   => ['azonosítók'],
            Name => ['nevek'],
            # ...
        },
        Priority = {
            ID   => ['azonosítók'],
            Name => ['nevek'],
            # ...
        },
        SLA = {
            SLAID    => ['azonosítók'],
            Name     => ['nevek'],
            Calendar => ['naptárak'],
            # ...
        },
        State = {
            ID       => ['azonosítók'],
            Name     => ['nevek'],
            TypeName => ['állapottípusnév'],,
            TypeID   => ['állapottípus-azonosító'],
            # ...
        },
        Owner => {
            UserLogin => ['felhasználónevek'],
            Group_rw => [
                'csoportok',
            ],
            Role => [
                'admin',
            ],
            # ...
        },
        Responsible => {
            UserLogin => ['felhasználónevek'],
            Group_rw => [
                'csoportok',
            ],
            Role => [
                'admin',
            ],
            # ...
        },
        DynamicField => {
            # A neveknek DynamicField_<mezonev> formátumban kell lenniük.
            # A tömbben [ ... ] lévő értékeknek mindig a dinamikus mező
            #   meghatározásban megadott lefordítatlan belső adatkulcsoknak
            #   kell lenniük, és nem a felhasználónak megjelenített adatértékeknek.
            DynamicField_Mezo1             => ['valamilyen érték'],
            DynamicField_MasikMezo         => ['valamilyen érték'],
            DynamicField_JegySzabadSzoveg2 => ['valamilyen érték'],
            # ...
        },
        # vagylagosan a jegytulajdonságok megadhatók a jegykivonatban
        Ticket => {
            Queue                => ['Nyers'],
            State                => ['new', 'open'],
            Priority             => ['prioritások'],
            Lock                 => ['lock'],
            CustomerID           => ['azonosítók'],
            CustomerUserID       => ['azonosítók'],
            Owner                => ['tulajdonosok'],
            DynamicField_Mezo1   => ['valamilyen érték'],
            DynamicField_EnMezom => ['valamilyen érték'],
            # ...
        },
    },

    # illesztési tulajdonságok (létező értékek az adatbázisból)
    PropertiesDatabase => {
        # Lásd a „Properties” szakaszt, ugyanaz a beállítás használható itt is.
        # ...
    }

    # lehetséges lehetőségek visszaállítása (fehér lista)
    Possible => {
        # lehetséges jegylehetőségek (fehér lista)
        Ticket => {
            Queue                => ['Forródrót', 'Koordináció'],
            State                => ['állapotok'],
            Priority             => ['5 very high'],
            DynamicField_Mezo1   => ['valamilyen érték'],
            DynamicField_EnMezom => ['valamilyen érték'],
            # ...
            NewOwner             => ['valamilyen tulajdonos'],
            OldOwner             => ['valamilyen tulajdonos'],
            # ...
        },

        # A lehetséges tevékenység párbeszédek számának korlátozása,
        #   amelyeket az ügyintéző/ügyfél használhat egy folyamatjegyben.
        ActivityDialog => ['TP1', 'TP3'],

        # A lehetséges folyamatok számának korlátozása, amelyek indíthatók
        Process => ['Process-9c378d7cc59f0fce4cee7bb9995ee3eb', 'Process-12345678901234567890123456789012'],

        # lehetséges művelet lehetőségek (fehér lista)
        Action => [
            'AgentTicketBounce',
            'AgentTicketPhone'.      # csak a felosztás művelet megjelenítéséhez/elrejtéséhez használható
            'AgentLinkObject',       # csak az összekapcsolás művelet megjelenítéséhez/elrejtéséhez használható
            # ...
        ],
    },
    # lehetőségek hozzáadása (fehér lista)
    PossibleAdd => {
        # Lásd a „Possible” szakaszt
        # ...
    },
    # lehetőségek eltávolítása (fekete lista)
    PossibleNot => {
        # Lásd a „Possible” szakaszt
        # ...
    },
};