Troubleshooting and frequently asked questions (FAQ)

Troubleshooting and frequently asked questions (FAQ)


Here you will find common errors, known limitations and frequently asked questions about work packages and transmittals.



TABLE OF CONTENTS



Common errors


ProblemCauseSolution
The work package menu is missingThe licence for work packages is missing, or the user group does not have accessCheck that the module is activated (contact Telaris) and that the user group has access
The package is not in the listThe package was created in a different project areaSwitch project area and search again
The progress is standing stillThe tags in the package lack requirements, or the requirements are not weightedCheck the requirements and the weighting on the tag types
Documentation is missing from the bundleThe checklists are not completed, or the files are on tags that are not in the packageCheck the content of the package before the bundle is built
The document bundle does not arriveThe assembly runs in the background and takes time for large packagesWait until the job is finished; check the status of the background job if the wait is long
The transmittal cannot be sentRecipient, reason for issue or other mandatory details are missingFill in the fields and set the transmittal to ready
The recipient cannot open the transmittalThe link or the password is wrong, or the transmittal is closedSend the link again, and check the status
The status cannot be changed backThe transmittal is closedA closed transmittal is final; create a new revision instead
The deviation points are not shown in the packageThe points are registered on tags that have not been added to the packageAdd the tags to the package



Known limitations


  • Work packages belong to one project area, and the number series is specific to each area
  • The progress on the package comes from the requirements on the tags – without requirements there is no progress to show
  • Document bundles are built in the background, and are not immediately available for large packages
  • A closed transmittal cannot be reopened; changes require a new revision
  • Com and MC packages assume that the business actually works according to NORSOK Z-007
  • The recipient's access applies to the transmittal, not the work package as a whole



What the module does not do


  • The work package does not carry out the work – it gathers what is done on the tags
  • The transmittal is not an e-signature service; the acceptance is recorded in the system
  • The module does not replace project planning – progress schedule and milestones are in the planning module
  • The content of the document bundle is not quality-assured automatically; what has been filled in is included



Frequently asked questions


What is the difference between a work package and a deviation point?

The work package delimits a delivery to be completed and handed over. The deviation point is a single finding to be rectified. They are built on the same underlying structure, but are used for entirely different things.


What is the difference between a work package and a transmittal?

The work package is the content – the tags, the work and the documentation. The transmittal is the formal letter that sends the documentation out to the recipient.


Why does it take time to create the document bundle?

Because it is assembled as a background job. A package can contain hundreds of forms and files.


Can the recipient see the whole system?

No. The recipient opens the transmittal through a dedicated link with a password, and sees only the documentation that belongs to it.


How do we know the transmittal has been received?

The system records when it was opened and when it was accepted, with a timestamp.


We need to change something in a transmittal that has been sent – what do we do?

Create a new revision. A sent or closed transmittal is not changed afterwards.


What do the phases construction, mechanical completion and commissioning mean?

It is the usual division in industrial projects. Businesses that do not work this way usually use only the first stage.



Glossary


TermExplanation
Work packageDelimited delivery that gathers tags, tasks and documentation
Work package typeThe type that determines how the package behaves
TransmittalFormal transmittal of documentation to a recipient
Transmittal typeThe type that governs the setup of a transmittal
Reason for issueThe reason a transmittal is sent
RevisionEdition number of a transmittal
Document bundleCombined PDF built from the documentation in the package
Incoming fileDocumentation received from outside and placed on the package
Task fileFile that originates from the work on the tags
MC packagePackage for mechanical completion per NORSOK Z-007
Com packagePackage for commissioning per NORSOK Z-007
MCSIStatus report for mechanical completion per system
CSRIStatus report for checklist status
Deviation pointFinding to be rectified, often called punch






Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select at least one of the reasons
CAPTCHA verification is required.

Feedback sent

We appreciate your effort and will try to fix the article