Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

CardioLog Analytics provides easily integrates personal user data into reports and provides advanced visitor segmentation capabilities by integrating both external and internal personal user data into reports.Retrieval of additional using existing user directories.

Additional user information, such as department, gender, and other profile data is performed retrieved by the User Categories Updates service , which retrieves the data from Active Directory attributes or SharePoint User Profiles by default. The User Categories Updates service can also retrieve the data from a custom source (any human resource management system or even custom databases), using a designated web service that supplies the user information.

Anchor
retrieving user info
retrieving user info
Develop the Custom User Categories Web Service

In order to load additional user information from a web service, specify a web service from which the User Categories Updates service will extract the user data. This is done through the CardioLog Administration user interface:
  1. Create the custom user information web service for your organization.
  2. Verify that the custom user information web service returns a valid XML response, according to the XML schema, and that .
  3. Confirm the CardioLog Scheduling Service user account has sufficient permissions to access (request) the web service.
  4. In the navigation pane in CardioLog go in CardioLog go to Administration System Configuration User Category Management.
  5. Click Add Categories Source > Custom.
    Image Removed
    Image Added
    System Configuration - User Category Management - : Custom Categories Service

  6. Enter a name for the custom user categories source in the Title textboxfield
  7. Enter the custom user categories web service URL in the Website URL textbox the website URL text box (Acceptable file extensions are "aspx", "asmx" or "xml").
  8. Select Select Yes for Is Web Service = Yes and
  9. If you use an .asmx file in the URL field, enter the custom user categories web service method name in the Web Method Name textbox (in case of using "asmx")text box.
  10. Click Set and enter user the web service's user credentials if required in order to access the web service.
  11. Click Save and restart the Go to CardioLog Scheduling Service under Administration in the navigation pane and click Restart Service in the upper right hand corner.
  12. After the next run of thescheduled User Categories Updates service, your user categories will be added to the Active Directory attributes will be made available in the Visitor Segments filter of each report, under User Categories.

Anchor
creating user info
creating user info
Custom User Categories Web Service Schema

The user information web service should be exposed by a web page which provides an XML string response, according to the following . Follow this format: 

Info
iconfalse
titleXML Schema


<?xml version="1.0" encoding="utf-8" ?>

<xs:schema id="CategoryXmlSchema"

elementFormDefault="qualified"

xmlns:mstns="http://tempuri.org/CategoryXmlSchema.xsd"

xmlns:xs="http://www.w3.org/2001/XMLSchema">

<xs:element name="tree">

<xs:complexType>

<xs:sequence>

<xs:element name="item" type="UserCategoryXmlNode" minOccurs="0" maxOccurs="unbounded" />

</xs:sequence>

</xs:complexType>

</xs:element>

<xs:complexType name="UserCategoryXmlNode">

<xs:sequence>

<xs:element name="userName" type="xs:string" />

<xs:element name="categories" minOccurs="0" maxOccurs="1">

<xs:complexType>

<xs:sequence>

<xs:element name="categoryValue" type="categoryNode" minOccurs="0" maxOccurs="unbounded" />

</xs:sequence>

</xs:complexType>

</xs:element>

</xs:sequence>

</xs:complexType>

<xs:complexType name="categoryNode">

<xs:sequence>

<xs:element name="categoryName" type="xs:string" minOccurs="1" maxOccurs="1" />

<xs:element name="categoryValue" type="xs:string" minOccurs="1" maxOccurs="1" />

</xs:sequence>

</xs:complexType>

</xs:schema>

Field Definitions:

 

Info
iconfalse
titleSample Data


<tree>

<item>

<userName>MyCompany\james</userName>

<categories>

<categoryValue>

<categoryName>Region</categoryName>

<categoryValue>West</categoryValue>

</categoryValue>

<categoryValue>

<categoryName>Gender</categoryName>

<categoryValue>Male</categoryValue>

</categoryValue>

</categories>

</item>

<item>

<userName>MyCompany\taylor</userName>

<categories>

<categoryValue>

<categoryName>Region</categoryName>

<categoryValue>North</categoryValue>

</categoryValue>

<categoryValue>

<categoryName>Gender</categoryName>

<categoryValue>Female</categoryValue>

</categoryValue>

</categories>

</item>

</tree>