2. fejezet - OTRS belsőségek - hogyan működik

Egy Item elem egyetlen adatot tartalmaz. Az elhagyható ValueType attribútum határozza meg, hogy milyen típusú adat, és hogyan kell megjeleníteni a felhasználónak a grafikus felületen. Ha nincs ValueType megadva, akkor alapértelmezetten String lesz.

Nézze meg a lent a különböző értéktípusok meghatározását.

<Setting Name="Ticket::Hook" Required="1" Valid="1">
    <Description Translatable="1">The identifier for a ticket, e.g. Ticket#, Call#, MyTicket#. The default is Ticket#.</Description>
    <Navigation>Core::Ticket</Navigation>
    <Value>
        <Item ValueType="String" ValueRegex="">Ticket#</Item>
    </Value>
</Setting>
                    

Ezzel a beállítási elemmel tömbök jeleníthetők meg.

<Setting Name="SettingName">
    ...
    <Value>
        <Array>
            <Item Translatable="1">1. érték</Item>
            <Item Translatable="1">2. érték</Item>
            ...
        </Array>
    </Value>
</Setting>
                    

Ezzel a beállítási elemmel kivonatok jeleníthetők meg.

<Setting Name="SettingName">
    ...
    <Value>
        <Hash>
            <Item Key="Egy" Translatable="1">Első</Item>
            <Item Key="Ketto" Translatable="1">Második</Item>
            ...
        </Hash>
    </Value>
</Setting>
                    

Lehetőség van egymásba ágyazott tömb vagy kivonat elemek meglétére is (mint például tömbök kivonata, kivonatok tömbje, tömbök kivonatainak tömbje, stb.). Lent van egy példa a kivonatok tömbjére.

<Setting Name="ExampleAoH">
    ...
    <Value>
        <Array>
            <DefaultItem>
                <Hash>
                    <Item></Item>
                </Hash>
            </DefaultItem>
            <Item>
                <Hash>
                    <Item Key="Egy">1</Item>
                    <Item Key="Ketto">2</Item>
                </Hash>
            </Item>
            <Item>
                <Hash>
                    <Item Key="Harom">3</Item>
                    <Item Key="Negy">4</Item>
                </Hash>
            </Item>
        </Array>
    </Value>
</Setting>
                    

<Setting Name="SettingName">
    ...
    <Value>
        <Item ValueType="String" ValueRegex=""></Item>
    </Value>
</Setting>
                    

Egy beállítási elem számokhoz és egysoros karakterláncokhoz. Ellenőrizhető az érvényesség egy reguláris kifejezéssel, ha lehetséges (elhagyható). Ez az alapértelmezett ValueType.

<Setting Name="SettingName">
    ...
    <Value>
        <Item ValueType="String" ValueRegex="" Translatable="1">Érték</Item>
    </Value>
</Setting>
                    

Az opcionális Translatable attribútum jelöli meg ezt a beállítást fordíthatóként, amely azt fogja eredményezni, hogy fel lesz véve az OTRS fordítási fájljaiba. Ezt az attribútumot bármely címkére el lehet helyezni (lásd lent is).

Egy beállítási elem jelszavakhoz. Továbbra is egyszerű szövegként van tárolva az XML-ben, de el van fedve a grafikus felhasználói felületen.

<Setting Name="SettingName">
    ...
    <Value>
        <Item ValueType="Password">Titok</Item>
    </Value>
</Setting>
                    

Egy beállítási elem Perl-modulhoz. Rendelkezik egy ValueFilter attribútummal, amely szűri a lehetséges értékeket a kiválasztásnál. A lenti példában a felhasználó a Kernel::System::Log::SysLog vagy a Kernel::System::Log::File Perl-modult választhatja.

<Setting Name="SettingName">
    ...
    <Value>
        <Item ValueType="PerlModule" ValueFilter="Kernel/System/Log/*.pm">Kernel::System::Log::SysLog</Item>
    </Value>
</Setting>
                    

Egy beállítási elem többsoros szöveghez.

<Setting Name="SettingName">
    ...
    <Value>
        <Item ValueType="Textarea"></Item>
    </Value>
</Setting>
                    

Ez a beállítási elem előre beállított értékeket nyújt egy legördülő menüként. A SelectedID vagy a SelectedValue attribútumok előre kiválaszthatnak egy alapértelmezett értéket.

<Setting Name="SettingName">
    ...
    <Value>
        <Item ValueType="Select" SelectedID="Queue">
            <Item ValueType="Option" Value="Queue" Translatable="1">Várólista</Item>
            <Item ValueType="Option" Value="SystemAddress" Translatable="1">Rendszercím</Item>
        </Item>
    </Value>
</Setting>
                    

Ennek a jelölőnégyzet beállítási elemnek két állapota van: 0 vagy 1.

<Setting Name="SettingName">
    ...
    <Value>
        <Item ValueType="Checkbox">0</Item>
    </Value>
