Commence Web Companion Technical DocumentationCommence Web Companion ControlThe Commence Web Companion Control allows users to access web-based information related to data in Commence. The control provides a collection of methods that each generate a URL from a set of data strings. The Commence Web Companion is a COM Server created via the Active Template Library (ATL), and requires the MFC DLLs (currently using version 6). It contains the GetURL object, which provides a set of methods that each generate a URL from data strings passed into the method. This generated URL can then be used to go directly to a web service containing information related to the data strings passed to method.GetURL ObjectThe GetURL object provides a set of methods that generate URLs from data passed into each method. Strings (specifically BSTRs) are used to pass all data to and from the methods.Each method provided by the GetURL object is documented below:DirectoryCompany (Category, City, State, *rsltURL)Description:Generates a URL that will search for companies with the selected category, city, and state. Affiliate Program:Yellow Pages - InfoSpaceInput Parameters:CategoryString containing the target business category. CityString containing the target city. StateString containing the target state (2 letter abbreviation format).Output Parameter:rsltURLString that will be filled with the target URL.DirectoryPerson (First, Last, City, State, *rsltURL)Description:Generates a URL that will search for people with the selected name and location. Affiliate Program:WhiteYellow Pages - InfoSpaceInput Parameters:FirstString containing the target first name. LastString containing the target last name. CityString containing the target city. StateString containing the target state (2 letter abbreviation format).Output Parameter:rsltURLString that will be filled with the target URL.FindCompany (Company, *rsltURL) OBSOLETEDescription:Generates a URL that will search for a web site for the specified company. Affiliate Program:Yellow Pages - InfoSpaceInput Parameters:CompanyString containing the target company name.Output Parameter:rsltURLString that will be filled with the target URL.FindCompany (Company, City, State *rsltURL)Description:Generates a URL that will search for a web site for the specified company in the city and state. Affiliate Program:Yellow Pages - InfoSpaceInput Parameters:CompanyString containing the target company name. CityString containing the name of the city. StateString containing the name of the StateOutput Parameter:rsltURLString that will be filled with the target URL.GetDirections (StartStreet, StartCity, StartState, StartZip, StartCountry, DestStreet, DestCity, DestState, DestZip, DestCountry, *rsltURL)Description:Generates a URL that provides driving directions between the start and destination locations. Affiliate Program:Driving Directions - MapQuestInput Parameters:StartStreetString containing the street address of the starting location. StartCityString containing the city of the starting location. StartStateString containing the state of the starting location. StartZipString containing the five digit zip code of the starting location. StartCountryString containing the country of the starting location (currently only US is supported). DestStreetString containing the street address of the destination location. DestCityString containing the city of the destination location. DestStateString containing the state of the destination location. DestZipString containing the five digit zip code of the destination location. DestCountryString containing the country of the destination location (currently only US is supported).Output Parameter:rsltURLString that will be filled with the target URL.GetMap (Street, City, State, Zip, Country, *rsltURL)Description:Generates a URL that provides a map of the target location. Affiliate Program:Maps - MapQuestInput Parameters:StreetString containing the street address of the target location. CityString containing the city of the target location. StateString containing the state of the target location. ZipString containing the five digit zip code of the target location. CountryString containing the country of the target location (currently only US is supported).Output Parameter:rsltURLString that will be filled with the target URL.GetNewsBusiness (*rsltURL)Description:Generates a URL that displays business news. Affiliate Program:Business News - LycosInput Parameters:(none)Output Parameter:rsltURLString that will be filled with the target URL.GetNewsGeneral (*rsltURL)Description:Generates a URL that displays general news. Affiliate Program:General News - LycosInput Parameters:(none)Output Parameter:rsltURLString that will be filled with the target URL.GetNewsSports (*rsltURL)Description:Generates a URL that displays sports news. Affiliate Program:Sports News - LycosInput Parameters:(none)Output Parameter:rsltURLString that will be filled with the