Přeskočit na hlavní obsah

Vlastní javascript ve formuláři Nový požadavek

Můžete ovlivnit vzhled a chování systému Nový formulář ticketu pomocí vlastního JavaScriptu. Můžete například:

  • Skrývání a zobrazování určitých polí formuláře v závislosti na hodnotách jiných polí.
  • Určete, která pole jsou povinná v závislosti na hodnotách ostatních polí.

Vložte vlastní JavaScript do formuláře služby pomocí příkazu Správa - Služby - Nový formulář požadavku JavaScript.

Ve skriptu můžete použít následující funkce:

NázevPopisPříklady
getElement(itemName)Funkce vrací objekt pole itemName ve formuláři.
var $ticketName = self.getElement('tHdTicket.sHdTicket');
getValue(itemName)

Funkce vrací hodnotu, která je aktuálně vyplněna ve formuláři v poli itemName.

Funkce vrací objekt {id, value} :

  • Aktuální obory: {null, filled value}
  • Datové pole: {null, objekt typu Date()}
  • Výběrové pole: {selected item id, item text displayed}
  • Pole Objekty: Array[{object id, object path}]
  • Pole Přílohy: {null, null}
var ticketName = self.getValue('tHdTicket.sHdTicket').value; var slaId = self.getValue('tHdTicket.liHdTicketSlaId').id;
setValue(itemName, value)

Vyplní pole itemName ve formuláři hodnotou value.

Pro pole typu int s výběrem hodnot uveďte id hodnoty v parametru value v nabídce (tColumnValue.iColumnValueId), nikoli její text. Je také možné vkládat hodnoty, ke kterým uživatel nemá oprávnění.

U polí s datem zadejte v parametru hodnota objekty typu Date().

Pokud do pole číselného typu (int, float) zadáte jinou než číselnou hodnotu, hodnota pole se nezmění a do konzoly prohlížeče se vypíše chyba.

Do polí s formátovaným textem (HTML) lze vkládat pouze prostý text (bez značek HTML).

self.setValue('tHdTicket.@Description', 'I am coding like a champ'); self.setValue('tHdTicket.Objects', 100); self.setValue('tHdTicketCust.CustomDate', new Date("2020-03-01T12:00"));
show(itemName)Zobrazí pole itemName ve formuláři, pokud bylo skryté.
self.show('tHdTicket.@Description');
hide(itemName)Skryje pole itemName ve formuláři, pokud je zobrazeno a není vyžadováno. Skrytá pole se při odeslání formuláře neodesílají.
self.hide('tHdTicket.@Description');
setRequired(itemName)Nastaví pole itemName jako povinné, tj. uživatel musí před odesláním formuláře vyplnit hodnotu.
self.setRequired('tHdTicket.@Description');
setNotRequired(itemName)Nastaví pole itemName jako nepovinné. Pole, jejichž povinnost je nastavena v servisním procesu, nelze tímto způsobem nastavit jako nepovinná.
self.setNotRequired('tHdTicket.@Description');
onChange(itemName, function())

Při změně hodnoty pole itemName se automaticky zavolá definovaná funkce.

Funkci onChange() volejte pouze v těle funkce initHandlers().

Definovaná funkce se obvykle volá pouze při ukončení vstupního pole. V polích s výběrem hodnot se volá po výběru hodnoty z nabídky. Ve formátovaném textovém vstupním poli se volá po každém napsaném znaku, změně formátování atd. Funkce je volána také při programové změně hodnoty pomocí funkce setValue().

function ticketNameChanged() {
    var ticketName = self.getValue('tHdTicket.sHdTicket').value;
    self.show('tHdTicket.@Description');
    self.setValue('tHdTicket.@Description', 'Name: ' + ticketName);
};

NewFormScript.prototype.initHandlers = function () {
    self.onChange('tHdTicket.sHdTicket', ticketNameChanged);
}

Při změně názvu požadavku ve formuláři výše uvedený skript zobrazí pole popisu požadavku a vloží do něj zadaný název požadavku.

Funkci ticketNameChanged() můžete nahradit anonymní funkcí definovanou přímo v argumentu volání funkce onChange().

Hodnoty parametru itemName:

Položka formulářeitemName
NázevtHdTicket.sHdTicket
PopistHdTicket.@Description
PřílohytHdTicket.@Attachments
SlatHdTicket.liHdTicketSlaId
Související organizacetHdTicket.RelatedAccountId
Číslo zařízenítHdTicket.sHdTicketDeviceCode
PrioritatHdTicket.Priority
DopadtHdTicket.Impact
NaléhavosttHdTicket.Urgency
ObjektytHdTicket.Objects
Vlastní poletHdTicketCust.<database column name>
Poznámka

Při hromadných úpravách sekcí a textových bloků se vytvářejí nová ID pro vlastní JavaScript. Proto je třeba odpovídajícím způsobem aktualizovat všechny stávající používané vlastní JavaScripty.

Formulář můžete upravit pomocí standardního javascriptu i mimo zde popsané funkce.

Příklady skriptů:

Příklad č. 1​

Pokud má pole Priorita(tHdTicket.Priorita) hodnotu kritická nebo vysoká, zobrazí se ve formuláři vlastní pole Důvod (tHdTicketCust.PrioritaDůvod ), které je povinné.

var self; 

NewFormScript.prototype.init = function () {  
    self = this;   
    //Hide the Justification field when the form is loaded  
    self.hide('tHdTicketCust.PriorityReason'); 
} 

NewFormScript.prototype.initHandlers = function () {   
    //Logging a change to the Priority field  
    self.onChange('tHdTicket.Priority', function() {    
        var priorityValue = self.getValue('tHdTicket.Priority').value;     
        //Check whether the Priority field has a high or critical    
        if (priorityValue == 'high' || priorityValue == 'critical') {
            //Setting the Justification field as mandatory     
            self.setRequired('tHdTicketCust.PriorityReason');
            //Display the Reason field     
            self.show('tHdTicketCust.PriorityReason');     
        }
        else {       
            //Setting the Reason field as optional     
            self.setNotRequired('tHdTicketCust.PriorityReason');     
            self.hide('tHdTicketCust.PriorityReason');     
        }   
    });
}

Příklad č. 2​

Ve vlastním poli Kontaktní telefon (tHdTicketCust.ContactPhone) chceme zobrazit zástupný symbol: "Zadejte v mezinárodním formátu, např. +420 123 456 789".

var self; 

NewFormScript.prototype.init = function () {   self = this;
//Set placeholder on field self.getElement('tHdTicketCust.ContactPhone').find('input').attr('placeholder', 'Enter in international format e.g. +420 123 456 789');}