assigning_activity

Template:— assigning_activity (asg_act)

Date: 2008/01/16 14:19:35
Revision: 1.15

Cover Contents Description Model diags.Input params.Ref. params.Instantiation path Instance diags.Characterizations Issues

This section specifies the template assigning_activity.

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

Description

This template describes how to assign an activity to something in a given role. For example, a maintenance activity that has been performed on a product is recorded by assigning an Activity_actual to a Product_as_realized.

Model diagrams

The EXPRESS-G diagram in Figure 1 shows the templates and EXPRESS entities that are required to represent the template "assigning_activity". The text highlighted in blue shows the template parameters.

Figure 1 — An EXPRESS-G representation of the Information model for assigning_activity

The graphic for the template to be used in other EXPRESS-G diagrams is shown in Figure 2 below.

Figure 2 — The graphical representation of assigning_activity template

Input parameters

The following input parameters are defined for this template:

role_class_name (Type='CLASS')

The class name of the External_class corresponding to the role of the assignment, e.g. "Activity_input" (urn:plcs:rdl:std:Activity_input), or "Activity_output" (urn:plcs:rdl:std:Activity_output).

The following classes and their sub-classes can be used:

classifications: "Applied_activity_assignment" (urn:plcs:rdl:std:Applied_activity_assignment)

role_ecl_id (Default=urn:plcs:rdl:std,Type='URN')

The identifier of the External_class_library storing the definition of the class referenced by the parameter @role_class_name.

assigned_activity (Type= 'ENTITY (Activity)' )

The activity to which the items are assigned

items (Type= 'SELECT (activity_item)' )

The activity, product, individual, task_method, etc that is being assigned to the activity.

Reference parameters

The following reference parameters are defined for this template:

appl_act(Type='ENTITY (Applied_activity_assignment)')

Allow the Applied_activity_assignment entity instantiated in this path to be referenced when this template is used.

Note: The Applied_activity_assignment entity can be referenced in a template path by:

%^target = $assigning_activity.appl_act%

where target is the parameter to which the Applied_activity_assignment 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 Reading Capability Templates help section.

-- Instantiate an Applied_activity_assignment
Applied_activity_assignment

-- Bind the Applied_activity_assignment to the reference parameter
%^appl_act = Applied_activity_assignment%

-- Set the Applied_activity_assignment attribute role to be ignored
Applied_activity_assignment.role = '/IGNORE'

-- Assign reference data for role of Applied_activity_assignment
/assigning_reference_data(
    items=Applied_activity_assignment,
    class_name=@role_class_name,
    ecl_id=@role_ecl_id)/

-- Assign the Applied_activity_assignment to the
-- to the instances passed into the template through the @items
-- input parameter (e.g. a Product_as_realized)
Applied_activity_assignment.items -> @items

-- Assign the Applied_activity_assignment to the
-- to the Activity passed into the template through the @assigned_activity
-- input parameter (e.g. a Product_as_individual_view)
Applied_activity_assignment.assigned_activity -> @assigned_activity

The following entities are instantiated with attributes as specified:

Entity in path	Value	Inherited from
Applied_activity_assignment.role	'/IGNORE'	—

Instance diagrams

The instance diagram in Figure 3 shows an example of the EXPRESS entities and templates that are instantiated by the template:

/assigning_activity(role_class_name='Activity_output', role_ecl_id='urn:plcs:rdl:std', items='#237', assigned_activity='#235')/

(an illustration of the consolidated assigning_activity template is shown in Figure 4 below.)

Figure 3 — Entities instantiated by assigning_activity template

The instance diagram in Figure 4 shows the graphic symbol for the template that is to be used in other instance diagrams. The example template is:

/assigning_activity(role_class_name='Activity_output', role_ecl_id='urn:plcs:rdl:std', items='#237', assigned_activity='#235')/

Figure 4 — Instantiation of assigning_activity template

Characterizations

No common characterizations of the template assigning_activity have been identified. However, the ISO 10303-239 EXPRESS model may enable other assignments to the entities instantiated by the template.