seeddms-code/op/op.SetReviewersApprovers.php

467 lines
18 KiB
PHP
Raw Normal View History

<?php
// MyDMS. Document Management System
// Copyright (C) 2002-2005 Markus Westphal
// Copyright (C) 2006-2008 Malcolm Cowe
2010-10-29 13:19:51 +00:00
// Copyright (C) 2010 Matteo Lucarelli
2016-08-09 05:34:30 +00:00
// Copyright (C) 2010-2016 Uwe Steinmann
//
// This program is free software; you can redistribute it and/or modify
// it under the terms of the GNU General Public License as published by
// the Free Software Foundation; either version 2 of the License, or
// (at your option) any later version.
//
// This program is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
// GNU General Public License for more details.
//
// You should have received a copy of the GNU General Public License
// along with this program; if not, write to the Free Software
// Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
include("../inc/inc.Settings.php");
include("../inc/inc.Utils.php");
2022-11-09 05:40:50 +00:00
include("../inc/inc.LogInit.php");
include("../inc/inc.Language.php");
include("../inc/inc.Init.php");
include("../inc/inc.Extension.php");
include("../inc/inc.DBInit.php");
include("../inc/inc.ClassUI.php");
include("../inc/inc.Authentication.php");
if (!isset($_POST["documentid"]) || !is_numeric($_POST["documentid"]) || intval($_POST["documentid"])<1) {
UI::exitError(getMLText("document_title", array("documentname" => getMLText("invalid_doc_id"))),getMLText("invalid_doc_id"));
2010-10-29 13:19:51 +00:00
}
$documentid = $_POST["documentid"];
$document = $dms->getDocument($documentid);
if (!is_object($document)) {
UI::exitError(getMLText("document_title", array("documentname" => getMLText("invalid_doc_id"))),getMLText("invalid_doc_id"));
}
2010-10-29 13:19:51 +00:00
if ($document->getAccessMode($user) < M_ALL) {
UI::exitError(getMLText("document_title", array("documentname" => $document->getName())),getMLText("access_denied"));
}
2010-10-29 13:19:51 +00:00
if (!isset($_POST["version"]) || !is_numeric($_POST["version"]) || intval($_POST["version"])<1) {
UI::exitError(getMLText("document_title", array("documentname" => $document->getName())),getMLText("invalid_version"));
2010-10-29 13:19:51 +00:00
}
$version = $_POST["version"];
2010-10-29 13:19:51 +00:00
$content = $document->getContentByVersion($version);
if (!is_object($content)) {
UI::exitError(getMLText("document_title", array("documentname" => $document->getName())),getMLText("invalid_version"));
2010-10-29 13:19:51 +00:00
}
// control status.
$overallStatus = $content->getStatus();
2010-10-29 13:19:51 +00:00
if ($overallStatus["status"]==S_REJECTED || $overallStatus["status"]==S_OBSOLETE ) {
UI::exitError(getMLText("document_title", array("documentname" => $document->getName())),getMLText("cannot_assign_invalid_state"));
}
2015-02-27 16:11:50 +00:00
$folder = $document->getFolder();
$owner = $document->getOwner();
2015-02-27 16:11:50 +00:00
// Retrieve a list of all users and groups that have review / approve
// privileges.
$docAccess = $document->getReadAccessList($settings->_enableAdminRevApp, $settings->_enableOwnerRevApp);
$accessIndex = array("i"=>array(), "g"=>array());
foreach ($docAccess["users"] as $i=>$da) {
$accessIndex["i"][$da->getID()] = $i;
}
foreach ($docAccess["groups"] as $i=>$da) {
$accessIndex["g"][$da->getID()] = $i;
}
// Retrieve list of currently assigned reviewers and approvers, along with
// their latest status.
$reviewStatus = $content->getReviewStatus();
$approvalStatus = $content->getApprovalStatus();
// Index the review results for easy cross-reference with the Approvers List.
$reviewIndex = array("i"=>array(), "g"=>array());
foreach ($reviewStatus as $i=>$rs) {
if ($rs["status"]!=-2) {
if ($rs["type"]==0) {
$reviewIndex["i"][$rs["required"]] = array("status"=>$rs["status"], "idx"=>$i);
}
else if ($rs["type"]==1) {
$reviewIndex["g"][$rs["required"]] = array("status"=>$rs["status"], "idx"=>$i);
}
}
}
// Index the approval results for easy cross-reference with the Approvers List.
$approvalIndex = array("i"=>array(), "g"=>array());
foreach ($approvalStatus as $i=>$rs) {
if ($rs["status"]!=-2) {
if ($rs["type"]==0) {
$approvalIndex["i"][$rs["required"]] = array("status"=>$rs["status"], "idx"=>$i);
}
else if ($rs["type"]==1) {
$approvalIndex["g"][$rs["required"]] = array("status"=>$rs["status"], "idx"=>$i);
}
}
}
2010-10-29 13:19:51 +00:00
// Get the list of proposed reviewers, stripping out any duplicates.
$pIndRev = (isset($_POST["indReviewers"]) ? array_values(array_unique($_POST["indReviewers"])) : array());
$pGrpRev = (isset($_POST["grpReviewers"]) ? array_values(array_unique($_POST["grpReviewers"])) : array());
if($user->getID() != $owner->getID()) {
$res=$owner->getMandatoryReviewers();
if($user->isAdmin())
$res = array();
} else
$res=$user->getMandatoryReviewers();
foreach ($res as $r) {
if(!in_array($r['reviewerUserID'], $pIndRev))
$pIndRev[] = $r['reviewerUserID'];
if(!in_array($r['reviewerGroupID'], $pGrpRev))
$pGrpRev[] = $r['reviewerGroupID'];
}
foreach ($pIndRev as $p) {
if (is_numeric($p)) {
if (isset($accessIndex["i"][$p])) {
// Proposed reviewer is on the list of possible reviewers.
if (!isset($reviewIndex["i"][$p])) {
// Proposed reviewer is not a current reviewer, so add as a new
// reviewer.
$res = $content->addIndReviewer($docAccess["users"][$accessIndex["i"][$p]], $user);
switch (true) {
case $res > 0:
// Send an email notification to the new reviewer.
2012-10-05 19:49:58 +00:00
if($settings->_enableNotificationAppRev) {
if ($notifier) {
$notifier->sendAddReviewMail($content, $user, $docAccess["users"][$accessIndex["i"][$p]]);
2012-10-05 19:49:58 +00:00
}
}
break;
case $res === -1:
case $res === false:
UI::exitError(getMLText("document_title", array("documentname" => $document->getName())),getMLText("internal_error"));
break;
case $res === -2:
UI::exitError(getMLText("document_title", array("documentname" => $document->getName())),getMLText("access_denied"));
break;
case $res === -3:
UI::exitError(getMLText("document_title", array("documentname" => $document->getName())),getMLText("reviewer_already_assigned"));
break;
}
}
else {
// Remove reviewer from the index of possible reviewers. If there are
// any reviewers left over in the list of possible reviewers, they
// will be removed from the review process for this document revision.
unset($reviewIndex["i"][$p]);
}
}
}
}
/* $reviewIndex['i'] has now those individual reviewers which are left over
* and must be removed. There are two cases to distinguish: 1. The user may
* access the document but shall no longer review the document, 2. the user
* many not access the document any more.
*/
if (count($reviewIndex["i"]) > 0) {
foreach ($reviewIndex["i"] as $rx=>$rv) {
if ($rv["status"] == 0) {
// User is to be removed from the review list.
if (!isset($docAccess["users"][$accessIndex["i"][$rx]])) {
// User does not have any review privileges for this document
// revision or does not exist.
/*
$queryStr = "INSERT INTO `tblDocumentReviewLog` (`reviewID`, `status`, `comment`, `date`, `userID`) ".
"VALUES ('". $reviewStatus[$rv["idx"]]["reviewID"] ."', '-2', '".getMLText("removed_reviewer")."', NOW(), '". $user->getID() ."')";
$res = $db->getResult($queryStr);
*/
$res = $content->delIndReviewer($dms->getUser($reviewStatus[$rv["idx"]]["required"]), $user, getMLText("removed_reviewer"));
}
else {
$res = $content->delIndReviewer($docAccess["users"][$accessIndex["i"][$rx]], $user);
switch (true) {
case $res === 0:
// Send an email notification to the reviewer.
2012-10-05 19:49:58 +00:00
if($settings->_enableNotificationAppRev) {
if ($notifier) {
$notifier->sendDeleteReviewMail($content, $user, $docAccess["users"][$accessIndex["i"][$rx]]);
2012-10-05 19:49:58 +00:00
}
}
break;
case $res === -1:
case $res === false:
UI::exitError(getMLText("document_title", array("documentname" => $document->getName())),getMLText("internal_error"));
break;
case $res === -2:
UI::exitError(getMLText("document_title", array("documentname" => $document->getName())),getMLText("access_denied"));
break;
case $res === -3:
UI::exitError(getMLText("document_title", array("documentname" => $document->getName())),getMLText("reviewer_already_removed"));
break;
}
}
}
}
}
foreach ($pGrpRev as $p) {
if (is_numeric($p)) {
if (isset($accessIndex["g"][$p])) {
// Proposed reviewer is on the list of possible reviewers.
if (!isset($reviewIndex["g"][$p])) {
// Proposed reviewer is not a current reviewer, so add as a new
// reviewer.
$res = $content->addGrpReviewer($docAccess["groups"][$accessIndex["g"][$p]], $user);
switch (true) {
case $res > 0:
// Send an email notification to the new reviewer.
2012-10-05 19:49:58 +00:00
if($settings->_enableNotificationAppRev) {
if ($notifier) {
$notifier->sendAddReviewMail($content, $user, $docAccess["groups"][$accessIndex["g"][$p]]);
2012-10-05 19:49:58 +00:00
}
}
break;
case $res === -1:
case $res === false:
UI::exitError(getMLText("document_title", array("documentname" => $document->getName())),getMLText("internal_error"));
break;
case $res === -2:
UI::exitError(getMLText("document_title", array("documentname" => $document->getName())),getMLText("access_denied"));
break;
case $res === -3:
UI::exitError(getMLText("document_title", array("documentname" => $document->getName())),getMLText("reviewer_already_assigned"));
break;
}
}
else {
// Remove reviewer from the index of possible reviewers.
unset($reviewIndex["g"][$p]);
}
}
}
}
if (count($reviewIndex["g"]) > 0) {
foreach ($reviewIndex["g"] as $rx=>$rv) {
if ($rv["status"] == 0) {
// Group is to be removed from the review list.
if (!isset($docAccess["groups"][$accessIndex["g"][$rx]])) {
// Group does not have any review privileges for this document
// revision or does not exist.
/*
$queryStr = "INSERT INTO `tblDocumentReviewLog` (`reviewID`, `status`, `comment`, `date`, `userID`) ".
"VALUES ('". $reviewStatus[$rv["idx"]]["reviewID"] ."', '-2', '".getMLText("removed_reviewer")."', NOW(), '". $user->getID() ."')";
$res = $db->getResult($queryStr);
*/
$res = $content->delGrpReviewer($dms->getGroup($reviewStatus[$rv["idx"]]["required"]), $user, getMLText("removed_reviewer"));
}
else {
$res = $content->delGrpReviewer($docAccess["groups"][$accessIndex["g"][$rx]], $user);
switch (true) {
case $res === 0:
// Send an email notification to the review group.
2012-10-05 19:49:58 +00:00
if($settings->_enableNotificationAppRev) {
if ($notifier) {
$notifier->sendDeleteReviewMail($content, $user, $docAccess["groups"][$accessIndex["g"][$rx]]);
2012-10-05 19:49:58 +00:00
}
}
break;
case $res === -1:
case $res === false:
UI::exitError(getMLText("document_title", array("documentname" => $document->getName())),getMLText("internal_error"));
break;
case $res === -2:
UI::exitError(getMLText("document_title", array("documentname" => $document->getName())),getMLText("access_denied"));
break;
case $res === -3:
UI::exitError(getMLText("document_title", array("documentname" => $document->getName())),getMLText("reviewer_already_removed"));
break;
}
}
}
}
}
// Get the list of proposed approvers, stripping out any duplicates.
$pIndApp = (isset($_POST["indApprovers"]) ? array_values(array_unique($_POST["indApprovers"])) : array());
$pGrpApp = (isset($_POST["grpApprovers"]) ? array_values(array_unique($_POST["grpApprovers"])) : array());
if($user->getID() != $owner->getID()) {
$res=$owner->getMandatoryApprovers();
if($user->isAdmin())
$res = array();
} else
$res=$user->getMandatoryApprovers();
foreach ($res as $r) {
if(!in_array($r['approverUserID'], $pIndApp))
$pIndApp[] = $r['approverUserID'];
if(!in_array($r['approverGroupID'], $pGrpApp))
$pGrpApp[] = $r['approverGroupID'];
}
foreach ($pIndApp as $p) {
if (is_numeric($p)) {
if (isset($accessIndex["i"][$p])) {
// Proposed approver is on the list of possible approvers.
if (!isset($approvalIndex["i"][$p])) {
// Proposed approver is not a current approver, so add as a new
// approver.
$res = $content->addIndApprover($docAccess["users"][$accessIndex["i"][$p]], $user);
switch (true) {
case $res > 0:
// Send an email notification to the new approver.
2012-10-05 19:49:58 +00:00
if($settings->_enableNotificationAppRev) {
/* Send notification only if document is currently not in review state,
* because then the approvers will be informed anyway when review state
* is left and approval state is entered.
*/
2012-10-05 19:49:58 +00:00
if ($overallStatus["status"]!=0 && $notifier) {
$notifier->sendAddApprovalMail($content, $user, $docAccess["users"][$accessIndex["i"][$p]]);
2012-10-05 19:49:58 +00:00
}
}
break;
case $res === -1:
case $res === false:
UI::exitError(getMLText("document_title", array("documentname" => $document->getName())),getMLText("internal_error"));
break;
case $res === -2:
UI::exitError(getMLText("document_title", array("documentname" => $document->getName())),getMLText("access_denied"));
break;
case $res === -3:
UI::exitError(getMLText("document_title", array("documentname" => $document->getName())),getMLText("reviewer_already_assigned"));
break;
}
}
else {
// Remove approver from the index of possible approvers.
unset($approvalIndex["i"][$p]);
}
}
}
}
if (count($approvalIndex["i"]) > 0) {
foreach ($approvalIndex["i"] as $rx=>$rv) {
if ($rv["status"] == 0) {
// User is to be removed from the approvers list.
if (!isset($docAccess["users"][$accessIndex["i"][$rx]])) {
// User does not have any approval privileges for this document
// revision or does not exist.
/*
$queryStr = "INSERT INTO `tblDocumentApproveLog` (`approveID`, `status`, `comment`, `date`, `userID`) ".
"VALUES ('". $approvalStatus[$rv["idx"]]["approveID"] ."', '-2', '".getMLText("removed_approver")."', NOW(), '". $user->getID() ."')";
$res = $db->getResult($queryStr);
*/
$res = $content->delIndApprover($dms->getUser($approvalStatus[$rv["idx"]]["required"]), $user, getMLText("removed_approver"));
}
else {
$res = $content->delIndApprover($docAccess["users"][$accessIndex["i"][$rx]], $user);
switch (true) {
case $res === 0:
// Send an email notification to the approver.
2012-10-05 19:49:58 +00:00
if($settings->_enableNotificationAppRev) {
if ($notifier) {
$notifier->sendDeleteApprovalMail($content, $user, $docAccess["users"][$accessIndex["i"][$rx]]);
2012-10-05 19:49:58 +00:00
}
}
break;
case $res === -1:
case $res === false:
UI::exitError(getMLText("document_title", array("documentname" => $document->getName())),getMLText("internal_error"));
break;
case $res === -2:
UI::exitError(getMLText("document_title", array("documentname" => $document->getName())),getMLText("access_denied"));
break;
case $res === -3:
UI::exitError(getMLText("document_title", array("documentname" => $document->getName())),getMLText("reviewer_already_removed"));
break;
}
}
}
}
}
foreach ($pGrpApp as $p) {
if (is_numeric($p)) {
if (isset($accessIndex["g"][$p])) {
// Proposed approver is on the list of possible approvers.
if (!isset($approvalIndex["g"][$p])) {
// Proposed approver is not a current approver, so add as a new
// approver.
$res = $content->addGrpApprover($docAccess["groups"][$accessIndex["g"][$p]], $user);
switch (true) {
case $res > 0:
// Send an email notification to the new approver.
2012-10-05 19:49:58 +00:00
if($settings->_enableNotificationAppRev) {
/* Send notification only if document is currently not in review state,
* because then the approvers will be informed anyway when review state
* is left and approval state is entered.
*/
2012-10-05 19:49:58 +00:00
if ($overallStatus["status"]!=0 && $notifier) {
$notifier->sendAddApprovalMail($content, $user, $docAccess["groups"][$accessIndex["g"][$p]]);
2012-10-05 19:49:58 +00:00
}
}
break;
case $res === -1:
case $res === false:
UI::exitError(getMLText("document_title", array("documentname" => $document->getName())),getMLText("internal_error"));
break;
case $res === -2:
UI::exitError(getMLText("document_title", array("documentname" => $document->getName())),getMLText("access_denied"));
break;
case $res === -3:
UI::exitError(getMLText("document_title", array("documentname" => $document->getName())),getMLText("approver_already_assigned"));
break;
}
}
else {
// Remove approver from the index of possible approvers.
unset($approvalIndex["g"][$p]);
}
}
}
}
if (count($approvalIndex["g"]) > 0) {
foreach ($approvalIndex["g"] as $rx=>$rv) {
if ($rv["status"] == 0) {
// User is to be removed from the approvers list.
if (!isset($docAccess["groups"][$accessIndex["g"][$rx]])) {
// Group does not have any approval privileges for this document
2010-10-29 13:19:51 +00:00
// revision or does not exist.
/*
$queryStr = "INSERT INTO `tblDocumentApproveLog` (`approveID`, `status`, `comment`, `date`, `userID`) ".
"VALUES ('". $approvalStatus[$rv["idx"]]["approveID"] ."', '-2', '".getMLText("removed_approver")."', NOW(), '". $user->getID() ."')";
$res = $db->getResult($queryStr);
*/
$res = $content->delGrpApprover($dms->getGroup($approvalStatus[$rv["idx"]]["required"]), $user, getMLText("removed_approver"));
}
else {
$res = $content->delGrpApprover($docAccess["groups"][$accessIndex["g"][$rx]], $user);
switch (true) {
case $res === 0:
// Send an email notification to the approval group.
2012-10-05 19:49:58 +00:00
if($settings->_enableNotificationAppRev) {
if ($notifier) {
$notifier->sendDeleteApprovalMail($content, $user, $docAccess["groups"][$accessIndex["g"][$rx]]);
2012-10-05 19:49:58 +00:00
}
}
break;
case $res === -1:
case $res === false:
UI::exitError(getMLText("document_title", array("documentname" => $document->getName())),getMLText("internal_error"));
break;
case $res === -2:
UI::exitError(getMLText("document_title", array("documentname" => $document->getName())),getMLText("access_denied"));
break;
case $res === -3:
UI::exitError(getMLText("document_title", array("documentname" => $document->getName())),getMLText("approver_already_removed"));
break;
}
}
}
}
}
2010-10-29 13:19:51 +00:00
$content->verifyStatus(false,$user);
add_log_line("?documentid=".$documentid);
header("Location:../out/out.DocumentVersionDetail.php?documentid=".$documentid."&version=".$version);
?>