= V2 Screen Layouts = [[V2Master]] | [[V2HighLevelDesign]] <> = To Do = 1. Review button (''new'', ''edit'' and ''delete'') placement on detail screens 1. Review: How does button '''+File''' work? 1. Define the contents of the ''Transmittals Block'' 1. Review block headers and sub-headers (including font size) 1. Review menu titles for configuration related menu items 1. Review for correctness [ALL] 1. Add buttons with button titles, tune button colors (should be less glaring) 1. Check widths of selects, to be consistent across screens 1. Check links for consistent actions 1. We plan to go to a single edit screen, instead of separate edit screens for the object data and classification. 1. Introduce different header background colors for each object (using subtle tones). One or a combination of the following: 1. Apply color based on object type 1. Apply color based on block type = Work Status = || '''Item''' || '''Draft''' || '''Spec.''' || '''Coding''' || '''Review''' || '''Rework''' || '''OK''' || '''Notes''' || ||<-8> '''Detail Screens''' || || Document || Done || Done || Done || Done || Done || OK || || || Task || Done || Done || Done || Done || Done || OK || || || Transmittal || Done || Done || Done || Done || Done || OK || Transmittal form open || || User || Done || Done || Done || Done || Done || OK || || || File || Done || Done || Done || Done || Done || OK || || || Dossier || Done || Done || Done || Done || Done || OK || || ||<-8> '''New/Edit Screens''' || || Document || ''n/a'' || ''n/a'' || Done || Done || Done || OK || || || Task || ''n/a'' || ''n/a'' || Done || Done || Done || OK || Add ''type'' to title || || Transmittal || ''n/a'' || ''n/a'' || Done || Done || Done || OK || || || User || ''n/a'' || ''n/a'' || Done || Done || Done || Ok || Additional email in identification bock || || File || ''n/a'' || ''n/a'' || Done || Done || OPEN || OPEN || || || Dossier || ''n/a'' || ''n/a'' || Done || Done || OPEN || OPEN || || ||<-8> '''List Screens''' || || Documents || ''n/a'' || ''n/a'' || ''n/a'' || Done || Done || OK || || || Tasks || ''n/a'' || ''n/a'' || ''n/a'' || Done || Done || OK || || || Transmittals || ''n/a'' || ''n/a'' || ''n/a'' || Done || Done || OK || || || Users || ''n/a'' || ''n/a'' || ''n/a'' || Done || Done || OK || || || Files || ''n/a'' || ''n/a'' || ''n/a'' || Done || Done || OK || || || Dossiers || ''n/a'' || ''n/a'' || ''n/a'' || Done || Done || OK || || || Invitations || OPEN || OPEN || OPEN || Done || OPEN || OPEN || || ||<-8> '''Configuration Screens''' || || Folders || Open || Open || Open || Open || OPEN || OPEN || || || Task || Open || Open || Open || Open || OPEN || OPEN || || || Classification Lists || Open || Open || Open || Open || OPEN || OPEN || || || Classification Classes || Open || Open || Open || Open || OPEN || OPEN || || || Classification Schemas || Open || Open || Open || Open || OPEN || OPEN || || || Resource Subtypes || Open || Open || Open || Open || OPEN || OPEN || || || Access privileges || Open || Open || Open || Open || OPEN || OPEN || || = General Notes = == Process == 1. If it's difficult to come to agreement then default to showing more data and then solicit customer feedback for additional guidance == Terminology == 1. '''Object''' - Refers to system objects such as documents, revisions, tasks, transmittals, users, etc. Block ordering is applicable to following Objects: * Documents and Revisions * Tasks * Transmittals * Users * Files * Dossiers * Project Team * (Folders - lower priority) * (Classification Fields - lower priority) 1. '''Type''' - A field associated with the object that determines its classification class, and consequently: * The allowed set of classification fields and their properties * The screen display of the classification fields == Block Ordering == ''Not all block types are relevant to all Objects.'' 1. '''{Object} {Type} {Code}''' - Default page title 1. '''Identification Block''' * '''Type''' - e.g. Document type * '''Code''' - e.g. Document code * '''Title''' - Could be multiple lines, depending on the ''type'' * '''Author/Issuer''' - Depends on ''type'' * '''Date''' - Depends on ''type'' * ''Additional object specific fields'' * '''(Status, Private/Public, External/ProjectTeam flags)''' - '''''Issue:''''' to review * Identification block classification fields (for the given data type) - Only displayed of classification values for the identification block, for the given type, are defined or if one of the fields is defined as ''display on detail'' * Note that ''Description/Summary'' fields should be defining in the classification configuration '''TN: why?''' 1. '''Folder Block''' - for all objects except ''Team Members'' 1. '''Project Position Block''' - For ''Team Members'' only, can contain multiple entries if the team member is assigned more than one project position * '''TN: not a classification?''' * '''AH: in the initial release this block will not be implemented. The short-term workaround is to define project position as a classification field, which will be displayed in one of the other blocks''' 1. '''Responsibilities and Due Dates Block''' - Not implemented in the first release 1. '''Classification Block''' - Only displayed if classification values for the classification block, for the given type, are defined or if one of the fields is defined as ''display on detail'' 1. '''Properties Block''' - Only displayed if classification values for the data block, for the given type, are defined or if one of the fields is defined as ''display on detail'' 1. '''Message Block''' - For ''Transmittals'' 1. '''Revision Blocks''' - For ''Documents'', includes ''Files'' and ''Note'' sub-blocks 1. '''Note Blocks''' - For ''Tasks'' 1. '''References''' - Sub-header 1. '''Links Block''' - Not implemented in the first release 1. '''Subscribers Block''' - Not implemented in the first release 1. '''Transmittals Block''' 1. '''Links Block''' - Not implemented in the first release (except for Dossier links). * ''To review: should this block include references to Dossiers? Or should that be in a separate block?'' 1. '''Subscribers Block''' - Not implemented in the first release. 1. '''Transmittals Block''' - Only implemented for the ''Documents Detail'' screen == Buttons == 1. ''History'' buttons will not be available in the first release === Button Formatting === ''To review'' 1. '''eEdit''' - Text: ''Edit'' icon followed by the text. Colored blue 1. '''+New''' - Text: ''Plus'' icon followed by the text. Colored blue. The text may be something other than ''New'' 1. '''xDetach''' - Text: ''X'' icon follow by the text. Colored yellow 1. '''xDelete''' - Text: ''X'' icon followed by the text. Colored red === Button Enabling === '''''To``Do''''' 1. Button enabling based on: * User roles * Object status = Detail Screens = == Document Detail Layout == 1. '''Document - {type} {code}''' - Page title. The code is the only document code, which excludes the revision code 1. '''Identification {startOfTitle}''' - Document identification block. Note that there is no edit button, editing is initiated by the edit button on the individual revision * '''Type''' - Document type * '''Code''' - Document code * '''Title''' - 4-line document Title. The title comes from the revision with highest revision number * ''Document Identification fields'' - Optional. ''To review: These are the document's identification fields. Given the title is from the revision, will there be confusion?'' 1. '''Folder {lowestLevelOfFolderPath}''' - Folder block 1. '''Classification''' - Document classification block. Optional 1. '''Properties''' - Document data block. Optional 1. '''Revisions''' - Sub-header 1. '''Revisions''' - Revisions Block with button '''+Revision''' 1. '''Revision {revisionNumber} {date} {startOfTitle}''' - Revision sub-block. Buttons '''eEdit''', '''xDelete''' (Requires confirm). Note that there must always be at least one revision present. 1. '''Identification''' - Revision identification sub-sub-block * '''Type''' - Revision Type * '''Code''' - '''{documentCode}-{revisionCode}''' * '''Title''' - 4-line document Title. * '''Author''' * '''Date''' * '''TN: 'Description' should be removed from model?''' * ''Revision Identification Fields'' - Optional 1. '''Responsibilities and Due Dates''' - Revision workflow sub-sub-block 1. '''Classification''' - Revision classification sub-sub-block. Optional 1. '''Properties''' - Revision Data sub-sub-block. Optional 1. '''Revision Files''' - Revision file list sub-sub-block, table with following columns, button '''+File''' * '''Type''' - File type * '''Author''' - Who uploaded * '''Date''' - Date/time stamp '''TN: is it ok to have 'Date' as label fro date/time?''' * '''Description''' * '''Filename''' * Buttons: '''eEdit''', '''xDetach''', '''xDelete''' 1. '''Notes''' - Sub-header 1. '''Notes''' - Sub-sub-block with button '''+Note/File''' 1. '''{initials} {datetimeStamp} {startOfNoteText}''' - Revision notes sub-sub-sub-block. Buttons '''eEdit''', '''xDelete''' 1. '''{noteText}''' 1. '''Attached Files''' - Attachment file list block, a table with following columns, with buttons '''+File''' * '''Type''' - File type * '''Author''' - Who uploaded * '''Date''' - Date/time stamp * '''Description''' * '''Filename''' * Buttons: '''eEdit''', '''xDetach''', '''xDelete''' 1. '''References''' - Sub-header 1. '''Links''' - Links block 1. '''Subscribers''' - Subscribers block 1. '''Transmittals''' - Transmittals block === Document Detail Buttons === 1. '''Documents/Revisions''' 1. Edit document & revision - Edits all document and revision fields, including their associated classification fields. Excludes: * Notes * Files * Workflow fields - Deal with this after the first release * Linked items 1. New revision 1. Delete revision - Deleting the last revision also deletes the document (perhaps displaying a pop-warning) 1. '''Notes''' 1. New note 1. Edit note 1. Delete note 1. '''Files''' - Both revision files and notes files: 1. New file - Includes both uploading files and attaching files 1. Edit file - Edit the file's metadata 1. Delete file 1. De-attach file Note: In the edit/new screens, there is only a ''Save'' button and there are no ''Back'', ''Cancel'', ''Preview'', ''Confirm'', etc. buttons. '''''To``Do''''' 1. Describe the button enable/disable rules === Document Detail Issues === 1. Compare with transmittal detail screen layout and see how the files are displayed. Will it still be possible to easily transmit notes attachments files (instead of ''working files'')? 1. Editing of Revision blocks (see *** above): how to handle editing of individual notes? Probably best to have a separate Edit button on each Note. 1. Clicking on Document Revision N in a List should open detail screen with Revision block and sub-block for Revision N open. == Task Detail Layout == 1. '''Task - {type} {code}''' - Page Title. 1. '''Identification {startOfTitle}''' - Task Identification block. Buttons '''eEdit''', '''xDelete''' * '''Type''' - Task Type * '''Code''' - Task Code * '''Title''' - Task Title * '''Issuer''' * '''Date''' * ''Task Identification fields'' - Optional 1. '''Folder {lowestLevelOfFolderPath}''' - Folder block 1. '''Responsibilities and Due Dates''' - Task sub-block 1. '''Classification''' - Task classification block. Optional 1. '''Properties''' - Task data block. Optional 1. '''Notes''' - Sub-header 1. '''Notes''' - Notes container block with button '''+Note/File''' 1. '''{initials} {datetimeStamp} {startOfNoteText}''' - Notes sub-block. Buttons '''eEdit''', '''xDelete''' 1. '''{noteText}''' - Display ''free floating'' (e.g. not in its own block) 1. '''Attached Files''' - Attachment file list block, a table with following columns, with buttons '''+File''' * '''Type''' - File type * '''Issuer''' - Who uploaded * '''Date''' - Date/time stamp * '''Description''' * '''Filename''' * Buttons: '''eEdit''', '''xDetach''', '''xDelete''' 1. '''References''' - Sub-header 1. '''Links''' - Links block 1. '''Subscribers''' - Subscribers block 1. '''Transmittals''' - Transmittals block === Task Detail Buttons === 1. Notes are edited separately from the task and its classifications '''''To``Do''''' 1. Describe the button enable/disable rules == Transmittal Detail Layout == 1. '''Transmittal - {type} {code}''' - Page title. 1. '''Identification {status} - {startOfTitle}''' - Transmittal identification block. Buttons '''eEdit''', '''xDelete''' * '''Type''' - Transmittal type * '''Code''' - Transmittal code * '''Title''' * '''Status''' - ''pending'', ''scheduled'', ''sent'', ''cancel pending'', ''canceled''. * '''Transmittal Time''' - The display of the date and time suppressed (the entire row) if the status is not sent yet. * '''Cancel Time''' - - The display of the date and time suppressed (the entire row) if the transmittal is not canceled. * ''Classification Identification Fields'' - Optional 1. '''Folder {lowestLevelFolderPath}''' - Folder block 1. '''Responsibilities and Due Dates''' 1. '''Classification''' - Transmittal classification block. Optional 1. '''Properties''' - Transmittal data block. Optional 1. '''Message''' - sub-header 1. '''Message''' - Block 1. '''Header''' - sub-block * '''From''' * '''Date''' - Date only, with display of time. The date is not set if status is ''pending'' * '''To''' - Contains: '''{initials} - {lastName}, {firstName}, {selectedEmailAddress}''' * '''CC''' - Contains: '''{initials} - {lastName}, {firstName}, {selectedEmailAddress}''' * '''BCC''' - Contains: '''{initials} - {lastName}, {firstName}, {selectedEmailAddress}''' * '''Subject''' - Contains: '''{projectCode} Transmittal {type} {code} {title}''' - Read-only in edit screen 1. '''Text''' - sub-block 1. '''Attachments''' - sub-block. Contains table (no column headers. '''''Issue''''' Change background color of the line with the document code and title to provide visual hint) with the following columns (displayed as two rows): * '''{sequenceNumber}''' * '''{documentCode}-{revisionCode}''' * '''{title}''' * '''Revision File''' or '''Note Attachment''' * '''{fileType}''' * '''{documentCode-revisionCode-sequenceAlpha}''' or '''{fileNamePrefixedByDocumentCode}''' - for respectively Revision File or Note Attachment === Transmittal Detail Buttons === 1. There is only one edit button, which edits the entire transmittal, including the recipients and documents '''''To``Do''''' 1. Describe the button enable/disable rules == Project Team Detail Layout == 1. '''Project Team - {Type} - {firstName lastName}''' - Page title 1. '''Identification {firstName lastName}''' - User identification block. Buttons '''eEdit''', '''xDelete''' * '''Type''' - Team Member Type * '''First Name''' * '''Last Name''' * '''Initials''' * '''Company''' - ''Note: New database field. Not required'' * '''Primary Email''' * '''Secondary Emails''' - Can contain multiple entries, displayed in vertical list * ''User Identification Fields'' - Optional 1. '''Project Organisation {lowestLevelOrgansiationalBreakdown}''' - Organisation block. Not implemented in the initial release * '''Project Position''' - Displayed in the same format as the Folder is displayed in other Folder blocks 1. '''Classification''' - User classification block. Optional 1. '''Properties''' - Use data block. Optional. Can be used to define the user's contact info 1. '''Access Privileges''' - Sub-header 1. '''Access Privileges''' - access privileges and responsibilities * '''Internal/External''' - ''Issue: Convert to radio button. Need to define field header and and the names for the off/off values'' * '''Login Enabled''' - ''Note: Convert to radio button, with Yes and No values'' * '''Access Privileges''' Contains a table with the following columns (no column headers): * '''Privilege''' * '''Folder Path''' (global + assigned folders) '''Issues:''' 1. Display the User Detail page in single column format (e.g. like all the other detail pages), with blocks consistent with other object detail screens 1. Remove the Quick Links block, all necessary links are already in banner menu 1. ''Project Role'' should be removed from system data and be replaced by ''Project Position''. 1. ''Project Role'' now mandatory system data similar to Folder; project role can be configured as a classification field (text description) if needed === Project Team Detail Buttons === 1. Users cannot be deleted when: 1. They have ''history'' in the system. E.g. their userId appears in the system's event log or the audit trail 1. They are assigned as issuers, to workflow steps, etc. 1. Users may be able to edit their own metadata, but no their own user roles (unless they have the appropriate administrator role) == File Detail Layout == 1. '''File - {type} {filename}''' - Page title 1. '''Identification {filename}''' - File identification block. Buttons '''eEdit''', '''xDelete''' * '''Type''' - File Type. Contains: '''Revision File''' or '''Note Attachment''' or blank if not-attached to an object * '''File Name''' * '''Attached to''' * '''File ID''' - Contains: '''{fileId}''' * '''Uploader''' * '''Date''' - File upload date and time * '''Description''' - description required as system data since files do not allow classification 1. '''Folder {lowestLevelOfFolderPath}''' - Folder block. If the file is attached to an object then the attached object's folder is displayed 1. '''Properties''' - File properties block. Displays fields from the ''file_assets'' database table (not classification fields) * '''File Format''' * '''Size''' * '''Original File Name''' === Files Detail Buttons === 1. Files cannot be deleted from the file detail screen, if they are attached to an object 1. ''To review: can file metadata be edited when the file is part of a locked item? E.g. a revision that was transmitted'' '''''To``Do''''' 1. Describe the button enable/disable rules == Dossier Detail Layout == 1. '''Dossier - {name}''' - Page title 1. '''Identification {name}''' - Dossier identification block. Buttons '''eEdit''', '''xDelete''' * '''Name''' - Dossier name * '''Issuer''' * '''Private Dossier''' Yes/No * '''Date''' - Creation date * '''Description''' - The description field is required, because dossiers do not allow classification 1. '''Folder {lowestLevelOfFolderPath}''' - Folder block 1. '''Items''' - Sub-header 1. '''Document Revisions''' - Revision items block, contains a table with the following columns: * '''Item''' - Contains: '''{documentCode}-{revisionCode}''' * '''Description''' - Contains '''{revisionTitle}''' 1. '''Tasks''' - Task items block, contains a table with the following columns: * ''To``Do'' '''Issues:''' 1. ''To review:'' Is ''Document Revisions'' a sensible block title? 1. The Resource Type in the Document Revisions / Task blocks doesn't seem required, as this is given by the block header === Dossier Detail Buttons === '''''To``Do''''' 1. Describe the button enable/disable rules = Edit Screens = == Document Edit Layout == == Task Edit Layout == == Transmittal Edit Layout == == User Edit Layout == == File Edit Layout == == Dossier Edit Layout == == Note Edit Layout == = List Screens = == Document List Layout == == Task List Layout == == Transmittal List Layout == == User List Layout == == File List Layout == == Dossier List Layout ==