viewBL.php
13.5 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
<?php
/**
* $Id$
*
* Contains the business logic required to build the document view page.
* Will use documentViewUI.php for HTML
*
* Expected form varaibles:
* o $fDocumentID - Primary key of document to view
*
* Optional form variables:
* o fCollaborationEdit - the user attempted to edit a collaboration step that is currently active
* o fForDownload - the user is attempting to download the document
* o fBeginCollaboration - the user selected the 'Begin Collaboration' button
* o fFireSubscription - the document has been modified, and a subscription alert must be fired
*
* @author Rob Cherry, Jam Warehouse (Pty) Ltd, South Africa
* @date 21 January 2003
* @package presentation.lookAndFeel.knowledgeTree.documentmanagement
*/
require_once("../../../../config/dmsDefaults.php");
require_once("$default->fileSystemRoot/lib/security/permission.inc");
require_once("$default->fileSystemRoot/lib/email/Email.inc");
require_once("$default->fileSystemRoot/lib/users/User.inc");
require_once("$default->fileSystemRoot/lib/documentmanagement/PhysicalDocumentManager.inc");
require_once("$default->fileSystemRoot/lib/documentmanagement/DocumentTransaction.inc");
require_once("$default->fileSystemRoot/lib/documentmanagement/Document.inc");
require_once("$default->fileSystemRoot/lib/documentmanagement/DependantDocumentInstance.inc");
require_once("$default->fileSystemRoot/lib/documentmanagement/DocumentCollaboration.inc");
require_once("$default->fileSystemRoot/lib/archiving/DocumentArchiving.inc");
require_once("$default->fileSystemRoot/lib/foldermanagement/FolderCollaboration.inc");
require_once("$default->fileSystemRoot/lib/foldermanagement/FolderUserRole.inc");
require_once("$default->fileSystemRoot/lib/roles/Role.inc");
require_once("$default->fileSystemRoot/lib/foldermanagement/Folder.inc");
require_once("$default->fileSystemRoot/lib/visualpatterns/PatternListFromQuery.inc");
require_once("$default->fileSystemRoot/lib/visualpatterns/PatternTableSqlQuery.inc");
require_once("$default->fileSystemRoot/lib/visualpatterns/PatternCustom.inc");
require_once("$default->fileSystemRoot/lib/visualpatterns/PatternListFromQuery.inc");
require_once("$default->fileSystemRoot/lib/visualpatterns/PatternTableSqlQuery.inc");
require_once("$default->fileSystemRoot/lib/visualpatterns/PatternListBox.inc");
require_once("$default->fileSystemRoot/lib/web/WebDocument.inc");
require_once("$default->fileSystemRoot/lib/subscriptions/Subscription.inc");
require_once("$default->fileSystemRoot/lib/subscriptions/SubscriptionEngine.inc");
require_once("$default->fileSystemRoot/presentation/lookAndFeel/knowledgeTree/documentmanagement/archiving/restoreArchivedDocumentUI.inc");
require_once("$default->fileSystemRoot/presentation/lookAndFeel/knowledgeTree/documentmanagement/documentUI.inc");
require_once("$default->fileSystemRoot/presentation/lookAndFeel/knowledgeTree/documentmanagement/viewUI.inc");
require_once("$default->fileSystemRoot/presentation/lookAndFeel/knowledgeTree/foldermanagement/folderUI.inc");
require_once("$default->fileSystemRoot/presentation/Html.inc");
if (checkSession()) {
require_once("$default->fileSystemRoot/presentation/webpageTemplate.inc");
$oPatternCustom = & new PatternCustom();
if (isset($fDocumentID)) {
$oDocument = & Document::get($fDocumentID);
if (isset($fCollaborationEdit) && Permission::userHasDocumentWritePermission($fDocumentID)) {
//return value from collaborationBL.php. User attempted to edit
//a step in the document collaboration process that is currently being
//executed
$sStatusMessage = "You cannot edit a document collaboration step that is completed or currently underway";
$oPatternCustom->setHtml(getStatusPage($oDocument, $sStatusMessage));
$main->setDHTMLScrolling(false);
} else if (isset($fBeginCollaboration) && Permission::userHasDocumentWritePermission($fDocumentID)) {
//begin the collaboration process
//first ensure that all steps in the collaboration process are assigned
$aFolderCollaboration = FolderCollaboration::getList("WHERE folder_id = " . $oDocument->getFolderID());
if (count($aFolderCollaboration) > 0) {
//if the the folder has collaboration steps set up
$aFolderUserRoles = FolderUserRole::getList("document_id = " . $fDocumentID);
if (count($aFolderCollaboration) == count($aFolderUserRoles)) {
//if all the roles have been assigned we can start the collaboration process
//TODO: check if this collaboration has already occured, and then reset all the steps before beginning it again
//DocumentCollaboration::resetDocumentCollaborationSteps($fDocumentID);
$oDocument->beginCollaborationProcess();
$sStatusMessage = "Document collaboration successfully started";
$oPatternCustom->setHtml(getStatusPage($oDocument, $sStatusMessage));
} else {
//not all the roles have actual users assigned to them, so we must assign the
//default users and then proceed
FolderUserRole::createDefaultFolderUserRoles($oDocument);
$oDocument->beginCollaborationProcess();
$sStatusMessage = "Document collaboration successfully started";
$oPatternCustom->setHtml(getStatusPage($oDocument, $sStatusMessage));
}
} else {
//the folder has no collaboration set up yet, so we can't start document collaboration
$sStatusMessage = "The collaboration steps for the folder must be set up before collaboration can begin";
$oPatternCustom->setHtml(getStatusPage($oDocument, $sStatusMessage));
}
$main->setDHTMLScrolling(false);
} else if ((isset($fCollaborationStepComplete)) && (DocumentCollaboration::userIsPerformingCurrentCollaborationStep($fDocumentID))) {
//the user has signled that they have completed their step in the collaboration process
if (DocumentCollaboration::isLastStepInCollaborationProcess($fDocumentID)) {
//the last step in the collaboration process has been performed- email the document creator
$oDocument->endCollaborationProcess();
// on the last collaboration step- trigger a major revision
// major version number rollover
$oDocument->setMajorVersionNumber($oDocument->getMajorVersionNumber()+1);
// reset minor version number
$oDocument->setMinorVersionNumber(0);
$oDocument->update();
// TODO: create a transaction?
$oUser = User::get($oDocument->getCreatorID());
$sBody = $oUser->getName() . ", the collaboration process for the document, '" . generateLink("/presentation/lookAndFeel/knowledgeTree/documentmanagement/viewBL.php", "fDocumentID=" . $oDocument->getID(), $oDocument->getName()) . "', has been completed. ";
$oEmail = & new Email();
$oEmail->send($oUser->getEmail(), "Document collaboration complete", $sBody);
//possibly set the document up for web publishing????
$sStatusMessage = "Document collaboration complete. The document initiator has been notified";
$oPatternCustom->setHtml(getStatusPage($oDocument, $sStatusMessage));
} else {
//start the next steps if all criteria are met
DocumentCollaboration::beginNextStepInCollaborationProcess($fDocumentID, $_SESSION["userID"]);
$sStatusMessage = "The next steps in the collaboration process have been started";
$oPatternCustom->setHtml(getStatusPage($oDocument, $sStatusMessage));
}
$main->setDHTMLScrolling(false);
} else if ((isset($fForPublish)) && (!DocumentCollaboration::documentIsPendingWebPublishing($fDocumentID))) {
if ($fSubmit) {
// user wishes to publish document
$aWebDocument = WebDocument::getList("document_id = $fDocumentID");
$oWebDocument = $aWebDocument[0];
if (strlen($fWebSiteID) > 0) {
$oWebDocument->setStatusID(PENDING);
$oWebDocument->setWebSiteID($fWebSiteID);
$oWebDocument->setDateTime(getCurrentDateTime());
} else {
$oWebDocument->setStatusID(PUBLISHED);
$oWebDocument->setWebSiteID(-1);
$oWebDocument->setDateTime(getCurrentDateTime());
}
if ($oWebDocument->update()) {
$oDocumentTransaction = & new DocumentTransaction($fDocumentID, "Document sent for web publishing", UPDATE);
$oDocumentTransaction->create();
if ((strlen($fWebSiteID) > 0) && (strlen($fComment) > 0)) {
DocumentCollaboration::notifyWebMaster($fDocumentID, $fComment);
}
if ((strlen($fWebSiteID) > 0) && (strlen($fComment) > 0)) {
$sStatusMessage = "The document has been marked as pending publishing and the web publisher has been notified";
} else {
$sStatusMessage = "The document has been published";
}
$oPatternCustom->setHtml(getPage($oDocument, true, $sStatusMessage));
} else {
$sStatusMessage = "An error occured while attempting to update the document for publishing";
$oPatternCustom->setHtml(getStatusPage($oDocument, $sStatusMessage));
}
} else {
// prompt for the website to publish to
$oPatternCustom->setHtml(getWebPublishPage($oDocument));
$main->setFormAction($_SERVER['PHP_SELF']);
}
$main->setDHTMLScrolling(false);
} else if (Permission::userHasDocumentWritePermission($fDocumentID) || Permission::userHasDocumentReadPermission($fDocumentID)) {
// check subscription flag
// ??
if (isset($fFireSubscription)) {
// fire subscription alerts for the modified document
$count = SubscriptionEngine::fireSubscription($fDocumentID, SubscriptionConstants::subscriptionAlertType("ModifyDocument"),
SubscriptionConstants::subscriptionType("DocumentSubscription"),
array( "folderID" => $oDocument->getFolderID(),
"modifiedDocumentName" => $oDocument->getName()));
$default->log->info("viewBL.php fired $count subscription alerts for modified document $fFolderName");
}
if ($oDocument->isLive()) {
if (Permission::userHasDocumentWritePermission($fDocumentID)) {
$oPatternCustom->setHtml(getPage($oDocument, true));
} else if (Permission::userHasDocumentReadPermission($fDocumentID)) {
$oPatternCustom->setHtml(getPage($oDocument, false));
}
$main->setDHTMLScrolling(false);
$sJavaScript = "switchDiv('" . (isset($fShowSection) ? $fShowSection : "documentData") . "', 'document');";
if ($fCheckedOut) {
$sCheckOutMessage = "You have now checked out this document. No one else can make updates to the document while you have it checked out. Save the document, make your changes and check it back in as soon as you finish working on it.";
$sJavaScript .= "redirectLink('$sCheckOutMessage', '" . generateControllerUrl("downloadDocument", "fDocumentID=$fDocumentID") . "')";
}
$main->setOnLoadJavaScript($sJavaScript);
} else if ($oDocument->isArchived()) {
// allow admins to restore the document
if (Permission::userIsSystemAdministrator() || Permission::userIsUnitAdministrator()) {
$oPatternCustom->setHtml(getRestoreArchivedDocumentPage($oDocument));
} else {
// and ordinary users to request that the document be restored
$oPatternCustom->setHtml(getRequestRestoreDocumentPage($oDocument));
}
} else {
$oPatternCustom->setHtml("<a href=\"" . generateControllerLink("browse", "fFolderID=" . $oDocument->getFolderID()) . "\"><img src=\"$default->graphicsUrl/widgets/back.gif\" border=\"0\" /></a>\n");
$main->setErrorMessage("The document you have chosen no longer exists in the DMS.");
}
$main->setFormAction("$default->rootUrl/control.php?action=modifyDocument&fDocumentID=" . $oDocument->getID());
} else {
if ($oDocument) {
$oPatternCustom->setHtml("<a href=\"" . generateControllerLink("browse", "fFolderID=" . $oDocument->getFolderID()) . "\"><img src=\"$default->graphicsUrl/widgets/back.gif\" border=\"0\" /></a>\n");
} else {
$oPatternCustom->setHtml("<a href=\"javascript:history.go(-1)\"><img src=\"$default->graphicsUrl/widgets/back.gif\" border=\"0\" /></a>\n");
}
$main->setErrorMessage("Either you do not have permission to view this document, or the document you have chosen no longer exists on the file system.");
}
} else {
require_once("$default->fileSystemRoot/presentation/webpageTemplate.inc");
$oPatternCustom->setHtml("<a href=\"javascript:history.go(-1)\"><img src=\"$default->graphicsUrl/widgets/back.gif\" border=\"0\" /></a>\n");
$main->setErrorMessage("You have not chosen a document to view");
}
$main->setCentralPayload($oPatternCustom);
$main->render();
}
?>