Menu

Project settings

Configuration, conventions and retention. Some of these reinterpret documents that have already been read.

Demonstration project - no figure here describes a real facilityChanges are not saved
Why

A change is compared against what the project currently holds and reported field by field. A submission that changes nothing is refused rather than reported as saved.

Writes are validated against the engineering rules and then refused, because no database has been configured for this environment.

Project

Nothing is written: the form reports what would change.

Identification

What this project is and who it is for.

Appendix letters are read from this contract, never presumed

Engineering conventions

Applies to documents processed afterwards.

Used to recognise a document number in a title block

Decides what counts as a tag. Changing it changes what the registers contain.

Retention

Null is not zero: no agreed policy is a different state from a policy of immediate deletion.

Leave blank where no retention policy has been agreed with the client

A convention change reinterprets what is already read

Changing the tag grammar does not reformat anything: it changes what counts as a tag. Documents already processed keep the registers they produced until they are read again, so a change leaves the project holding two interpretations until reprocessing is done deliberately.

The tag grammar as it stands

What this project currently recognises as a tag.

Tag patterns
Asset classNormalises toWhat it matches
equipment$1-$2$3Equipment: letter prefix, four digits, optional suffix
instrument$1-$2$3Instrument: ISA function letters and loop number
valve$1-$2$3Valve: function prefix and sequence
line$1-$2-$3-$4-$5Line: unit, service, sequence, size, class
cable$1-$2Cable: cable prefix and sequence
loop$1-$2-LOOPInstrument loop
Retention: blank is not zero

A blank retention period means no policy has been agreed with the client. That is a different state from a policy of deleting immediately, and storing it as zero would make the two indistinguishable - at which point somebody’s drawings get deleted because a field was never filled in.

What is not configurable here

  • The project code, which every issued document number carries
  • Who may approve, granted per person on the team page
  • Confidence ceilings, which are properties of the reading methods

Why these cannot change