Views

Difference between revisions of "How to set up an OpenStage XML Application"

The Wiki of Unify contains information on clients and devices, communications systems and unified communications. - Unify GmbH & Co. KG is a Trademark Licensee of Siemens AG.

Jump to: navigation, search
m
 
(11 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 +
{{Breadcrumb|0|0|{{dev-en}}|OpenStage|OpenStage XML Applications}}
 +
 
== Scope ==
 
== Scope ==
 
Follow this step-by-step instructions to set up an example XML application on your [[OpenStage SIP|OpenStage]] 60/80. The application will display a weather forecast for a region of your own choice.
 
Follow this step-by-step instructions to set up an example XML application on your [[OpenStage SIP|OpenStage]] 60/80. The application will display a weather forecast for a region of your own choice.
Line 15: Line 17:
  
 
=== Setup Using the Web Interface ([[WBM]]) ===
 
=== Setup Using the Web Interface ([[WBM]]) ===
# Open your web browser and enter the transfer protocol, IP address and port number of your phone. If HTTP is used, port 8085 must be added, for example <code>http://192.168.1.15:8085</code>. For HTTPS, the phone uses the standard port (<code>443</code>), for example: <code>https://192.168.1.15</code>. If the browser displays a certificate notification, confirm it.<br>In the upper right corner of the web page, the phone's call number, IP address, and DNS name are displayed. The left column contains the user menu tree.[[Image:XML_apps-screenshot-wbm-homepage.gif|250px|none]]<br>
+
# Open your web browser and enter the transfer protocol, IP address and port number of your phone. If HTTP is used, port 8085 must be added, for example <tt>http://192.168.1.15:8085</tt>. For HTTPS, the phone uses the standard port (<tt>443</tt>), for example: <tt>https://192.168.1.15</tt>. If the browser displays a certificate notification, confirm it.<br>In the upper right corner of the web page, the phone's call number, IP address, and DNS name are displayed. The left column contains the user menu tree.[[Image:XML_apps-screenshot-wbm-homepage.gif|250px|none]]<br>
# Click on the <code>Administrator Pages</code> tab. In the dialog box, enter the admin password:[[Image:XML_apps-screenshot-wbm-admin-login.gif|250px|none]]<br>
+
# Click on the <tt>Administrator Pages</tt> tab. In the dialog box, enter the admin password:[[Image:XML_apps-screenshot-wbm-admin-login.gif|250px|none]]<br>
 
# The administration main page opens. The left column now contains the menu tree. If you click on an item which is printed in normal style, the corresponding dialog opens in the center of the page. If you click on an item printed in bold letters, a sub-menu opens in the right column.<br>
 
# The administration main page opens. The left column now contains the menu tree. If you click on an item which is printed in normal style, the corresponding dialog opens in the center of the page. If you click on an item printed in bold letters, a sub-menu opens in the right column.<br>
# Navigate to <code>Applications</code> > <code>XML applications</code> > <code>Add application</code> and enter the required data. [[Image:XML_apps-screenshot-add_application.png|250px|none]]The following settings are required to set up the application:
+
# Navigate to <tt>Applications</tt> > <tt>XML applications</tt> > <tt>Add application</tt> and enter the required data. [[Image:XML_apps-screenshot-add_application.png|250px|none]]The following settings are required to set up the application:
## <code>Display name</code>: <code>Weather</code>
+
## <tt>Display name</tt>: <tt>Weather</tt>
## <code>Application name</code>: <code>Weather</code>
+
## <tt>Application name</tt>: <tt>Weather</tt>
## <code>Server address</code>: <code>87.106.21.36</code>
+
## <tt>Server address</tt>: <tt>87.106.21.36</tt>
## <code>Server port</code>: <code>8080</code>
+
## <tt>Server port</tt>: <tt>8080</tt>
## <code>Protocol</code>: <code>http</code>
+
## <tt>Protocol</tt>: <tt>http</tt>
## <code>Program name</code>: <code>WR/WR</code>
+
## <tt>Program name</tt>: <tt>WR/WR</tt>
## <code>Use Proxy</code>: <code>Yes/No</code> (Depends on your internet access configuration; if a proxy is needed, see for {{File-DL|Administration Manual OpenStage HiPath 8000|pdf}}, chapter 3.12.1.2 for instructions)
+
## <tt>Use Proxy</tt>: <tt>Yes/No</tt> (Depends on your internet access configuration; if a proxy is needed, see for {{File-DL|Administration Manual OpenStage OpenScape Voice|pdf}}, chapter 3.12.1.2 for instructions)
# When the configuration data is correct and complete, click on <code>Submit</code>. Now you can [[#Testing_the_XML_Application|test]] the Application.
+
# When the configuration data is correct and complete, click on <tt>Submit</tt>. Now you can [[#Testing_the_XML_Application|test]] the Application.
  
 
=== Setup Using the Local Phone Menu ===
 
=== Setup Using the Local Phone Menu ===
# Press the menu key repeatedly until the <code>Settings</code> tab is active (the key toggles between the <code>Settings</code> menu, the <code>Applications</code> menu, and the applications currently running.) [[Image:Navkeys-menu.gif|250px|none]]<br>
+
# Press the menu key [[Image:XML_apps-operakey_menu_wp3.jpg]] repeatedly until the <code>Settings</code> tab is active (the key toggles between the <code>Settings</code> menu, the <code>Applications</code> menu, and the applications currently running).<br>The key is located in the mode keys area: [[Image:Navkeys-menu.gif|250px|none]]<br>
 
# With the [[TouchGuide]], navigate to the Admin menu and press <code>OK</code>. [[Image:XML_apps-screenshot-admin.png|250px|none]]<br>
 
# With the [[TouchGuide]], navigate to the Admin menu and press <code>OK</code>. [[Image:XML_apps-screenshot-admin.png|250px|none]]<br>
 
# You are prompted to enter the administrator password. <br>If the password is numeric, just type it using the number keys. On typing the first digit, an input text field will open up. <br>For entering non-numeric characters, press the [[Image:osk-rau.gif]] key once or repeatedly, depending on the desired character. The [[Image:osk-rau.gif]] key cycles around the input modes as follows: (Abc) -> (abc) -> (ABC) -> (123) -> back to start. [[Image:XML_apps-screenshot-password.png|250px|none]] To correct an entry, use this key on the [[TouchGuide]]: [[Image:XML_apps-touchguide-back.gif|100px|none]]<br>
 
# You are prompted to enter the administrator password. <br>If the password is numeric, just type it using the number keys. On typing the first digit, an input text field will open up. <br>For entering non-numeric characters, press the [[Image:osk-rau.gif]] key once or repeatedly, depending on the desired character. The [[Image:osk-rau.gif]] key cycles around the input modes as follows: (Abc) -> (abc) -> (ABC) -> (123) -> back to start. [[Image:XML_apps-screenshot-password.png|250px|none]] To correct an entry, use this key on the [[TouchGuide]]: [[Image:XML_apps-touchguide-back.gif|100px|none]]<br>
Line 41: Line 43:
 
## <code>Protocol</code>: <code>http</code>
 
## <code>Protocol</code>: <code>http</code>
 
## <code>Program name</code>: <code>WR/WR</code>
 
## <code>Program name</code>: <code>WR/WR</code>
## <code>Use Proxy</code>: <code>Yes/No</code> (Depends on your internet access configuration; if a proxy is needed, see for {{File-DL|Administration Manual OpenStage HiPath 8000|pdf}}, chapter 3.12.1.2 for instructions)
+
## <code>Use Proxy</code>: <code>Yes/No</code> (Depends on your internet access configuration; if a proxy is needed, see for {{File-DL|Administration Manual OpenStage OpenScape Voice|pdf}}, chapter 3.12.1.2 for instructions)
 
# When finished, navigate to <code>Save & exit</code> and press <code>OK</code>. [[Image:XML_apps-screenshot-admin-add_weather.png|250px|none]]
 
# When finished, navigate to <code>Save & exit</code> and press <code>OK</code>. [[Image:XML_apps-screenshot-admin-add_weather.png|250px|none]]
  
Line 47: Line 49:
  
 
== Testing the XML Application ==
 
== Testing the XML Application ==
# Press the menu/applications key once or repeatedly until the '''Applications''' tab is active. '''Weather''' is available.
+
# Press the menu key [[Image:XML_apps-operakey_menu_wp3.jpg]] once or repeatedly until the <code>Applications</code> tab is active. <code>Weather</code> is available.
# Start '''Weather''' by pressing '''OK'''. If everything went well, you see the start screen of the application. [[Image:XML_apps-screenshot-weather.png|250px|none]]
+
# Start <code>Weather</code> by pressing <code>OK</code>. If everything went well, you see the start screen of the application. [[Image:XML_apps-screenshot-weather.png|250px|none]]
  
 
== See Also ==
 
== See Also ==
* [[Preview:OpenStage_XML_Applications]]
+
* [[OpenStage XML Applications]]
* {{File-DL|Administration Manual OpenStage HiPath 8000|pdf}} - Chapter 3.12.1 explains the setup/configuration of XML applications via local phone menu
+
* {{File-DL|Administration Manual OpenStage OpenScape Voice|pdf}} - Chapter 3.12.1 explains the setup/configuration of XML applications via local phone menu
 
* {{File-DL|Deployment-Service en|pdf}} - Chapter 7.1.14.4 explains the setup/configuration of XML applications via local phone menu via [[DLS]]
 
* {{File-DL|Deployment-Service en|pdf}} - Chapter 7.1.14.4 explains the setup/configuration of XML applications via local phone menu via [[DLS]]

Latest revision as of 07:24, 28 April 2011

Scope

Follow this step-by-step instructions to set up an example XML application on your OpenStage 60/80. The application will display a weather forecast for a region of your own choice.

Prerequisites

For setting up and running the example XML application, you need the following:

  • An OpenStage 60/80 phone with appropriate SIP firmware (version V1R3.x). (Currently, only the SIP variant supports XML applications.)
  • Internet access for the phone, directly or via proxy. Connections to port 8080 over HTTP must be possible.

Set up an XML Application

There are three ways to set up and configure an XML application on an OpenStage phone:

  • Local Phone Menu: The graphical user interface provided by OpenStage 60/80.
  • WBM (Web Based Management): The web interface provided by all OpenStage phones. It allows the user and administrator to configure the phone using a web browser.
  • DLS (Deployment Service): A versatile administration tool for IP phones.

Setup Using the Web Interface (WBM)

  1. Open your web browser and enter the transfer protocol, IP address and port number of your phone. If HTTP is used, port 8085 must be added, for example http://192.168.1.15:8085. For HTTPS, the phone uses the standard port (443), for example: https://192.168.1.15. If the browser displays a certificate notification, confirm it.
    In the upper right corner of the web page, the phone's call number, IP address, and DNS name are displayed. The left column contains the user menu tree.
    XML apps-screenshot-wbm-homepage.gif

  2. Click on the Administrator Pages tab. In the dialog box, enter the admin password:
    XML apps-screenshot-wbm-admin-login.gif

  3. The administration main page opens. The left column now contains the menu tree. If you click on an item which is printed in normal style, the corresponding dialog opens in the center of the page. If you click on an item printed in bold letters, a sub-menu opens in the right column.
  4. Navigate to Applications > XML applications > Add application and enter the required data.
    XML apps-screenshot-add application.png
    The following settings are required to set up the application:
    1. Display name: Weather
    2. Application name: Weather
    3. Server address: 87.106.21.36
    4. Server port: 8080
    5. Protocol: http
    6. Program name: WR/WR
    7. Use Proxy: Yes/No (Depends on your internet access configuration; if a proxy is needed, see for pdf.png  Administration Manual OpenStage OpenScape Voice, chapter 3.12.1.2 for instructions)
  5. When the configuration data is correct and complete, click on Submit. Now you can test the Application.

Setup Using the Local Phone Menu

  1. Press the menu key XML apps-operakey menu wp3.jpg repeatedly until the Settings tab is active (the key toggles between the Settings menu, the Applications menu, and the applications currently running).
    The key is located in the mode keys area:
    Navkeys-menu.gif

  2. With the TouchGuide, navigate to the Admin menu and press OK.
    XML apps-screenshot-admin.png

  3. You are prompted to enter the administrator password.
    If the password is numeric, just type it using the number keys. On typing the first digit, an input text field will open up.
    For entering non-numeric characters, press the osk-rau.gif key once or repeatedly, depending on the desired character. The osk-rau.gif key cycles around the input modes as follows: (Abc) -> (abc) -> (ABC) -> (123) -> back to start.
    XML apps-screenshot-password.png
    To correct an entry, use this key on the TouchGuide:
    XML apps-touchguide-back.gif

  4. On pressing OK, the admin menu opens. With the TouchGuide, navigate to the Applications item.
    XML apps-screenshot-admin-applications.png
    To navigate, you can either run your finger around the sensor ring, or press the up/down keys:
    XML apps-touchguide-up-down.gif

  5. Press OK to open the Applications item and select XML. On pressing OK again, Add application appears in the context menu.
    XML apps-screenshot-admin-add application.png
    Press OK to open the XML application menu.
  6. In the application menu, enter the data required to access the example application. For each parameter that must be entered, proceed as follows:
    Navigate to the item to be configured and press OK. Use the keypad to enter data. To toggle between character and number modes, press the osk-rau.gif key, as in step 3. To select special characters, press the osk-ast.gif key. To enter a character, select it first by pressing the accordant keypad key as often as necessary. After a short time, the character is accepted in the parameter field. Thus the input procedure is similar to mobile phones. The screenshot shows the data entry in operation:
    XML apps-screenshot-dispkeypad.png
    (For more information about data entry, see the pdf.png  User Manual OpenStage 60-80 SIP)
    The following settings are required to set up the application:
    1. Display name: Weather
    2. Application name: Weather
    3. Server address: 87.106.21.36
    4. Server port: 8080
    5. Protocol: http
    6. Program name: WR/WR
    7. Use Proxy: Yes/No (Depends on your internet access configuration; if a proxy is needed, see for pdf.png  Administration Manual OpenStage OpenScape Voice, chapter 3.12.1.2 for instructions)
  7. When finished, navigate to Save & exit and press OK.
    XML apps-screenshot-admin-add weather.png


Testing the XML Application

  1. Press the menu key XML apps-operakey menu wp3.jpg once or repeatedly until the Applications tab is active. Weather is available.
  2. Start Weather by pressing OK. If everything went well, you see the start screen of the application.
    XML apps-screenshot-weather.png

See Also