AppBuilder New Object Dialog
Beta Draft
Author: (Author's Name)
Date Last Updated: (Date)
Scheduled Release: (Release Number)


Revision History The following revisions have been made to this document:

Date: (date)
Revision: (rev-no)
Developer: (developer)
Summary of Changes: (summary)


Copyright © 2000 by Progress Software Corporation ("PSC"), 14 Oak Park, Bedford, MA 01730, and other contributors as listed below. All Rights Reserved.

The Initial Developer of the Original Code is PSC. The Original Code is Progress IDE code released to open source December 1, 2000.

The contents of this file are subject to the Possenet Public License Version 1.0 (the "License"); you may not use this file except in compliance with the License. A copy of the License is available as of the date of this notice at http://www.possenet.org/license.html

Software distributed under the License is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. You should refer to the License for the specific language governing rights and limitations under the License.


Contributors
Jane Contributor, Joe Contributor


Contents

1. Overview
2. Architecture
3. Primary Data Structures
4. Primary Algorithms and Processes
5. Advanced Topics
6. Dependencies
7. Source Files
8. Build Process and Requirements
9. Execution Methods
10. Test Requirements and Strategies
11. Supplementary Information
12. Related Documentation

1. Overview

The AppBuilder’s New Object dialog box is available to create new design windows, procedures, SmartObject masters, and WebObjects.

2. Architecture

Choosing New from the AppBuilder File menu or choosing the AppBuilder New button invokes the New Object dialog box.

The objects that can be created include one of the following categories:

· Containers

· SmartObjects

· Procedures

· WebObjects

The categories available for object creation depend on the license of the product being used.

A ProVision license (shared variable _AB_license = 1) displays:

· Containers

· SmartObjects

· Procedures.

A WebSpeed license (_AB_license = 2) displays:

· Containers

· SmartObjects (only SmartDataObject)

· Procedures

· WebObjects

A Provision Plus license (_AB_license = 3) displays all object types.

Choosing the Template button invokes the Choose Template dialog box that displays available templates and allows their code to be previewed.

Selecting an object to create from the available object types in the dialog’s selection list returns the template name to the calling routine (choose_file_new internal procedure of adeuib/uibmproa.i). The choose_file_new procedure then invokes Open_Untitled (internal procedure of adeuib/uibmproe.i), passing it the name of the template that it uses to open the template with adeuib/_open-w.p.

3. Primary Data Structures

The _custom temp-table records store custom object file data used by the New Object dialog box. _custom records contain the following data pertinent to the New Object dialog:

· Name

· Base Type (Container, Procedure, SmartObject, or WebObject)

· Attributes (contains template name)

4. Primary Algorithms and Processes

When the AppBuilder initializes, the custom object files are processed (via adeuib/_cr_cust.p) and read into _custom temp-table records used by the New Object dialog box to display objects available for creation. Custom object files are also processed whenever the palette is updated.

5. Advanced Topics

N/A

6. Dependencies

N/A

7. Source Files

This tool uses the following source files:

Source File

Description

adeuib/_newobj.w

New Object dialog box.

adecomm/_fndfile.p

Choose Template dialog box.

adeuib/uibmproa.i

AppBuilder a – d internal procedures, contains choose_file_new which invokes the New Object dialog.

8. Build Process and Requirements

N/A

9. Execution Methods

N/A

10. Test Requirements and Strategies

N/A

11. Supplementary Information

N/A

12. Related Documentation

The following documents provide additional information about the tool:

· AppBuilder Developer’s Guide

· Application Development Environment – Getting Started

· ENV POSSE Programmer FAQs (Word document)

· ENV How to Be a POSSE Programmer (PowerPoint presentation)