Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
DocumentRegisterID

Module Overview:

The Document Communications feature provides a template-based approach to standardised documents. A document includes some base attributes and allows client-specific document formats to be defined through Extension Fields. The preview and email of documents uses the email Conversation panel with integrated Microsoft Office 365 email conversations to provide a view of sent and received emails (if Office 365 is enabled and you are on our AWS hosting platform). This feature is currently available under the Contracts or Subcontracts module.

Category Setup

The Category Hierarchy provides the customisable classification for a Document Type. Access 'Category Hierarchy' from the System Setup - Documents - Category Hierarchy menu.

Document Type Email Template Setup

You can set up standard templates for different document types, meaning each Register Type can have distinct text that makes sense for that type. Access 'Document Type Email Templates' from the System Setup - Documents - Register Email Templates menu.

Statuses Setup

A list of Status options may be configured. This is from the Statuses screen for the type 'Document Register Statuses'.  Note these are NOT document type specific but system wide.

Extension Columns Setup

The extension columns are setup in the standard manner with support for view conditions. Extension fields are defined for the 'DocumentRegister' Extension Type.

Where a set of fields are particular to a scenario, for example a document type (by using View criteria DocumentRegister.DocumentRegisterTypeId with a Criteria Value), then the relevant criteria must be specified.

Multiple extension views are supported, so you may have generic attributes applicable to all documents (or the general Web Portal view) as well as document type specific attributes.

Expand
titleExample of an extension fields view for Delay details:

Image Removed

Image Removed

Image Removed

Image AddedImage AddedImage Added

DocumentRegisterTypeID in the

view criteria

Criteria Value must match the TypeID in the Document Register Type. In this case 3 is the ID for Notice of Likely Delay, which is the document type that will show the extension

coulmns

columns above.

Image Removed
Image AddedImage Added


For custom fields to be shown always regardless of the document type, a new view called 'Web Portal' must be created, and this will enable custom fields under this view to display on all documment communications.



Document Number Setup

The control parameter ‘Document Register Number Template’ has a tokenised string definition for the Document Number. If the control parameter is not set up, the default number is the DocumentRegisterID.

The tokens supported are:

•   [JobCode]
•   [DocTypeId]
•   [FormatNextNo]

So, a format like ‘[JobCode]-[DocTypeId]-[FormatCounter]’ would produce a Doc No of ‘4003-2-5’ for job code 4003, where say Site Instruction doc type id is 2, and the document is the fifth Site Instruction for job 4003.

The generated number may be refreshed unless the document has already been sent.

Document Type Setup

The Document Type associates the respective element for the type. Access 'Document Register Type List' from the System Setup - Documents - Register Types menu.

Generic Document Report

Image Removed
Image Added

The standard ‘Document Register’ report type includes the wbDocumentRegister001-Generic Document Register format.

Remember that for any Report Types to be visible they must be included in the relevant Report Groups.

Usage

Image Removed
Image Added

The Document Communications feature is accessed from Documents under the List menu. A new Document is created with the [+ New Document] button. A new document can also be created from Job Enquiry → Documents tab or from a Subcontract → Documents tab.

A.  Select the required Doc Type as per the Register Type setup. This will drive the associated defaults in this tab and the Content tab. Also specify a Name for this document.

B.  The editable Doc No can be specified or generated as per the Document Number setup. The existing number can be refreshed should a numbering component change.

C.  Select the Category for this document. The options available are as per the setup for the selected Doc Type.

D.  Select the applicable Status. The options are as per Status setup.

E.  Some document-related dates may be recorded. The Doc Date and Response Required are included in the generic report.

F.  The document may be associated to one or more entities, where Document is an existing document.

G.  The outcome for this document may be recorded in due course.

H.  Once you Save you can 'Reload Extension Columns' to view the associated fields. Conditional extension columns are setup in the usual manner.

When you select

the 

the Doc Type on

the 

the Details

 tab

 tab, the type selected will change the defaults of

the 

the Contents

 tab

 tab.

I. 

The 

The Details

 defaults

 defaults based on the Document Type

 used

 used as per the Register Types

 setup

 setup. This may be edited and supports basic html formatting, forming the main body of the generated report.

J.  The

email 

email Subject

 defaults based

 defaults based on the Document Type

 used

 used as per

the Register Email Template setup

the Register Email Template setup and may be edited.

K.  The

email 

email Body

 also defaults based

 also defaults based on the Document Type

 used

 used as per

the Register Email Template setup

the Register Email Template setup and may be edited.

L.  Specify the sender of the document in Document From. This field is included in the generic report as the sender of the document.

M.  Specify

the To recipient and CC recipient

the To recipient and CC recipient, if required. Use

the 

the +

 button

 button to add additional addresses to either field. Only

the 

the To

 recipients

 recipients are listed in the generic report.

N.

  

  Files may be attached to the email, selected from those already attached to the document using

the 

the [Attachments] button. Use

the 

the +

 button

 button to add additional attachments.

O.  Use

the 

the [Preview]

 button

 button to display the PDF version of the document, noting that the preview does not display email-related details. Use the Edit button to return to this editable view. Additional Preview report options must belong to the Report Type

 associated

 associated with the

selected 

selected Document Type. The generic format installed is located under

the 

the Document Register Report Type.

P.  After previewing,

 use 

 use [Send]

 to

 to email the document. The sent email is displayed in the conversation panel as the first email.  A document MUST be previewed before it can be sent.

After sending, viewing the document will default to the PDF view.

Q.  The default view for a sent message is the PDF view of the document.

R.  Click the down/up caret to show/hide the email area.

S.  The email area supports the typical Forward and Reply options, and these emails will also display in the conversation panel for the document.

T. 

The 

The Edit Message link displays the data entry view of the content tab.



Child Pages:

Child pages (Children Display)
alltrue
excerptTypesimple

Related Modules:


FAQs: