AutoDiscover Service

The AutoDiscover Service is installed on the default ServerName/HostHeader URL when installing K2 and can be accessed using this default URL.  For example:

http://{ServerName/HostHeader}/AutoDiscover/AutoDiscover

When opening the URL the information is downloaded and can now be used with external applications.

With a few manual configuration steps, AutoDiscover can be added to another URL. This allows the user to open a URL, well known to the company, to return K2 application details.

The JSON structure of the information returned is illustrated below:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
{
  "ProductVersions": {
    "ServerVersion": "5.1001.0000.0",
    "SmartFormsVersion": "5.1001.0000.0"
  },
  "ProductLicenses": {
    "ServerLicense": true,
    "SmartFormsLicense": true
  },
  "Environment": {
    "Fields": [
      {
        "Name": "SmartForms Designer 1",
        "Type": "SmartForms Designer URL",
        "Value": "http://{ServerName/HostHeader}/Designer",
        "IsDefault": "True"
      },
      {
        "Name": "SmartForms Runtime 1",
        "Type": "SmartForms Runtime URL",
        "Value": "https://{ServerName/HostHeader}/Runtime/Runtime",
        "IsDefault": "True"
      },
      {
        "Name": "Web Service URL SSL",
        "Type": "Web Service URL",
        "Value": "https://{ServerName/HostHeader}",
        "IsDefault": "False"
      },
      {
        "Name": "SmartForms Designer 1",
        "Type": "SmartForms Runtime URL",
        "Value": "http://{ServerName/HostHeader}/Designer/Runtime",
        "IsDefault": "False"
      },
      {
        "Name": "SmartForms Designer 1 SSL",
        "Type": "SmartForms Designer URL",
        "Value": "https://{ServerName/HostHeader}/Designer",
        "IsDefault": "False"
      },
      {
        "Name": "Web Service URL",
        "Type": "Web Service URL",
        "Value": "http://{ServerName/HostHeader}",
        "IsDefault": "True"
      }
    ]
  }
}

The K2 URL information being returned is set by default at the time of the K2 installation.  These values are:

• SmartForms Designer URL
• SmartForms Runtime URL
• Web Service URL
• Forms Server

To add more K2 URL's to return, the value of the AutoDiscover column in the Environment.Field table of the K2 database can be set to 1. 

The AutoDiscover Service requires a Microsoft .NET Framework 4.0 Application Pool.

As previously stated, AutoDiscover is installed on the default ServerName/HostHeader URL when installing K2.  However, another URL can be used with AutoDiscover but has to be configured manually.  Follow the steps below:

1. Go to %PROGRAMFILES%\K2\WebServices and copy the AutoDiscover folder.  Paste it in a different location.
2. Open the Internet Information Services (IIS) Manager.
3. Add a new Application Pool. Select Microsoft .NET Framework 4.0 and Integrated as the Managed pipeline mode.
4. Ensure that the correct permissions for the new Application Pool are set.
5. Add a new Application on the K2 Site.
6. Enter an Alias for the new Application and select the newly created Application Pool.
7. Point the physical path to the location where the AutoDiscover folder was copied to.
8. Ensure to add the correct user details to connect to the new application using the Connect as button.
9. The new URL can now be used to retrieve K2 application details.