Reviewing and Revising a Document Onpolicy

Reviewing & Revising – JAVA DISABLED

OnPolicy uses Java software to launch Windows applications from the browser (the preferred method) and then save your document changes automatically. If Java is turned off in the Admin Settings, then you will have to upload and download your document revisions manually from your computer to the cloud.

Downloading a Document for Revision

Start in the Documents Detail screen. In the “Document Details” window (figure 1), the Supplier Evaluation form has three revision, or version, numbers. You can download any of these versions for review — here, we’re going to look at the most recent version, revision number “1.1.1.0”. Click on the blue “down arrow” for that version.

 

Download Document Revision

Figure 1

When you click on the down arrow, your browser may give you the choice of opening the document on your local HDD or saving it to your local HDD (figure 2).

 

open document revision

Figure 2

Saving the file should result in your anti-virus software automatically scanning the file for malware (make sure that function is “on”), so we recommend that you save the document (figure 2, 3).

 

save file location

Figure 3

Open the downloaded file (figure 4) for review. If you’re satisfied with the document, go back to OnPolicy and “Accept Review”.

 

Open the downloaded file

Figure 4

If you’re going to make changes to the file, we recommend you turn on the “Track Changes” function in Word so the document Author sees what you, the Reviewer, want changed (figure 5).

 

Track Changes in Word

Figure 5

Uploading a Revised Document

Return to OnPolicy. In the Document Details window, under Revisions, highlight the version of the document that you changed and click on the green “+” above (figure 6).

 

green+

Figure 6

New Revision box pops up on your screen (figure 7). Click on the “Select” button to locate the file you want to upload. When you click on “Select”, an Import New Revision box appears. Click on the “Browse” button.

 

New Revision

Figure 7

In the File Upload window, locate the file you revised and click on “Open” (figure 8).

 

File Upload

Figure 8

When you’re returned to the “Import New Revision” box (figure 9), click on the “Upload” button. That returns you to the “New Revision” box. The version to be replaced should be highlighted already (be sure that it is); now click on “Import“.

 

Import New Revision

Figure 9

If the import is successful, the Author will see that there is a version “1.1.2.0″ Draft of the document awaiting their review (figure 10). The Author clicks on the “download arrow” to download the file and make changes.

 

Draft

Figure 10

Changing and Resubmitting the Rejected Document

In a manner similar to what’s described above, the Author opens the downloaded Word document to accept the Reviewer’s changes and make additional changes, as needed (figure 11).

 

Reviewers changes

Figure 11

The Author can then upload the revised document to OnPolicy once more (figure 12, (a)). The Author “submits” that uploaded document — version “1.2.2.0″ — for another document review (figure 12).

 

upload revised document

Figure 12

Reviewing & Revising – JAVA ENABLED

Review the section of the wiki entitled “Enabling/Disabling Java“, as well as the section on “Work Flow”.

Opening the Document for Review

As in the preceding section (Java Disabled), the Reviewer can either accept or reject the draft document. In order review the document and make changes, the Reviewer opens the document. At this point, the Reviewer may add comments or make changes to the document.

Having Java enabled, the Reviewer clicks on the “pencil icon” (figure 13), which initiates a sequence of events. (Note that the version/revision number of the document is “0.0.0.0“.)

 

Java enabled revision

Figure 13

Once you click on the “pencil”, the Java program will start automatically or it may be downloaded and saved to your local hard drive. If you saved the file (done for virus scanning), you open it — here, by double-clicking on the Java icon.

…which opens in a Microsoft Word window for viewing and editing (figure 14).

 

Microsoft Word window

Figure 14

The Reviewer Revises the MS-Word Document

The Reviewer scans the document (figure 15) to see if it meets a variety of requirements, which may include:

  • Appropriate formatting;
  • Appearance consistent with to existing documentation of the same time (font size, first line of paragraph is indented/flush, etc.);
  • Spelling, punctuation are correct;
  • Grammar and syntax are appropriate;
  • Language, terminology are appropriate for the intended audience; and
  • The document having a unique name (and document ID).

The Reviewer may like the document “as is”, or without modification. In this case they would close the “Word” document and return to OnPolicy to click on Accept Review and move the document down the Work Flow. The Reviewer may make changes to the draft document (figure 15).

 

Accept Review

Figure 15

The Reviewer has to save the revised/modified document, as shown in figure 16.

 

save revised document

Figure 16

Loading the Revised Document into OnPolicy for the Author

After saving the document with revisions, the Reviewer returns to OnPolicy to load that document. They load the document by clicking on the green plus sign (“+”) in the upper right of the Revisions tab (figure 17).

 

Loading Revised Document

Figure 17

Next, the Reviewer clicks on the “Select” button in the New Revision box, then clicks on the “Browse” button in the Import New Revision box (figure 18).

 

New Revision box

Figure 18

The Reviewer locates the document to be uploaded (figure 19).

 

locates the document

Figure 19

When the file is located, the Reviewer clicks on the Upload button in Import New Revision, then on the Import button in Import Revision (figure 20).

 

Upload button

Figure 20

The Author Revises and Uploads the Rejected Document

After the revised file has been imported to OnPolicy, the Author sees a new revision number (0.0.1.0) for what is now a draft document (see figure 21 and compare with figure 20). To review the document and make the necessary changes, the Author clicks on the pencil icon.

 

draft document

Figure 21

If the Reviewer has used the “Track Changes” function (in MS-Word) to modify the document, the Author can accept deletions and other changes, as well as make additional changes that may be called for (figure 22).

 

accept deletions

Figure 22

The Author should then save the revised document using the “Save As…” function, to be sure the file doesn’t go to temporary storage and become lost (figure 23).

 

save the revised document

Figure 23

Return to the “Document Details” window and, with the Draft document revision highlighted (figure 24), click on the green “+”.

 

Document Details

Figure 24

The Revised Document – Ready To Be Resubmitted

Once you locate the document on your local drive, you’ll import it to OnPolicy (figure 25). See Loading the Revised Document section, above, for details on the import process.

 

import revised document

Figure 25

The revision number is incremented once again (figure 26). At this point, the Author clicks on the Submit Draft button to restart the Work Flow process.

 

revision number

Figure 26

Return to Help