Drawing File Name and Folders

Administrator Command Reference Manual

Drawing File Name and Folders

Drawing File Name and Folders

Certain ADMIN functions such as Copy, Reconfigure, Delete may act on the drawing files associated with DRAFT or SCHEMATIC databases. The administrator may need to know details of these if there is a problem.

Drawing files are stored using a strict naming convention. The elements used to build the file are illustrated below:

The prefix is dependant on the file type, the following options are available.


File Type	Prefix
Picture file	M
Marine Hull Drawing	D
Diagram	V
Stencil	V
Template	V
Neutral Format (SVG)	V

The Ref No is dependant on the file type, the following options are available:


File type	Element Type	Database
Picture file	SHEE,OVER	PADD
Marine Hull Drawing	SHEE,OVER	PADD
Diagram (Visio)	SCDIAG	SCHE
Stencil (Visio)	SCSTEN	SCHE
Template (Visio)	SCTEMP	SCHE
Neutral Format (SVG)	SCDIAG	SCHE

The extract file number from which the Drawing was saved.

The version number when the Drawing was saved.

The Page number prefix part of the file name is only used when dealing with SVG files.

Number of pages per Schematic Diagram. Only used when dealing with Neutral format (SVG) files. Non-Visio diagrams only have one page.

The file name suffix is dependant on the file type, the following options are available.

Note:

Visio files may be stored in either Binary or XML format; The types and numbers of files are defined by attributes.


File type	Suffix
Picture file	-
Marine Hull Drawing	sdb
Diagram (Visio)	Vdx or vsd
Stencil (Visio)	Vsx or vss
Template (Visio)	Vtx or vst
SVG	Svg

Drawing files are stored in a folder defined by an environment variable. In the case of Draft drawing files see table below the file is stored in a numbered sub-folder is determined by the database reference (Module 32 of the second component of the reference)..


File type	Suffix
Picture file	{project}PIC
Marine Hull Drawing	{project}DRG
Diagram	{project}DIA
Stencil	{project}STE
Template	{project}TPL
SVG	{project}DIA

The following attributes may be useful at the above elements


Q DRFTYP	List of drawing file types for elements
Q DRFILE	Default drawing file name for element (for SVG files, for highest number file)
Q DRFILE (number)	Drawing file of specification type of element

There are also attributes specific to each element type


PICF, DOFIL	for SHEE (PICF, also applies to OVER)
VISF, NVIEWF	for SCDIAG (VISF also applies to SCSTEN, SCTEMP)

Splitting of Folders

When the number of files in a folder becomes huge, the performance of the Microsoft Windows file system can suffer. Some folders in the AVEVA Plant project folder structure are especially susceptible to this negative effect:


<project>PIC	containing AVEVA Plant Draft picture files

These folders have been split by creating 32 subfolders numbered '00', '01', …, '31', and the files, that were previously stored in the main folder, now are spread among the subfolders using an algorithm, that guarantees the most even distribution of files. As a result, the number of files in a single subfolder will be significantly lower, improving the file system performance. The formula for determining the subfolder is:

subfolder number = DBREF[2] modulo 32

where DBREF[2] is the second element of the DB reference of the picture element.

For example: A sheet in the BAS project having the DB reference =15773/4101, extract file number (EXFI) 16, and picture version number (PVNO) 25.

The associated picture file path would be:

/%BASPIC%/05/M15773-4101-16-25

where the file name itself is built from the DB reference, the EXFI and PVNO attribute values, as in previous versions, but the subfolder number (05) has been derived by the formula:

4101 modulo 32 = 5

Assuming, that the DB references are allocated sequentially, we can then expect an even selection of the subfolder for the picture files. Some features of the implemented algorithm:

•

If the DB reference does not change, the subfolder number also stays the same.

•

Creation of the new version of the picture, or modification of this picture from an extract will change the EXFI or PVNO attribute values, but the reference would stay the same, thus preserving the selected subfolder number.

•

If the picture element is removed, and then later recreated (e.g. from a DATAL transfer), it may get assigned a different DB reference, than originally, thus getting possibly a different subfolder for its picture file.

All existing Admin functions, including purging picture files, copying or deleting DBs, creating or replicating projects, etc., are aware of the new folder structure. In order to facilitate the handling of the subfolders and the files therein, the following pseudo-attributes have been implemented.


PICF/ilename	returns the path to the AVEVA Plant Draft picture file for the current picture element

As compared to the folder structure valid for previous versions, the new layout looks as follows:

Figure A:1.

Layout of the <project>PIC Folders

Figure A:2.

Layout of the <project>DWG Folder

1974 to current year. AVEVA Solutions Limited and its subsidiaries. All rights reserved.