MARIAN

Attribute-Based Commodity Codes

Version 2007 (6.2) November 2006 DMAR1-PE-200039E

Copyright
Copyright © 2000-2006 Intergraph Corporation. All Rights Reserved.
Including software, file formats, and audiovisual displays; may be used pursuant to applicable software license
agreement; contains confidential and proprietary information of Intergraph and/or third parties which is protected by
copyright law, trade secret law, and international treaty, and may not be provided or otherwise made available
without proper authorization.

Restricted Rights Legend

Use, duplication, or disclosure by the government is subject to restrictions as set forth below. For civilian agencies:
This was developed at private expense and is “restricted computer software” submitted with restricted rights in
accordance with subparagraphs (a) through (d) of the Commercial Computer Software - Restricted Rights clause at
52.227-19 of the Federal Acquisition Regulations (“FAR”) and its successors, and is unpublished and all rights are
reserved under the copyright laws of the United States. For units of the Department of Defense (“DoD”): This is
“commercial computer software” as defined at DFARS 252.227-7014 and the rights of the Government are as
specified at DFARS 227.7202-3.

Unpublished – rights reserved under the copyright laws of the United States.
Intergraph Corporation
Huntsville, Alabama 35894-0001

Warranties and Liabilities

All warranties given by Intergraph Corporation about equipment or software are set forth in your purchase contract,
and nothing stated in, or implied by, this document or its contents shall be considered or deemed a modification or
amendment of such warranties. Intergraph believes the information in this publication is accurate as of its
publication date.
The information and the software discussed in this document are subject to change without notice and are subject to
applicable technical product descriptions. Intergraph Corporation is not responsible for any error that may appear in
this document.
The software discussed in this document is furnished under a license and may be used or copied only in accordance
with the terms of this license.
No responsibility is assumed by Intergraph for the use or reliability of software on equipment that is not supplied by
Intergraph or its affiliated companies. THE USER OF THE SOFTWARE IS EXPECTED TO MAKE THE FINAL
EVALUATION AS TO THE USEFULNESS OF THE SOFTWARE IN HIS OWN ENVIRONMENT.

Trademarks
Intergraph, the Intergraph logo, SmartSketch, FrameWorks, SmartPlant, INtools, MARIAN, PDS, and IntelliShip
are registered trademarks of Intergraph Corporation. Microsoft and Windows are registered trademarks of Microsoft
Corporation. Other brands and product names are trademarks of their respective owners.
 Table of Contents

Table of Contents
Table of Contents ...............................................................................................................3

Introduction........................................................................................................................4
What are Attribute-Based Commodity Codes? ............................................................5

Commodity Code Generation ...........................................................................................6

A.50.01 Attributes ........................................................................................................6
A.50.04 Attribute Sets ..................................................................................................8
Free-Format CC.......................................................................................8
Rule-Driven CC.......................................................................................8
S.10.01 Commodity Rule ...........................................................................................10
S.10.02 Commodity Group.........................................................................................11
S.10.03 Commodity Part.............................................................................................12
S.30.01 Commodity Code...........................................................................................13

MARIAN Attribute-Based Commodity Codes 3

Introduction

Introduction
This document describes the creation of attribute-based commodity codes (CCs). This
type of CCs is new with MARIAN® 5.5.1.

4 MARIAN Attribute-Based Commodity Codes

 Introduction

What are Attribute-Based Commodity Codes?

Attribute-based CCs are directly based on attributes from A.50.01 and not on table
details from S.20.02. They are used to handle tagged material and have the item rule
SWT (standardized item with tag). Attribute-based CCs have no object parameter
attached, and their ident has the geometric input columns set to zero. These
conditions enable each CC to have one ident and multiple tags.

You can build rule-driven CCs or free-format CCs based on attributes:

Rule-driven CCs have an attribute set that works as a commodity rule. The
commodity code string, its description, and the commodity layout are structured
according to this rule.

