(r10) APPXSourceCodeControlSystem < Main

Tags: view all tags
---+ APPX Source Code Control System 

_This page describes the Source Code Control System feature of APPX Application Design._ 

%TOC% 
---++ Concepts 
<blockquote style="MARGIN-RIGHT: 0px" dir="ltr">
---+++ Suites / Versions / Applications 

Within the source code control system, applications can be grouped by version and by suite.&nbsp; For example, you might define a suite for the the APPXBANG Business Applications.&nbsp; Within that suite, you might define three versions; a production version (00), a test version (01), and a development version (02).&nbsp; Each version would include the 12 applications that make up the APPXBANG Business Application suite.&nbsp; In this example, there would be 36 separate applications defined in the APPX Application file.&nbsp; An application must be defined in the APPX Application file before it can be included in a source code control system suite and version. 
---+++ Projects / Jobs / Tasks 

Within the source code control system, development tasks are created and managed and are grouped by job and by project.&nbsp; Projects&nbsp;can be created for&nbsp;a Suite, a Suite/Version, or a Suite/Version/Application. 
---+++ Scope 

Scope is usually used to define the boundaries for a Project, Job, or Task.&nbsp; In other words, you can use scope to define which design objects are allowed to be viewed, edited, deleted, etc. when a designer is working on a specific Task.&nbsp; If you want to exercise precise control, scope will let you do that.&nbsp; For example, you could define a Task to modify the CUSTOMER MAINTENANCE input process and you could specify that only that one specific design object (CUSTOMER MAINTENANCE)&nbsp;is allowed to be changed and that it is not allowed to be deleted. However, on the other extreme, if you, as a project manager,&nbsp;don't want to control access to specific design objects, then you&nbsp;can simply not define a scope for a Task. 

When defining the scope for a project, job, or task it is sometimes easier to specify the exceptions.&nbsp; For example, you&nbsp;might define a scope to&nbsp;Exclude all design&nbsp;objects and then, by exception, you&nbsp;might define additional scope records identifying specific design objects to be included.&nbsp; Or, you might take the opposite approach and define a scope to Include all design objects and then, by exception, you might define additional scope records identifying specific design objects to be excluded. 

Scope can be defined for Projects, Jobs, and Tasks.&nbsp; Scope can also be defined for Suites, Versions, and Applications.&nbsp; If you define scope for a Suite, then all projects tied to that Suite, its Versons, or its Applications&nbsp;will be&nbsp;constrained by the scope defined for the Suite.&nbsp; If you define scope for a specific Version of a Suite, then all projects tied to that Version or its Applications will be constrained by the scope defined for the Suite and the Version.&nbsp; The scope defined for a Project, Job, or Task cannot broaden the scope defined for the Suite, Version, or Application that the projected is tied to. 
---+++ Notes 

&nbsp; 

Notes can be attached at many different points within the structure of the source code control system.&nbsp; Notes can be attached to Suites, Versions, Applications, Projects, Jobs, Tasks,&nbsp;Scopes, and Objects.</blockquote>
---++ Suites 

The APPX Source Code Control system requires suites that are to be managed must first be defined.&nbsp; The [[%ATTACHURL%/SuiteMaint1.PNG][Suite Maintenance]] program can be used to enter and edit suites. 
---+++ Suite Attributes 
---++++ Suite ID 

Each Suite is uniquely identified by a 10-character Suite ID. 
---++++ Suite Description 

Each suite has a 30-character description. 
---++++ Design Access 

Design access controls what level of access is allowed for the applications within a suite.&nbsp; Design access must be specified for each suite and is inherited by each application in the suite&nbsp;in the event that design access is not specified for the application or the application's version.&nbsp; The following design access levels are allowed: 
   * <div class="TML">NO ACCESS - Does not allow design objects to be viewed or edited.</div>
   * <div class="TML">VIEW ONLY - Allows design objects to be viewed but not edited.</div>
   * <div class="TML">NOT TRACKED - Allows design objects to be viewed and edited.</div>
   * <div class="TML">TRACKED - Requires that a Project/Job/Task be identified before a design object can be viewed or edited.</div>
---++++ Scope Defaults&nbsp; 

Each Suite must include default scope specifications indicating that all&nbsp;design objects&nbsp;are to be automatically included or excluded and which design modes are allowed for included objects. 

Scope Defaults&nbsp;must be specified for each suite and&nbsp;are inherited by each application in the suite&nbsp;in the event that&nbsp;scope defaults are&nbsp;not specified for the application or the application's version.&nbsp; The scope default fields provide a quick way to specify the equivalent of a scope record for the suite. 

Scope&nbsp;defined at the suite level cannot be overridden by project scope records.&nbsp; In other words, a project manager cannot define a project that is outside of the scope defined for the suite. 

The scope default values&nbsp;are not&nbsp;inherited by individual scope records when the fields are null (The fields should not be null in individual scope records.) 
---+++++ Scope Type 

&nbsp; 
   * INCLUDE - All design objects are __included__ within the scope of the suite.
   * EXCLUDE - All design objects are __excluded__ from the scope of the suite.
---+++++ Allow Add? 

If checked, this option will allow new objects to be added to applications within the suite. 
---+++++ Allow Del? 

If checked, this option will allow objects to be deleted from applications within the suite. 
---+++++ Allow Chg? 

If checked, this option will allow objects to be changed for applications within the suite. 
---++ Versions 

A Suite may have one or more Versions.&nbsp; For example, a suite may have a Production version, a Development version, and a Test version.&nbsp; Versions are identified by a two-character code. The same version code may be used in more than one suite.&nbsp; However, the applications for a specific version may not be assigned to more than one suite. 
---+++ Version Attributes 
---++ Applications 

