Description of the Service Generation tool for Hosted Messaging and Collaboration 4.5

Article translations Article translations
Article ID: 956369 - View products that this article applies to.
This article has been archived. It is offered "as is" and will no longer be updated.
Expand all | Collapse all

On This Page

SUMMARY

This article describes the Service Generation tool. This tool is an updated version of the CSF WES Generation tool that was previously available in the Hosting Solutions CSF Integration Kit. This tool lets you more easily create ASP Web Services and Well Enabled Services (WES) that comply with the Solution for Hosted Messaging and Collaboration core APIs and that integrate with external services, such as Connected Services Framework (CSF).

INTRODUCTION

The Service Generation tool uses a utility that is named Service Generator (ServiceGenerator.exe). You must install the ServiceGenerator.msi manually before you can use this tool. The default deployment location of the Service Generator is under %Program Files%\Microsoft Hosting\Provisioning\ServiceGenerator.

You can use the Service Generator at a command prompt. The syntax and arguments for using this tool are described here:

Syntax

ServiceGenerator.exe /t:<wes|aspnet> /s:<MPFNamespaceFile> /n:<codeNamespace> /c:<className> /i:<imports>[,imports,...] [/o:<targetDir>] [/v:<off|error|info|verbose] [/p:<Csharp|VisualBasic]
Collapse this tableExpand this table
ArgumentUseDescription
/tRequired
  • Type - Select the kind of Web Service generation. Connected Services Framework (CSF) Well-enabled Services and ASP.NET 2.0 Web services are supported.
  • Enum
    • Wes - Generate CSF 3.0 compliant service
    • AspNet - Generate ASP.NET 2.0 Web service
/sRequiredSource - The path of the Microsoft Provisioning System (MPS) namespace file that contains the provisioning API and the XML Schema Definitions that will provide the basis for the service that is generated.
/nRequiredNamespace - The .NET namespace for the service that is generated.
/cRequiredClass - The class name for the service that is generated.
/iRequiredImports - One or more namespaces that will be declared as import or that will use statements that depend on the output language. The output is supplied as a comma-delimited list.
/oOptionalOutput Directory - Output directory for files that are generated. If the directory is not supplied, the current directory is used in which the Service Generator utility is located.
/vOptional
  • Verbosity - Set the verbosity level of the console output. By default, the verbosity mode is set to "info."
  • Enum
    • off
    • error
    • info
    • verbose
/pOptional
  • Provider (CodeDom) - The CodeDomProvider type that is used to generate source code.
  • Enum
    • Csharp
    • VisualBasic

WES Installers

The Service Generator tool can be used to generate Well-Enabled Services (WES) from a well-formed namespace with schema markup. The default location of the WES installers is under \Service Provisioning\WellEnabledServices\ on the Hosted Messaging and Collaboration 4.5 installation disk.

File information

The English version of this update has the file attributes (or later file attributes) that are listed in the following table. The dates and times for these files are listed in Coordinated Universal Time (UTC). When you view the file information, it is converted to local time. To find the difference between UTC and local time, use the Time Zone tab in the Date and Time item in Control Panel.
Collapse this tableExpand this table
File nameHostedactivedirectorywes.msi
File versionNot Applicable
File size702,464
Date (UTC)26-Sep-2008
Time (UTC)10:13
SHA-1 hashNot Applicable
MD5 hashNot Applicable
File nameHostedcdi2007wes.msi
File versionNot Applicable
File size676,864
Date (UTC)26-Sep-2008
Time (UTC)10:13
SHA-1 hashNot Applicable
MD5 hashNot Applicable
File nameHostedemail2007wes.msi
File versionNot Applicable
File size758,272
Date (UTC)26-Sep-2008
Time (UTC)10:13
SHA-1 hashNot Applicable
MD5 hashNot Applicable
File nameHostedmobility2007wes.msi
File versionNot Applicable
File size688,640
Date (UTC)26-Sep-2008
Time (UTC)10:13
SHA-1 hashNot Applicable
MD5 hashNot Applicable
File nameHostedofficecommunicationsserverwes.msi
File versionNot Applicable
File size705,024
Date (UTC)26-Sep-2008
Time (UTC)10:13
SHA-1 hashNot Applicable
MD5 hashNot Applicable
File nameHostedsharepoint2007wes.msi
File versionNot Applicable
File size699,904
Date (UTC)26-Sep-2008
Time (UTC)10:13
SHA-1 hashNot Applicable
MD5 hashNot Applicable
File nameHostedunifiedmessaging2007wes.msi
File versionNot Applicable
File size676,352
Date (UTC)26-Sep-2008
Time (UTC)10:13
SHA-1 hashNot Applicable
MD5 hashNot Applicable
File nameManagedactivedirectorywes.msi
File versionNot Applicable
File size697,344
Date (UTC)26-Sep-2008
Time (UTC)10:13
SHA-1 hashNot Applicable
MD5 hashNot Applicable
File nameManagedplanswes.msi
File versionNot Applicable
File size723,968
Date (UTC)26-Sep-2008
Time (UTC)10:13
SHA-1 hashNot Applicable
MD5 hashNot Applicable
File nameServicegenerator.msi
File versionNot Applicable
File size633,344
Date (UTC)26-Sep-2008
Time (UTC)10:13
SHA-1 hashNot Applicable
MD5 hashNot Applicable
File nameTestservicegeneratorwes.msi
File versionNot Applicable
File size653,312
Date (UTC)26-Sep-2008
Time (UTC)10:13
SHA-1 hashNot Applicable
MD5 hashNot Applicable
Note You may have to supply the Web site and the Virtual directory parameter value in order to deploy these WES installers in your custom development environment.

