Application Setup
Please ensure the latest HR Application is installed on the same system as the Web Service as this implementation will control the provision of information by the Web Service.
QLx
For the web parts to work correctly with QLx, it is required to setup a non-administrative user called REMOTE_HR.
THE SOFTWARE
A Software Portal user must be set in the Connection Manager (jsconnection.exe).
Install the Web Service
Download and unzip QLHRWebService.zip, select setup.exe and follow the instructions of the installation wizard.
There should now be a HRWebService folder in the web site where you installed the web service. Under that folder, there should be a web.config. Make sure that the Jane.Environment value is set to QL for QL-x and JANE for Jane HR.
Additional Instructions for Upgrading from ASP.NET v1.0
The web parts are only compatible with ASP.NET v2.0 . If you need to update the Sharepoint web site, follow the instructions below.
1. Make sure that Sharepoint Services 2.0 Service Pack 2 or greater is installed.
2. In “C:Program FilesCommon FilesMicrosoft Sharedweb server extensions60bin” create a file called STSADM.EXE.CONFIG with the following pasted in:
<?xml version=”1.0″ encoding=”utf-8″ ?>
<configuration>
<startup>
<supportedRuntime version=”v2.0.50727″ /> <!– update the version # once .Net v2.0 is released –>
<supportedRuntime version=”v1.1.4322″ /> <!– this is the version number for .Net v1.1 –>
</startup>
</configuration>
3. Remove installed web parts, if necessary; stsadm -o deletewppack qlhrwebparts.web.
4. In IIS Manager, go to the properties of the web site where Sharepoint is installed.
5. In the ASP.NET tab, change the ASP.NET version from 1.1.4322 to 2.0.50727.
6. Restart IIS.
7. From the command line, run the following from the “c:Program FilesCommon FilesMicrosoft Sharedweb server extensions60bin” directory:
STSADM.EXE -o upgrade -forceupgrade -url https://<url of the sharepoint site>
Install The Web Parts
Download and unzip QLHRWebParts.zip.
From the Command prompt:
cd “C:Program FilesCommon FilesMicrosoft Sharedweb server extensions60BIN”
STSADM.EXE -o enumwppacks
STSADM.EXE -o deletewppack -name QLHRWebParts_$Version$.cab
There are two options available when installing the cab file:
GAC (Global Assembly Cache)
STSADM.EXE -o addwppack -filename $pathToCabFile$ -globalinstall
Bin
If you have multiple Sharepoint sites on the same server, you might want to potentially have a live site and a test site. In this instance, you might only want to update the test site (to test a new version of the cab file). You can therefore install the cab file to a specified site.
STSADM.EXE -o addwppack -filename $pathToCabFile$ -url $urlOfSite$
Configuring the web.config
Finally, the following entry should be added to the configuration file (web.config) of the Sharepoint Web Site to enable it to locate the Web Service when the Web Parts require it. Typically this would reside in c:InetpubWebSiteName e.g. c:inetpubcompanyweb
Change Trust Level to Full i.e. <Trust Level=”Full” originURL=”” … /> (This is only required if you installed the cab file to the Bin folder as all DLLs in the GAC are fully trusted)
Change <pages enableSessionState=”false” to<pages enableSessionState=”true”
Under <httpModules> add or uncomment the following line:
<add name=”Session” type=”System.Web.SessionState.SessionStateModule” />
In the appSettings section (this section may need to be added manually). Add the following settings:
<configuration>
…
<appSettings>
<add key=”HRWebService” value=”https://localhost/HRWebService/CallComObject.asmx” />
<!– QLx users need to add the following –>
<add key=”Agresso.QLP.Environment” value=”<PUT_YOUR_CONNECTION_CODE_HERE>” /> <!– QL Administrator – Connection Code –>
<add key=”Agresso.QLP.Qualifier” value=”<PUT_YOU_REMOTE_HR_PASSWORD_HERE>” /> <!– Password for REMOTE_HR user –>
</appSettings>
…
</configuration>