Cognos-SDK-For-Customerers

©2009IBMCorporation1IBMCognos8SDKforCustomerIBMCognos工程师凌敏©2009IBMCorporation21.什么是SDK？2.怎样安装和运行SDK例子3.SDK程序的结构和门户集成议程©2009IBMCorporation3前提•了解IBMCognos8•基本了解编程语言JavaorC#©2009IBMCorporation41.什么是SDK©2009IBMCorporation5SDK扩展业务商务智能的价值•更快速更方便的将CognosBI功能集成到其它应用中。可以将CognosBI功能集成到包括ERP在内的应用程序.•将Cognos应用程序集成到门户环境.BI内容可以被无缝添加到现有门户，从而增强信息的交付功能。•定制BI，满足特殊需要.©2009IBMCorporation6SDK的角色•IBMCognos8提供丰富的用户接口去运行更为复杂和广泛的任务•SDK(SoftwareDevelopmentKit)是IBMCognos8的额外的一个组件,可以通过程序执行下面的功能:1.许多通过IBMCognos8UI才能完成的一些工作2.其他自定义或者特定需求的任务•SDK可以让IBMCognos8更容易集成到其他应用程序中.©2009IBMCorporation7SDK不能做的是SDK不能更改IBMCognos8的一些用户接口,包括：•门户页面,•登入页面•任何自定义的窗口•任何CognosConnection中的Studios•IBMCognos的Logo©2009IBMCorporation8SDKAPI•SDK的主要组件是API(ApplicationProgrammingInterfaces),也就是BIBusAPI•SDKAPI有三个开发包:Java,COM(forVisualBasic6.0)and.NET(forC#)•Note:Cognos不会再支持COM-SDKVisualBasic6.•SDKAPI不仅可以运行在单独的环境中,还可以运行在web页面中,如ASP或者JSP.©2009IBMCorporation9其他SDK组件1.URLinterface,通过URL拼接不同的参数而产生不同操作,通过HTTP的方式与其他应用程序集成.2.FrameworkmanagerSDK,用于模型元数据管理和发布包3.ScriptPlayer,一个运行Frameworkmanager中创建的actionlogs的命令行4.IBMCognos8MashupServices,开放RESTandWSDL/SOAP接口;是8.4.1的新组件,必须要有SDKlicense的用户才能使用©2009IBMCorporation10SDK文档TheSDK8.4文档有以下几个部分组成:•IBMCognos8SDKGettingstarted(55pages)•IBMCognos8SDKInstallationandconfigurationguide(13pages)•IBMCognos8SDKDeveloperGuide(2948pages)•IBMCognos8SDKCustomAuthenticationProviderDeveloperGuide(41pages)•IBMCognos8SDKFrameworkmanagerDeveloperGuide(168pages)©2009IBMCorporation11SDK是怎样工作的•TheSDKAPI包括有些类相当于IBMCognos8services.包括ContentManagerService,ReportService,MonitorService.•当调用SDK其中的方法时,会产生SOAP(SimpleObjectAccessProtocol)消息,并且会通过HTTP协议发送到合适的IBMCognos8service.•SDK程序可以运行在没有安装IBMCognos8server的机器上,只需要一些lib资源.©2009IBMCorporation12SDK在Cognos体系架构中的地位SOAPSOAPSOAPFIREWALLFIREWALLFIREWALLASP,JSP,VB,ExcelCGIServletCognosBIBusDB2,OracleOthers…MicrosoftIISNetscapeWSReportStudioQueryStudioAdminUIApplicationConsumerUIGatewaySDKReportServicePresentationServiceAdminNotificationServicePortalDispatcherPromptEngineRenderingEngineMetadataEngineQueryEngineContentManagerCAMContentStoreCustomerDatabaseWebsphereWeblogicTomcatWebServicesSOAP/WSDLMicrosoft&SUNclusterservices©2009IBMCorporation132.怎样安装和运行SDK例子©2009IBMCorporation14怎样安装SDK•IBMCognos8SDK必须安装在IBMCognos8BIServer组件已经安装好的服务器上.SDK安装过程和Cognos8其他组件安装过程类似•SDK有三个不同的开发包:Java,COMand.NET•这些开发包在c8/sdk目录下,包含三个不同的文件夹:•java是Java开发包•vb是COM开发包•csharp是.NET开发包©2009IBMCorporation15开发包的例子•每一个开发包的路径下有很多的例子•每一个例子都有一个html文件描述它.•每个例子都有源文件以及注释,包括对BIBusAPISDK一些方法的调用总结•如何使用例子在“IBMCognos8SDKGettingstarted”guide里有相应的描述©2009IBMCorporation16如何运行Java的例子•运行Java的例子,•在Windows里脚本为build.bat和run.bat•在UNIX里脚本为build.sh和run.sh•JDK必须安装在当前机器•在每一个脚本文件中,根据当前机器情况,更新JAVA_HOME和CRN_HOME这两个变量的值•并且可以通过c8\sdk\下的build-samples.batorbuild-samples.sh编译所有例子文件©2009IBMCorporation17如何在.Net环境运行•对不同.NetFramework版本调用不同的dll库©2009IBMCorporation18如何在.Net环境运行•对于VisualStudio.NET2003或者VisualStudio2005.都需要AddReference动态库添加到工程中•在VisualStudio.NET2003,需要添加cognosdotnet.dll和cognosdotnetassembly.dll.•在VisualStudio2005,需要添加cognosdotnet_2_0.dll和cognosdotnetassembly_2_0.dll.•最后导入Cognos自带工程或者代码示例即可©2009IBMCorporation19SDKAuthenticationProviders•IBMCognos8不会管理用户,用户是通过认证源自己进行管理的•IBMCognos8支持很多认证源:1.ActiveDirectoryServer2.IBMCognosSeries73.LDAP4.eTrustSiteMinder5.NTLM6.SAPBW7.CustomAuthenticationProvider•CustomAuthenticationProvider是通过SDK方式生成的•“AuthenticationProviders”就是一些认证接口©2009IBMCorporation20SDKAuthenticationproviders技术SDK有两个认证源的例子:1.SDKFullCustomauthenticationprovider,实现了所有IBMCognos8所要求的连接认证源的方法.2.SDKTrustedsign-onprovider定义了通过另一个认证源实现单点登入的方法.在与其他WEB应用程序集成时非常方便.这些例子在:c8\sdk\java\AuthenticationProvider在“IBMCognos8SDKCustomAuthenticationProviderDeveloperGuide”文档中有相应的技术描述©2009IBMCorporation212.SDK程序的结构和门户集成©2009IBMCorporation22SDK程序的是三个部分•每一个SDK程序都有三个主要的部分.前两个部分是标准的,所有程序都会需要,第三个部分与具体要运行的任务有关:1.为Cognos连接初始化对象2.登入Cognos3.执行相应的任务•注意:我们使用Java语言的作为例子.©2009IBMCorporation23Part1–为Cognos连接初始化对象•这些对象是通过URL方式访问IBMCognos8服务器进行初始化的•在IBMCognos8Configuration里,默认URL为“DispatcherURIforexternalapplications”所配置的,比如：•它也可以通过网关的方式访问©2009IBMCorporation24Part2–登入Cognos•IBMCognos8支持包括已经通过直接认证的方式和匿名用户的方式访问.•如果不允许匿名用户,SDK登入必须使用namespaceID，用户名和密码的方式.•认证的XML串像这样:credentialnamespaceNTLM/namespaceusernameadminusernamepasswordpwd/password/credential©2009IBMCorporation25Part3–执行任务•运行一些特定的任务.•接下来的代码示例是用来显示公共文件夹的包•Contentmanager服务通过searchpath“/content//package”完成查询，并且获得“searchPath”和the“defaultName”属性.•这个查询返回BaseClass数组.©2009IBMCorporation26Thecode–overallstructurepublicclassSDKExample{privatestaticStringdispatcherURL==NTLM;privatestaticStringuserName=user;privatestaticStringpassword=pwd;privateContentManagerService_PortcmService;publicstaticvoidmain(Stringargs[]){SDKExamplemainClass=newSDKExample();//instantiatetheclassmainClass.initialize(dispatcherURL);//initializeobjectsforconnectionmainClass.logonToCognos(nameSpaceID,userName,password);//logontoCognosmainClass.executeTasks();//executethesp