Notice: This website is an unofficial Microsoft Knowledge Base (hereinafter KB) archive and is intended to provide a reliable access to deleted content from Microsoft KB. All KB articles are owned by Microsoft Corporation. Read full disclaimer for more details.

Office Web Component (O.W.C.) interactive usage


Author: Alvin Bruney MVP

View products that this article applies to.

Abstract

The new rules allow for one computer to share its installed�O.W.C. interactive license with an unlimited number of computers giving these computers the capability to experience an interactive�O.W.C. application even though these computers do not have a qualifying Microsoft product or a valid license installed. You may recall that static, non-interactive use of the Office Web Components is always free for versions 10 thru 11 of the�O.W.C. but interactive usage requires a license. Licensing information for the components can be found on the Microsoft Office website and in Community solutions article � 555075 in sufficient detail. The new licensing rules do not apply to�O.W.C. version 9 and will not be considered here. The new licensing terms do have serious restrictions and these will be examined here.

↑ Back to the top


Examining the new rules

Interactivity can be extended thru shared licensing. There are some overriding qualifications and conditions which regulate its use. A shared license may only be extended to another desktop if there is explicit intent thru policy or otherwise to install a qualifying product at a later date. This option is only extended to business entities�that own an Enterprise, Select, or Maintenance Agreement for Microsoft Office. As an example, let�s consider a corporate intranet scenario where an application developed with the�O.W.C. needs to be deployed in an interactive manner. The corporate entity fully intends to install qualifying products such as Microsoft Excel on all desktops and possesses an Enterprise level agreement. The installation forms part of the new corporate policy to upgrade all Microsoft Excel software to the most recent version. Let�s assume further, that the company is fairly large so that the roll out will take a significant amount of time and will be done in phases. In this case, the corporate entity has the option to use shared licensing to allow users who aren�t yet part of the roll out to participate in�a full interactive experience.

The licensing requirements are straightforward. The business entity must fully intend to install qualifying products on every desktop which will experience interactivity. You may take from this discussion that shared licensing is best suited for a corporate setting where a guarantee can be made either with policy or otherwise that each desktop will eventually install a qualifying product. An example of policy may be�an Enterprise level Agreement. Because of these restrictions, shared licensing cannot legally be used in an internet scenario. The overriding concern here is that a guarantee cannot be made either�thru policy or otherwise�that the client computers accessing the components will, at some point in time, install a qualifying product to cause interactivity. Consequently, all internet shared licensing is necessarily a breach of the new licensing terms of use for�O.W.C. versions 10 and 11.

For Independent Software Vendors, the licensing requirements are the same. The rule of thumbs to use is:
Does a formal Enterprise, Select, or Maintenance agreement exist?
Can the business entity guarantee thru policy or otherwise that every computer will eventually install a qualifying product?

Because of the nature of the ISV business, most ISV's cannot make that guarantee. Rather than leaving your business entity open to litigation, you should use the�O.W.C. in a non-interactive manner. Remember, non-interactive usage is always free and requires none of the above�qualifying conditions. It does require installation of the Office Web Components. Shared licensing�is best suited for�intranet scenarios and mostly apply to�corporate settings for the previously stated reasons.

↑ Back to the top


How to: implement shared licensing

Shared licensing is implemented thru a special file called the License Package File (LPK). The LPK is implemented using an License Package Authoring Tool which is a free utility provided by Microsoft available on the Microsoft website or here. A discussion on how to use the LPK Tool is provided in the documentation which comes with the tool and will not be provided here. This license file allows one computer with a valid installation of the�O.W.C. and a qualifying product such as Microsoft Excel�or valid�O.W.C. license to share its valid license with another client computer in a temporary manner. This special licensing file or LPK must be placed on the server serving the web pages which contain the�O.W.C. component. The path to this file is exposed to the browser thru a special parameter inside an object manager tag. Usually, the developer writing the application hard codes the object manager inside the web page using the special object tag. The object manager tag must be the first tag inside the web page and it may not be customized with attributes such as width and back color for example. Consider an�O.W.C. object manager embedded in a webpage which may look like the following:

<OBJECT CLASSID="clsid:5220cb21-c88d-11cf-b347-00aa00a28331">
�� <PARAM NAME="LPKPath" VALUE="LPKfilename.LPK">
</OBJECT>


At run-time the hosting container, usually a browser, examines this object tag embedded in the webpage. The browser extracts the path and attempts to find the LPK file pointed to by the path. The path variable is relative and the value name should not be changed. Failure to find this path results in view-only mode use. If the file is found, it is parsed to retrieve a special key which is used as a hash into the permissions manager. A successful hash value results in an�O.W.C. component able to render in interactive mode, otherwise, the component renders in view-only mode. Observe that the LPK file is the instrument used to grant interactive use so�the necessary precautions should be taken to secure the contents of the LPK file on the server.

The implications of these rule changes are subtle but very important. Notice that interactivity no longer depends on a qualifying Microsoft Office product installed on the computer. The license object manager now has the option to retrieve a valid client license from the server and share it with the requesting client�to allow interactivity. This retrieval is automatic and occurs when a hosting container detects that the webpage contains an embedded object manager. The hosting container takes care of the permissions request and passes the license key obtained from the LPK file to the license manager for authentication.

It�s important to point out that if the object tag is tampered with, the licensing hash will fail and only render in view-only mode. A number of view-only problems can be resolved simply by verifying that the CLASSID is correct and that the path pointed to is valid. Visual studio contains an annoying bug which will remove the path variable from the object manager tag resulting in non-interactive use any time the aspx file is changed. Remember that the default mode is view-only or non-interactivity for versions 10 and 11 of the Office Web Components.

Hopefully, this article has shed some light on interactive usage for the O.W.C.. For qualifying products which install a valid�O.W.C. license, please consult the Microsoft office website.

↑ Back to the top


Community solutions content disclaimer

Microsoft corporation and/or its respective suppliers make no representations about the suitability, reliability, or accuracy of the information and related graphics contained herein. All such information and related graphics are provided "as is" without warranty of any kind. Microsoft and/or its respective suppliers hereby disclaim all warranties and conditions with regard to this information and related graphics, including all implied warranties and conditions of merchantability, fitness for a particular purpose, workmanlike effort, title and non-infringement. You specifically agree that in no event shall Microsoft and/or its suppliers be liable for any direct, indirect, punitive, incidental, special, consequential damages or any damages whatsoever including, without limitation, damages for loss of use, data or profits, arising out of or in any way connected with the use of or inability to use the information and related graphics contained herein, whether based on contract, tort, negligence, strict liability or otherwise, even if Microsoft or any of its suppliers has been advised of the possibility of damages.

↑ Back to the top


Keywords: KB555094, kbhowto, kbpubmvp, kbpubtypewp, kbpubtypecca

↑ Back to the top

Article Info
Article ID : 555094
Revision : 1
Created on : 4/18/2004
Published on : 4/18/2004
Exists online : False
Views : 470