Example code
An example skeleton dialing provider is installed with the UNICOM Intelligence Developer Documentation Library at:
[INSTALL_FOLDER]\IBM\SPSS\DataCollection\<version>\DDL\ThirdPartyDialer\Skeleton
Preparing the example code
Before using the example skeleton to build your dialing provider, you must first change some settings and codes in the example project.
1 Add the following reference component installation paths to the project properties Additional Include Directories: Project > Properties > Configuration Properties > C/C++ > General.
|
Reference components
|
Installation path
|
|
IOM.dll
|
C:\Program Files\Common Files\IBM\SPSS\DataCollection\<version>\ IOM
|
|
DPMScripting.dll, spssmr.dpm.agent.tlb
|
C:\Program Files\Common Files\IBM\SPSS\DataCollection\<version>\ ProjectMgmt
|
|
mrFuncLib.dll, mrEvaluate.dll
|
C:\Program Files\Common Files\IBM\SPSS\DataCollection\<version>\ DataModel.2
|
|
msado15.dll
|
C:\Program Files\Common Files\IBM\SPSS\DataCollection\<version>\ ado
|
|
Quota.dll
|
C:\Program Files\Common Files\IBM\SPSS\DataCollection\<version>\ Quota
|
Alternatively, you can copy the files to each specific folder, and then add the path to the Additional Include Directories. If you do this, you must ensure that the files can be found by the Visual C++ compiler.
2 Make the spssmr.dpm.agent.tlb file writable in the C:\Program Files\Common Files\IBM\SPSS\DataCollection\<version>\ProjectMgmt directory.
Then launch a Windows command prompt and register the spssmr.dpm.agent.dll.
Recreate the spssmr.dpm.agent.tlb file via regasm.exe (shipped with the Microsoft .NET SDK):
regasm spssmr.dpm.agent.dll /tlb
3 Replace the TypeLib UUID and dialing provider coclass UUID with a new UUID in the DialingProvider.idl and DialingProvider.rgs files.
In DialingProvider.idl:
▪Replace the TypeLib UUID: 301D3BBB-7A0B-4D44-82B7-8D6143F56012 with a new UUID. To create the new GUID, use GuidGen.exe, available from the Tools > Create GUID menu in Visual Studio.
▪Replace the coclass UUID: 9A0CA9B0-7F36-4088-81BF-D62A7475C5A3 with a new UUID.
▪Update the helpstring content to describe the integrated dialer.
In DialingProvider.rgs:
▪Replace all CLSID uuid: 9A0CA9B0-7F36-4088-81BF-D62A7475C5A3 with the new coclass UUID that is used in the DialingProvider.idl file.
▪Replace the TypeLib UUID: 301D3BBB-7A0B-4D44-82B7-8D6143F56012 with the new TypeLib UUID that is used in the DialingProvider.idl file.
▪Update the Skeleton.Provider to a new dialing provider program ID based on the name of integrated dialer. Also update the registry descriptions by replacing SPSS Skeleton with the name of the integrated dialer.
You can build the skeleton project after completing the previous steps. After building the project you can then add your codes and build your dialing provider.
See also