Consultor Eletrônico



Kbase 15333: Starting with Roundtable and an existing application
Autor   Progress Software Corporation - Progress
Acesso   Público
Publicação   10/05/1998
Starting with Roundtable and an existing application

Basic understanding of what a new user is faced with. This should be
directory structure into Roundtable. At lease one pmodule should
independent work area, with it's own code and schema. Define the
the unit of task definition in Roundtable. After creating a task
process that will automatically build Roundtable objects based on
large applications. The load process must be run for each module
be sure to set the SHOW METER flag to NO in the CHARACTER version
code and schema objects on the task in the Roundtable repository.
DRAFT COPY - Currently under review and edit.

INTRODUCTION:
=============
Roundtable needs to register the existing application before and
changes can be made with Roundtable. Use the following steps to
get an application into Roundtable. For a large application these
steps will take a long time. For a large application the user
should consider using a consultant to register the application.


WHY YOU NEED TO KNOW THIS:
===========================
Basic understanding of what a new user is faced with. This should be
helpful to give users a guideline of what they should do first


PROCEDURAL APPROACH:
====================

After loading Roundtable and setting up a repository, use the
following steps to register an application in Roundtable:

1) Build PRODUCTS and PRODUCT MODULES. This maps the application
directory structure into Roundtable. At lease one pmodule should
exist for each sub-directory in the system.
2) Build CODE SUB-TYPES. One sub-type should be created for each
code extension supported. Sub-types define the types of code
objects Roundtable will manage.
3) Build primary development WORKSPACE. A workspace is an
independent work area, with it's own code and schema. Define the
first path entry of the workspace as the root path to this
work area.
4) Define WORKSPACE SOURCES. This is how you tell Roundtable where
a particular product will be managed. The first product will
have a workspace source to it self. (After telling Roundtable
you want to add a workspace source tell it the source workspace
is the current workspace, and the product is the new product you
created in step 1)
5) Create a TASK to load all of the code and dictionary. A task is
the unit of task definition in Roundtable. After creating a task
it must be selected to be able to use the task.
6) Register the database(s) OBJECTS. Select the dictionary module
and create a PDBASE object in Roundtable for each database used
in this application. When creating the PDBASE object use the
logical name of the database as the object name.
7) Load the database schema. Roundtable provides a schema load
process that automatically builds Roundtable objects based on
the Tables and Fields that exist in the database. To begin
the Schema Load process either press <F4> or click the right
mouse button while the cursor is on the Dbase tab folder.
After the load has been done all schema changes should be made
from within Roundtable.
8) Load the code. Roundtable provides a Code Load tool that will
register all of the code in the directories defined in step 1.
The Code Load routine is quite manual, and may be unusable for
large applications. The load process must be run for each module
individually.
9) Compile the application using the Selective Compile process.
With this screen you can tell Roundtable to compile the entire
application using wildcards. When compiling a large application
be sure to set the SHOW METER flag to NO in the CHARACTER version
of Roundtable. All compilable objects must either compile, or
be set to not compilable before starting the next step.
10) Complete the task. This process permanently stores all of the
code and schema objects on the task in the Roundtable repository.
This process will verify that all compiles were completed and
can take a long time.
11) Create a release. A RELEASE certifies the current state of a
workspace. This certification will mark in Roundtable the
starting point of the application and will give you incremental
deployment capabilities as well.


ONLINE PROCEDURES OR UTILITIES:
===============================


REFERENCES TO WRITTEN DOCUMENTATION:
====================================

Refer to the tutorials provided in the character and GUI products
for sample applications and additional setup definition.

Progress Software Technical Support Note # 15333