update_stx_elements

Updates the preview files of textual work instructions that contain specific standard text elements. The purpose of this utility is to: Systematically find the operation and process revisions that contain textual work instructions that reference a specific standard text element. Update the preview files offline rather than singly in rich client. In a typical case, one or more standard text library elements are revised, reviewed, approved and released. The basic steps to perform the mass update of preview files in relevant textual work instructions are: In My Teamcenter, create a change notice and add the standard text element revisions to the change notice’s Problem Items folder. Apply the release status to the change notice revision. Create or identify a saved revision rule that will configure the released revision of the standard text elements. Identify or create one or more saved revision rules that will configure the revisions of the operations and processes whose work instructions need to be updated. You may use more than one rule, such as a latest working rule and a rule for the most recently released and exported revisions. Run the utility to search for processes and operations, specifying as input the change notice ID, the revision rule names, logon credentials, and the findImpacted argument. Upon completion of the search, the change item's Impacted Items folder contains any process and operation revisions whose work instructions need to be updated. If necessary, you can review and modify the list. Run the utility again to update the textual work instruction preview files, this time using the updateImpacted argument. Once complete, send the updated process and operation revisions in the Impacted Items folder to downstream applications for export. Note The utility updates all of the standard text elements in each textual work instruction according to the stx revision rule. Standard library symbol objects are not supported. For the utility to work, the preference MEWiWorkInstructionMacroTemplate must be set to TWIfor_TC1016OOTB_macro_spec_template. If you use a custom specification template, it must contain all the macros in MEWiWorkInstructionMacroTemplate. The utility requires a Microsoft Office version compatible with Teamcenter 10.1, as defined in the Hardware and Software Certifications knowledge base article on Support Center, and a Teamcenter Manufacturing Documentation license. The logon user must have necessary read and write privileges. Syntax update_stx_elements [-u=user-id {-p=password | -pf=password-file} -g=group] [-cnid=change-notice-item-id] [-stxRevRuleName=rev-rule-for-configuring-stx-text-element] [-structRevRuleNames=comma-delimited-list-of-revision-rule-names-for- configuring-process-and-operation-revisions] {-findImpacted | -updateImpacted} [-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. -cnid Specifies the change notice ID. -stxRevRuleName Specifies the revision rule used to configure the standard text (stx) element. -structRevRuleNames Specifies a comma-delimited list of revision rule names for configuring process and operation revisions. -findImpacted | -updateImpacted The first argument, findImpacted, finds operations or process revisions that have textual work instructions affected by selected standard text elements. The second, updateImpacted, updates the textual work instructions attached to those operations or process revisions with the standard text elements. -h Displays help for this utility.