Generic Documents

Prerequisites

This tutorial assumes you already know the following:

1. Logging in to CommonSpot
2. Creating a new page 

Contents

Overview

Each document, or set of documents, will have its own page. The document page gives the user an easy way of learning about the documents before downloading them.

Most documents uploaded to the site will be Generic Documents. If you want to upload a document on the site that isn't related to procurement or a Comptroller audit, make it a Generic Document.

Here is an example of what your generic document page might look like:

Create or Edit

Should you edit or create a new document?

Create a new document page if:

1. This document, or an older version, is not already on the website.

Learn how to create a new document page.

Edit a document page if:

Creating Generic Documents

Step 1: Create the Document Page

1. Navigate to your documents folder.
2. Log in to CommonSpot and open the toolbars.
3. Click on the New menu in the gray menu bar.
4. Click on Page.
5. Create the page as you normally would, with one exception:
6. 1. In the Standard Metadata make sure you change the Category to Generic Documents.  
      

Step 2: Fill Out the Generic Document Element

There should be a Generic Document element waiting for you on the page, like this:

If you don't see this element, go to Properties -> Standard Properties and make sure you've changed the Category to Generic Documents.

Click on the link provided to fill out the element. 

1. Thumbnail: If you'd like this document to have a small image, choose or upload it here. This is optional, and usually used for reports that have a cover.
2. • The image should be a maximum of 150px wide
3. Summary: A brief explanation of the document(s), so people know what they are downloading.
4. Document 1: This is the first, and perhaps only, document. 
5. 1. Press the Select button.
   2. Choose Upload New Document and press Insert Link.
   3. Choose your document from your computer, and give it a title.
   4. Press Save.
6. Document 2, Document 3, etc: You can choose up to 20 more documents. The process is the same as for Document 1.
7. Once you are finished, press Save.

NOTE: The Document 1 slot MUST have a document in it. If you start with Document 2, or if you remove Document 1 but have other documents in 2-20, none of your documents will appear.

Editing the Document

1. First, navigate to the page you would like to change.
2. Next, click on the Generic Documents gear icon on the upper-left corner of the element.
3. Several options will appear. Select Edit Data to access all the form fields associated with the page.

4. You can edit any information previously entered in the form fields.
5. Several types of edits to the documents are possible:
6. 1. You can replace an uploaded document with a newer version by clicking Select, then clicking the button that says Upload New Version.
   2. You can remove a previously uploaded document by clicking Clear.
   3. You can upload additional documents. The form allows for a total of 20 uploaded documents. 
7. Once you have completed the edits, press save.

Possible Errors

Here are some issues you may run into:

Title Already Exists

If you give a document a title that already exists in your document folder, you'll see this error:

To get around this, use a unique title for your document. Some tips:

1. Add 'Document' to the end of the title.
2. Add the version number to the end of the title.
3. Add the date to the end of the title.

Document Element is Missing

If you created the page and there's no document element to be seen, then you likely forgot to choose the correct page category:

To fix this:

1. Go to Properties in the gray toolbar
2. Choose Standard
3. Choose Generic Documents from the Category drop-down menu

Document Area Says [hidden]

If you've added some documents to the page, but the document area just says [hidden], this means that you didn't add a document to Document 1. Document 1 MUST be used, otherwise no documents will appear at all.