Trimble asked me today to start a post on the forum here on the TML Library update that was made the week of July 4th, and that I will update as we move into the future.
Trimble and Rockpile Solutions have formed a business partnership around the TML Macros. Originally the TMLs created by Trimble were developed to test the TML Programming environment to make sure that it worked and so we could test the TML programming language and it's integration with the TBC database and object libraries etc. The TMLs were also created to provide open source to potential TML Developers so that they could learn how to write TMLs and interact with the TBC platform. Many TMLs were created for these purposes between November 2018 when TML was first introduced with TBC v5.0 and today, however they are not as well known as they could be and also many needed updating etc to bring them into line with TBC v5.3+ going forwards. A large number of the TMLs had no icons, were partially documented and needed more detailed testing, and we collectively needed to create a long term game plan.
Rockpile Solutions in that same period of time was formed by my colleague Peter Kistler. Trimble worked with Peter to assist him to develop a TML Licensing System and TML distribution platform and that has evolved nicely to the current release introduced the week of July 4th 2020 as TML Status 3.0.
TML Status 3.0 can be downloaded from the Rockpile Solutions website at www.RockpileSolutions.com and is the best way to manage your TML Library. The command is running all the time in background and will tell you when you don't have a license to run a selected command, will tell you when a command you are running has been updated, and will manage your Toolbox License (annual subscription) if you have one, allowing you to assign seats to users in your organization in line with the number of seats that you have available.
When we updated to TML Status 3.0 we also adopted all of the currently available TMLs. We now support those all centrally under a common Toolbox system, common menu configuration, and we have updated all commands to have new Icons, Tool Tips, Command Names for the Menus, the layout and location on the menus as well as the icon sizing etc on the menus. In addition, all of the TMLs were converted into compiled TMLs (the source code versions are still available on the Trimble TML Macros forum if you need examples to work from. The TMLs went through extensive testing, and validation, we added the F1 key to provide access to help pages and help training videos on the Rockpile Solutions Community pages. This gives us an easy way to provide up to date information about each command and to provide training assistance when you start to work with the commands.
Having said all of the above, the changes made the week of July 4th were major changes - the Website, Forum, the TML Status Server and Every TML Command (~70 commands) were affected and in addition we added a host of new commands and updates to commands. In this process we have found a few things that have tripped up based on older versions of the software in use and also users only doing partial updates - creating a mix of the pre July 4 and Post July 4 solutions which have thrown a few "Exceptions or Traceback Errors". In all cases that we are aware of they have been addressed and people are up and running, however if not, please don't hesitate to call or email me on +1 720 323 0481 / firstname.lastname@example.org and we will take care of getting you up and running swiftly.
We have tested everything going back as far as TBC v5.1, however we recommend where possible you use TBC v5.3 or the upcoming TBC v5.31. We thoroughly test on the current release and the next release coming, and if we find busts on older versions we will endeavor to fix things so they work on all in use versions of TBC, however in some cases TBC updates have broken commands and so they will now work best on the latest releases of the software.
To install everything correctly, you should do the following steps
- Download and install TML Status v3.0 this has an all new look as shown below. You can download this using TML Status or you can download it from www.RockpileSolutions.com. You will find the download link in blue in the center of the home page.
- Shut Down and Restart TBC
- Run TML Status v3.0. The first time you run TML Status you will be asked to complete your User profile and then you will need to open and review the Terms and Conditions and Privacy Statements for Rockpile Solutions. In order to run TML Status you will need a Trimble ID (you can get one of these from www.connect.trimble.com and select Sign In and then Create a New Trimble ID. Enter your email address and the password that you want to use for your Trimble ID.In TBC, you then need to use Support, Options and select External Services profiles and create a Trimble ID Profile (v5.30) or a Trimble Connect Profile (older versions of TBC). Enter your email address and Password (for your Trimble ID), then tap Test Settings to check that it works, then Tap Sign In and then Tap Set as Active. The Trimble ID is then saved and will run every time you start TBC.
- The first time that you do this after July 4th 2020, we recommend that you select every TML in the list of commands available, and check the checkbox in the Update column. This will ensure that your entire TML library will be updated to the latest TMLs available, and will ensure that after a restart you will have the full system installed correctly. We do not recommend that you do a selective partial install, as that may leave some legacy elements behind that may cause some issues in the new setup.
- As a part of this update, you will get the new Menu manager command. This manages the 3 Macro Menus for TBC and ensures the correct layout, sizing and locations of all commands. Menu Manager runs each time you start TBC and can be accessed from the Tool Shed menu once everything is installed correctly.
- After downloading and installing the updated library, TML Status will close, and you should now shut down TBC and restart the program. All new TMLs are loaded at run time for TBC. The first time you do this after a full update, TBC will take a little longer to start than normal. After the first restart, TBC will start at the normal speed thereafter.
- If everything was installed correctly, then the TBC Menus should now have 3 menus for the Macros - each will be prefixed with the orange R as shown below.
The menus for Data Prep, Modeling and Tool Shed should look as follows after a correct installation. If you did not install all the available commands, then the layout will be the same but the commands that you did not install will be absent from the menus.
If they do not look like this or at least very similar to this, please call us so we can get you set up 100% correctly.
- At this point you should be ready to Rock n Roll.
- If on start up TBC appears to stall it is likely that you have a "Traceback" error - hover over the TBC Icon in the taskbar, if a Traceback dialog is open on one of your screens, you will see it on the hover over as a pop up. Select it so you can see it, make a note of the TML command that it is referencing or the error that it is showing or make a screen grab of it and send it to us at email@example.com along with a contact number where we can reach you. The first step of troubleshooting any of these if directly attributed to a specific TML is to use TML Status to update that TML and restart TBC. If a problem persists send us the email and we will call you to troubleshoot the issue.
- We have seen one issue with TBC v5.20 where Menu Manager would not install correctly. That was addressed on July 23rd and an updated Menu Manager posted that solves the problem. Download the updated Menu Manager using TML Status.
If we see other issues, we will post them in this Blog as a reference for you to use.
The link below provides access to the Rockpile Solutions document that covers the licensing, installation and management of your RPS Command Library. Please use this as your reference if you are having any type of issue.
Click Here for the RPS Command Management and Licensing document.
Licensed vs Unlicensed TML Commands
As a part of the agreement with Trimble, we have agreed to support and maintain all TMLs provided by Trimble previously. This does mean that to receive fixes or updates you will use TML Status to update them as and when issues are encountered.
The "Trimble" commands will be maintained as license free indefinitely with the capabilities that were available when we took over their support. We do receive requests daily for improvements to many commands. If we develop an extended version of a command, we will create it as a hybrid command that has a license free and licensed component of the same command. In these scenarios, when running without a license, the extended functionality will be displayed in Orange Text so that you can clearly see which parts are licensed and unlicensed. When you have a license, you will have the full command with all capabilities available to you.
The Rockpile Solutions commands are licensed under subscription agreements valid for 1 to 3 years (see below)
TML Commands vs TBC Native Commands
You can tell a TBC Native command based on
- The icon colors are in most cases Black, Grey and Blue
- The commands will typically be found on the main TBC Menus (those without the Orange R in front of them
You can tell a TBC TML Command from Rockpile Solutions based on
- The commands will be on a menu with the Orange R prefix
- The command Icons will be Black, Grey and Orange
If you have support issues on any TML Command, please call us on +1 720 797 1001 or +1 720 323 0481 or post your issue on the community forums and we will be happy to engage to resolve the issues. All commands have extensive help and we hope that the combination of full documentation and video tutorials will get you fully productive quickly.
RPS Command Toolbox Licensing
The TML library has been broken down into three primary Toolboxes as follows
- RPS Data Prep Toolbox - Provides a powerful toolset to supplement TBC data prep capabilities. Tools to manage layers, clean up and sort CAD or PDF data and to perform data modifications, edits and create new objects
- RPS Modeling Toolbox - Provides a powerful toolset to supplement TBC surface, cross section and corridor modeling capabilities. Tools that manipulate and correct surface models, imported PDF or CAD cross section data and corridor models. Tools to enhance model or takeoff drawings and provide enhanced reporting and data output capabilities
- RPS Tool Shed Toolbox - The RPS Tool Shed contains a selection of tools that do not specifically fit into the Data Prep or Modeling Toolboxes. These can be licensed as a collection or individually on request. For example if all you need is the Moss Export you can request a license just for that command.
In addition we offer an RPS All Tools Package which incorporates all of the commands available today as well as anything we may introduce during the subscription period of your license.
Click Here for the RPS Data Prep Toolbox Data Sheet
Click Here for the RPS Modeling Toolbox Data Sheet
Click Here for the RPS Tool Shed Data Sheet
You can order TML Toolboxes from the Rockpile Solutions website at Toolboxes - Rockpile Solutions
The RPS Toolboxes are licensed via an annual subscription, providing access to the tools for one year for one person. Subscriptions can be purchased for up to 3 years in advance, with the All Tools package, this gives you a price lock in for the 3 years of the subscription, and full access to any tools that we create and introduce during that period.
If you would like to discuss licensing please call us on the phone numbers or email addresses listed in this blog post.
Thanks for your interest in the RPS Command Library - we look forward to working with you
Partner / Marketing Director