Template:— work_requirement (wrk_reqt)
Context:— UK_Defence
Date: 2009/10/28 17:51:03
Revision: 1.4

This section specifies the template work_requirement.

NOTE  The template has been defined in the context of UK_Defence. Refer to the business context for details of related templates.

NOTE  An explanation of a template and the associated instantiation path is provided in the Template overview section.

Description

This template describes how to represent the information requirements of a UK_Defence Work Requirement object. A Work Requirement object represents a statement of requirement for work to be undertaken.

Business perspective

A Work Requirement information object is a type of Requirement that provides a set of tasks that may be used to provide a solution (i.e. remedy) to a specified issue (e.g. a symptom/issue) associated with a particular Product (the affected Product).

The tasks identified may or may not be the same as those that are actually carried out, but should identify the solution(s) (or methods) used to bring the Product back into an agreed level of serviceability.

Business object definition

This information object represents the information about a Work Requirement.



Figure 1 —  A MOOD Business Architect representation of the Business Object: Work Requirement

Figure 1 —  A MOOD Business Architect representation of the Business Object: Work Requirement

The attributes of the Work Requirement object are tabled below.

Attribute name

Attribute description

Attribute type

Optionality

Affected Product This is the reference to the product on which the required tasks need to be performed. There may be only 1 Affected Product. Relationship (to Product or subtype) Mandatory
Required tasks This is the reference to the (list of) tasks that need to be performed. Relationship (to Task list) Mandatory

Table 1 — Work Requirement attribute details (note - this object inherits attributes from Requirement in addition to those shown below).

Model diagrams
The EXPRESS-G diagram in Figure 2 shows the templates and EXPRESS entities that are required to represent the template "work_requirement". The text highlighted in blue shows the template parameters.
This figure shows a relationship between a Requirement and a Work_request, via a Requirement_assignment. This allows the other relations from the Work_request to both the affected products and required tasks to be referenced. The id, source organization and version information is the identical across both the Requirement and the Work_request.


Figure 2 —  An EXPRESS-G representation of the Information model for work_requirement

Figure 2 —  An EXPRESS-G representation of the Information model for work_requirement

The graphic for the template to be used in other EXPRESS-G diagrams is shown in Figure  3 below.
This figure shows the additional relationships that are added by the Work_requirement business object.


Figure 3 —  The graphical representation of the work_requirement template

Figure 3 —  The graphical representation of the work_requirement template

Input parameters
The following input parameters are defined for this template:
affected_product (Default=Product,Type= 'ENTITY (Product)' )
The affected Product
required_tasks (Default=Task_method_version,Type= 'ENTITY (Task_method_version)' )
The required tasks
acceptance_criteria (Default=Description of assessment criteria,Type='STRING')
The item description
date_required (Type= 'SELECT (date_or_date_time_select)' , Optional)
The date that the requirements are to be met.
reqt_id (Type='STRING')
The identifier assigned to a requirement.
source_organization_id (Type='STRING')
The organization id code
name (Type='STRING')
The requirement's name
description (Type='STRING')
The requirement's description
priority (Default=Medium,Type='CLASS')
The priority level of the Requirement
The following classes and their sub-classes can be used:
classifications: [Low]
[warning:]Error RDL4: The URI urn:plcs:rdl:uk_defence is not listed in dexlib/data/refdata/rdl_index.xml
[Medium]
[warning:]Error RDL4: The URI urn:plcs:rdl:uk_defence is not listed in dexlib/data/refdata/rdl_index.xml
[High]
[warning:]Error RDL4: The URI urn:plcs:rdl:uk_defence is not listed in dexlib/data/refdata/rdl_index.xml
[Top]
[warning:]Error RDL4: The URI urn:plcs:rdl:uk_defence is not listed in dexlib/data/refdata/rdl_index.xml
version (Type='STRING')
The identifier assigned to a requirement version.
owner (Type= 'SELECT (organization_or_person_in_organization_select)' )
The owner of the requirement.
Reference parameters
The following reference parameters are defined for this template:
wrk_reqt(Type='ENTITY (Requirement)')
Allow the Requirement entity instantiated in this path to be referenced when this template is used.
Note: The Requirement entity can be referenced in a template path by:
%^target = $work_requirement.wrk_reqt%
where target is the parameter to which the Requirement is bound.
wrk_reqt_version(Type='ENTITY (Requirement_version)')
Allow the Requirement_version entity instantiated in this path to be referenced when this template is used.
Note: The Requirement_version entity can be referenced in a template path by:
%^target = $work_requirement.wrk_reqt_version%
where target is the parameter to which the Requirement_version is bound.
wrk_reqt_design_view(Type='ENTITY (Requirement_view_definition)')
Allow the Requirement_view_definition entity instantiated in this path to be referenced when this template is used.
Note: The Requirement_view_definition entity can be referenced in a template path by:
%^target = $work_requirement.wrk_reqt_design_view%
where target is the parameter to which the Requirement_view_definition is bound.
wrk_reqt_design_contxt(Type='ENTITY (View_definition_context)')
Allow the View_definition_context entity instantiated in this path to be referenced when this template is used.
Note: The View_definition_context entity can be referenced in a template path by:
%^target = $work_requirement.wrk_reqt_design_contxt%
where target is the parameter to which the View_definition_context is bound.
Instantiation path
The instantiation path shown below specifies the entities that are to be instantiated by the template.
A description of templates and the syntax for the instantiation path is provided in the Templates Help/Information section.
/requirement(
    acceptance_criteria=@acceptance_criteria,
    date_required=@date_required,
    reqt_id=@reqt_id,
    source_organization_id=@source_organization_id,
    name=@name,
    description=@description,
    priority=@priority,
    version=@version,
    owner=@owner)/

