Working with Add to Teamcenter Interactive


You can add documents to the Teamcenter managed environment using Add to Teamcenter Interactive. The documents that you select to add to the managed library are called direct documents. These direct documents may contain links to other documents or reference other documents, which are known as indirect documents. For example, when you add an assembly to a managed library, all the parts and subassemblies within the selected assembly are indirect documents. Similarly, a part copy within a part document or a part referenced within a drawing document are also indirect documents.

Running Add to Teamcenter Interactive

To run Add to Teamcenter Interactive, from the Start menu, choose UDS QY CAD 2022→Choose PDM Integration→Add to Teamcenter- Interactive.

You can also start Add to Teamcenter Interactive from QY CAD by selecting the Application menu→Manage→Add Document to Teamcenter.

Note:

Before starting Add to Teamcenter Interactive from QY CAD, ensure that the application is not already started.

Revision Rules and Add to Teamcenter Interactive

When you add unmanaged documents to a Teamcenter managed environment using Add to Teamcenter Interactive, you have the option to specify the revision rule used to create the BOM.

The first time you run Add to Teamcenter Interactive, the Teamcenter default revision rule is used. The Session Settings dialog box defines the Revision Rule used by the session.

Progress Log and log files

When you run Add to Teamcenter Interactive, the Progress Log displays vital information so that you do not have to search for it in various log files. However, if you want to consult the log files for additional information, they are available to you as well.

Log files are generated that contain errors or warnings occurring during the file upload transaction. The default location for log files is determined on the File Locations page of the QY CAD Options dialog box.

You can use log files to monitor the success or failure of your documents loading into the Teamcenter database. The log files you will interact with most often are grouped in the subfolder \Add to Teamcenter that is created when you run Add to Teamcenter Interactive. Each file uses a naming convention consisting of a description, timestamp, and file extension. For example, AddToTeamcenter_20180514131232.log. The timestamp is a 14 digit unique identifier using the format YYYYMMDDHHmmss where:

  • YYYY is the year. In the example, 2018.

  • MM is the month. In the example, 05 is May.

  • DD is the day. In the example, 14 is the 14th.

  • HH is the hour using a 24-hour clock beginning at midnight which is 00 and going through 23, which is 11:00pm. In the example, 13 is 1:00pm.

  • mm is the minute. In the example, 12 is 12 minutes past the hour.

  • ss is the seconds. In the example, 32 is 32 seconds past the minute.

Log File

Description

AddToTeamcenter_<timestamp>.log

Contains all Add to Teamcenter Interactive option settings. The setting names are not localized for this development log file.

ATTHistory_<timestamp>.xml

Contains information regarding the blocks of data being added to Teamcenter, the number of links within the block, and how long each block took to load. The history is only reset and cleared if you start a new Add to Teamcenter Interactive process.

TALLog_<timestamp>.xml

The Teamcenter Application Layer log file. Includes a timer so the total time for input is measured accurately.

Output files

When you run Add to Teamcenter, files are generated as output of the process. All output files created from one input list have the same timestamp so it is easy to identify which output file is related to another. The default location for output files is, C:\Users\<username>\AppData\Roaming\UDS\QY CAD\Version 222\Log Files\Add to Teamcenter.

Note:

You must have Microsoft Excel or an equivalent .CSV editor installed to open .CSV output files.

Output File

Description

BrokenLinkLog_<timestamp>.xml

Contains information regarding the broken link and the parent document.

Unordered_<timestamp>.CSV

Lists input files after the completion of the scan for broken links.

Caution:

This file cannot be used as input to the Add to Teamcenter Interactive process.

Ordered_<timestamp>.CSV

Contains an ordered list of your input files along with their reverse links. If a file has a reverse link, it is listed twice with two order numbers and also listed twice in the pass/fail log. The ordered list is generated as a result of the pass/fail log. This file cannot be used as input to the Add to Teamcenter Interactive process.

Note:

You can rename the Ordered_<timestamp>.CSV file and use it as an input file to Add to Teamcenter; however the format must match the expected input. You can only submit one .CSV file for processing at a time.

SuccessFailureLog_<timestamp>.CSV

Lists the documents you are importing and provides a summary of success or failure of the import process for each file. The log is written once per Add to Teamcenter Interactive session even if you elect to suspend or retry the upload process. The order number in this file matches the order number from the Ordered_<timestamp>.CSV file so you can match up entries between the two files during troubleshooting.
Note:

All log and output files persist from one Add to Teamcenter Interactive session to another. Work with your system administrator to develop a schedule to archive the contents of the C:\Users\<username>\AppData\Roaming\UDS\QY CAD\Version 222\Log Files\Add to Teamcenter folder to manage disk space on your computer.

Resuming Add to Teamcenter

When you use the Add to Teamcenter Interactive program, some requested actions may not complete, or they may complete with warnings. In either case, a notification dialog box is displayed. You cannot start a new import of files into the Teamcenter database until the previous one is completed or canceled.

The options on the notification dialog box determine how you proceed. You can view the log generated by the process, view a summary, continue, cancel, suspend, or view help regarding the upload process.

  • View Log —Displays the Add to Teamcenter log file.

  • Summary—Displays the SEEC Information dialog box providing a quick summary of errors or warnings encountered during the Add to Teamcenter process.

  • Continue—Continues the Add to Teamcenter process and starts loading the files into the managed environment. This option is disabled if there are errors noted.

  • Cancel—Exits the Add to Teamcenter process so you can start over. Any processing is discarded and the queue is cleared of documents being loaded into Teamcenter. You are returned to the Add to Teamcenter dialog box.

  • Suspend—Interrupts processing and exits the Add to Teamcenter program, but leaves the import queue intact. Data already created in Teamcenter is not deleted. When you later restart the Add to Teamcenter process using the Retry button, the files resume loading from this point.

  • Help—Displays help information regarding the dialog box.

If you previously suspended the transaction, the notification dialog box is displayed automatically when you next start the Add to Teamcenter program.

Restart a session (workflow) Understanding Teamcenter terms

© 2021 UDS