## page was renamed from ICARUS-Weblicht
= ICARUS-Weblicht-Perspective =
The {{attachment:weblicht_perspective.png}} perspective provides an easy way to use CLARIN-D Webservices ([[http://weblicht.sfs.uni-tuebingen.de/weblichtwiki/index.php/Main_Page|WebLicht Tübingen]]):

[[ICARUS|{{attachment:navi_up.png|Back to ICARUS Main Page}}]][[extern/ICARUS|Back to ICARUS Main Page]]

<<Anchor(icarus-weblicht-index)>>
== Index: ==
 I. [[#icarus-webchain-toolbar|Webchain Toolbar]]
 I. [[#icarus-webchain-toolbar|Webservice Toolbar]]
 I. [[#how-to-new-webservice|How to create a new webservice]]
 I. [[#how-to-new-webchain|How to create a new Webchain]]

<<Anchor(icarus-webchain-toolbar)>>
=== I. Webchain Toolbar: ===
 * {{attachment:weblicht_webchain_toolbar.png}}
  * {{attachment:weblicht_rename-chain.png}} = Save all {{attachment:webchain.png}} webchains (''ICARUS\data\webchain.xml'')
  * {{attachment:weblicht_execute-chain.png}} = Execute the selected {{attachment:webchain.png}} webchain
  * {{attachment:weblicht_add-chain.png}} = Add New Webchain
  * {{attachment:weblicht_delete-chain.png}} = Delete the selected {{attachment:webchain.png}} webchain
  * {{attachment:weblicht_clone-chain.png}} = Clone the selected {{attachment:webchain.png}} webchain
  * {{attachment:weblicht_rename-chain.png}} = Open dialog to rename the selected {{attachment:webchain.png}} webchain
  * {{attachment:weblicht_edit-chain.png}} = Edit the selected {{attachment:webchain.png}} webchain
  * {{attachment:weblicht_webservice_inspect.png}} = Show {{attachment:webservice.png}} webservice details. Note: read-only mode, to edit the webservice use the {{attachment:weblicht_edit-service.png}} edit webservice button that can be found within the {{attachment:weblicht_webservices.png}} webservice view tab

[[#icarus-weblicht-index|{{attachment:navi_up.png|Back to index}}]][[#icarus-weblicht-index|Back to index]]


<<Anchor(icarus-webservice-toolbar)>>
=== II. WebserviceToolbar: ===
 * {{attachment:weblicht_webservice_toolbar.png}}
  * {{attachment:weblicht_save-service.png}} =Save Webservice
  * {{attachment:weblicht_new-service.png}} = Add Webservice
  * {{attachment:weblicht_delete-service.png}} = Delete Webservice
  * {{attachment:weblicht_clone-service.png}} = Clone Webservice
  * {{attachment:weblicht_edit-service.png}} = Edit Webservice
  * {{attachment:weblicht_sort-service-asc.png}} = Sort webservices in ascending order
  * {{attachment:weblicht_sort-service-desc.png}} = Sort webservices in descending order

[[#icarus-weblicht-index|{{attachment:navi_up.png|Back to index}}]][[#icarus-weblicht-index|Back to index]]


<<Anchor(how-to-new-webservice)>>
=== III. How to create a new webservice: ===
Creating a new webservice require the following steps:

 1. Switch to the {{attachment:weblicht_webservices.png}} tab (on the left)
 1. Click {{attachment:weblicht_new-service.png}} to create a new webservice. Then the new webservice window will show up. [[attachment:weblicht_new-webservice.png|{{attachment:weblicht_new-webservice.png|attachment:weblicht_new-webservice.png|height="200"}}]]
 1. Fill in all the required information and press "ok". Note: The input and output features will be added in step 5.
 1. This will add the webservice to the webservice list to the left. Select the webservice and click {{attachment:weblicht_edit-service.png}} to edit the io-features.
 1. The io-features are all attribute-name/attribute-value pairs. E.g. lang: de (name = lang; value = de), type: text/plain (name=type; value = text/plain) if there is no value only the name must be specified. [[attachment:weblicht_webservice-io.png|{{attachment:weblicht_webservice-io.png|attachment:weblicht_webservice-io.png|width="250"}}]]
 1. Apply all changes - now the webservice may be used within webchains.

Example webservice information (screenshot taken from [[http://weblicht.sfs.uni-tuebingen.de/weblichtwiki/index.php/Main_Page|WebLicht Tübingen]]) [[attachment:weblicht_new-webservice.png|{{attachment:weblicht_example_tcf-converter.png|attachment:weblicht_example_tcf-converter.png|width="300"}}]]

and the resulting ICARUS webservice [[attachment:weblicht_new-webservice.png|{{attachment:weblicht_webservice_icarus.png|attachment:weblicht_webservice_icarus.png|width="300"}}]]

[[#icarus-weblicht-index|{{attachment:navi_up.png|Back to index}}]][[#icarus-weblicht-index|Back to index]]


<<Anchor(how-to-new-webchain)>>
=== IV. How to create a new webchain: ===
Before creating a  new webchain {{attachment:weblicht_webchain.png}} all necessary {{attachment:webservice.png}} webservices {{attachment:weblicht_webservices.png}} must have been speficied.

 1. Switch to the {{attachment:weblicht_webchain.png}} tab (on the left)
 1. Click {{attachment:weblicht_new-service.png}} to create a new webchain. Then the "new webchain dialog" will show up [[attachment:weblicht_webchain_new.png|{{attachment:weblicht_webchain_new.png|attachment:weblicht_webchain_new.png|height="150"}}]]
  * Static Input = The user can specify a string that is always used as an input when executing the webchain.
  * Location = A file is used as input (user must ensure by hisself that the input is a valid / readable file for the io-webervice).
  * Dynamic = Whenever the webchain is executed a dialog shows up where the user may specify a string that will be passed to the webchain.
 1. Add all desired webservices to the chain. Example: {{attachment:weblicht_webchain_edit.png|attachment:weblicht_webchain_edit.png|width="300"}}
 1. For each webchain one output must be specified. The webchain output can be saved to a file or diplayed within ICARUS (dynamic) (if there is a presenter that can handle the output data)
 1. The webchain is executed using {{attachment:weblicht_execute-chain.png}} the button.


Example:
The Webchain shown in 4.) was executed, using "Karin fliegt nach New York. Sie will dort Urlaub machen." as a static input. The output was set to dynamic and therefore the result was passed to the graph outline tab. The resulting parsetree of the two sentences is shown in the figure below:

[[attachment:weblicht_graph-outline-example.png|{{attachment:weblicht_graph-outline-example.png||width=600}}]] 

Any webservices and chains the user created (and saved) can be found in the icarus folder under the following destination: ''icarus\data\weblicht.xml'' (webservices) and ''icarus\data\webchain.xml'' (Webchains).

[[#icarus-weblicht-index|{{attachment:navi_up.png|Back to index}}]][[#icarus-weblicht-index|Back to index]]