Bentley Transmittals Services (BTS) for ProjectWise FAQs
Installation and Setup
PLEASE NOTE: For full installation instructions, please refer to the Bentley Transmittals Services (BTS) Implementation Guide provided with the software before posting questions.
1) What is the recommended configuration for Bentley Transmittals Services?
BTS consists of three modules, Bentley Transmittals Server, Bentley Transmittals Portal and the Bentley Transmittal connector for ProjectWise, in addition to your existing ProjectWise SELECTseries 4 Integration Server (Transmittals does NOT function with prior SELECTseries versions of the Integration Server). Each module should be installed on its own computer for optimal performance.
2) What type of database is supported for Bentley Transmittals Services?
BTS currently is supported to run on Microsoft SQL Server 2008 Standard or Express (see BTS readme for specific requirements.) Oracle is not currently supported for the Bentley Transmittals database, but we do support an environment where your ProjectWise Database is running on Oracle.
3) What is Filestream and why does it need to be enabled?
Filestream is a feature of SQL 2008 that allows transmittals themselves to be stored in the database. Enabling file stream on an existing database engine should not affect any existing databases any more than reporting services would affect them; it’s just another SQL feature.
Please read this link for more information on SQL FILESTREAM.
http://msdn.microsoft.com/en-us/library/cc949109.aspx
4) Can I customize the cover letter?
Yes. Variables can be added or removed to the Excel template file, see the Bentley Transmittals connector for ProjectWise user guide for a full list. To modify the template simply modify the existing template that was imported into your ProjectWise datasource when running the initial BTS configuration wizard.
5) Can I move the cover letter template to a new folder?
Yes, since PW uses a GUID (global unique ID) to identify documents, Transmittals will be able to find the template wherever it’s moved within the datasource.
6) When running the Bentley Transmittals Server Deployment Wizard, why is my Integration Server not listed?
On your ProjectWise Integration Server, open dmskrnl.cfg and search for CADOperators (default setting is CADOperators=Administrators)
If the user that you are logged into the Transmittals Server machine is not a local administrator on the Integration server, add it to this list
- Example: CADOperators=Administrators;domain\user.name
7) Will Bentley Transmittals Services run in a load balanced cluster?
No. The Transmittal Service layer/portal does not support load balancing. You *can* load balance the PW Integration Servers, as long as they all point at the same Transmittals Service endpoint.
See the BTS Implementation guide for further instructions on how to configure Transmittals with a PW clustered environment.
8) Can one Transmittal Server be configured to handle multiple datasources?
Each Bentley Transmittal Services instance is configured for one ProjectWise Integration Server. If that Integration server is configured with multiple datasources, you will have the ability to enable transmittals on each of those datasources.
9) After installing, I log into ProjectWise Administrator and am not prompted to enable transmittals in the datasource when it isn't already enabled.
What likely happened is that someone had already answered NO to the prompt to not enable transmittals in that datasource, which it will only ask once. To then enable transmittals you can right click on the datasource after logging in through the Administrator and select All Tasks>Enable Bentley Transmittal Services for this datasource. log out and log back in to get prompted to enable transmittals on that datasource.
10) My server is in a DMZ, what ports need to be open on the firewall?
When you configure your BTS Server you configured a net.tcp binding on your IIS Web Site, the port you chose to use is the port that is used from the Portal Server to the Transmittals Server and continuing to the PW Integration Server.
When you configure your BTS Portal Server, you similarly configured an IIS Web Site, this time with an https binding. This port is what users will connect over when accessing the portal through their web browser
PWE:
- [Outgoing] [to PWIS machine] [TCP:5800] PW connection to PWIS and BTS-via-PWIS.
PWIS:
- [Incoming] [from PWE clients] [TCP:5800] PW connection to PWIS
- [Incoming] [from BTS client] [TCP:5800] PW connection to PWIS
- [Outgoing] [to BTS machine] [TCP:<IIS/net.tcp>] connection from PWE via PWIS on a TCP port defined for IIS site where BTS services are deployed.
- [Outgoing] [to PW Database machines] [TCP:<depends on db>]
BTS:
- [Incoming] [from PWIS machine] [TCP:<IIS/net.tcp>] connection from PWE via PWIS on a TCP port defined for IIS site where BTS services are deployed.
- [Incoming] [from Portal machine] [TCP:<IIS/net.tcp>] connection from Portal on a TCP port defined for IIS site where BTS services are deployed.
- [Incoming] [from Portal machine] [TCP/HTTP(80) ] connection from Portal deployment app for service discovery on a http port (80).
- [Outgoing] [to PWIS machine] [TCP:5800] PW connection to PWIS.
- [Outgoing] [to BTS Database machine] [TCP:1433] SQL server connection
Portal:
- [Outgoing] [to BTS machine] [TCP:<IIS/net.tcp>] connection from Portal on a TCP port defined for IIS site where BTS services are deployed.
- [Outgoing] [to BTS machine] [TCP/HTTP(80) ] connection from Portal deployment app for service discovery on a http port (80).
- [Incoming] [from user machines] [TCP/HTTP(80)/HTTPS(443)] connection to Portal IIS, depending on site settings.
ProjectWise Explorer
1) Can I enable multiple projects at once for Transmittals?
No, you must go to the properties of each project that needs it, and enable Bentley Transmittal Services. Once enabled, you can copy settings from another project that you have already configured.
2) Why are the OK and Apply buttons greyed out in the Transmittals Settings in PW Explorer?
Make sure your user has the user setting “Allow user to change project types and project properties” turned on.
3) When issuing a transmittal, I get the error “Cover letter generation has failed while filing the cover letter. Class not registered”
Verify that Microsoft Excel is installed (see Transmittals Readme for specific requirements)
4) What happens if the number of transmittals I have in my project exceeds the number of digits I set in the Transmittal settings?
The number will automatically increment beyond the limit.
Portal
1) When downloading content, Internet Explorer gives this error that it cannot be downloaded
Check your browser settings under Internet Options and turn off the setting under Security “Do not save encrypted pages to disk”
2) Why can’t I see a thumbnail of the documents, “preview not available”?
Thumbnails are not available in V1.0
3) My link sets aren’t appearing from the downloaded transmittal package
Transmittal packages do not currently support the adding of documents with link sets, if the linked documents exist in a different folder than the master document
4) Why am I getting a corrupt file message when trying to download cover letter file from portal after changing my ProjectWise datasource name?
Renaming the ProjectWise datasource after configuring Bentley Transmittal Services is not recommended, as it can break certain Bentley Transmittal Services functionality. To restore full functionality, change the datasource name back to what it was during the BTS install.
5) Why am I getting an Internet Explorer dialog asking “Do want to stop running this script?” if you have lots of documents (About 700) in one folder or choose “Show all folder content”.
This is standard behavior for IE8. To resolve this, upgrade to IE 9. If upgrading to IE 9 is not an option, use the folder tree and save smaller amount of documents in each folder (ex 200 in one folder.) This work-around will solve the issue until pressing “Show all folder content” button.
6) I opened a master file from my transmittal package, but the references are not appearing.
When you download the package, it will be a zip file, you must first extract the zip file before opening the files and it will find the valid reference files.
7) Can one Transmittal Portal be configured for multiple Transmittal Servers?
No. Each portal is configured for one Transmittal Server.
8)WhatifIneedtochangetheportallinkinmytransmittalsemail,myuserscannotreachthehttps:\\servername\portal
Pleaseseethefollowingtechnote:http://communities.bentley.com/products/projectwise/content_management/w/wiki/configure-bentley-transmittals-portal-for-projectwise-to-use-a-specific-url.aspx
9)HowdoIcustomizetheheadlineonthePortalsite?
Therearetwofiles,oneforthelogonscreenandanotherfortheotherpagesoftheportal. Theyarebothchangedinthesamemanner.
C:\ProgramFiles\Bentley\Transmittals\portal\views\account\logon.cshtml
C:\ProgramFiles\Bentley\Transmittals\portal\views\shared\_Layout.cshtml
Thelinethatneedstobechangedis
<spanclass="clientHeader">@View.Layout_CustomizableHeadline</span>
bychangingtheentiresectionbetweenthe><,youcanchangetheheadline.
Forexample: <spanclass="clientHeader">Thisismyheadline</span>