1
2
3
4
5
6
7
8
9
|
<html dir="ltr"><head>
<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
<META HTTP-EQUIV="assetid" CONTENT="HV01082290"><META NAME="lcid" CONTENT="1033"><title>Toolkit Sample</title><link rel="stylesheet" type="text/css" href="office10.css"><script type="text/javascript" language="Javascript" src="ExpCollapse.js"></script><script type="text/javascript" language="JavaScript" src="inline.js"></script></head><body><p id="ExpandAllLine" class="ExpFav"><a href="#" onclick="ExpandAll()" onkeypress="ExpandAll()" class="DropDown"><img id="picHeader" border="0" src="expandtri.gif" alt="Show All"><span id="ExpandAll">Show All</span></a></p><h1>Toolkit Sample</h1><p>The Toolkit sample research service accepts a query response file as input and displays the content of the query response, as delimited by the <b class="bterm">Content</b> element. This tool facilitates the debugging of a research service while it is being developed.</p><p><a href="#" class="DropDown" onclick="Outline2()" onkeypress="Outline2()"><img border="0" src="blueup.gif" alt="Show">Configuring the Toolkit research service</a></p><div id="ExpCol" class="collapsed" border="0"><p>The SDK provides the source files toolkit.asmx and toolkit.asmx.cs. This section describes how to build a Toolkit research service as a Web service based on these files.</p><div class="ind"><p><a href="#" class="DropDown" onclick="Outline2()" onkeypress="Outline2()"><img border="0" src="blueup.gif" alt="Show">Requirements</a></p><div id="ExpCol" class="collapsed" border="0"><ul><li>Microsoft® Office 2003</li><li>Microsoft .NET Framework 1.0 or later</li><li>Microsoft .NET Framework 1.0 Software Development Kit, or a later release</li><li>Microsoft Internet Information Services (IIS) 5.0 or later</li></ul><p><b>Note</b> IIS should be installed before you set up the Microsoft .NET Framework SDK. If you have installed or re-installed IIS after setting up the Microsoft .NET Framework SDK, you will experience unexpected behavior when you try to view ASP.NET pages. To fix this, register ASP.NET with IIS again by running the aspnet_regiis.exe utility. For more information, see Knowledge Base article 306005 , "<a href="http://r.office.microsoft.com/r/rlidAWSContentRedir?AssetID=XT010971891033&CTT=11&Origin=HV010822901033" target="_new">HOWTO: Repair IIS Mapping After You Remove and Reinstall IIS</a>.”</p></div></div><div class="ind"><p><a href="#" class="DropDown" onclick="Outline2()" onkeypress="Outline2()"><img border="0" src="blueup.gif" alt="Show">Configure the research service</a></p><div id="ExpCol" class="collapsed" border="0"><ol><li>Do the following: <ul><li>If you have installed the Research SDK on the computer that hosts the IIS server <i>ServerName</i>, go to step 2.</li><li><p><a href="#" class="DropDown" onclick="Outline2()" onkeypress="Outline2()"><img border="0" src="blueup.gif" alt="Show">If you have installed the Research SDK on a computer different from <i>ServerName</i>: </a></p><div id="ExpCol" class="collapsed" border="0"><ol><li>Create a folder called Tools on <i>ServerName</i>.<p><b>Note</b> To avoid access problems when running the Toolkit Web service, do not place the Tools folder under the My Documents folder.</p></li><li>From the computer that the SDK is installed on, copy the contents of the Tools folder (under <i>Drive</i>:\Program Files\Microsoft Office 2003 Developer Resources\Microsoft Office 2003 Research Service SDK) to the Tools folder on <i>ServerName</i>.</li></ol></div></li></ul></li><li><p><a href="#" class="DropDown" onclick="Outline2()" onkeypress="Outline2()"><img border="0" src="blueup.gif" alt="Show">Map the Tools folder to a virtual directory named ToolsServices on <i>ServerName</i></a></p><div id="ExpCol" class="collapsed" border="0"><ol><li>From the Microsoft Windows® <b class="ui">Start</b> menu, click <b class="bterm">Control Panel</b>, and then double-click <b class="ui">Administrative Tools</b>.</li><li>Double-click <b class="ui">Internet Information Services</b>.</li><li>In the Internet Information Services folder tree, expand the folders for the local computer, the <b class="ui">Web Sites</b> directory, and the <b class="ui">Default Web Site</b>.</li><li>Create a new virtual directory named ToolsServices by right-clicking <b class="ui">Default Web Site</b> and selecting <b class="ui">New</b> and <b class="ui">Virtual Directory</b>. Follow the instructions in the Virtual Directory Creation Wizard to map Tools to ToolsServices.</li></ol></div></li></ol><p>The Research Service SDK provides the assembly for this research service Toolkit.dll in Tools\Bin.</p><p><a href="#" class="DropDown" onclick="Outline2()" onkeypress="Outline2()"><img border="0" src="blueup.gif" alt="Show">If you need to modify toolkit.asmx.cs: </a></p><div id="ExpCol" class="collapsed" border="0"><p>With the modified toolkit.asmc.cs located on <i>ServerName</i>, at the Windows command prompt, change to the Tools\Toolkit folder and run make.bat to compile and build the Web service. The assembly file toolkit.dll will be generated in the Tools\Bin folder.</p><p><b>Note</b> Make.bat uses the Microsoft® Visual C# command-line compiler, csc.exe, which is part of the Microsoft .NET Framework SDK. If necessary, modify make.bat to include a search path for the compiler.</p></div></div></div></div><p><a href="#" class="DropDown" onclick="Outline2()" onkeypress="Outline2()"><img border="0" src="blueup.gif" alt="Show">Searching the Toolkit research service</a></p><div id="ExpCol" class="collapsed" border="0"><p>Before you can search on the Toolkit research service for the first time, add the research service to the <b class="bterm">Research</b> task pane using the URL http://<i>ServerName</i>/ToolsServices/Toolkit/toolkit.asmx. For more information about adding a research service, see <a href="rsAddingUI.htm" id="HV01082279" lcid=" ">Adding Services through the Office User Interface</a>.</p><ol><li>On the <b class="bterm">Research</b> task pane, under <b class="ui">Search for</b>, type the full path name of the file that contains a query response. <p><b>Note</b> If the file does not reside on your local computer, make sure that the query response file is accessible from your computer. The query response must be an XML file that supports the <a href="rsxsdResponse.htm" id="HV01084530" lcid=" ">Microsoft.Search.Response Schema</a>. For an overview of the query schemas, see <a href="rsReferenceSchemas.htm" id="HV01082292" lcid=" ">XML Schemas Overview</a>.</p></li><li>The Research Service SDK provides a set of sample files containing query responses. You can list these query response files by typing <b class="bterm">dir</b> under <b class="ui">Search for</b>, and then clicking any of the files to display the content. Some of the sample files contain smart tags that facilitate inserting or copying text specified in the query response file.</li><li>To view all the options of the Toolkit research service, type <b class="bterm">help</b> under <b class="ui">Search for</b>.</li></ol></div><p><a href="#" class="DropDown" onclick="Outline2()" onkeypress="Outline2()"><img border="0" src="blueup.gif" alt="Show">Design of the Toolkit research service</a></p><div id="ExpCol" class="collapsed" border="0"><p>The Toolkit research service specifies two Web methods, <b class="bterm">Query</b> and <b class="bterm">Registration</b>, under the <b class="bterm">Search</b> namespace. The page http://<i>ServerName</i>/ToolsServices/Toolkit/toolkit.asmx provides a brief description and a hyperlink to the formal definition of each method.</p><div class="ind"><p><a href="#" class="DropDown" onclick="Outline2()" onkeypress="Outline2()"><img border="0" src="blueup.gif" alt="Show"><b class="bterm">Query</b></a></p><div id="ExpCol" class="collapsed" border="0"><p>This method parses input from the given file name, determines if it contains a valid query response, and returns an appropriate query response. Then the <b class="bterm">Research</b> task pane displays the appropriate results based on the returned query response. The query response supports the <a href="rsxsdResponse.htm" id="HV01084530" lcid=" ">Microsoft.Search.Response Schema</a>.</p></div></div><div class="ind"><p><a href="#" class="DropDown" onclick="Outline2()" onkeypress="Outline2()"><img border="0" src="blueup.gif" alt="Show"><b class="bterm">Registration</b></a></p><div id="ExpCol" class="collapsed" border="0"><p>This method is called when you initially add the Toolkit research service to the task pane. At that point, it sends a registration request. This method always returns a registration response. The registration response supports the <a href="rsxsdRegistrationResponse.htm" id="HV01084526" lcid=" ">Microsoft.Search.Registration.Response Schema</a>.</p></div></div><p>For more information about the research service schemas, see <a href="rsReferenceSchemas.htm" id="HV01082292" lcid=" ">XML Schemas Overview</a>.</p></div><center><a href="XMLSchemaCopyright_HV01147162.htm">©2003-2004 Microsoft Corporation. All rights reserved.</a>
Permission to copy, display and distribute this document is available at: <a
href="http://r.office.microsoft.com/r/rlidAWSContentRedir?AssetID=XT010988631033&CTT=11&Origin=HV011232471033"
target="_new">http://msdn.microsoft.com/library/en-us/odcXMLRef/html/odcXMLRefLegalNotice.asp</a></center></body></html>
|
