# -- # 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::CloudService::Backend::Configuration; use strict; use warnings; use Kernel::System::VariableCheck qw(:all); our @ObjectDependencies = ( 'Kernel::Config', 'Kernel::System::Cache', 'Kernel::System::DB', 'Kernel::System::Log', 'Kernel::System::Main', 'Kernel::System::Valid', 'Kernel::System::YAML', ); =head1 NAME Kernel::System::CloudService::Backend::Configuration =head1 DESCRIPTION CloudService configuration backend. =head1 PUBLIC INTERFACE =head2 new() Don't use the constructor directly, use the ObjectManager instead: my $CloudServiceObject = $Kernel::OM->Get('Kernel::System::CloudService::Backend::Configuration'); =cut sub new { my ( $CloudService, %Param ) = @_; # allocate new hash for object my $Self = {}; bless( $Self, $CloudService ); $Self->{CacheType} = 'CloudService'; $Self->{CacheTTL} = 60 * 60; # 1 hour return $Self; } =head2 CloudServiceAdd() add new CloudServices returns id of new CloudService if successful or undef otherwise my $ID = $CloudServiceObject->CloudServiceAdd( Name => 'some name', Config => $ConfigHashRef, ValidID => 1, UserID => 123, ); =cut sub CloudServiceAdd { my ( $Self, %Param ) = @_; # check needed stuff for my $Key (qw(Name Config ValidID UserID)) { if ( !$Param{$Key} ) { $Kernel::OM->Get('Kernel::System::Log')->Log( Priority => 'error', Message => "Need $Key!", ); return; } } # check config if ( !IsHashRefWithData( $Param{Config} ) ) { $Kernel::OM->Get('Kernel::System::Log')->Log( Priority => 'error', Message => "CloudService Config should be a non empty hash reference!", ); return; } my %ExistingCloudServices = reverse %{ $Self->CloudServiceList( Valid => 0 ) }; if ( $ExistingCloudServices{ $Param{Name} } ) { $Kernel::OM->Get('Kernel::System::Log')->Log( Priority => 'error', Message => "A CloudService with the name $Param{Name} already exists.", ); return; } # dump config as string my $Config = $Kernel::OM->Get('Kernel::System::YAML')->Dump( Data => $Param{Config} ); # get database object my $DBObject = $Kernel::OM->Get('Kernel::System::DB'); # sql return if !$DBObject->Do( SQL => ' INSERT INTO cloud_service_config (name, config, valid_id, create_time, create_by, change_time, change_by) VALUES (?, ?, ?, current_timestamp, ?, current_timestamp, ?)', Bind => [ \$Param{Name}, \$Config, \$Param{ValidID}, \$Param{UserID}, \$Param{UserID}, ], ); return if !$DBObject->Prepare( SQL => 'SELECT id FROM cloud_service_config WHERE name = ?', Bind => [ \$Param{Name} ], ); my $ID; while ( my @Row = $DBObject->FetchrowArray() ) { $ID = $Row[0]; } # delete cache $Kernel::OM->Get('Kernel::System::Cache')->CleanUp( Type => $Self->{CacheType}, ); return $ID; } =head2 CloudServiceGet() get CloudServices attributes my $CloudService = $CloudServiceObject->CloudServiceGet( ID => 123, # ID or Name must be provided Name => 'MyCloudService', ); Returns: $CloudService = { ID => 123, Name => 'some name', Config => $ConfigHashRef, ValidID => 123, CreateTime => '2011-02-08 15:08:00', ChangeTime => '2011-02-08 15:08:00', }; =cut sub CloudServiceGet { my ( $Self, %Param ) = @_; # check needed stuff if ( !$Param{ID} && !$Param{Name} ) { $Kernel::OM->Get('Kernel::System::Log')->Log( Priority => 'error', Message => 'Need ID or Name!', ); return; } # get cache object my $CacheObject = $Kernel::OM->Get('Kernel::System::Cache'); # check cache my $CacheKey; if ( $Param{ID} ) { $CacheKey = 'CloudServiceGet::ID::' . $Param{ID}; } else { $CacheKey = 'CloudServiceGet::Name::' . $Param{Name}; } my $Cache = $CacheObject->Get( Type => $Self->{CacheType}, Key => $CacheKey, ); return $Cache if $Cache; # get database object my $DBObject = $Kernel::OM->Get('Kernel::System::DB'); # sql if ( $Param{ID} ) { return if !$DBObject->Prepare( SQL => ' SELECT id, name, config, valid_id, create_time, change_time FROM cloud_service_config WHERE id = ?', Bind => [ \$Param{ID} ], Limit => 1, ); } else { return if !$DBObject->Prepare( SQL => ' SELECT id, name, config, valid_id, create_time, change_time FROM cloud_service_config WHERE name = ?', Bind => [ \$Param{Name} ], Limit => 1, ); } my %Data; while ( my @Data = $DBObject->FetchrowArray() ) { %Data = ( ID => $Data[0], Name => $Data[1], Config => $Data[2], ValidID => $Data[3], CreateTime => $Data[4], ChangeTime => $Data[5], ); } # Convert YAML string back to Perl data structure. if ( $Data{Config} ) { $Data{Config} = $Kernel::OM->Get('Kernel::System::YAML')->Load( Data => $Data{Config} ); } # set cache $CacheObject->Set( Type => $Self->{CacheType}, Key => $CacheKey, Value => \%Data, TTL => $Self->{CacheTTL}, ); return \%Data; } =head2 CloudServiceUpdate() update CloudService attributes returns 1 if successful or undef otherwise my $Success = $CloudServiceObject->CloudServiceUpdate( ID => 123, Name => 'some name', Config => $ConfigHashRef, ValidID => 1, UserID => 123, ); =cut sub CloudServiceUpdate { my ( $Self, %Param ) = @_; # check needed stuff for my $Key (qw(ID Name Config ValidID UserID)) { if ( !$Param{$Key} ) { $Kernel::OM->Get('Kernel::System::Log')->Log( Priority => 'error', Message => "Need $Key!", ); return; } } # check config if ( !IsHashRefWithData( $Param{Config} ) ) { $Kernel::OM->Get('Kernel::System::Log')->Log( Priority => 'error', Message => "CloudService Config should be a non empty hash reference!", ); return; } my %ExistingCloudServices = reverse %{ $Self->CloudServiceList( Valid => 0 ) }; if ( $ExistingCloudServices{ $Param{Name} } != $Param{ID} ) { $Kernel::OM->Get('Kernel::System::Log')->Log( Priority => 'error', Message => "A CloudService with the name $Param{Name} already exists.", ); return; } # dump config as string my $Config = $Kernel::OM->Get('Kernel::System::YAML')->Dump( Data => $Param{Config} ); # get database object my $DBObject = $Kernel::OM->Get('Kernel::System::DB'); # check if config and valid_id is the same return if !$DBObject->Prepare( SQL => ' SELECT config, valid_id, name FROM cloud_service_config WHERE id = ?', Bind => [ \$Param{ID} ], Limit => 1, ); my $ConfigCurrent; my $ValidIDCurrent; my $NameCurrent; while ( my @Data = $DBObject->FetchrowArray() ) { $ConfigCurrent = $Data[0]; $ValidIDCurrent = $Data[1]; $NameCurrent = $Data[2]; } if ( $ValidIDCurrent eq $Param{ValidID} && $Config eq $ConfigCurrent && $NameCurrent eq $Param{Name} ) { return 1; } # sql return if !$DBObject->Do( SQL => ' UPDATE cloud_service_config SET name = ?, config = ?, valid_id = ?, change_time = current_timestamp, change_by = ? WHERE id = ?', Bind => [ \$Param{Name}, \$Config, \$Param{ValidID}, \$Param{UserID}, \$Param{ID}, ], ); # delete cache $Kernel::OM->Get('Kernel::System::Cache')->CleanUp( Type => $Self->{CacheType}, ); return 1; } =head2 CloudServiceDelete() delete a CloudService returns 1 if successful or undef otherwise my $Success = $CloudServiceObject->CloudServiceDelete( ID => 123, UserID => 123, ); =cut sub CloudServiceDelete { my ( $Self, %Param ) = @_; # check needed stuff for my $Key (qw(ID UserID)) { if ( !$Param{$Key} ) { $Kernel::OM->Get('Kernel::System::Log')->Log( Priority => 'error', Message => "Need $Key!", ); return; } } # check if exists my $CloudService = $Self->CloudServiceGet( ID => $Param{ID}, ); return if !IsHashRefWithData($CloudService); # delete web service return if !$Kernel::OM->Get('Kernel::System::DB')->Do( SQL => 'DELETE FROM cloud_service_config WHERE id = ?', Bind => [ \$Param{ID} ], ); # delete cache $Kernel::OM->Get('Kernel::System::Cache')->CleanUp( Type => $Self->{CacheType}, ); return 1; } =head2 CloudServiceList() get CloudService list my $List = $CloudServiceObject->CloudServiceList(); or my $List = $CloudServiceObject->CloudServiceList( Valid => 0, # 0 | 1 (optional) (default 1) ); =cut sub CloudServiceList { my ( $Self, %Param ) = @_; # set default $Param{Valid} //= 1; # get cache object my $CacheObject = $Kernel::OM->Get('Kernel::System::Cache'); my $CacheKey = 'CloudServiceList::Valid::' . $Param{Valid}; my $Cache = $CacheObject->Get( Type => 'CloudService', Key => $CacheKey, ); return $Cache if ref $Cache; my $SQL = 'SELECT id, name FROM cloud_service_config'; if ( $Param{Valid} ) { # get valid object my $ValidObject = $Kernel::OM->Get('Kernel::System::Valid'); $SQL .= ' WHERE valid_id IN (' . join ', ', $ValidObject->ValidIDsGet() . ')'; } # get database object my $DBObject = $Kernel::OM->Get('Kernel::System::DB'); return if !$DBObject->Prepare( SQL => $SQL ); my %Data; while ( my @Row = $DBObject->FetchrowArray() ) { $Data{ $Row[0] } = $Row[1]; } # set cache $CacheObject->Set( Type => 'CloudService', Key => $CacheKey, Value => \%Data, TTL => $Self->{CacheTTL}, ); return \%Data; } 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