Prerequisites

In order to be able to use any of these Well-Enabled Services, you must deploy them on a system that is configured as a Microsoft Provisioning System (MPS) client.

The following is a list of the items that you have to install on the computer that you use:
  • Windows Server 2003 R2
  • Microsoft Visual Studio 2005 RTM
  • .Net framework 2.0
You have to have access to the following in your development environment in order to use the Service Generator if you do not want to deploy the solution completely:
  • Access to an instance of MPS from the Microsoft Solution for Hosted Messaging and Collaboration version 4.5.
  • A domain controller that you have administrative access to. This can be a server that runs Microsoft Virtual Server.
  • A server that runs the service that you are creating a provider for and that you can use to try your provider. This can be a server that runs Virtual Server.
Check "Microsoft Hosting Solutions for Service Providers" frequently for updates to the Microsoft Provisioning System SDK. For more information, visit the following Microsoft Web site:
http://technet.microsoft.com/en-us/serviceproviders/default.aspx

Deployment

Before you begin, make sure the computer onto which you plan to deploy this tool meets the Service Generator prerequisites.

Note The computer on which the Service Generator will be installed is referred to as DEV01.

To install the Service Generator utility, follow these steps:
  1. Log on to DEV01 as a member of the Domain Admins group.
  2. Copy the Service Generator installer file (ServiceGenerator.msi) to DEV01.
  3. To start the installation, double-click ServiceGenerator.msi, and then click Next.
  4. On the License Agreement page, click to select I accept the terms in the license agreement, and then click Next.
  5. Complete the Customer Information form, and then click Next.
  6. On the Setup Type page, select the Custom option, and then click Next.

    Note Leave Complete selected if you want to install the Service Generator with the default configuration.
  7. On the Custom Setup page, click the drive icon on the left side of MPS Service Generator, select This feature will be installed on local hard drive, and then click Next.

    Note Click Change to specify a different location to install the Service Generator. By default, the installation location is as follows:
    %Program Files%\Microsoft Hosting\Provisioning\ServiceGenerator
  8. On the Ready to Install the Program page, click Install.
  9. On the Installer Wizard Completed page, click Finish.

REFERENCES

For more information, visit the following Microsoft Web site:
http://technet.microsoft.com/en-us/serviceproviders/default.aspx
If you want additional functionality that exceeds the functionality that the ServiceGenerator.exe utility provides, you can download the Hosting Solutions CSF Integration Kit 1.1 by visiting the following Microsoft Web site:
http://www.microsoft.com/downloads/details.aspx?FamilyID=ca89cd8d-5ad6-4558-a0d0-99e46d7e59a5&DisplayLang=en

Properties

Article ID: 956369 - Last Review: October 21, 2013 - Revision: 2.2
APPLIES TO
  • Microsoft Solution for Hosted Messaging and Collaboration 4.0
  • Microsoft Solution for Hosted Messaging and Collaboration 4.5
Keywords: 
kbnosurvey kbarchive kbautohotfix kbhotfixserver kbqfe kbexpertiseinter KB956369

Give Feedback

 

Contact us for more help

Contact us for more help
Connect with Answer Desk for expert help.
Get more support from smallbusiness.support.microsoft.com