# AdapterForDocuments

**AdapterForDocuments** captures 2D graphics and attributes from Intergraph SmartPlant SmartSketch and stores them in a `*.upvd` file. This file is then used as input for CAXperts **UDiTH Builder** to add 2D drawings to 3D sessions.

## Using AdapterForDocuments

## General Notes

**AdapterForDocuments** converts Smart 3D isometric and layout drawings, PDF files in general, and PDMS/E3D isometric drawings.
The resulting conversion format, `*.upvd`, can be integrated into a UDiTH model and linked intelligently.

### Notes for conversion with SmartSketch

SmartSketch may not always run completely reliably during the conversion process, which can result in licence seats not being returned properly to the licence server.

To avoid this, we recommend checking out a SmartSketch licence locally before running AdapterForDocuments. Please refer to the Intergraph documentation for details on how to do this.

![](./media/AdapterForDocuments_image10.png)

All Intergraph SmartSketch files are supported.

AdapterForDocuments works with SmartSketch version 2016 or later.

## Conversion of Smart 3D isometric drawings

The first tab, **S3D**, is used for processing Smart 3D isometrics and layout drawings. As with all tabs, this section is activated for processing only when the option is selected.
<img src="./media/AdapterForDocuments_image11.jpg" width="587" height="717">

This button enables processing of the isometric drawing into a `UPVD` file.

**AdapterForDocuments** starts **SmartSketch** and extracts the drawings into a `UPVD` file.

When you combine the `UPVD` file with the 3D model in **UDiTH Builder**, the resulting UPV session contains 3D objects linked to 2D isometric drawings, and vice versa:

<table>
<tr><td>

<img src="./media/AdapterForDocuments_image12.png" width="317" height="240">

</td><td>

<img src="./media/AdapterForDocuments_image13.png" width="317" height="240">

</td></tr>
</table>

## Conversion of PDF files

**AdapterForDocuments** can integrate all types of PDF file into a UDiTH model. When this section is activated, you only need to browse to a folder in the file system. The complete folder structure beneath that folder is then read and processed.

With an optional mapping file, all necessary links between the PDF and the relevant conditions in the model can be configured accordingly.

<img src="./media/AdapterForDocuments_image14.jpg" width="704" height="563">

An example for a mapping file is available in "C:\\Program Files
(x86)\\CAXperts\\AdapterForDocuments\\Templates\\PDF-Mapping.xlsx"

The synchronise button writes all links into the selected mapping-file.

## Conversion of PDMS/E3D isometric drawings

**AdapterForDocuments** can also convert PDMS/E3D isometrics. The converted isometrics include intelligent hotspots for all parts except straight pipes, so they have a direct link to the 3D model, just like S3D isometrics.

For this to work, the isometrics must be exported from PDMS as PDFs together with their hit files. This is an option within PDMS iso creation.

<img src="./media/AdapterForDocuments_image18.png" width="485" height="538">

## Additional settings

By default, AdapterForDocuments allows a single drawing name.

<img src="./media/AdapterForDocuments_image15.png" width="641" height="427">

## Command line mode

**AdapterForDocuments** can also be started in command line mode. To get all
parameters directly in a command window, just type:

\"C:\\Program Files
(x86)\\CAXperts\\AdapterForDocuments\\AdapterForDocuments.exe\" /?

<img src="./media/AdapterForDocuments_image16.png" width="589" height="125">

Available parameters are:

-output:D:\\path\\to\\file.upvd (Occurance: ExactlyOnce, Help Text: Path
to the output file)\
-sp3dfolder:C:\\drawings (Occurance: AtMostOnce, Help Text: Path to the
sp3d input folder)\
-pdffolder:C:\\pdfs (Occurance: AtMostOnce, Help Text: Path to the pdf input folder)\
-pdmse3dfolder:C:\pdmsE3d (Occurance: AtMostOnce, Help Text: Path to the pdmsE3d input folder)
-pdfmappingfile:C:\\pdfConfiguration\\mapping.xlsx (Occurance: AtMostOnce, Help Text: Path to the pdf mapping input file)\
-hierarchicalupdate (Occurance: AtMostOnce, Help Text: Determines
whether the dircetory structure of moved drawings should be updated)\
-onlycheckednodes (Occurance: AtMostOnce, Help Text: If selected, only
the checked nodes/drawings/pdfs will be updated/added. Otherwise all
nodes in all sub folder of the given folder will be considered).

Possible syntax for command-line:

\"C:\\Program Files
(x86)\\CAXperts\\AdapterForDocuments\\AdapterForDocuments.exe\"
-output:D:\\path\\file.upvd -sp3dfolder:C:\\drawings -pdffolder:C:\\pdfs -pdfmappingfile:C:\\pdfConfiguration\\mapping.xlsx

## Log files

The software creates log files in the local TEMP directory (e.g.
"C:\\Temp\\AdapterForDocuments\\". The user can also open these files by
double-clicking on the CAXperts **AdapterForDocuments** status bar:

<img src="./media/AdapterForDocuments_image17.png" width="682" height="394">