Each Version of a Suite may have one or more Applications.&nbsp; The same Application may exist in&nbsp;more than one&nbsp;Version. However, a specific application/version may only be assigned to a single suite. 
---+++ Application Attributes 
---++ Scope 
---++ Projects 

Projects can be defined for a Suite, a Suite/Version, or for a Suite/Version/Application.&nbsp; Each project is identified by a 10-character Project ID.&nbsp; Project ID's must be unique&nbsp;at&nbsp;each Suite/Version/Application level.&nbsp; In other words, you can create more than one project with the same Project ID as long as the projects are defined for different Suites, Suites/Versions, and Suites/Versions/Applications. 

Depending on which level a project is define, there is an implied scope constraint.&nbsp; For example, if a project is defined for a specific Suite/Version/Application, then that project can only apply to that specific application and version. 
---++ Jobs 
---++ Tasks 
---++ Notes 
---++ Bugs: 
   1 Suite Maint - Version count is not correct when two suites have been entered.
   1 Suite Maint - Scope count should display "None" when no scope records have been entered.
   1 Suite Maint - &nbsp;needs optional child to go directly&nbsp;to Versions.
   1 Version Maint -&nbsp;needs optional child to go directly&nbsp;to Applications.
   1 Suite Maint - Labels are not being displayed correctly on the buttons on the continuation frame for suites.
   1 Suite Maint - Scope Type, Allow Add?, Allow Del?, and Allow Chg?&nbsp;should all be&nbsp;required fields.
   1 Suite Maint - Field labels need to be more verbose, e.g. "Allow Add?" could be "Allow New Objects To Be Added?
   1 Notes Maint - Titlebar needs to identify the parent type that the note is attached to, e.g. "Source Code Control - Suites"
   1 Notes Maint - Heading area should identify the specific record that the note is attached to, e.g. "Suite: APPXBANG - APPXBANG Business Applications"
   1 Notes Maint - When adding a note, if you press CANCEL, Notes Maintenance is canceled and you are returned to the calling program.&nbsp; You should be returned to the list of notes.
   1 Notes Maint - Change is not allowed from the scrolling list of notes.&nbsp; Change should be allowed. Add, delete, and inquire are all allowed.
   1 Projects/Jobs/Tasks Maint - Add mode is not allowed.&nbsp; I can only add a project from within Application Suites maint.
   1 Projects/Jobs/Tasks Maint - Object record does not show correct notes count.
   1 projects/Jobs/Tasks maint - When viewing Full Log Detail, Object record has no owner.&nbsp; What is the owner field used for?
   1 Fields are missing documentation - document all fields.
   1 Design - Source Code Control panel should not refer to "# for Xfer"
   1 Design - Source Code Control panel refers to "# In Use".&nbsp; Don't know what this means.
   1 Design - Source Code Control - Select Project.&nbsp; Column headings are screwed up.
   1 Design - allowed me to select a task that had a status of pending. - Changed the status to Active automatically.&nbsp; Seems like the status should be Assigned before it can be selected.
   1 Design - SCC - Select Project - Does not show all available projects.&nbsp; Maybe because they all had the same Project ID?
   1 Design - I made a change to an input object and it did not prompt me for a comment describing the change when I exited from&nbsp;the object.&nbsp;
   1 Design - When looking at the scrolling list of input process, there is no indication of which ones have been changed.
   1 Design - If I hover over the title Project message, the tooltip that pops up has truncated info.
   1 Design - Object status screen - data fields are offset to the left and display on top of field labels.
   1 Design - Options pulldown list all items twice
   1 Design - Help pulldown list all items twice
   1 Design - SCC panel on menu still showed 0 in use after I had made a change to an input object.
   1 Design - SCC Log detail - shows changed=N for an input object after I made a change.
   1 Design - Tried to add a comment to an&nbsp; audit history record.&nbsp; Would not save comment.
   1 Design - SCC panel on design menu has a label "Control Level".&nbsp; System Admin uses "Design Access".&nbsp; We need to be consistent.
   1 XFER - SCC let me select object that was not complete.
   1 XFER - SCC Status values are IDENTIFIED, ACTIVE, and COMPLETED?&nbsp; What is this field??
   1 XFER - SCC needs to allow xfer of Project, Job, or Tasks based on Dependence &amp; Mgt Status.&nbsp; Should individual objects be allowed to be excluded?
   1 XFER - status column not lined up.
   1 XFER - two counts in footer - What are they?
   1 XFER - Clear All and Select All buttons don't seem to work.
   1 XFER - Selected For Xfer logic field should not allow null value
   1 SCC Inquiries - Menu says "Object History" - screen says "Object Inquiry".
   1 SCC Inquiries - Menu says "Objects Inquiry" - screen says "Audit Information - Search".
   1 Project Maint - need to enter field doc.
---++ Enhancements: 
   1 Scope Maint - Need to be able to scan on Object Name field.
   1 Scope Maint - Need to be able to see all higher level scope records.
   1 Projects - need to be able to change the level that a project is attached to - Suite, Version, Application.&nbsp; For example, if attached to suite, need to be able to move the project to a version or individual application.

&nbsp; 

-- SteveFrizzell - 29 Oct 2007
Attachments
Topic attachments
I	Attachment	History	Action	Size	Date	Who	Comment
PNG	SuiteMaint1.PNG	r1	manage	30.0 K	2008-04-23 - 15:47	SteveFrizzell	Suite Maintenance
Topic revision: r10 - 2008-04-25 - SteveFrizzell
~~Edit~~
~~Attach~~