Using Windchill Gateway for Cadence Allegro Design Workbench
Windchill Gateway for Cadence Allegro Design Workbench provides the following synchronization scripts:
|
Script Name
|
Required Arguments
|
Function
|
|
run_ADW_Adapter.bat
|
• namingServiceName
• adapterServiceName
|
Starts the adapter
|
|
ExportWindchillPartsToLibrary.bat
|
• username
• password
• wncTaskDispatcherURL
• adapterServiceName
• contextType
• exportFromContextName
• partNumberPattern
• pageSize
|
Exports Windchill parts to the library and calls an internal library script to register them. (Registration prevents a part from being exported more than once.)
|
|
ImportLibraryPartsToWindchill.bat
|
• username
• password
• wncTaskDispatcherURL
• adapterServiceName
• contextType
• importContextName
• importFolderName
• pageSize
|
Imports Library parts to Windchill and creates the appropriate response file.
|
|
If ADW Library is synchronizing with FBA (Form Based Authentication) enabled Windchill Server, wncTaskDispatcherURL must contain protocolAuth prefix: http://<windchilldomain>/<windchillname>/protocolAuth/servlet/SimpleTaskDispatcher
|
|
Arguments for these scripts are defined as follows:
|
Argument Name
|
Value
|
|
namingServiceName
|
Info*Engine Adapter configuration name (in format <windchill domain>.<hostname>.namingService). namingServiceName ends with ‘namingService’ suffix.
|
|
adapterServiceName
|
Info*Engine Adapter name – corresponding Info*Engine Adapter name (in format <windchill domain>. <hostname>. <adapterName> (in Info*Engine example described in this document, adapterName was defined as ‘adw’).
|
|
Username
|
The user name used to log in to Windchill.
|
|
password
|
Corresponding password used to log in to Windchill.
|
|
wncTaskDispatcherURL
|
A full URL to Windchill Task Dispatcher in format: http://<windchill domain>/<windchill name>/servlet/SimpleTaskDispatcher
|
|
If ADW Library is synchronizing with FBA (Form Based Authentication) enabled Windchill Server, wncTaskDispatcherURL must contain protocolAuth prefix: http://<windchilldomain>/<windchillname>/protocolAuth/servlet/SimpleTaskDispatcher
|
|
|
exportFromContextName
|
The Windchill context name from where parts are exported to the library side.
|
|
contextType
|
Library or product.
|
|
partNumberPattern
|
The exact part Windchill number (equals to Allegro Design Workbench Library part name) or pattern (“%001”) that must be exported.
If the wild card (%) is used, the script argument partNumberPattern must be in the quotation marks, for example “%001”.
|
|
importContextName
|
Windchill context name where synchronized objects (parts) reside.
|
|
importFolderName
|
Windchill folder name where synchronized objects (parts) reside.
|
|
pageSize
|
The maximum number of parts, imported/exported during one transaction and described in a single XML file.
|
The user of any library machine must start the Allegro Design Workbench Adapter using the run_ADW_Adapter.bat script, and then proceed with synchronization tasks. The only other scripts which MUST be run in order for synchronization to occur are ExportWindchillPartsToLibrary.bat and ImportLibraryPartsToWindchill.bat. However, it is likely that most users want to automate these tasks.
|
|
If exportFromContextName or importFolderName values contain white space, they must be surrounded by double quotes.
|
|
|
It is possible to use a scheduler, such as the Windows Scheduled Tasks utility, to invoke the scripts described in this section. Automatic execution can provide ongoing ”behind the scenes” synchronization.
|
Synchronizing the Part When the Part is Checked out in Windchill and Checked out in ADW
|
Check-out Status
|
Initial Sync of the Part?
|
State of Checked-out (original) Part in sending application
|
ADW to Windchill
|
Windchill to ADW
|
|
The part is checked out in Windchill
|
No
|
Changed
|
Not allowed
|
Allowed
|
|
Yes
|
Not changed
|
Not allowed
|
Export to Windchill gives the following warning message in the ADW logs that are generated on the Windchill server:
WTPart with number XX-XX-XX was previously exported. Skipping it. “No parts need or can be exported from Windchill to ADW Library. See ADW log file for more details.”
|
|
Yes
|
New
|
Not allowed
|
Allowed
|
|
The part is checked out in ADW
|
No
|
Changed
|
Allowed *
|
Allowed
|
|
Not changed
|
Allowed *
|
Allowed
|
|
Yes
|
New
|
Allowed *
|
Allowed
|
|
|
*: To disable ADW to Windchill synchronization, perform the following step.
If checked out objects in ADW are not to be sent in export.xml to PTC, in <windchill sync system>/configuration/query.xml, change the following setting:
<Attribute name="current" value="" />
to
<Attribute name="current" value="!~~Checkout" />
|
