intouch v2.2.3 guide - m. ... the intouch web service can communicate with multiple intouch data...

Download inTouch v2.2.3 guide - m. ... The inTouch Web Service can communicate with multiple inTouch Data Services

Post on 11-Mar-2020

1 views

Category:

Documents

0 download

Embed Size (px)

TRANSCRIPT

  • inTouch v2.2.3

    www.bondadapt.com Copyright 2015 - Bond International Software

    v2.2.3

    Version: 1.2 Date: September 2015 Authors: C.Dewar-English, A.Taperek

    Information and installation pack

    http://www.bondadapt.com

  • inTouch v2.2

    Features are dependent on Adapt version and inTouch service version. See the Compatibility Chart (Appendix III) for further details.

    Main Features • Fully connected with live data • Configurable searches tailored to your

    requirements • Configurable record views • Integrates with Email and Phone

    functions • View Tasks, Diary and Journal • Run Workflow • Document Library access • Favourites synchronised with Adapt

    New in v2.2 • Full support for Android, Windows Phone,

    Blackberry etc. via the mobile web service • Improved and simplified server installation • inTouch system configuration console (for easy

    system setup) • Various bug fixes and enhancements

    www.bondadapt.com Copyright 2015 - Bond International Software

    v2.2.3

    http://www.bondadapt.com

  • inTouch components

    Device (App or mobile web browser) Native iOS app for iPhone/iPod Touch/iPad Mobile web site for modern smartphones Communicates with inTouch Web Service

    Web Service Running in IIS 6 or later Communicates with Devices Communicates with inTouch Data Service

    Data Service Standard Windows Service Communicates with inTouch Web Service Communicates with Adapt via the V11 Web Services

    Quick setup

    Quick setup

    inTouch is comprised of three components - the mobile device and two inTouch services

    1

    2

    3

    www.bondadapt.com Copyright 2015 - Bond International Software

    v2.2.3

    http://www.bondadapt.com

  • Devices inTouch

    Web Service inTouch

    Data Service

    Standard

    Multiple Adapt

    Systems

    e.g. OnDemand

    Load Balanced

    Web Servers

    One Web Server, multiple Data

    Servers

    Adapt

    The inTouch Web Service can communicate with multiple inTouch Data Services on different servers

    The inTouch Data Service can communicate with multiple Adapt Systems on different servers

    Flexible configurations The inTouch services can be installed in various configurations depending on architecture and individual requirements.

    www.bondadapt.com Copyright 2015 - Bond International Software

    v2.2.3

    http://www.bondadapt.com

  • Installation This inTouch v2.2 setup guide is for use with inTouch with Adapt v11 only.

    Adapt v9 requires the inTouch v2.1 services (with Adapt Net Tools). See the inTouch v2.1 installation guide for further details.

    www.bondadapt.com Copyright 2015 - Bond International Software

    v2.2.3

    http://www.bondadapt.com

  • Prerequisites

    1. A working Adapt v11 system • 11.7 / 9.1

    • or 11.6.8 SP6 or higher (with supplemental Business Objects for workflow, available from:

    https://m.adaptondemand.com/intouch/resources/)

    2. A Windows server which can connect to Adapt to host the Data Service (Can be the existing Adapt application server)

    • Windows Server 2003 R2 or later

    • .NET framework 4.0 or later

    3. A web server which can connect to the Adapt Data Service • Windows Server 2003 R2 or later

    • .NET framework 4.0 or later

    • IIS 6.0 or later

    • TLS/SSL certificate

    inTouch requires the following components:

    www.bondadapt.com Copyright 2015 - Bond International Software

    v2.2.3

    https://m.adaptondemand.com/intouch/resources/ http://www.bondadapt.com

  • Step 1. Data Service Installation

    1. Download the latest release of the Data Service Installer from:

    https://m.adaptondemand.com/intouch/resources/

    There is both a 32 and 64-bit version of the Data Services. Make sure you install the correct version for the platform your server is using. See Appendix I for details

    2. Run the Windows Installer package (.msi)

    3. Specify the install location

    4. Specify a communication port (e.g. 9009) - ensure the firewall allows incoming connections

    from the web server to this port.

    5. Complete the installation

    6. Check the service is running: Bond Mobile Data Access Service (v2.2)

    Check the Windows Event Viewer (Application Log) for additional details.

    All steps complete

    4

    6

    3

    Install the inTouch data service on any machine on the Adapt network

    www.bondadapt.com Copyright 2015 - Bond International Software

    v2.2.3

    https://m.adaptondemand.com/intouch/resources/ http://www.bondadapt.com

  • Step 2. Web Service Installation

    1. Download the latest release of the Web Service Installer from:

    https://m.adaptondemand.com/intouch/resources/

    There is both a 32 and 64-bit version of the Web Services. Make sure you install the correct version for the platform your server is using. See Appendix I for details.

    2. Run the Windows Installer package (.msi)

    3. Specify the install location

    4. Choose the platform type which IIS is running under (32-bit or 64-bit), this may be different to the

    computer’s actual architecture.

    3

    4

    Install the inTouch web service on a secure Web Server running IIS 6 or 7

    Continued...

    If you are installing the 32-bit version of the web services, the page shown to the right does not appear during the installation and 32-bit is automatically selected.

    (See Appendix II for additional details on determining the platform for the IIS application pool)

    www.bondadapt.com Copyright 2015 - Bond International Software

    v2.2.3

    https://m.adaptondemand.com/intouch/resources/ http://www.bondadapt.com

  • Step 2. Web Service Installation

    5. Specify whether the web service will be accessed over HTTPS (recommended) or HTTP

    HTTPS Secure connections will require a TLS/SSL certificate which can be obtained from a Certificate Authority (CA)

    http://en.wikipedia.org/wiki/Certificate_authority

    6. Specify the external web address.

    i.e. the full URL including Domain name

    7. Create the web service management console user

    Specify a secure password (you will use this username and password later)

    8. Complete the installation

    5

    6

    7

    (continued)

    All steps complete

    www.bondadapt.com Copyright 2015 - Bond International Software

    v2.2.3

    http://en.wikipedia.org/wiki/Certificate_authority http://www.bondadapt.com

  • Step 3a. IIS 7 configuration

    1. Launch IIS Manager

    2. Right-click the folder where you installed the web services

    3. Choose Convert to Application

    4. Click OK

    5. Complete any other non-Adapt IIS tasks, such as installing a TLS certificate

    6. Complete any other non-Adapt IIS tasks, such as installing a TLS certificate. The server must have

    the correct .NET framework installed, as well as the .svc ASAPI filters and HTTP-activation components

    (installed via Control Panel’s Add Windows features options)

    2

    3

    The following steps apply only if you are using IIS 7.

    All steps complete

    www.bondadapt.com Copyright 2015 - Bond International Software

    v2.2.3

    http://www.bondadapt.com

  • Step 3b. IIS 6 configuration 1. Launch IIS Manager

    2. View the properties for the folder where you installed the web services

    3. Click Create to convert to an application

    4. Click Configuration...

    5. In the upper section, Edit the Application Extension for “.aspx”

    6. Ensure the Executable is set to:

    C:\WINDOWS\microsoft.net\Framework\v4.0.30319\aspnet_isapi.dll

    Click OK

    7. In the lower section, Insert a Wildcard Application Map:

    8. Set the Executable to:

    C:\WINDOWS\microsoft.net\Framework\v4.0.30319\aspnet_isapi.dll

    Un-Check Verify that file exists

    Click OK

    9. Click OK

    10. Complete any other non-Adapt IIS tasks, such as installing a TLS certificate. The server must have

    the correct .NET framework installed, as well as the .svc ASAPI filters and HTTP-activation

    components (installed via Control Panel’s Add Windows features options)

    3 4

    5 7

    6

    8

    The following steps apply only if you are using IIS 6.

    All steps complete

    www.bondadapt.com Copyright 2015 - Bond International Software

    v2.2.3

    http://www.bondadapt.com

  • Step 4. Adapt Setup

    1. Log into Adapt V11 SysAdmin

    2. Edit the WebUser profile

    3. Under the WebServices section ensure Metadata access is ticked.

    4. Create a new user used for inTouch background processes (This is to allow codes,

    config and roles retrieval)

    5. Assign the new user to the WebUser Profile

    All steps complete

    3

    5

    2

    4

    www.bondadapt.com Copyright 2015 - Bond International Software

    v2.2.3

    http://www.bondadapt.com

  • Step 5. System setup

    1. Navigate to the website’s /console page

    e.g. https://abcrecruit.co.uk/bondmobilewebservices/console

    2. Login with the