-- re-direct the output from the call..
%^wrk_reqt = $requirement.reqt%
%^wrk_reqt_version = $requirement.reqt_version%
%^wrk_reqt_design_view = $requirement.reqt_design_view%
%^wrk_reqt_design_contxt = $requirement.reqt_design_contxt%

-- To remove - handled by supertype
-- Date_or_date_time_assignment
-- Date_or_date_time_assignment.role='/IGNORE'
-- Date_or_date_time_assignment.items -> ^wrk_reqt_version
-- Date_or_date_time_assignment.assigned_date -> @date_required
%^ra = Requirement_assignment%
Requirement_assignment.assigned_requirement -> ^wrk_reqt_design_view
Requirement_assignment.id = '/IGNORE'
Requirement_assignment.description = '/IGNORE'

-- provide the role of the Requirement_assignment by classifying it
/assigning_reference_data(
    items=^ra,
    class_name='Request_required',
    ecl_id='urn:plcs:rdl:uk_defence')/
/referencing_work_request(
    id=@reqt_id,
    id_class_name='Work_request_identification_code',
    id_ecl_id='urn:plcs:rdl:std',
    org_id=@source_organization_id,
    org_id_class_name='Organization_identification_code',
    org_id_ecl_id='urn:plcs:rdl:std',
    version_id=@version,
    version_id_class_name='Version_identification_code',
    version_id_ecl_id='urn:plcs:rdl:std',
    version_org_id=@source_organization_id,
    version_org_id_class_name='Organization_identification_code',
    version_org_id_ecl_id='urn:plcs:rdl:std')/

-- recast the call for the work request
%^wrk_request = $referencing_work_request.work_req%
Requirement_assignment.assigned_requirement -> ^wrk_request
%^ama = Activity_method_assignment%
Activity_method_assignment.associated_request -> ^wrk_request
Activity_method_assignment.assigned_method -> @required_tasks

-- provide the role of the Activity_method_assignment by classifying it
/assigning_reference_data(
    items=^ama,
    class_name='Related_tasks',
    ecl_id='urn:plcs:rdl:uk_defence')/
%^aia = Affected_items_assignment%
Affected_items_assignment.assigned_work_request -> ^wrk_request
Affected_items_assignment.items -> @affected_product

-- provide the role of the Affected_items_assignment by classifying it
/assigning_reference_data(
    items=^aia,
    class_name='Affected_products',
    ecl_id='urn:plcs:rdl:uk_defence')/
