iServices

The iServices are web services through which an external application interacts with CampusNexus CRM. The Web Service Definition Language (WSDL) interface acts as an interface between the external application and iServices.

Prerequisites

Identify and install the prerequisite software. See Software Requirements by Component — iServices.

The prerequisites for installing iServices are:

  • The Database component must be installed.

  • Microsoft Microsoft Web Service Enhancement 3.0 (WSE 3.0) and iServices must be installed on the same computer.

    To install WSE 3.0, navigate to the Prerequisites\WSE 3.0 folder and run MicrosoftWSE3.0.msi.

  • You must obtain the following licenses:

    • iService - Service: for installing and using Contact, Account, Interaction, Utils, Reports, and Portal iServices.

    • iService - COF: for installing and using COF iService.

    For information about iServices licenses, contact Anthology Inc. Professional Services.

 

Set Up iServices

  1. In the Installation menu, click iServices. The iServices Settings screen is displayed.  Closed

    iServices Settings

    Note: The iServices are not licensed individually. They are bundled together and are installed all at once. The Options form enables you to change the virtual directory names for the iServices separately.

  2. Click Add to add a line to the Settings screen.

  3. Select an appropriate Action. The following Action values are available:

    • None – Performs no action.

    • Install – Performs a fresh installation or upgrade of a component. You can install or upgrade multiple components at the same time.

    • Uninstall – Removes all subcomponents on that machine and uninstalls the component from Programs and Features.

    Optional: Click Select All to set the Action field to Install for all components listed on this screen. Click Unselect All to set the Action field to None.

  4. Enter the Machine Name for the component to be installed.

  5. Click copy icon to copy a line. Edit the copied line as needed.

    Copy as many lines as needed to create the iService components required for the installation.

  6. Click Options (ellipsis) icon to view or edit the Options form.

    iService Options

  7. Verify or edit the Application Server, Main Database, and IIS Virtual Root Settings in the Options form.

  8. Click OK to save changes on the Options form. The form is closed.

  9. Accept the default Destination Directory or select a directory where the information for this component is stored. Changing this directory will apply across all machines in the Machine Name column.

  10. Click Delete icon to delete a selected line.

  11. Click Test to ensure the setup for the corresponding line is correct. If a test on a particular line fails, check all associated fields and click Test again.

  12. If all tests pass, click right arrows.

     

Postinstallation Tasks

Following are the postinstallation steps for iServices:

  1. Configure the following settings for the DefaultAppPool Application Pool. To do so:

    1. Open the Internet Information Services (IIS) Manager in one of the following ways:

      Go to Start, Run. Type inetmgr.

      — OR —

      Type inetmgr in the Search box of the Start menu.

    2. Click ENTER.

    3. Navigate to the <Server Name>, Application Pool node. The Application Pools screen is displayed.

    4. In the Application Pools screen, right-click the DefaultAppPool Application Pool, and select Basic Settings. The Edit Application Pool dialog box is displayed.

    5. Set the value of the fields in the Edit Application Pool dialog box as follows:

      • Set the value of the .Net Framework Version field to .Net Framework v4.0.30319.

      • Set the value of the Managed Pipeline Mode field to Integrated.

    6. In the Application Pools screen, right-click the DefaultAppPool Application Pool, and select Advanced Settings. The Advanced Settings dialog box is displayed.

  2. In the Process Model section, set the value of the Identity field as Local System.

     

Note: The iServices API documentation is available in the Service Catalog (login required).