Hyperlinks

Information

• PLANTA project supports three different types of hyperlinks
  • HL: Linked files (real hyperlinks)
  • HL: Local files
  • HL: Files in the DB
• They differ in their filing procedure and filing directory as well as in their file editing procedure.

Details

• You can figure out from the data field information which hyperlink type is used in the current module (via F1 in the hyperlink field or via ? Data Field Information in the menu bar) in the Column type field.
• Depending on the type of hyperlink there are different context menu commands.
  • For read only hyperlinks not all context menu commands are available.

Note

• The maximum length of file names for HL: local files and HL: files in the DB is 75 characters.

See also: Hyperlink-Customizing

Create Hyperlink/Hyperlink File

Information

• In general, the procedure of creating a hyperlink and a hyperlink file is the same for all three types of hyperlinks. Only the filing procedure and the filing directory are different:
  • HL: Linked file: When creating a hyperlink, only a link to the already existing file is created.
  • HL: Local files: Upon creation of a hyperlink, a copy of the source file is saved to the local directory.
  • HL: Files in the DB: When creating a hyperlink, a copy of the source file is saved to a temporary directory and to the local directory at the same time.

Weblinks & Directories

• Furthermore, it is possible to create links to local directories or internet links for all three types of hyperlinks, just the way this is done for files. This can be done e.g. by dragging a directory or internet link to a hyperlink field or via the context menu (Insert command (see below)) The only difference is that instead of a file, only information on the type and destination of the link is saved. The link is opened immediately when it is clicked (in Windows Explorer or the default webbrowser).

Create Hyperlink by Selecting and Inserting a File from the Directory

Procedure

• Right-click on the data field in which you wish to insert the hyperlink.
  • The context menu is opened.
• Select the Insert command.
• Click on the Search button in the dialog window.
  • Alternatively, type in part of the required path into the input field or click on the arrow key in the input field. A listbox with a list of recently opened files is opened. Select the required area.
    • Depending on whether you type in manually or use the arrow key, the listbox reacts differently.
      • If it is opened by typing in a string, it is dynamic and can be enlarged if necessary.
      • If it is opened by clicking on the arrow key, it is static and its size cannot be changed.
• Select the file from the required directory.
• Click on Open.
  • The selected path is displayed in the dialog window.
• Click on OK in the dialog window.
  • The hyperlink is inserted into the required field.
• Save in module.
• Depending on the type of hyperlink, the hyperlink file is either saved
  • in the local directory (HL: Local files) or
  • in the temporary directory and in the database at the same time (HL: Files in the database) or
  • no file but only a link is created (HL: Linked files).

Create Hyperlink by Inserting a File from the Clipboard

Procedure

• Copy the required file into the clipboard.
• Right-click on the data field in which you wish to insert the hyperlink.
  • The context menu is opened.
• Select the Insert from clipboard command .
  • The hyperlink is inserted in the hyperlink field.
• Save in module.
• Depending on the type of hyperlink, the hyperlink file is either saved
  • in the local directory (HL: Local files) or
  • in the temporary directory and in the database at the same time (HL: Files in the database) or
  • no file but only a link is created (HL: Linked files).

Create Hyperlink by Inserting a File via Drag&Drop from the Directory

Procedure

• Via Drag&Drop you can directly drag the required element from the explorer to the hyperlink field.
• Save in module.
• Depending on the type of hyperlink, the hyperlink file is either saved
  • in the local directory (HL: Local files) or
  • in the temporary directory and in the database at the same time (HL: Files in the database) or
  • no file but only a link is created (HL: Linked files).

Create Hyperlink by Copying an Already Existing Hyperlink

Procedure

• Right-click on the source hyperlink (the hyperlink to be copied).
  • The context menu is opened.
