SAMPLES_USER_GUIDE_README

advertisement
User Guide for Programming
according to the Sample
Contents
1. Install CreditLine .......................................................................................................................... 2
1.1 Topology of CreditLine Environment..................................................................................... 2
1.2 Installation steps ................................................................................................................... 2
2. Configure and run the Sample..................................................................................................... 3
2.1 Prerequisites .......................................................................................................................... 3
2.2 Steps to Configure and Run the Sample ................................................................................ 3
3. Programming according to the Sample ....................................................................................... 4
3.1 Prerequisites .......................................................................................................................... 4
3.2 Steps to Programme according to the Sample ...................................................................... 4
4. Troubleshooting .......................................................................................................................... 5
1. Install CreditLine
1.1 Topology of CreditLine Environment
1.2 Installation steps
 For Server Side:
1) Log in Machine A(CreditLine Server) in the topology above.
2) Click here to download the “CreditLine4.1Build1102SP49.exe” or higher version.
3) Run CreditLine4.1Build1102SP49.exe file and follow the instructions to complete
the installation of the software.
4) In file ”C:\911\Server\FileMonitor.Server.Service.exe.config” change “ServicePort” to
any value that will work on your network. Leave the other settings as the default values.
5) Run “C:\911\Server\InstallServerService.bat” as administrator to start the service on
server side.
6) If necessary, run “C:\911\Server\UnInstallServerService.bat” as administrator to stop
the service on server side.
Note: If you change any settings in the file “FileMonitor.Server.Service.exe.config”, you will
need to restart the service.
 For Client Side:
7) Log in Machine B(CreditLine Client) in the topology above.
8) Click here to download the “CreditLineClient4.1Build1102SP49.exe” or higher
version.
9) Run CreditLineClient4.1Build1102SP49.exe file and finish the installation.
10) In file ” C:\911\Client\FileMonitor.Client.Service.exe.config”:
a. Change “FileMonitorServerIPAddress” to the Server Machine A’s IP
address and the port you set on the server the in following format
“127.0.0.1:xxx”, where xxx is the port number.
b. Also, make sure that "FileMonitorDirectory" is set to the same local
message folder on the local drive as set by the API clcSetMessageDir. For
instance, <add key="FileMonitorDirectory" value="..\MESSAGES"/>
would correspond to "C:\911\Messages"
c. Leave the other settings as the default values.
11) Run “C:\911\Client\InstallClientService.bat” as administrator to start the service on the
client side.
12) If necessary run “C:\911\Client\UnInstallClientService.bat" as administrator to stop the
service on Terminal side.
Note: If you change any settings in the file “FileMonitor.Client.Service.exe.config”, you will
need to restart the service.
2. Configure and run the Sample
2.1 Prerequisites


Microsoft .NET Framework 2.0 or higher
CreditLine4.1Build1102SP49 or higher
2.2 Steps to Configure and Run the Sample
This paragraph is to guide you how to configure and run the Sample.
1) Complete the steps in1.2,then:
2) Log in Machine B(CreditLine Client) in the1.1 Topology of CreditLine Environment
3) Click here to download the sample(CS:C Sharp, VB.Net) as you need, then Unzip the
downloaded file.
4) Please copy “clcCom.dll”, “CSDriver.exe” files to CreditLine Client installation
path(C:\911\api).
Note: Please do NOT overwrite the existing files(ClcCom is the new com library, it can be
used in C#, VB.Net).
5) Please copy folder “C:\911\BIN” and “C:\911\Data” from server Machine A to client
Machine B’s installation path(C:\911).
6) Double chick CSDriver.exe to run the Sample as the following screenshot:
3. Programming according to the Sample
3.1 Prerequisites


Microsoft .NET Framework 2.0 or higher
CreditLine4.1Build1102SP49 or higher
3.2 Steps to Programme according to the Sample
This paragraph is to guide you how to configure and run the Sample.
1) Complete the installation steps in1.2 then:
2) Log in Machine B(CreditLine Client) in the1.1 Topology of CreditLine Environment.
3) Click here to download the sample(CS:C Sharp, VB.Net) as you need, then Unzip the
downloaded file.
4) Please copy “clcCom.dll”, “CSDriver.exe” files to CreditLine Client installation
path(C:\911\api).
Note1: Please do NOT overwrite the existing files(ClcCom is the new com library, it can
be used in C#, VB.Net).
Note2: Directory "CSDriver" is the C# sample source code.
5) Please copy folder “C:\911\BIN” and “C:\911\Data” from server Machine A to client
Machine B’s installation path(C:\911).
6) Add the reference to the ClcCom library.
In "vs.net 2005 IDE", from menu Project->Add Reference.
In the popup window, select Browse and then browse to the directory to select the
ClcCom.dll.
7) After that, you can follow the sample to program.
Note: If you have more than one Client, please call the api "void setClientName(string
ClientName)" to set a different name for each Client before processing any transactions.
4. Troubleshooting


When running the sample application, if you encounter the error “side-by-side…”.
Please try to install “vcredist_x86.exe” on your environment.
For Win7 User, no matter the OS is Win7-32bit or Win7-64bit, we suggest you to enable
‘Is64BitPlatform=YES’ in ClcCs.ini which can be found in C:\911\api.
Download