# -- # Copyright (C) 2001-2019 OTRS AG, https://otrs.com/ # -- # This software comes with ABSOLUTELY NO WARRANTY. For details, see # the enclosed file COPYING for license information (GPL). If you # did not receive this file, see https://www.gnu.org/licenses/gpl-3.0.txt. # -- package Kernel::System::Priority; use strict; use warnings; our @ObjectDependencies = ( 'Kernel::Config', 'Kernel::System::Cache', 'Kernel::System::DB', 'Kernel::System::Log', 'Kernel::System::SysConfig', 'Kernel::System::Valid', ); =head1 NAME Kernel::System::Priority - priority lib =head1 DESCRIPTION All ticket priority functions. =head1 PUBLIC INTERFACE =head2 new() create an object my $PriorityObject = $Kernel::OM->Get('Kernel::System::Priority'); =cut sub new { my ( $Type, %Param ) = @_; # allocate new hash for object my $Self = {}; bless( $Self, $Type ); $Self->{CacheType} = 'Priority'; $Self->{CacheTTL} = 60 * 60 * 24 * 20; return $Self; } =head2 PriorityList() return a priority list as hash my %List = $PriorityObject->PriorityList( Valid => 0, ); =cut sub PriorityList { my ( $Self, %Param ) = @_; # check valid param if ( !defined $Param{Valid} ) { $Param{Valid} = 1; } # create cachekey my $CacheKey; if ( $Param{Valid} ) { $CacheKey = 'PriorityList::Valid'; } else { $CacheKey = 'PriorityList::All'; } # check cache my $Cache = $Kernel::OM->Get('Kernel::System::Cache')->Get( Type => $Self->{CacheType}, Key => $CacheKey, ); return %{$Cache} if $Cache; my $DBObject = $Kernel::OM->Get('Kernel::System::DB'); # create sql my $SQL = 'SELECT id, name FROM ticket_priority '; if ( $Param{Valid} ) { $SQL .= "WHERE valid_id IN ( ${\(join ', ', $Kernel::OM->Get('Kernel::System::Valid')->ValidIDsGet())} )"; } return if !$DBObject->Prepare( SQL => $SQL ); # fetch the result my %Data; while ( my @Row = $DBObject->FetchrowArray() ) { $Data{ $Row[0] } = $Row[1]; } # set cache $Kernel::OM->Get('Kernel::System::Cache')->Set( Type => $Self->{CacheType}, TTL => $Self->{CacheTTL}, Key => $CacheKey, Value => \%Data, ); return %Data; } =head2 PriorityGet() get a priority my %List = $PriorityObject->PriorityGet( PriorityID => 123, UserID => 1, ); =cut sub PriorityGet { my ( $Self, %Param ) = @_; # check needed stuff for (qw(PriorityID UserID)) { if ( !$Param{$_} ) { $Kernel::OM->Get('Kernel::System::Log')->Log( Priority => 'error', Message => "Need $_!" ); return; } } # check cache my $Cache = $Kernel::OM->Get('Kernel::System::Cache')->Get( Type => $Self->{CacheType}, Key => 'PriorityGet' . $Param{PriorityID}, ); return %{$Cache} if $Cache; my $DBObject = $Kernel::OM->Get('Kernel::System::DB'); # ask database return if !$DBObject->Prepare( SQL => 'SELECT id, name, valid_id, create_time, create_by, change_time, change_by ' . 'FROM ticket_priority WHERE id = ?', Bind => [ \$Param{PriorityID} ], Limit => 1, ); # fetch the result my %Data; while ( my @Row = $DBObject->FetchrowArray() ) { $Data{ID} = $Row[0]; $Data{Name} = $Row[1]; $Data{ValidID} = $Row[2]; $Data{CreateTime} = $Row[3]; $Data{CreateBy} = $Row[4]; $Data{ChangeTime} = $Row[5]; $Data{ChangeBy} = $Row[6]; } # set cache $Kernel::OM->Get('Kernel::System::Cache')->Set( Type => $Self->{CacheType}, TTL => $Self->{CacheTTL}, Key => 'PriorityGet' . $Param{PriorityID}, Value => \%Data, ); return %Data; } =head2 PriorityAdd() add a ticket priority my $True = $PriorityObject->PriorityAdd( Name => 'Prio', ValidID => 1, UserID => 1, ); =cut sub PriorityAdd { my ( $Self, %Param ) = @_; # check needed stuff for (qw(Name ValidID UserID)) { if ( !$Param{$_} ) { $Kernel::OM->Get('Kernel::System::Log')->Log( Priority => 'error', Message => "Need $_!" ); return; } } my $DBObject = $Kernel::OM->Get('Kernel::System::DB'); return if !$DBObject->Do( SQL => 'INSERT INTO ticket_priority (name, valid_id, create_time, create_by, ' . 'change_time, change_by) VALUES ' . '(?, ?, current_timestamp, ?, current_timestamp, ?)', Bind => [ \$Param{Name}, \$Param{ValidID}, \$Param{UserID}, \$Param{UserID}, ], ); # get new priority id return if !$DBObject->Prepare( SQL => 'SELECT id FROM ticket_priority WHERE name = ?', Bind => [ \$Param{Name} ], Limit => 1, ); # fetch the result my $ID; while ( my @Row = $DBObject->FetchrowArray() ) { $ID = $Row[0]; } return if !$ID; # delete cache $Kernel::OM->Get('Kernel::System::Cache')->CleanUp( Type => $Self->{CacheType}, ); return $ID; } =head2 PriorityUpdate() update a existing ticket priority my $True = $PriorityObject->PriorityUpdate( PriorityID => 123, Name => 'New Prio', ValidID => 1, UserID => 1, ); =cut sub PriorityUpdate { my ( $Self, %Param ) = @_; # check needed stuff for (qw(PriorityID Name ValidID UserID)) { if ( !$Param{$_} ) { $Kernel::OM->Get('Kernel::System::Log')->Log( Priority => 'error', Message => "Need $_!" ); return; } } my $DBObject = $Kernel::OM->Get('Kernel::System::DB'); return if !$DBObject->Do( SQL => 'UPDATE ticket_priority SET name = ?, valid_id = ?, ' . 'change_time = current_timestamp, change_by = ? WHERE id = ?', Bind => [ \$Param{Name}, \$Param{ValidID}, \$Param{UserID}, \$Param{PriorityID}, ], ); # delete cache $Kernel::OM->Get('Kernel::System::Cache')->CleanUp( Type => $Self->{CacheType}, ); return 1; } =head2 PriorityLookup() returns the id or the name of a priority my $PriorityID = $PriorityObject->PriorityLookup( Priority => '3 normal', ); my $Priority = $PriorityObject->PriorityLookup( PriorityID => 1, ); =cut sub PriorityLookup { my ( $Self, %Param ) = @_; # check needed stuff if ( !$Param{Priority} && !$Param{PriorityID} ) { $Kernel::OM->Get('Kernel::System::Log')->Log( Priority => 'error', Message => 'Need Priority or PriorityID!' ); return; } # get (already cached) priority list my %PriorityList = $Self->PriorityList( Valid => 0, ); my $Key; my $Value; my $ReturnData; if ( $Param{PriorityID} ) { $Key = 'PriorityID'; $Value = $Param{PriorityID}; $ReturnData = $PriorityList{ $Param{PriorityID} }; } else { $Key = 'Priority'; $Value = $Param{Priority}; my %PriorityListReverse = reverse %PriorityList; $ReturnData = $PriorityListReverse{ $Param{Priority} }; } # check if data exists if ( !defined $ReturnData ) { $Kernel::OM->Get('Kernel::System::Log')->Log( Priority => 'error', Message => "No $Key for $Value found!", ); return; } return $ReturnData; } 1; =head1 TERMS AND CONDITIONS This software is part of the OTRS project (L). This software comes with ABSOLUTELY NO WARRANTY. For details, see the enclosed file COPYING for license information (GPL). If you did not receive this file, see L. =cut