</Setting>
                    

Ez a beállítási elem egy dátumértéket tartalmaz.

<Setting Name="SettingName">
    ...
    <Value>
        <Item ValueType="Date">2016-02-02</Item>
    </Value>
</Setting>
                    

Ez a beállítási elem egy dátumot és egy időértéket tartalmaz.

<Setting Name="SettingName">
    ...
    <Value>
        <Item ValueType="DateTime">2016-12-08 01:02:03</Item>
    </Value>
</Setting>
                    

Ez a beállítási elem egy könyvtárat tartalmaz.

<Setting Name="SettingName">
    ...
    <Value>
        <Item ValueType="Directory">/etc</Item>
    </Value>
</Setting>
                    

Ez a beállítási elem egy fájlútvonalat tartalmaz.

<Setting Name="SettingName">
    ...
    <Value>
        <Item ValueType="File">/etc/hosts</Item>
    </Value>
</Setting>
                    

Ez a beállítási elem egy bizonyos entitás értékét tartalmazza. A ValueEntityType attribútum határozza meg az entitás típusát. Támogatott entitások: DynamicField, Queue, Priority, State és Type. A következetesség-ellenőrzések fogják biztosítani, hogy csak érvényes entitások legyenek beállíthatók, és hogy azok az entitások, amelyeket a beállításokban használnak, ne legyenek érvénytelenre állíthatók. Amikor egy entitást átneveznek, akkor az összes hivatkozó konfigurációs beállítás frissítve lesz.

<Setting Name="SettingName">
    ...
    <Value>
        <Item ValueType="Entity" ValueEntityType="Queue">Szemét</Item>
    </Value>
</Setting>
                    

Ez a beállítási elem egy időzóna értéket tartalmaz.

<Setting Name="SettingName">
    ...
    <Value>
        <Item ValueType="TimeZone">UTC</Item>
    </Value>
</Setting>
                    

Ez a beállítási elem meghatározásokat tartalmaz az olyan munkaszüneti napokhoz, amelyek minden évben ismétlődnek. A következő attribútumok kötelezőek: ValueMonth, ValueDay.

<Setting Name="SettingName">
    ...
    <Value>
        <Item ValueType="VacationDays">
            <DefaultItem ValueType="VacationDays"></DefaultItem>
            <Item ValueMonth="1" ValueDay="1" Translatable="1">Újév</Item>
            <Item ValueMonth="5" ValueDay="1" Translatable="1">A munka ünnepe</Item>
            <Item ValueMonth="12" ValueDay="24" Translatable="1">Szenteste</Item>
        </Item>
    </Value>
</Setting>
                    

Ez a beállítási elem meghatározásokat tartalmaz az olyan munkaszüneti napokhoz, amelyek csak egyszer fordulnak elő. A következő attribútumok kötelezőek: ValueMonth, ValueDay és ValueYear.

<Setting Name="SettingName">
    ...
    <Value>
        <Item ValueType="VacationDaysOneTime">
            <Item ValueYear="2004" ValueMonth="1" ValueDay="1">Teszt</Item>
        </Item>
    </Value>
</Setting>
                    

Ez a beállítási elem meghatározásokat tartalmaz a munkaidőhöz.

<Setting Name="SettingName">
    ...
    <Value>
        <Item ValueType="WorkingHours">
            <Item ValueType="Day" ValueName="Mon">
                <Item ValueType="Hour">8</Item>
                <Item ValueType="Hour">9</Item>
            </Item>
            <Item ValueType="Day" ValueName="Tue">
                <Item ValueType="Hour">8</Item>
                <Item ValueType="Hour">9</Item>
            </Item>
        </Item>
    </Value>
</Setting>
                    

Modul regisztráció az ügyintézői felülethez:

<Setting Name="SettiFrontend::Module###AgentModuleName">
    ...
    <Value>
        <Item ValueType="FrontendRegistration">
            <Hash>
                <Item Key="Group">
                    <Array>
                    </Array>
                </Item>
                <Item Key="GroupRo">
                    <Array>
                    </Array>
                </Item>
                <Item Key="Description" Translatable="1">Telefonhívás.</Item>
                <Item Key="Title" Translatable="1">Telefonos jegy</Item>
                <Item Key="NavBarName">Ticket</Item>
            </Hash>
        </Item>
    </Value>
</Setting>
                    

<Array>
    <DefaultItem>
        <Array>
            <DefaultItem ValueType="Select" SelectedID='option-2'>
                <Item ValueType="Option" Value="option-1">1. lehetőség</Item>
                <Item ValueType="Option" Value="option-2">2. lehetőség</Item>
            </DefaultItem>
        </Array>
    </DefaultItem>
    ...
</Array>
                    

<Hash>
    <DefaultItem>
        <Hash>
            <DefaultItem ValueType="Date">2017-01-01</DefaultItem>
        </Hash>
    </DefaultItem>
    ...
</Hash>