Skip navigation FileNet logo
  Open Client Developer's Guide
  Search  |  Index  |  Glossary   |  
Open menu Overview
Close menu Open Client Architecture
  Project Directory Structure
  Open menu Developing ASPX Pages
  Close menu User Interface Controls
    Open Client Guidelines
    XML / Serialized XML Objects
    Control Factory
  Open menu Data Provider
Open menu Developing for Process
Open menu Error and Exception Handling
Open menu Customizing the Framework
Globalization / Localization
Open menu General Information
   

Open Client Guidelines

  • Each user control should define the supported data format(s).
  • The supported data format should be based on XML / XML serializable objects.
  • The XML data should have a namespace definition.
  • XML Schema should be used to define the XML data format. This enables the use of the .NET XSD.EXE tool to generate XML serializable objects. The user control can then be configured to accept either XML data and/or XML serializable objects.
  • Each user control should define the events that it can fire. However, the ASPX Page container / controller is responsible to determine if and how the user control should handle fired events.
  • User controls are added to an ASPX Page container or .NET server control using the control collection property, Controls. Each user control is added as a child to the collection using a statement similar to the following:
    Ctrl.Controls.Add(ChildControl)
  • The ASPX Page container has to implement the public method ControlCallBack to receive the fired event callbacks from a user control.
  • User controls and Control Factory controls use the AutoPostBack and ViewState features to present the application data to the user.
  • Classes having IDM COM object should have a Dispose() method (Method of IDisposable interface). After using the instance of above specified class, the Dispose() method should be called to clean up resources held by IDM COM object. The Dispose() method should use the “Marshal.ReleaseCOMObject()” to clean up resources held by IDM COM objects. For cases where IDM COM objects are directly used in methods, the “Marshal.ReleaseCOMObject()” can be used to free resources held by IDM COM object.