==== Background ====

The links can contain variables, which are filled at run-time. Thus, parameterized links are possible.

This is one way to include pieces from a foreign system, for instance links from SAP templates or a link from an archive system.

----

==== Technical Application ====

**Links are added within the modeling environment of the TIM tasks.** Click on an activity or node and then select "Tasks". Now, select the option "Links" from the corresponding task.

For non-parameterized links in a file, include the following code:

<code>
<links>
<link name="Bakery Price List" class="com.dooris.bpm.entities.SimpleUrl"
 url="file:\\tim.intranet\09-PriceList\PriceList-Bakery-2013.xlsx"/>
</links>
</code>

The URL and name of the link must then be changed accordingly.

For non-parameterized links in a folder/shared directory, include the following code:

<code>
<links>
<link name="Bakery-Folder" class="com.dooris.bpm.entities.SimpleUrl"
 url="file:\\tim.intranet\09-PriceList\"/>
</links>
</code>

The URL and name of the link must then be changed accordingly.

For non-parameterized links on a website, include the following code:

<code>
<links>
<link name="Homepage" class="com.dooris.bpm.entities.SimpleUrl" url="http://www.tim-solutions.de"/>
</links>
</code>

For parameterized links on websites, include the following code:

<code>
<links>
<link name="Archivsystem" class="com.dooris.bpm.links.ProcessVariableLink" parameter1="http://archivsystem/SearchformPage.aspx?execute=1&values=${artikelnr}"/>
</links>
</code>

In this case, the variable names must also be changed in addition to the name and URL of the link. Any number of variables may be included in a link. Variables must be one of the existing process variables.

By complying with the following template, any number of links may be added:

<code>
<links>
<link name="Link 1" .../>
<link name="Link 2" .../>
<link name="Link 3" .../>
</links>
</code>

Please note that that the following characters must be replaced by the appropriate XML escape sequence within the URL:

<code>
"   "
'   '
<  <>  >

&   &
</code>

For example, instead of writing

<code>
<links>
<link name="Search" class="com.dooris.bpm.entities.SimpleUrl" url="http://www.tim-solutions.de?search=instances&amount=>0"/>
</links>
</code>

the following (correct) formulation must be used:

<code>
<links>
<link name="Search" class="com.dooris.bpm.entities.SimpleUrl" url="http://www.tim-solutions.de?search=instances&amount=>0"/>
</links>
</code>

----



==== Including links within iGrafx ====

In order to include a link using iGrafx, the following parameters must be included:

  * **To**  : Here, the link is given a meaningful name
  * **URL**  : Here, the destination is given, with the internet or intranet as the location
  * **Class**  : Here, two classes may be available:
== com.dooris.bpm.entities.SimpleLink ==

This class is used in the case of non-parameterized links

== com.dooris.bpm.links.ProcessVariableLink ==

If process variables are to be included in the links, this class must be entered.