This commit is contained in:
2024-10-14 00:08:40 +02:00
parent dbfba56f66
commit 1462d52e13
4572 changed files with 2658864 additions and 0 deletions

View File

@@ -0,0 +1,792 @@
# --
# 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::Modules::AgentITSMWorkOrderEdit;
use strict;
use warnings;
use Kernel::Language qw(Translatable);
use Kernel::System::VariableCheck qw(:all);
our $ObjectManagerDisabled = 1;
sub new {
my ( $Type, %Param ) = @_;
# allocate new hash for object
my $Self = {%Param};
bless( $Self, $Type );
return $Self;
}
sub Run {
my ( $Self, %Param ) = @_;
# get needed object
my $ParamObject = $Kernel::OM->Get('Kernel::System::Web::Request');
my $LayoutObject = $Kernel::OM->Get('Kernel::Output::HTML::Layout');
# get needed WorkOrderID
my $WorkOrderID = $ParamObject->GetParam( Param => 'WorkOrderID' );
# check needed stuff
if ( !$WorkOrderID ) {
return $LayoutObject->ErrorScreen(
Message => Translatable('No WorkOrderID is given!'),
Comment => Translatable('Please contact the administrator.'),
);
}
# get workdorder object
my $WorkOrderObject = $Kernel::OM->Get('Kernel::System::ITSMChange::ITSMWorkOrder');
# get workorder data
my $WorkOrder = $WorkOrderObject->WorkOrderGet(
WorkOrderID => $WorkOrderID,
UserID => $Self->{UserID},
);
# check error
if ( !$WorkOrder ) {
return $LayoutObject->ErrorScreen(
Message =>
$LayoutObject->{LanguageObject}->Translate( 'WorkOrder "%s" not found in database!', $WorkOrderID ),
Comment => Translatable('Please contact the administrator.'),
);
}
# get config object
my $ConfigObject = $Kernel::OM->Get('Kernel::Config');
# get config of frontend module
$Self->{Config} = $ConfigObject->Get("ITSMWorkOrder::Frontend::$Self->{Action}");
# get change object
my $ChangeObject = $Kernel::OM->Get('Kernel::System::ITSMChange');
# check permissions
my $Access = $ChangeObject->Permission(
Type => $Self->{Config}->{Permission},
Action => $Self->{Action},
ChangeID => $WorkOrder->{ChangeID},
WorkOrderID => $WorkOrderID,
UserID => $Self->{UserID},
);
# error screen
if ( !$Access ) {
return $LayoutObject->NoPermission(
Message => $LayoutObject->{LanguageObject}->Translate(
'You need %s permissions on the change!', $Self->{Config}->{Permission}
),
WithHeader => 'yes',
);
}
# store needed parameters in %GetParam to make it reloadable
my %GetParam;
for my $ParamName (qw(WorkOrderTitle Instruction PlannedEffort AttachmentUpload FileID)) {
$GetParam{$ParamName} = $ParamObject->GetParam( Param => $ParamName );
}
# get the checkbox value and store it in %GetParam to make it reloadable
$GetParam{MoveFollowingWorkOrders} = $ParamObject->GetParam( Param => 'MoveFollowingWorkOrders' );
# get all workorder ids for this change
my $WorkOrderIDsRef = $WorkOrderObject->WorkOrderList(
ChangeID => $WorkOrder->{ChangeID},
UserID => $Self->{UserID},
);
# find out the following workorder ids
my @FollowingWorkOrderIDs;
my $OwnWorkOrderIDFound;
WORKORDERID:
for my $OtherWorkOrderID ( @{$WorkOrderIDsRef} ) {
# check if the other workorder id is the own workorder id
if ( $OtherWorkOrderID eq $WorkOrderID ) {
$OwnWorkOrderIDFound = 1;
next WORKORDERID;
}
# we are only interested in the following workorder ids
next WORKORDERID if !$OwnWorkOrderIDFound;
# collect the following workorder ids
push @FollowingWorkOrderIDs, $OtherWorkOrderID;
}
# get Dynamic fields from ParamObject
my %DynamicFieldValues;
# get the dynamic fields for this screen
my $DynamicField = $Kernel::OM->Get('Kernel::System::DynamicField')->DynamicFieldListGet(
Valid => 1,
ObjectType => 'ITSMWorkOrder',
FieldFilter => $Self->{Config}->{DynamicField} || {},
);
# get dynamic field backend object
my $DynamicFieldBackendObject = $Kernel::OM->Get('Kernel::System::DynamicField::Backend');
# cycle trough the activated Dynamic Fields for this screen
DYNAMICFIELD:
for my $DynamicFieldConfig ( @{$DynamicField} ) {
next DYNAMICFIELD if !IsHashRefWithData($DynamicFieldConfig);
# extract the dynamic field value from the web request and add the prefix
$DynamicFieldValues{ 'DynamicField_' . $DynamicFieldConfig->{Name} }
= $DynamicFieldBackendObject->EditFieldValueGet(
DynamicFieldConfig => $DynamicFieldConfig,
ParamObject => $ParamObject,
LayoutObject => $LayoutObject,
);
}
# store time related fields in %GetParam
for my $TimeType (qw(PlannedStartTime PlannedEndTime)) {
for my $TimePart (qw(Year Month Day Hour Minute)) {
my $ParamName = $TimeType . $TimePart;
$GetParam{$ParamName} = $ParamObject->GetParam( Param => $ParamName );
}
}
# Remember the reason why saving was not attempted.
my %ValidationError;
# get upload cache object
my $UploadCacheObject = $Kernel::OM->Get('Kernel::System::Web::UploadCache');
# get form id
$Self->{FormID} = $ParamObject->GetParam( Param => 'FormID' );
# create form id
if ( !$Self->{FormID} ) {
$Self->{FormID} = $UploadCacheObject->FormIDCreate();
}
# update workorder
if ( $Self->{Subaction} eq 'Save' ) {
# challenge token check for write action
$LayoutObject->ChallengeTokenCheck();
# the title is required
if ( !$GetParam{WorkOrderTitle} ) {
$ValidationError{WorkOrderTitleServerError} = 'ServerError';
}
# get log object
my $LogObject = $Kernel::OM->Get('Kernel::System::Log');
# check whether complete times are passed and build the time stamps
my %SystemTime;
TIMETYPE:
for my $TimeType (qw(PlannedStartTime PlannedEndTime)) {
for my $TimePart (qw(Year Month Day Hour Minute)) {
my $ParamName = $TimeType . $TimePart;
if ( !defined $GetParam{$ParamName} ) {
$LogObject->Log(
Priority => 'error',
Message => "Need $ParamName!",
);
next TIMETYPE;
}
}
# transform work order planned time, time stamp based on user time zone
%GetParam = $LayoutObject->TransformDateSelection(
%GetParam,
Prefix => $TimeType,
);
# format as timestamp
$GetParam{$TimeType} = sprintf '%04d-%02d-%02d %02d:%02d:00',
$GetParam{ $TimeType . 'Year' },
$GetParam{ $TimeType . 'Month' },
$GetParam{ $TimeType . 'Day' },
$GetParam{ $TimeType . 'Hour' },
$GetParam{ $TimeType . 'Minute' };
# sanity check the assembled timestamp
$SystemTime{$TimeType} = $Self->_TimeStamp2Epoch(
TimeStamp => $GetParam{$TimeType},
);
# do not save if time is invalid
if ( !$SystemTime{$TimeType} ) {
$ValidationError{ $TimeType . 'Invalid' } = 'ServerError';
}
}
# check validity of the planned start and end times
if ( $SystemTime{PlannedStartTime} && !$SystemTime{PlannedEndTime} ) {
$ValidationError{PlannedEndTimeInvalid} = 'ServerError';
$ValidationError{PlannedEndTimeErrorType} = 'GenericServerError';
}
elsif ( !$SystemTime{PlannedStartTime} && $SystemTime{PlannedEndTime} ) {
$ValidationError{PlannedStartTimeInvalid} = 'ServerError';
$ValidationError{PlannedStartTimeErrorType} = 'GenericServerError';
}
elsif (
( $SystemTime{PlannedStartTime} && $SystemTime{PlannedEndTime} )
&& ( $SystemTime{PlannedEndTime} <= $SystemTime{PlannedStartTime} )
)
{
$ValidationError{PlannedStartTimeInvalid} = 'ServerError';
$ValidationError{PlannedStartTimeErrorType} = 'BeforeThanEndTimeServerError';
}
# check format of planned effort, empty is allowed
if (
$GetParam{PlannedEffort}
&& $GetParam{PlannedEffort} !~ m{ \A \d* (?: [.] \d{1,2} )? \z }xms
)
{
$ValidationError{'PlannedEffortInvalid'} = 'ServerError';
}
# cycle trough the activated Dynamic Fields for this screen
DYNAMICFIELD:
for my $DynamicFieldConfig ( @{$DynamicField} ) {
next DYNAMICFIELD if !IsHashRefWithData($DynamicFieldConfig);
my $ValidationResult = $DynamicFieldBackendObject->EditFieldValueValidate(
DynamicFieldConfig => $DynamicFieldConfig,
ParamObject => $ParamObject,
Mandatory => $Self->{Config}->{DynamicField}->{ $DynamicFieldConfig->{Name} } == 2,
);
if ( !IsHashRefWithData($ValidationResult) ) {
return $LayoutObject->ErrorScreen(
Message => $LayoutObject->{LanguageObject}->Translate(
'Could not perform validation on field %s!', $DynamicFieldConfig->{Label}
),
Comment => Translatable('Please contact the administrator.'),
);
}
# propagate validation error to the Error variable to be detected by the frontend
if ( $ValidationResult->{ServerError} ) {
$ValidationError{ $DynamicFieldConfig->{Name} } = ' ServerError';
}
}
# if all passed data is valid
if ( !%ValidationError ) {
my $CouldUpdateWorkOrder = $WorkOrderObject->WorkOrderUpdate(
WorkOrderID => $WorkOrderID,
WorkOrderTitle => $GetParam{WorkOrderTitle},
Instruction => $GetParam{Instruction},
PlannedStartTime => $GetParam{PlannedStartTime},
PlannedEndTime => $GetParam{PlannedEndTime},
PlannedEffort => $GetParam{PlannedEffort},
UserID => $Self->{UserID},
%DynamicFieldValues,
);
# update was successful
if ($CouldUpdateWorkOrder) {
# get all attachments from upload cache
my @Attachments = $UploadCacheObject->FormIDGetAllFilesData(
FormID => $Self->{FormID},
);
# build a lookup lookup hash of the new attachments
my %NewAttachment;
for my $Attachment (@Attachments) {
# the key is the filename + filesize + content type
my $Key = $Attachment->{Filename}
. $Attachment->{Filesize}
. $Attachment->{ContentType};
# append content id if available (for new inline images)
if ( $Attachment->{ContentID} ) {
$Key .= $Attachment->{ContentID};
}
# store all of the new attachment data
$NewAttachment{$Key} = $Attachment;
}
# get all attachments meta data
my @ExistingAttachments = $WorkOrderObject->WorkOrderAttachmentList(
WorkOrderID => $WorkOrderID,
);
# check the existing attachments
FILENAME:
for my $Filename (@ExistingAttachments) {
# get the existing attachment data
my $AttachmentData = $WorkOrderObject->WorkOrderAttachmentGet(
WorkOrderID => $WorkOrderID,
Filename => $Filename,
UserID => $Self->{UserID},
);
# do not consider inline attachments
next FILENAME if $AttachmentData->{Preferences}->{ContentID};
# the key is the filename + filesize + content type
# (no content id, as existing attachments don't have it)
my $Key = $AttachmentData->{Filename}
. $AttachmentData->{Filesize}
. $AttachmentData->{ContentType};
# attachment is already existing, we can delete it from the new attachment hash
if ( $NewAttachment{$Key} ) {
delete $NewAttachment{$Key};
}
# existing attachment is no longer in new attachments hash
else {
# delete the existing attachment
my $DeleteSuccessful = $WorkOrderObject->WorkOrderAttachmentDelete(
ChangeID => $WorkOrder->{ChangeID},
WorkOrderID => $WorkOrderID,
Filename => $Filename,
UserID => $Self->{UserID},
);
# check error
if ( !$DeleteSuccessful ) {
return $LayoutObject->FatalError();
}
}
}
# write the new attachments
ATTACHMENT:
for my $Attachment ( values %NewAttachment ) {
# check if attachment is an inline attachment
my $Inline = 0;
if ( $Attachment->{ContentID} ) {
# remember that it is inline
$Inline = 1;
# remember if this inline attachment is used in the workorder instruction
my $ContentIDFound;
# check workorder instruction for content id
if ( $GetParam{Instruction} =~ m{ $Attachment->{ContentID} }xms ) {
# found the content id
$ContentIDFound = 1;
}
# we do not want to keep this attachment,
# because it was deleted in the richt text editor
next ATTACHMENT if !$ContentIDFound;
}
# add attachment
my $Success = $WorkOrderObject->WorkOrderAttachmentAdd(
%{$Attachment},
WorkOrderID => $WorkOrderID,
ChangeID => $WorkOrder->{ChangeID},
UserID => $Self->{UserID},
);
# check error
if ( !$Success ) {
return $LayoutObject->FatalError();
}
next ATTACHMENT if !$Inline;
next ATTACHMENT if !$LayoutObject->{BrowserRichText};
# picture url in upload cache
my $Search = "Action=PictureUpload .+ FormID=$Self->{FormID} .+ "
. "ContentID=$Attachment->{ContentID}";
# picture url in workorder atttachment
my $Replace = "Action=AgentITSMWorkOrderZoom;Subaction=DownloadAttachment;"
. "Filename=$Attachment->{Filename};WorkOrderID=$WorkOrderID";
# replace url
$GetParam{Instruction} =~ s{$Search}{$Replace}xms;
# update workorder
$Success = $WorkOrderObject->WorkOrderUpdate(
WorkOrderID => $WorkOrderID,
Instruction => $GetParam{Instruction},
UserID => $Self->{UserID},
);
# check error
if ( !$Success ) {
$LogObject->Log(
Priority => 'error',
Message => "Could not update the inline image URLs "
. "for WorkOrderID '$WorkOrderID'!!",
);
}
}
# if there are any following workorders
# and if the following workorders should be moved,
# that means we want to keep the difference
# between the planned end date of this workorder and the the planned start dates of ALL LATER workorders
if ( @FollowingWorkOrderIDs && $GetParam{MoveFollowingWorkOrders} ) {
# convert the OLD planned end time of this workorder
# into system time (epoch seconds)
my $OldPlannedEndTimeSystemTime = $Self->_TimeStamp2Epoch(
TimeStamp => $WorkOrder->{PlannedEndTime},
);
# convert the NEW planned end time of this workorder
# into system time (epoch seconds)
my $NewPlannedEndTimeSystemTime = $Self->_TimeStamp2Epoch(
TimeStamp => $GetParam{PlannedEndTime},
);
# calculate the difference time
my $DiffTime = $NewPlannedEndTimeSystemTime - $OldPlannedEndTimeSystemTime;
# modify all following workorders
WORKORDERID:
for my $WorkOrderID (@FollowingWorkOrderIDs) {
# get workorder data
my $WorkOrder = $WorkOrderObject->WorkOrderGet(
WorkOrderID => $WorkOrderID,
UserID => $Self->{UserID},
);
# calculate the new planned start and end time for this following workorder
my %TimeData;
for my $TimeType (qw(PlannedStartTime PlannedEndTime)) {
# convert the old planned times of the workorder
# into system time (epoch seconds)
$TimeData{$TimeType} = $Self->_TimeStamp2Epoch(
TimeStamp => $WorkOrder->{$TimeType},
);
# add the difference and convert time to timestamp
$TimeData{$TimeType} = $Self->_Epoch2TimeStamp(
Epoch => $TimeData{$TimeType} + $DiffTime,
);
}
# update the workorder with the new times
my $Success = $WorkOrderObject->WorkOrderUpdate(
WorkOrderID => $WorkOrderID,
UserID => $Self->{UserID},
%TimeData,
);
# show error message, if update failed
if ( !$Success ) {
return $LayoutObject->ErrorScreen(
Message => $LayoutObject->{LanguageObject}->Translate(
'Was not able to update WorkOrder %s!', $WorkOrderID
),
Comment => Translatable('Please contact the administrator.'),
);
}
}
}
# delete the upload cache
$UploadCacheObject->FormIDRemove( FormID => $Self->{FormID} );
# load new URL in parent window and close popup
return $LayoutObject->PopupClose(
URL => "Action=AgentITSMWorkOrderZoom;WorkOrderID=$WorkOrderID",
);
}
else {
# show error message, when update failed
return $LayoutObject->ErrorScreen(
Message => $LayoutObject->{LanguageObject}
->Translate( 'Was not able to update WorkOrder %s!', $WorkOrderID ),
Comment => Translatable('Please contact the administrator.'),
);
}
}
}
else {
# delete all keys from GetParam when it is no Subaction
%GetParam = ();
# also reset the time fields
for my $TimeType (qw(PlannedStartTime PlannedEndTime)) {
if ( $WorkOrder->{$TimeType} ) {
my $DateTimeObject = $Kernel::OM->Create(
'Kernel::System::DateTime',
ObjectParams => {
String => $WorkOrder->{$TimeType},
},
);
# set the parameter hash for BuildDateSelection()
$GetParam{ $TimeType . 'Minute' } = $DateTimeObject->Format(
Format => '%M',
);
$GetParam{ $TimeType . 'Hour' } = $DateTimeObject->Format(
Format => '%H',
);
$GetParam{ $TimeType . 'Day' } = $DateTimeObject->Format(
Format => '%d',
);
$GetParam{ $TimeType . 'Month' } = $DateTimeObject->Format(
Format => '%m',
);
$GetParam{ $TimeType . 'Year' } = $DateTimeObject->Format(
Format => '%Y',
);
}
}
# get all attachments meta data
my @ExistingAttachments = $WorkOrderObject->WorkOrderAttachmentList(
WorkOrderID => $WorkOrderID,
);
# copy all existing attachments to upload cache
FILENAME:
for my $Filename (@ExistingAttachments) {
# get the existing attachment data
my $AttachmentData = $WorkOrderObject->WorkOrderAttachmentGet(
WorkOrderID => $WorkOrderID,
Filename => $Filename,
);
# do not consider inline attachments
next FILENAME if $AttachmentData->{Preferences}->{ContentID};
# add attachment to the upload cache
$UploadCacheObject->FormIDAddFile(
FormID => $Self->{FormID},
Filename => $AttachmentData->{Filename},
Content => $AttachmentData->{Content},
ContentType => $AttachmentData->{ContentType},
);
}
}
# get change that workorder belongs to
my $Change = $ChangeObject->ChangeGet(
ChangeID => $WorkOrder->{ChangeID},
UserID => $Self->{UserID},
);
# check whether change was found
if ( !$Change ) {
return $LayoutObject->ErrorScreen(
Message =>
$LayoutObject->{LanguageObject}->Translate( 'Could not find Change for WorkOrder %s!', $WorkOrderID ),
Comment => Translatable('Please contact the administrator.'),
);
}
# if there was an attachment delete or upload
# we do not want to show validation errors for other fields
if ( $ValidationError{Attachment} ) {
%ValidationError = ();
}
# output header
my $Output = $LayoutObject->Header(
Title => $WorkOrder->{WorkOrderTitle},
Type => 'Small',
);
# cycle trough the activated Dynamic Fields for this screen
DYNAMICFIELD:
for my $DynamicFieldConfig ( @{$DynamicField} ) {
next DYNAMICFIELD if !IsHashRefWithData($DynamicFieldConfig);
# get workorder dynamic fields from workorder if page is loaded the first time
if ( !$Self->{Subaction} ) {
$DynamicFieldValues{ 'DynamicField_' . $DynamicFieldConfig->{Name} }
= $WorkOrder->{ 'DynamicField_' . $DynamicFieldConfig->{Name} };
}
# get field html
my $DynamicFieldHTML = $DynamicFieldBackendObject->EditFieldRender(
DynamicFieldConfig => $DynamicFieldConfig,
Value => $DynamicFieldValues{ 'DynamicField_' . $DynamicFieldConfig->{Name} },
ServerError => $ValidationError{ $DynamicFieldConfig->{Name} } || '',
Mandatory => $Self->{Config}->{DynamicField}->{ $DynamicFieldConfig->{Name} } == 2,
LayoutObject => $LayoutObject,
ParamObject => $ParamObject,
AJAXUpdate => 0,
);
# skip fields that HTML could not be retrieved
next DYNAMICFIELD if !IsHashRefWithData($DynamicFieldHTML);
$LayoutObject->Block(
Name => 'DynamicField',
Data => {
Name => $DynamicFieldConfig->{Name},
Label => $DynamicFieldHTML->{Label},
Field => $DynamicFieldHTML->{Field},
},
);
# example of dynamic fields order customization
$LayoutObject->Block(
Name => 'DynamicField_' . $DynamicFieldConfig->{Name},
Data => {
Name => $DynamicFieldConfig->{Name},
Label => $DynamicFieldHTML->{Label},
Field => $DynamicFieldHTML->{Field},
},
);
}
# time period that can be selected from the GUI
my %TimePeriod = %{ $ConfigObject->Get('ITSMWorkOrder::TimePeriod') };
# set the time selections
for my $TimeType (qw(PlannedStartTime PlannedEndTime)) {
# set default value for $DiffTime
# When no time is given yet, then use the current time plus the difftime
# When an explicit time was retrieved, $DiffTime is not used
my $DiffTime = $TimeType eq 'PlannedStartTime' ? 0 : 60 * 60;
# add selection for the time
$GetParam{ $TimeType . 'SelectionString' } = $LayoutObject->BuildDateSelection(
%GetParam,
Format => 'DateInputFormatLong',
Prefix => $TimeType,
DiffTime => $DiffTime,
Validate => 1,
$TimeType . 'Class' => 'Validate_Required '
. ( $ValidationError{ $TimeType . 'Invalid' } || '' ),
%TimePeriod,
);
# add server error messages for the planned times
$LayoutObject->Block(
Name => $TimeType
. ( $ValidationError{ $TimeType . 'ErrorType' } || 'GenericServerError' )
);
}
# show planned effort if it is configured
if ( $Self->{Config}->{PlannedEffort} ) {
$LayoutObject->Block(
Name => 'ShowPlannedEffort',
Data => {
%{$WorkOrder},
%GetParam,
%ValidationError,
},
);
}
# show the checkbox for MoveFollowingWorkOrders if it is configured
if ( $Self->{Config}->{MoveFollowingWorkOrders} ) {
# set checkbox for MoveFollowingWorkOrders
if ( $GetParam{MoveFollowingWorkOrders} ) {
$GetParam{MoveFollowingWorkOrders} = 'checked="checked"';
}
$LayoutObject->Block(
Name => 'MoveFollowingWorkOrders',
Data => {
%GetParam,
},
);
}
# get all attachments meta data
$Param{AttachmentList} = [
$UploadCacheObject->FormIDGetAllFilesMeta(
FormID => $Self->{FormID},
)
];
# show the attachment upload button
$LayoutObject->Block(
Name => 'AttachmentUpload',
Data => {%Param},
);
# add rich text editor javascript
# only if activated and the browser can handle it
# otherwise just a textarea is shown
if ( $LayoutObject->{BrowserRichText} ) {
$LayoutObject->SetRichTextParameters(
Data => \%Param,
);
}
# start template output
$Output .= $LayoutObject->Output(
TemplateFile => 'AgentITSMWorkOrderEdit',
Data => {
%Param,
%{$Change},
%{$WorkOrder},
%GetParam,
%ValidationError,
FormID => $Self->{FormID},
},
);
# add footer
$Output .= $LayoutObject->Footer( Type => 'Small' );
return $Output;
}
sub _TimeStamp2Epoch {
my ( $Self, %Param, ) = @_;
my $TimeStamp = $Param{TimeStamp};
my $DateTimeObject = $Kernel::OM->Create(
'Kernel::System::DateTime',
ObjectParams => {
String => $TimeStamp,
},
);
return $DateTimeObject->ToEpoch() if $DateTimeObject;
return;
}
sub _Epoch2TimeStamp {
my ( $Self, %Param, ) = @_;
my $Epoch = $Param{Epoch};
my $DateTimeObject = $Kernel::OM->Create(
'Kernel::System::DateTime',
ObjectParams => {
Epoch => $Epoch,
},
);
return $DateTimeObject->ToString() if $DateTimeObject;
return;
}
1;