After a paper or an attachment has been uploaded to CabNet it is advisable that the on-screen display of the document is checked to confirm consistency to the original document. Minor display inconsistencies are acceptable and only materially significant inconsistencies in document formatting and display in CabNet should be addressed.
Technical trooubleshooting advice
Technical advice on troubleshooting any document display issues is set out under the following questions:
- Does the font display as expected on-screen in CabNet? e.g. does the font match the original document? Does bold text, italic text and bullet points match the original document? If no, then the browser settings may not be optimised to view CabNet, contact your Organisation Administrator or IT staff to confirm browser settings.
- Automatic paragraph numbering not displaying on-screen as expected? e.g. numbering is out of order or not displaying at all. If yes, then the document may need to be re-formatted to ensure a consistent style.
- Are the paragraphs indented more than in the original document? The original style may include an indent that is larger than what appears on the original document. The style should be changed in the original document.
- If your document has a table of contents, have the numbers for the pages displayed on-screen in CabNet? If it does not display correctly it will be necessary to upload a PDF version of the document.
- Does a shaded box appear where you expect to see text? It is likely that a form element has been used in the document. e.g. a drop down list. The CabNet previewer cannot read this form element. It will be necessary to remove the form element and re-upload the document.
- Do your headers and footers display as you would expect? e.g. do the page number formats display and/or match the original document? Do text or images that are in the header or footer of the original document display incorrectly or not display at all? Is the font size inconsistent?
- Is the header/footer page number format incorrect? – Roman numerals don’t display and need to be changed to figures
- Is the header/footer missing or displaying on the wrong pages? – unlink the header or footer.
- Is the font size inconsistent? – Use consistent styles.
- Is the positioning of the header incorrect? – Check the margins in the document, and adapt if necessary.
- Is text overlapping on-screen? If yes the document will need to be re-formatted to remove any overlapping text boxes.
- Do chart/diagrams/graphs display as expected? e.g. is all the information in the original chart displaying on-screen as expected. If no the chart may include several separate images. As a result the chart may need to be re-formatted to ensure the chart is contained in one image. Or convert the chart to an image and insert the single image in the document.
- Is text in a word document stretched or condensed? If yes then a word document may have been inserted into the main word document. You may need to re-format the document by copying and pasting the section of text into the main word document.
- Are all the hyper-links in the document displaying as expected? The previewer cannot display links and the document will require conversion to a PDF in order to display links.
- Is the text position on the page incorrect? The previewer does not recognise the top margin. Either re-set the margin to the same as the rest of the document and re-format the text in another way. Alternatively convert the document to PDF.
- Has an image been shifted to the next page of the document on-screen? The image my need to be re-sized in the original document.
Resolving document display issues
Only materially significant inconsistencies in document formatting and display in CabNet should be addressed.
- Step 1: Identify which issues outlined above are displaying on your document on-screen in CabNet.
- Step 2: If the issues are limited to those outlined in the point above titled “does the font display correctly on-screen in CabNet?”, confirm with your CabNet Organisation Administrators or agency IT support that the browser configuration settings are optimised to view documents on CabNet.
All CabNet user organisations have been provided with instructions to ensure the browser settings are optimised for viewing documents in CabNet. All organisations have also been provided with information on how to diagnose whether or not the settings are applied.
- Step 3: If the issues under any of the other bullet points above under the heading "Technical troubleshooting advice" are displaying and are materially significant further action may be required.
- Step 4: Use the information set out above to determine whether the underlying issue in the document can be remedied. If they can be remedied then changes should be made and the reformatted document should be re-uploaded.
If the underlying issue cannot be determined, assess whether a PDF version of the original document should be uploaded. Converting the original document into PDF format before upload may address persistent formatting issues.
A consequence of uploading the PDF version of the document is that it will not be able to be edited. In the unlikely event that the document requires edits, the original version would need to be retained and accessible by individuals that may need to undertake edits.
- Step 5: Re-upload the document in the original format, or convert the original document into PDF format and upload the document as a PDF.
Documents created as PDFs
It may be necessary to upload a document to CabNet that has been created as a PDF file. A brochure for public release that has been created for professional printing is an example.
These PDF documents should be optimised for web viewing to ensure that they display correctly on-screen in CabNet and in downloaded form.
Click on the following links for detailed guidance:
- Adobe - Help on optimising PDFs
- PDF.js - Optimising PDFs for display in Alfresco (the CabNet platform)
Professional-calibre desktop publishing applications are the most effective applications at displaying downloaded PDFs.
Refer to the following pages for more information: