Managing - Materials
Managing - Materials
Managing
Materials on Rich
Client
PLM00198 - 13.0
Contents
A material is made up of one or more substances. A substance is the basic form of matter that cannot be
disintegrated further using a mechanical or physical process. Each substance has a unique identifier
called Chemical Abstracts Service (CAS) number.
Types of materials
Confidential materials
Confidential materials are materials whose substance composition is kept confidential for competitive
reasons but can be viewed by authorized users such as the materials analyst and the compliance officer.
Unauthorized users can only view the material name and not the material composition in My
Teamcenter.
For example, some materials used in beauty products can be classified as confidential to limit the
number of users viewing the substance composition.
Proprietary materials
Proprietary materials are those materials whose substance composition is kept confidential for
competitive reasons and cannot be viewed in My Teamcenter. Even when checking for substance
compliance, proprietary materials do not contain the substance breakdown. However, a certificate, such
as a waiver, assuming responsibility for the material composition must be attached with the material
substance declaration.
For example, some materials used in health care products can be classified as proprietary because
manufacturers do not want to disclose the substance composition of the materials that they use in these
products.
Non-library materials
Non-library materials are local to NX. For example, for a part designed in NX, the material is created as a
non-library material in Teamcenter and associated to the part.
By default, you can create only one instance of a non-library material in Teamcenter. To create multiple
non-library materials in Teamcenter, set the MATERIALMGMT_allow_only_one_non_library_material
preference to false.
Run Teamcenter Environment Manager (TEM) on a Linux Server or Windows server, and install the
following components:
If you have already installed Teamcenter Foundation, to install the Teamcenter Materials Management
solution, run TEM, and select the Materials Management subfeature under Enterprise Knowledge
Foundation.
If you upgrade to a different version of Teamcenter, you do not need to manually select the Materials
Management subfeature again. Teamcenter automatically installs Materials Management along with
the Teamcenter upgrade.
You can enable a new user group or user role to perform the materials management-related activities by
adding the new role in the MATERIALMGMT_material_creator_roles preference and the new group in
the MATERIALMGMT_material_creator_groups preference.
You can define various conditions or rules that control who can or cannot access various objects using
the access control list in the Access Manager application. This helps to determine whether that specific
Teamcenter user group has permission to view or perform an action, such as deleting an object.
You can also display or suppress the available Materials Management features on the user interface for a
specific Teamcenter user by using the Command Suppression application.
Example:
If you specify ?7439.*.? as the value of the
MATERIALMGMT_wild_card_substance_cas_number_patterns preference and the CAS
number of a substance is 7439-92-1, the system skips the in-built validation for this substance.
This is because the string ?.*.? finds all character sequences with the prefix 7439 and skips the
validation for these substances.
While reimporting existing materials, ensure that the external identifiers for materials are the same.
The material information is in the MatML file format and is converted into the TC XML file format using
the matml_to_tcxml.xsl style sheet. You must update the values of site_id and originatingSite in
the matml_to_tcxml.xsl style sheet to specify the Teamcenter site where you want to import the
information. Your administrator can provide you with the values of site_id and originatingSite.
In Teamcenter, the imported materials are represented differently based on whether the site ID
represents a local site in a single Teamcenter installation or an external site in a multi-Teamcenter
installation.
Importing material information and The materials and substances are created as local objects in
specifying the originating site as the Teamcenter. You can use Teamcenter to modify the
master or local site properties of the locally owned objects.
Importing material information and The materials and substances are created as replicas in
specifying the originating site as a site Teamcenter, and the master copy is owned by the external
in a multisite Teamcenter installation site. You cannot modify these replicas using Teamcenter.
Reimporting material information and If the material already exists in the Teamcenter materials
specifying the originating site as the library, then based on the external identifier, the existing
master or local site material object is updated with the contents of the MatML
file in Teamcenter. Also, the existing MatML dataset is
attached to the material revision with the new copy of the
MatML file.
Reimporting material information and If the material already exists in the Teamcenter materials
specifying the originating site as a site library, based on the external identifier, a new material
in a multisite Teamcenter installation revision is created and the MatML input file is attached as a
dataset to the newly created revision.
1. In the matml_to_tcxml.xsl style sheet, update the values of site_id and originatingSite
with either your local Teamcenter master site ID or the site ID of any other Teamcenter installation
(external site ID).
Use the Organization application to get the Teamcenter site ID or ask your administrator to provide
you with the values of site_id and originatingSite. The imported materials are
represented differently in Teamcenter based on the Teamcenter site ID.
Arguments
-u
Specifies the user ID.
Note:
If Security Services single sign-on (SSO) is enabled for your server, the -u and -p arguments
are authenticated externally through SSO rather than being authenticated against the
Teamcenter database. If you do not supply these arguments, the utility attempts to join an
existing SSO session. If no session is found, you are prompted to enter a user ID and password.
-p
Specifies the password.
Examples
2. In the New Item dialog box, select Material or Compound Material, and click Next.
3. In the Object Create Information dialog box, enter the following information, and click Next.
Field Description
CAS Number (Optional) Denotes the Chemical Abstracts Service (CAS) number of
the material.
IMDS Extended Name (Optional) Specifies the extended name of the material, if the
name exceeds 132 characters.
(If Substance Compliance
IMDS Integration is
installed)
Is IMDS Related object Specifies that the material is an IMDS object. You can upload the
material to IMDS only if Is IMDS Related object is set to True.
(If Substance Compliance
IMDS Integration is
installed)
Field Description
Is the material non-library (Optional) Specifies whether the material is local to NX. You can
create only one non-library material in Teamcenter.
(If Substance Compliance is
installed)
Is the material proprietary (Optional) Specifies whether the material is proprietary, the
substance composition is confidential, and is not visible in My
(If Substance Compliance is
Teamcenter.
installed)
If a proprietary material is used in a part, a waiver certifying full
responsibility for the material composition must be attached with
the material substance declaration.
Teamcenter Unique (Optional) Denotes a unique identifier to search for the material in
Identifier Teamcenter.
4. (Optional) Select the Open On Create check box if you want to open the material view after the
material is created.
5. (Optional) If Substance Compliance IMDS Integration is installed, in the Define business object
create information dialog box, select the appropriate classification from the IMDS Material
Classification list.
6. (Optional) Specify the revision for the new material or click Assign to automatically generate the
revision.
7. Click Finish.
Create semi-components
The Substance Compliance IMDS Integration template must be installed along with Materials
Management to create a semi-component.
2. In the New Item dialog box, select Item, and click Next.
3. In the Object Create Information dialog box, in the Item Information section, enter the following
information.
Field Description
Unit of Measure This field must not be used when creating a semi-
component.
Field Description
IMDS Extended Name (Optional) Specifies the extended name of the semi-
component, if the name exceeds 132 characters.
IMDS Measured Weight per Item (Optional) Denotes the weight of the semi-component.
IMDS Unit Type (Optional) Denotes the unit of measure based on how
the semi-component is used in a part.
For example, a wire as a semi-component would be
measured as 100 grams per meter.
IMDS Polymeric Parts Marking (Optional) Specifies the part marking criteria for the semi-
component.
5. (Optional) Select the Open On Create check box to open the semi-component view on creation.
6. Click Finish.
Create substances
A substance is the basic form of matter that cannot be disintegrated further using a mechanical or
physical process.
2. In the New Business Object dialog box, select Substance, and click Next.
3. In the Object Create Information dialog box, enter the following information, and click Finish.
Field Description
CAS Number Denotes the Chemical Abstracts Service (CAS) number of the
substance.
1. In My Teamcenter, search for the substance that you want to assign to a material.
3. Search for the material to which you want to assign the selected substance.
4. Expand the material revision, select the Substances folder, and choose Edit→Paste.
5. In the Enter the values for Properties on Relation dialog box, enter the following information,
and click Finish.
Field Description
Maximum composition (in Specifies the maximum percentage composition of the substance
%) in the material if the substance composition is defined as a range.
Unlike Composition (in %), the total of Maximum composition (in
%) for all substances in a material can exceed 100%.
Field Description
Example:
The material steel comprises two substances: carbon and
iron. Consider a case where steel with a mass of 100 grams is
used in a part, and the composition of both carbon and iron
is defined as a range.
If the To use maximum composition property is set to true,
when the part is submitted for a compliance check, the
maximum composition of both substances is used. That is,
carbon and iron are calculated at 60 grams each (60% of 100
grams), resulting in 120 grams.
1. In My Teamcenter, click the menu to the right of the search box , and choose Advanced.
2. In the Search view, click the Select a Search menu , and choose More.
• To search for a substance, select Materials Management - Substance, and click OK.
1. In My Teamcenter, select the part or BOM for which you want to view the material and substance
information.
3. In the Show View dialog box, choose Materials Management→Material and Substance
Dashboard.
If the material was imported in the MatML format from an external materials library, you cannot update
the material or the substances in the material.
1. In My Teamcenter, search for the material, compound material, or substance that you want to
update.
1. In My Teamcenter, search for the material that contains the instance of the substance you want to
unassign.
2. Under the material revision, expand the Substances folder, and select the substance that you want
to unassign.
3. Choose Edit→Cut.
Before you delete a material or compound material, ensure that it is not associated with any compound
material, semi component, or part.
Before you delete a substance, ensure that it is not associated with any material.
1. In My Teamcenter, search for the material, compound material, or substance you want to delete.
This utility converts materials from the TC-XML format to the MatML format.
Arguments
-file
Specifies the MatML file that contains the information about the material objects to be exported.
-u
Specifies your user ID.
Note:
If Security Services single sign-on (SSO) is enabled for your server, the -u and -p arguments
are authenticated externally through SSO rather than being authenticated against the
Teamcenter database. If you do not supply these arguments, the utility attempts to join an
existing SSO session. If no session is found, you are prompted to enter a user ID and password.
-p
Specifies the password.
-g
Specifies the group associated with the user exporting the materials.
Examples
1. In My Teamcenter, search for the material that you want to assign to a part.
3. Search for the part to which you want to assign the selected material.
4. Expand the part revision, select the material revision, and choose Edit→Paste.
5. In the Enter the values for Properties on Relation dialog box, enter the following properties:
Field Description
Country of Origin for (Optional) Specifies the list of countries of origin that produce the
Conflict Minerals substance that is on a restricted list, in cases where a material
comprises such substances.
(If Substance Compliance is
installed)
6. (Optional) When the selected material is an International Material Data System (IMDS) material, if
the material contains a restricted substance such as lead or mercury, you must select an application
code if you want to upload the material data sheet to the IMDS:
b. In the Show View dialog box, under IMDS Integration, choose IMDS Integration
Dashboard.
c. On the Application Codes tab, click the cell under the Applied Application code column,
and select the application code from the list.
7. Click Save.
1. In My Teamcenter, search for the part that contains the instance of the material you want to
delete.
2. Under the part revision, expand the Materials folder, and select the material that you want to
delete.
3. Choose Edit→Cut.
material_export
Exports the material and associated substances information in MatML format.
SYNTAX
material_export
[-u=user-id
{-p=password | -pf=password-file}
[-g=group]
[-f=output-xml-file]
[-item=item-id]
[-rev=item–revision-id]
[-optionset=name]
[-transfermode=name]
[-h]
ARGUMENTS
-u
Specifies the user ID.
Note:
If Security Services single sign-on (SSO) is enabled for your server, the -u and -p arguments
are authenticated externally through SSO rather than being authenticated against the
Teamcenter database. If you do not supply these arguments, the utility attempts to join an
existing SSO session. If no session is found, you are prompted to enter a user ID and password.
-p
Specifies the password.
-file
Specifies the MatML file that contains the information about the material objects that are exported.
-item
Specifies the item ID. This argument is mutually exclusive with the -item_key argument.
-item_key
Specifies the a string identifier containing attributes that identify the item object to export. This
argument is mutually exclusive with the -item argument.
-rev
Specifies the item revision ID of the item that must be exported.
-optionset
Specifies the option set name of the transfer option set that must be used for this export.
-transfermode
Specifies the transfer mode name that is to be used during export.
-h
Displays help for this utility.
RESTRICTIONS
None.
EXAMPLES
material_import
Imports MatML file containing the materials and substances information into Teamcenter.
SYNTAX
material_import
[-u=user-id
{-p=password}
[-g=group]
[-file=input-xml-file]
[-dir=input-dir-path]
[-optionset=name]
[-transfermode=name]
[-errorcontinue=yes/no]
[-xsl=xsl-file]
[-h]
ARGUMENTS
-u
Specifies the user ID.
Note:
If Security Services single sign-on (SSO) is enabled for your server, the -u and -p arguments
are authenticated externally through SSO rather than being authenticated against the
Teamcenter database. If you do not supply these arguments, the utility attempts to join an
existing SSO session. If no session is found, you are prompted to enter a user ID and password.
-p
Specifies the password.
-g
Specifies the group associated with the user.
-optionset
Specifies the name of the transfer option set that must be used for this import.
-transfermode
Specifies the transfer mode name that is to be used during import.
-errorcontinue
Specifies the option to control continuation of import when an error is encountered. The default
value is no.
-xsl
Specifies the XSL file that needs to be applied on input material file before the import is performed.
If not provided, the default XSL file is located at TC_DATA is used.
-h
Displays the help for this utility.
RESTRICTIONS
None.
EXAMPLES
Asia-Pacific
Americas Suites 4301-4302, 43/F
Granite Park One AIA Kowloon Tower, Landmark East
5800 Granite Parkway 100 How Ming Street
Suite 600 Kwun Tong, Kowloon
Plano, TX 75024 Hong Kong
USA +852 2230 3308
+1 314 264 8499