The following entities are instantiated with attributes as specified:
Entity in path Value Inherited from
Requirement_assignment.id '/IGNORE'
Requirement_assignment.description '/IGNORE'
Instance diagrams
The instance diagram in Figure  4 shows an example of the EXPRESS entities and templates that are instantiated by the template:
/work_requirement(acceptence_criteria='Express Model must compile', reqt_id='WRAC-1-001-001', reqt_id_class_name='Work_requirement_id_code', source_organization_id='96412', name='Work Requirement Model ', description='A model of the work requirements is needed.', priority='Top', version='1.11', owner_id ='WR-OFCR-001-001', owner_surname='Tracey', owner_christian_name='Benjamen', owner_middle_name='', owner_prefix_title='', owner_suffix_title='')/
(an illustration of the consolidated work_requirement template is shown in Figure 5 below.)


Figure 4 —  Entities instantiated by work_requirement template

Figure 4 —  Entities instantiated by work_requirement template

The instance diagram in Figure 5 shows the graphic symbol for the template that is to be used in other instance diagrams. The example template is:
/work_requirement(acceptence_criteria='Express Model must compile', reqt_id='WRAC-1-001-001', reqt_id_class_name='Work_requirement_id_code', source_organization_id='96412', name='Work Requirement Model ', description='A model of the work requirements is needed.', priority='Top', version='1.11', owner_id ='WR-OFCR-001-001', owner_surname='Tracey', owner_christian_name='Benjamen', owner_middle_name='', owner_prefix_title='', owner_suffix_title='')/


Figure 5 —  Instantiation of work_requirement template

Figure 5 —  Instantiation of work_requirement template

Characterizations
The following section details how the work_requirement template can be optionally characterized by assigning other constructs to it. These are characterizations commonly applied to the template. The ISO 10303-239 EXPRESS model may enable other assignments to the entities instantiated by the template.
The EXPRESS-G diagram in Figure 6 shows the possible characterizations of the template "work_requirement".


Figure 6 —  Characterizations for work_requirement

Figure 6 —  Characterizations for work_requirement

The following characterizations may apply:
Characterization Document Association

NOTE   this characterization is optional.

A UK_Defence.work_requirement may have specific documents assigned to it, through the use of the following templates (or those based upon these): UK_Defence.document_association , and the associated UK_Defence.document . The following template calls show how these characterizations might be instantiated.

/document_association(id='', type='', source_organization='', purpose='', related_document='', related_item='')/
Characterization Justification

NOTE   this characterization is optional.

A UK_Defence.work_requirement may have a Justification assigned to it, through the use of the following template (or others based upon this): UK_Defence.justification. The following template calls show how these characterizations might be instantiated.

/justification(author_family_name='Smith', author_first_name='John', author_id='JS001', author_middle_name='', author_prefix_titles='', author_suffix_titles='', description='It was necessary', ID='JCTJ1234', ID_class_name='Identification_code', ID_organization='P12345678-801', purpose='Requirement_justification', purpose_ecl_id='urn:plcs:rdl:uk_defence', a_justification_for='#1')/
Characterization Record

NOTE   this characterization is optional.

A UK_Defence.work_requirement may have a Record assigned to it, through the use of the following template (or others based upon this): UK_Defence.record. The following template calls show how these characterizations might be instantiated.

/record(record_of='#xx', ID='R123', ID_source_organization='UK_Defence', Storage_media='Cd_rom', Date_created_year='2008', Date_created_month='1', Date_created_day='24', Date_created_hour='13', Date_created_minute='10', Date_created_second='3', Date_stored_year='2008', Date_stored_month='1', Date_stored_day='25', Date_stored_hour='11', Date_stored_minute='59', Date_stored_second='0', Storage_location_id='RSL01', Storage_location_id_type='Location_assignment_role', Storage_location_id_org='UK_Defence', Storage_location_name='The Record Strorage Depot', Storage_location_description='Depot for storing records', Storage_location_latitude='0.0', Storage_location_longitude='0.0', Storage_location_address_id='1', Storage_location_address_street='Hoo Road', Storage_location_address_postal_box='$', Storage_location_address_town='Newtown', Storage_location_address_region='Rutland', Storage_location_address_postal_code='RT1 3BC', Storage_location_address_country='UK')/
Characterization Status Assignment

NOTE   this characterization is optional.

A UK_Defence.work_requirement may have one or more status assigned to it, through the use of the following templates (or those based upon these): UK_Defence.status_assignment. The following template calls show how these characterizations might be instantiated.

/status_assignment(assigned_status='', assigned_status_ecl_id='', ID='', ID_type='', ID_organization='', subject='', type='', type_ecl_id='')/

© UK MOD 2010 — All rights reserved