tcc_context_upload

Uploads fully or partially configured assemblies to Teamcenter Community Collaboration after downloading them from Teamcenter. This utility does the following: Sets up the staging directory to store the temporary files. Executes a search in RDV setup and downloads the resulting data into a flat file (AJT or PLM XML) by calling the rdv_context_download utility. Calls the asciitojt utility to convert the AJT file downloaded in Step 2 into the JT format. Uploads the JT assembly files into Teamcenter Community Collaboration. Deletes the staging directory. Syntax tcc_context_upload [-u=user-id {-p=password | -pf=password-file} -g=group] [-item_id=item-ID] [-rev_id=revision-ID] [-variant_rule_name=variant-rule-name] [-revision_rule_name=revision-rule-name] [-engg_change_id=engineering-change-ID] [-sco_name=structure-context-object name[ [-folder_name=folder-name] [-process_name=process_name] [-zone_name=zone-name] [-zone_type=BOX | PLANE] [-title=JT-file-base-name] [-stage=staging-area] [-d] [-verbose][-tccuser=TeamcenterCommunity-user-name] [-tccpass=TeamcenterCommunity-password] [-tccanon] [-tcccreds=TeamcenterCommunity-credential-file] [-tccdestination=url] [-keep] [-h] Arguments -u Specifies the user ID. This is a user with Teamcenter administration privileges. 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. This argument is mutually exclusive with the -pf argument. -pf Specifies the password file. For more information about managing password files, see Manage password files. This argument is mutually exclusive with the -p argument. -g Specifies the group associated with the user. If used without a value, the user's default group is assumed. -sco_name Specifies the name of the structure context object. -item_id Specifies the item ID. -rev_id Specifies the revision ID. -key Specifies the key of the item. Use the following format: Copy [keyAttr1=keyVal1] [,keyAttr2=keyVal2]…[,keyAttrN=keyValN] To find the key of an object, use the get_key_string utility. To find the key of an object, use the get_key_string utility. -engg_change_id Specifies the engineering change item ID. The utility configures an RDV context based on change attachments and the latest engineering change revision. -process_name Specifies the name of the Teamcenter workflow processes that have not yet completed. -zone_name Specifies the name of the zone. When both the -zone_name and -zone_type arguments are specified, the utility performs an appearance or QPL search according to the preference settings. -zone_type Specifies the type of the zone, which must be either BOX or PLANE. The -zone_name argument must be used in conjunction with the -zone_type argument. -folder_name Configures a context based on attachments of the folder/envelope/engineering-change-revision-name. The attachments include the following: One product item revision One or more component item IDs Optional revision rule, overwrites the -r argument Optional variant rule, overwrites the -v argument Note Search results are affected by the following Teamcenter preferences: TC_config_rule_name WebDesignContextDefaultSearchDistance PortalDesignContextMaxMatchingObjects PortalDesignContextMaxMatchingBOMLines For more information, see the Teamcenter Environment Variables. -variant_rule_name Specifies the name of the variant rule. -revision_rule_name Specifies the revision rule, which defaults according to the TC_config_rule_name preference. -title Specifies the base name of the JT file. If not specified, it defaults to -I. -stage Specifies the staging area (for example, /tmp). If not specified, it defaults to $TC_TMP_DIR. -d Turns on debugging for the Create bookmark (rdv_context_download) utility. -verbose Turns on debugging for this utility. -tccuser Specifies the Teamcenter Community Collaboration user name if it is different than the user name in the -u argument. -tccpass Specifies the Teamcenter Community Collaboration password if it is different than the password in the -p argument. -tccanon Sets the Teamcenter Community Collaboration login to anonymous, assuming the destination permits anonymous access. -tcccreds Specifies the Teamcenter Community Collaboration externally created credential file for logging in. -tccdestination Specifies the URL for Teamcenter Community Collaboration. -keep Do not delete the staging area after uploading the JT assembly files. -h Displays help for this utility. Environment The TcCUploaderS.jar file must be present in CLASSPATH. The Teamcenter environment must be set to run this utility. As mentioned in the Dependencies section below, the user must have a Teamcenter Community Collaboration login and a Teamcenter Community Collaboration environment set up. If the IMAN_QPL_PROX_FILTER_INCL_COMPS environment variable is set, proximity searches not only return nearby parts for an instance, but also for all of its children and grandchildren. If the IMAN_RDV_VALID_OVERLAYS_ONLY environment variable is set, background searches (the -c or -n argument) return only background component instances overlaying valid combinations of variants. This may cause long processing times. If the environment variable RDVContextDownloadDebug=1 is set, the Teamcenter syslog file contains information about the rdv_context_download utility. If the environment variable RDV_debug=Init+QPL+SearchCriteria+Variants is set, the Teamcenter syslog file contains additional RDV debugging information. Dependencies This utility depends on the TcCUploaderS.jar file. Before using this utility, you must get this file from the Teamcenter Community Collaboration kit and place it in the CLASSPATH on each client host. You must have access to the Teamcenter Community Collaboration environment to run this utility. Restrictions Zone searches (-z) require an NX-based QPL search index with zones or zone filters explicitly created in a product structure for appearance caches. Context searches (-c and -n) require a QPL search index. The attachments include the following: One product item revision One or more component item IDs Optional revision rule, overwrites the -r argument Optional variant rule, overwrites the -v argument Note Search results are affected by the following Teamcenter preferences: TC_config_rule_name WebDesignContextDefaultSearchDistance PortalDesignContextMaxMatchingObjects PortalDesignContextMaxMatchingBOLMLines For more information, see the Teamcenter Environment Variables. Examples The following example uploads the antenna assembly to Teamcenter Community Collaboration, overlaying all applicable variants (the RDV search index is not used or needed). It uses the TC_config_rule_name user preference to determine the revision rule. Copy $TC_ROOT/bin/tcc_context_upload -item_id TL109375 -rev_id 004 -title Antenna -stage /tmp -tccuser subrata -tccdestination http://usamseveh001/mydocs The following example uploads the antenna assembly to Teamcenter Community Collaboration, overlaying all applicable variants (the RDV search index is not used or needed). It enforces a revision configuration using the Beta or less w/pdi revision rule. Copy $TC_ROOT/bin/tcc_context_upload -item_id TL109375 -rev_id 004 -title Antenna -revision_rule_name "Beta or less w/pdi" -stage /tmp -tccuser subrata -tccdestination http://usamseveh001/mydocs The following example uploads a subset of the RDV00190 product assembly that contains all components in the ENGINE zone to Teamcenter Community Collaboration. It also: Requires an NX ENGINE box zone in the top-level NX part file Requires an NX-based QPL search index Overlays all applicable variants May require a higher value for the PortalDesignContextMaxMatchingBOLMLines preference if the ENGINE zone has many components. Copy $TC_ROOT/bin/tcc_context_upload -item_id RDV00190 -rev_id 008 -title EngineCompartment - revision_rule_name "Beta or less w/pdi" -zone_name ENGINE -stage /tmp -tccuser subrata -tccdestination http://usamseveh001/mydocs The following example uploads a subset of the product assembly referenced in the latest revision of the 000042RDV Engineering Change Item, including affected components and their nearby parts within the distance specified in the WebDesignContextDefaultSearchDistance preference. Please note: 000042RDV is expected to reference the following: The affected parts or part revisions (for example, 15759576/003-RADIATOR ASM-(W/ A/C CNDSR) 15006864/015-REINF-RAD UPPER INR SUPT LH 15068174/002-SUPPORT_ASM_RADIATOR). The product item revision (for example, RDV00190/008). The revision rule (for example, Beta or less w/pdi) The subset contains all components inside the ENGINE zone. It requires a QPL search index. It overlays all applicable variants. Copy $TC_ROOT/bin/tcc_context_upload -engg_change_id 000042RDV -title RadiatorSupport -stage /tmp -tccuser subrata -tccdestination http://usamseveh001/mydocs