Free-format CCs are based on a free set of attributes entered to build a CC. The
commodity code and description are entered manually by the user. MARIAN builds
the layout and ensures that the same CC does not already exist in the project and that
another CC with the same attribute value combination does not exist within the same
commodity part.

MARIAN Attribute-Based Commodity Codes 5

Commodity Code Generation

Commodity Code Generation

A.50.01 Attributes
Attributes are the properties of a commodity code (CC). All attributes are created in
A.50.01. They are sorted in groups (formerly called types) and specified with their
datatype, length, description, and so on.

To predefine a list of values on an attribute, you can either enter a SELECT

statement in the Derived From field or change to the second window and enter a list
of distinct values there.

A special feature (the Default column) in the Valid Values section allows you to
select a row in the Comment/Valid Descriptions column to be the default value.
This value will be used unless you enter a value in the CC creation step at a later
time.

In the Comment/Valid Descriptions column, you can enter one or more alternative
strings enclosed in curly brackets. These strings can contain wildcard symbols such
as the percent sign (%) or the underscore sign (_). If you enter a description or the
data is obtained through the interface, the data is validated against the tokens in the
brackets. The comparison is not case-sensitive. When a match is found, the associated
Valid Value data is transferred to the CC and the first string contained in curly
brackets is accepted as the valid description.

6 MARIAN Attribute-Based Commodity Codes

 Commodity Code Generation

For example, if you want to access the value CS when the user types in text
beginning with “Carb” for the attribute MATERIAL, you would record CS in the
Valid Value column with string values such as {Carbon Steel} and {carb%} in the
Comment/Valid Descriptions field. MARIAN now will find CS as the value and set
the description to Carbon Steel.
You can also assign a value in the Valid Value column and leave the
Comment/Valid Descriptions field blank. If you do not place curly brackets around
the text, you can use the Comment/Valid Descriptions field to enter comments by
typing a description in the field.

MARIAN Attribute-Based Commodity Codes 7

Commodity Code Generation

A.50.04 Attribute Sets

Attributes can be combined to create attribute sets. Attribute sets can be used as a
commodity rule or as a default set to build CCs.

Free-Format CC
To create free-format CCs, an attribute set can be used as a master for copying to
create a new CC in S.30.01. You can enter a sequential number in the Seq/Digit
From field. This sequence is kept in S.30.01.

Rule-Driven CC
If you want to create rule-driven CCs, click the associated checkbox. This attribute
set can be used as a rule to structure your CC allowing the Seq/Digit From field to
become mandatory and unique. The Seq/Digit From field determines the purpose of
each CC digit. In the preceding figure, the 1st and 2nd digits are assigned the
th
MATERIAL_INSTR value, the 3rd and 4 digits are assigned the DIAMETER value,
and the 5th digit is assigned RATING information. To limit the digit usage of the last
attribute, assign a value range in the Digit To field.

The Default Value field can contain a fill pattern you can use if the attribute value
does not cover the full length of the reserved digits. If you do not enter a default
value, MARIAN inserts a blank space where needed. You can assign a fixed symbol
(in other words, a hyphen/minus) to appear in your CC by defining a value in the
Digit To field that does not fill the Digit From field of the following attribute. In this
case, the default value is inserted. In a rule-based commodity code, for example,
consider a case where the digits 1-3 are the discipline and digits 4-6 are the material.
A flange commodity code for piping could begin with PIPFLG, filling all 6 digits for
the discipline and material. However, if you abbreviate piping as PI instead of PIP,
you can let MARIAN automatically add a space as the 3rd digit (PIFLG) or put a
hyphen in the Default Value field (PI-FLG).

8 MARIAN Attribute-Based Commodity Codes

 Commodity Code Generation

