Convert Brava! stamps to the new upgraded format - HxGN SDx - Update 43 - Installation & Upgrade

HxGN SDx Upgrade

Language
English (United States)
Product
HxGN SDx
Search by Category
Installation & Upgrade
SmartPlant Foundation / SDx Version
10

Update 36 and later delivers PDFTron, which is a view control utilized for View and Markup of certain file types.

You must perform the following steps before upgrading your environment. See Configure the PDFTron view control after upgrading your environment.

What file types are supported in the PDFTron view control?

The following file types are supported in this view control:

File format

Native application

File extension

CAD

AutoCAD Drawing

.dwg

AutoCAD Drawing Interchange Format

.dxf

MicroStation Design File

.dgn

Image

JPEG File Interchange

.jpg

Microsoft Windows Bitmap

.bmp

Portable Network Graphics

.png

Tagged Image File

.tif

Microsoft Office

Excel

.xls

Excel Open XML

.xlsx

Excel (Macros)

.xlsm

PowerPoint

.ppt

PowerPoint Open XML

.pptx

Word

.doc

Word Open XML

.docx

Word (Macros)

.docm

Text

Adobe Portable Document Format

PDF

Comma Separated Values

.csv

Text

.txt

Follow the expandable steps below for each stamp:

  1. Install the required software for the conversion process:

    • Google Chrome or Microsoft Edge

    • A text editor, such as Notepad

    • A Scalable Vector Graphics (SVG) editor, such as Inkscape

  2. Convert the stamps from XSP to SVG:

    Converting the Stamp to SVG

    You must repeat these steps for each stamp you want to convert.

    1. Prior to upgrading to PDFTron, view a file in the Web Client using Google Chrome or Microsoft Edge.

    2. Create a markup layer, adding a stamp you want to convert. Do not add any other markup elements.

    3. Clear the selection by switching to selection mode and clicking away from the stamp.

    4. Press F12 to open DevTools.

    5. Click Inspector, and select the stamp or an element of the stamp.

      This highlights both the text in the DevTools and the element in the browser window.

    6. Scroll slowly until the entire stamp is selected.

      The <g element should be selected; it is located about a dozen lines below the <svg element. It can contain any number of lines, possibly over 100.

    7. Right-click the <g element and select Copy > Copy HTML.

    8. Paste into a TXT file and save using the stamp file name with the SVG file extension.

  3. Make the stamps valid:

    Making the SVG Stamp File Valid

    After converting the stamp to SVG, you must make the file valid. Again, you must repeat these steps for each SVG stamp file you create.

    1. Open the SVG file using a text editor, such as Notepad.

    2. Remove all instances of xlink: from the file.

    3. Add the following to the beginning of the file:

      <svg xmlns="http://www.w3.org/2000/svg" overflow="hidden" width="400" height="200" viewBox="0 -300 600 300">

    4. Add the following to the end of the file:

      </svg>

    5. Find the first instance of matrix and replace the numbers inside the parentheses with the following:

      1,0,0,-1,0,0

    6. Find the second instance of matrix and replace the numbers inside the parentheses with the following:

      1,0,0,1,0,0

    7. Save changes.
      SHARED Tip You can view the new stamp file in Google Chrome or Microsoft Edge by right-clicking the file and selecting Open With > Google Chrome or Open With > Microsoft Edge. Only part of the stamp might be visible, or it might be surrounded by white space since the stamp has not been centered.

  4. If the stamp is dynamic, you must make the tokens available in the stamp:

    Making Tokens Available in the SVG Stamp

    If your stamp is dynamic, it might contain tokens. Tokens are placeholder elements used to add data to a stamp when it is created. You must identify which tokens, if any, are included in the stamp. After you identify the tokens, you must enter these new tokens in the SVG stamp file you created.

    1. Open the original XSP stamp file using a text editor, such as Notepad. The XSP files were delivered to [drive]:\ Server Files\SPFWebClient_Sites\[sitename]\viewers\resources\stamps.

    2. Identify any tokens included in the file. The token elements will begin with % and will be surrounded by <TokenTextLine> and </TokenTextLine> tags.

      SHARED Tip Try searching the file using TokenTextLine. If no results are returned, the stamp doesn't contain any tokens.

    3. If the file contains tokens, you must enter those into the SVG stamp file:

      1. Copy the text between the <TokenTextLine> and </TokenTextLine> tags. The token element will begin with %.

      2. Paste the text into a new TXT file for future reference.

      3. Close the XSP file and open the SVG stamp file using Inkscape.

        Do not worry if your stamp image is not visible.

      4. Press F8 to open the text for editing.

      5. Find the <TokenTextLine> and </TokenTextLine> tags and replace the text between the tags with the text copied from the XSP file.

        For example:

        <TokenTextLine>%Prompt(Please enter your name here:)</TokenTextLine>

      6. Save changes.

  5. Adjust the stamp's position:

    Adjusting the Stamp's Position

    Using an SVG editor, reposition your stamp so that it appears centered. The following steps are performed using Inkscape.

    1. Open the SVG stamp file using Inkscape.

    2. Select the stamp in the document.

    3. Press Ctrl+Shift+R to center and position the SVG on the drawing.

    4. Save changes.

  6. Adjust the stamp's sizing:

    Adjusting the Stamp's Sizing

    Using an SVG editor, adjust your stamp's default sizing. The following steps are performed using Inkscape.

    1. Open the SVG stamp file using Inkscape.

    2. Select the stamp in the document.

    3. Click and drag a corner of the stamp while pressing the Ctrl key.

    4. Press Ctrl+Shift+R to recenter and position the SVG on the drawing.

    5. Save changes.

Finish configuring your environment for PDFTron

When you are done, see Configure the PDFTron view control to finish configuring your environment for PDFTron.