Differences

This shows you the differences between two versions of the page.

--- docs:3400_how_to:0900_other_systems [2026/03/31 06:19] – Removed subpages and created accordion aware_support3
+++ docs:3400_how_to:0900_other_systems [2026/03/31 06:25] (current) – aware_support3
@@ Line 1: / Line 1: @@
 ====== Integration With Other Systems ======
+===== How To... =====
 {{simplenavi>docs:3400_how_to:0900_other_systems}}
@@ Line 31: / Line 32: @@
 </panel>
-<panel type="primary" title="expose a web-service">//**AwareIM**// will automatically expose the services you configure for your system as web services, so that other software systems or web sites can use them – see the “[[docs:2500_config_apps:2000_add_edit_services|Adding/Editing Services]]” section.
+<panel type="primary" title="expose a web-service">
+//**AwareIM**// will automatically expose the services you configure for your system as web services, so that other software systems or web sites can use them – see the “[[docs:2500_config_apps:2000_add_edit_services|Adding/Editing Services]]” section.
+</panel>
+<panel type="primary" title="expose a REST-ful service">
+//**AwareIM**// can expose a service you configure either as a SOAP-based web service or as a REST-ful service or both. For REST-ful services exposed by AwareIM applications that need to call the service need to call a particular URL using the HTTP protocol. This URL should include the AwareIM server name and port where Tomcat listens to requests and also the name of the service to be called and parameters. The default URL where AwareIM will listen to REST-ful requests has the following format:
+http://ServerName:ServerPort/AwareIM/REST/BusinessSpace/ServiceName?parameters
+Parameters are specified as paramName1=paramValue1&paramName2=paramValue2&...
+Where paramName1, paramName2 etc are names of the attributes of a business object that is specified as input to the process implementing the service.
+You can also specify your own custom URL in which case you also need to supply a file called rest.props
+All the details are explained in the “[[docs:2500_config_apps:2000_add_edit_services|Adding/Editing Services]]” section.
+</panel>
+<panel type="primary" title="consume a REST-ful service">
+To do this you need to define an intelligent business object by defining the REST communication channel with the object. This is described in the “[[docs:2500_config_apps:0500_add_edit_objects:0600_intelligent_bo|Defining Intelligent Business Objects]]” section.
+</panel>
+<panel type="primary" title="use a web-service">
+If you want to use an existing web service exposed by some web site then you need to do the following:
+  - Define an intelligent business object representing the web site exposing the web service with System intelligence type – see the “[[docs:2500_config_apps:0500_add_edit_objects:0600_intelligent_bo|Defining Intelligent Business Objects]]” section.
+  - Define the SOAP channel as the default channel for this object. Specify the URL where the WDSL file describing the web service is exposed as the property of the channel – see the “[[docs:2500_config_apps:0500_add_edit_objects:0600_intelligent_bo:0100_setup_soap|Setting Properties of SOAP Channel]]” section (alternatively ask the web service provider for the WSDL file, copy this file to a local file system and specify the URL to this, file, for example: ''file:%%/%%/c:/temp/lookup.wsidl'').
+  - Discover services of the business object – see the “[[glossary:discovering_services|Discovering Services]]” section. The web service you want to use should appear in the list of services exposed by the object.
+  - Define a rule that will request the service of the business object using the ''[[a_f:a:request_service|REQUEST SERVICE]]'' action.
+</panel>
+<panel type="primary" title="register AwareIM application in Facebook">
+In order to allow users to login via Facebook you need to register your AwareIM application with Facebook. In order to do this:
+  * Go to the URL [[https://developers.facebook.com/apps|https://developers.facebook.com/apps]]
+  * Create a new application
+  * When specifying site URL for the application enter the following URL:
+[[http://YourServerName:8080/AwareIM|http://YourServerName:8080/AwareIM]]
+You can use localhost instead of the server name when testing your application.
+When specifying “redirect URI” of the application enter the following URI:
+[[http://YourServerName:8080/AwareIM/req.awfb2|]]
+  * Copy application id and secret that Facebook should assign to your application – you will need these when setting up login options (see [[docs:3400_how_to:0600_users_and_login:0910_login_fb_tw_ggl]] sections)
+When users login to your //**AwareIM**// application they should use the following URL:
+[[http://YourServerName:8080/AwareIM/logon.awfb?domain=YourBusinessSpaceName&testingMode=false|]]
+</panel>
+<panel type="primary" title="register AwareIM application in Twitter">
+In order to allow users to login via Twitter you need to register your AwareIM application with Twitter. In order to do this:
+  * Go to the URL [[https://dev.twitter.com/apps|https://dev.twitter.com/apps]]
+  * Create a new application
+  * When specifying callback URL for the application enter the following URL:
+[[http://YourServerName:8080/AwareIM|http://YourServerName:8080/AwareIM]]
+You can use localhost instead of the server name when testing your application.
+When specifying “redirect URI” of the application enter the following URI:
+[[http://YourServerName:8080/AwareIM/req.awtw2|]]
+  * Copy consumer key and secret that Twitter should assign to your application – you will need these when setting up login options (see [[docs:3400_how_to:0600_users_and_login:0910_login_fb_tw_ggl]] section)
+When users login to your AwareIM application they should use the following URL:
+[[http://YourServerName:8080/AwareIM/logon.awtw?domain=YourBusinessSpaceName&testingMode=false|]]
+</panel>
+<panel type="primary" title="register AwareIM application in Google">
+In order to allow users to login via Google you need to register your //**AwareIM**// application with Google. In order to do this:
+  * Go to the URL [[https://code.google.com/apis/console|]]
+  * Create a new application
+  * When specifying redirect URI for the application enter the following URI:
+[[http://yourservername:8080/awareim/req.awggl2|]]
+You can use localhost instead of the server name when testing your application.
+When specifying “redirect URI” of the application enter the following URI:
+[[http://YourServerName:8080/AwareIM/req.awggl2|]]
+  * Copy client id and secret that Google should assign to your application – you will need these when setting up login options (see [[docs:3400_how_to:0600_users_and_login:0910_login_fb_tw_ggl]] section)
+  * If using synchronization with the Google Calendar make sure that access to the calendar API is allowed!
+When users login to your //**AwareIM**// application they should use the following URL:
+[[http://YourServerName:8080/AwareIM/logon.awggl?domain=YourBusinessSpaceName&testingMode=false|]]
 </panel>
 </accordion>