• Select the Copy command.
• Select the Insert from clipboard command by right-clicking in the required target hyperlink field.
• Save in module.
• Depending on the type of hyperlink, the hyperlink file is either saved
  • in the local directory (HL: Local files) or
  • in the temporary directory and in the database at the same time (HL: Files in the database) or
  • no file but only a link is created (HL: Linked files).

Note

• Please note that after copying the hyperlinks, although they have the same name, they are different hyperlinks with each having a separate file in the local directory/database. It is therefore recommended that you rename the copied hyperlink.

Create Hyperlink by Copying a Template File

Note

• The function is only available for HL: local files

Procedure

• Insert a new record containing an appropriate hyperlink field.
• Save.
• Confirm the File: Copy file from template? dialog message with Yes.
  • A copy of the template defined by the customizer is inserted in the hyperlink field.

Edit Hyperlink/Hyperlink File

Edit Hyperlink

Procedure

• Right-click on the hyperlink and select the context menu command Edit hyperlink.
  • The dialog window is opened.
• Change the text of the hyperlink or insert another hyperlink by selecting the Search button and save.

Edit Hyperlink File for HL: local files and HL: linked files

Procedure

• Click on the required hyperlink or select the command Open from the context menu.
• The control interface is opened.
• Change data and save

Note

• If 2 users access the same hyperlink simultaneously, the user who was first to open the hyperlink file is allowed to edit it. The second user can only view the file in read-only mode.

Edit Hyperlink File for HL: files in the DB

Procedure

• Click on the required hyperlink or select the command Open from the context menu.
• The control interface is opened.
  • As a result, the file is copied from the database into the temporary directory and opened there. The file is opened directly from the database.
  • Change data and save.
• If changes are to be applied to the database as well, the file has to be uploaded to the database.
  • To do so, right-click on the hyperlink and select Upload file from the context menu.
• If the file is not changed it remains in the temporary directory throughout the session and can be edited afterwards.
• If the file is not to be uploaded or changes are to be discarded, the file can be reset to the original date.
  • To do so, right-click the hyperlink and select Reset file from the context menu.
    • As a result, the file is deleted from the temporary direction.
• If the file is neither uploaded nor reset, a message appears when you close the program, informing you that there is changed data. If the message is confirmed with OK, the program is closed and the changed data is not uploaded.

Details

• The name of the hyperlink file can be changed via the Rename file context menu command.

Parallel Editing of Hyperlink Files

• If 2 users access the same hyperlink independently, the user who was first to open the hyperlink file is allowed to edit it.
• Hence, both users can edit and save their own copy.
• The user who is first to upload its file can do so without any problems.
• When the second user tries to upload its file, it gets the following message: Database conflict
  • When clicking the buttons, there are following options:
    • Compare: Comparing both versions and deciding later what to do.
      • As a result, the latest version from the database is opened (the first user's file) and can be compared to the own version.
    • Reload: Discard changes and load and open the latest version from the database (the first user's file)
    • Overwrite: Discard changes made by other user and save own changes.
    • Back

Downloads Window

Information

• The Downloads window helps the user to get an overview of the files downloaded from the database and/or already changed files.
• In this window, hyperlinks can be edited even if the module from which they were opened has already been closed.

Details

Delete Hyperlink/Hyperlink File

Procedure

• Right-click on the required hyperlink and select the Delete hyperlink command from the context menu.
  • As a result, the hyperlink is deleted from the hyperlink field and depending on the type of hyperlink it is
    • deleted from the local directory
    • from the database and the temporary directory (in case the file was downloaded before).
    • For linked files, only the link is deleted, not the file itself.

Note

• If a record containing a hyperlink is deleted entirely, the hyperlink as well as the hyperlink file are deleted.

Read-Only Access to Hyperlinks

Information

• If a specific hyperlink was defined as read-only hyperlink by the customizer upon integration, the user may open and view the corresponding hyperlink file but it can't be changed (the file is opened in read-only mode).
• The hyperlink itself must not be edited either. You can choose between the following two context menu commands: Open and Copy.