You can add commodity group and commodity part information to your CC by
defining an attribute called M_COMMODITY_GROUPS or. M_PARTS. Include this
information in the attribute set in the same manner as you define other attributes. On
creation of the CC, the attribute values forming the CC string are derived from the
commodity group/part and the text describing the description/layout of the CC.

MARIAN Attribute-Based Commodity Codes 9

Commodity Code Generation

S.10.01 Commodity Rule

Because a commodity rule is required by the data model for attribute-based CCs, you
must enter a commodity rule in your system if one is not already defined. This rule is
not used for attribute-based CCs, because the data it contains does not matter.

10 MARIAN Attribute-Based Commodity Codes

 Commodity Code Generation

S.10.02 Commodity Group

Commodity Groups are the highest level of grouping material. For attribute-based
CCs, only the name of the group is required. However, you should enter values in the
Rule, Standard, and Short Desc (Description) fields as well. You can build rule-
driven CCs by using the commodity group code in the commodity code string if you
have defined the commodity group code as described in the A.50.04 Attribute Sets
section.

MARIAN Attribute-Based Commodity Codes 11

Commodity Code Generation

S.10.03 Commodity Part

Using this menu, you can define a subdivision in relation to the items of the S10.02 -
Commodity Group. For example, if the Com. Group only describes general pipes,
you can use this menu to define and structure more specific information about
seamless pipes, welded pipes, and so on. Sections of the Com. Part name can be used
to develop the Commodity Code. The Short Desc and Description fields are
contained in the commodity description and commodity layout if you build rule-
driven CCs. Be sure to include the part in A.50.04 Attribute Set. The Rule field is
mandatory for rule-driven CCs, but is not necessary for attribute-based CCs.

You can attach an attribute set to a commodity part. If you attach an attribute set to a
commodity part, the attributes are automatically copied during the creation of the CC
into the S.30.01 Community Code. If you want to use your attribute set as a
commodity rule, you will need the following entry:

12 MARIAN Attribute-Based Commodity Codes

 Commodity Code Generation

S.30.01 Commodity Code

To assign the Commodity Group for the selected Commodity Part, a new commodity
code is generated by performing the following steps:
1. Enter the Group for which you intend to create a commodity code.
2. Mark the Part for which you intend to create a commodity code

3. Enter a temporary placeholder in the Commodity Code field if you build a rule-
driven CC or the authentic CC if you build a free-format one.
4. Set the Type to Attribute Based. The attributes from the attached set will be
copied into the block below.
5. Enter a short description in the Short Desc field. This text is automatically copied
to the Description field.
6. Save all entries and go to the lower block.
7. Manually enter all values with their description or by using the List Of Values
(LOV), if available, and save the entries.
8. You can add more attributes manually or enter a set name in the Additional Set
field. When you have finished, click the Insert Set. If the CC is rule-based, you
cannot add attributes. (See the Kind of Detail field in this block.)
9. Click Build One CC. If the CC is rule-based, the CC changes according to the
attribute set, the description, and the layout. For free-format CCs, only the
commodity layout is created.
Notes
• You cannot use the same CC twice in a project. All attributes and the
values indicating the kind of detail and usage for building the CC

MARIAN Attribute-Based Commodity Codes 13

Commodity Code Generation

must be unique within the part. Using the same attribute/value

combination is not allowed.
• You cannot use the same attribute more than once within one CC.
10. Click Build Ident to create one ident for the CC that has a geometric size of zero
and a hyphen, that is a minus sign, in the ident layout.
The description of the rule-driven CC is created by concatenating in sequential order
the descriptions of all the attributes (used to build this CC). If requested, the part
information is distributed as part short desc into CC Short Desc and part description
into CC Description.

The layout is created by concatenating attribute name value pairs consisting of all
dependent attributes that are defined as building the CC or as the CC layout. The part
information is distributed as part short desc into CC Layout Short and part
description into CC Layout Long. The part information is always first in the layout
string and cannot be suppressed.

14 MARIAN Attribute-Based Commodity Codes