Sharing InTime Results¶
The data generated in InTime can be shared with other users across different projects. You can share data manually through the use of a file or via the InTime Server. This guide shows how to manage InTime data across multiple users and multiple servers.
InTime can support a diverse range of the user and IT infrastructure. A single user can access multiple servers and may work on multiple projects. In another scenario, there can be multiple users working on the same project in a distributed networked environment.
How Data is Organized¶
By Project Path (Design ID)¶
For every project opened in InTime, if it is a new project folder and name, it assigned a Design ID. This Design ID is unique. All results that are generated will be tied to this Design ID. This is supported in all versions of InTime.
By Design Tag¶
Starting from InTime 3.1.4 onwards, a customizable text can be tagged to each project. Projects that are tagged with the same text, will be recognized as the same project.
Where Data is Stored¶
Every InTime client stores its data locally in a file called "intimeruns.db". The data may be a subset of the entire database in the InTime Server Database. There are 2 different modes.
User mode (default)¶
This is the default mode. The path can be changed to any custom folder using the
custom_session_path option, e.g.
/intime.sh -custom_session_path /mnt/mypath/
The database file will be in the plunify.jobs folder in the project folder. This can be conveniently backup with source control or shared with other users accessing the same source.
To enable this mode, close your project, run the Tcl command
misc set_runs_db project. Re-open the project
2. InTime Server Database¶
If InTime is running in a networked environment with multiple users and machines, the data can be saved (manually or automatically) in the centralized InTime Server Database (ISD).
What you See Is What You Get
Regardless of where data is stored, what you see in the history is what InTime uses for training and learning. If you don't see it in the history, that data is not part of the opened design.
Share By Design Tag¶
What is Design Tag¶
Tagging a design with a unique string allows you to control how and when its data is going to be used or shared.
Using the tag as an identifier, InTime syncs the relevant data quickly among different users, over multiple machines via the centralized InTime Server Database.
Each design can only have 1 tag. Changing the tag means overwriting the previous one. The tag is tied to the design, not individual results.
How to tag your design or change a tag¶
In the GUI, under “Current Project”, select “Design Tag” option in the menu.
For Tcl command, type
project design_tag rev1 where rev1 is the new tag.
To change the tag, follow the same steps as above.
Upload to InTime Server Database¶
To automatically backup to InTime Server Database, checked “Backup Results (InTime Server)” to enable it.
For GUI, see Export Data to InTime Server
For Tcl, run this command
results export –server_db
If the Design Tag has been changed locally, the design tag on InTime Server database will also be updated in the next sync.
Import from InTime Server Database¶
Go to “File” > “Import with Design Tag”.
There are 3 fields:
Number of results to import - The maximum is 500.
“Only Successful Results” or “All Results”, which includes failed and not started.
Example 1: Import 50 results with the design tag rev1.
plunify> results import -server_db -all –n 50 –designtag rev1
Example 2: Import 20 successful results with the design tag rev2.
plunify> results import -server_db -success –n 20 –designtag rev2
Automatically Sync Data for New Projects¶
When you open a new project (without results) in InTime, InTime prompts you for a Design Tag. If you provide a Design Tag, InTime will pull data with a matching Design Tag from the InTime Server Database.
To turn off this feature, enter at the Tcl console:
misc set auto_sync false
Share by Project Path (Design ID)¶
There are 3 channels to import or export results.
Local database file
The data is already in the current intimeruns database file but is saved under a different project or design ID. Different projects are assigned a "design ID", which differentiates them. (Only for import)
The data can be imported from the centralized InTime Server Database or exported to it.
External database file
The data is in a file which is exported from other InTime clients or can be imported from into InTime clients.
Export Data To Local File¶
To export data, select the
Export Results menu option. This will start the Export Results Wizard.
To do this in Tcl, first select the jobs that needs to be exported, using the
results add command.
Example, to export the results of the last job to a file, select the results of the last job, then export it.
plunify> results add last_job plunify> results export /tmp/backup.export -local_db
Example, to export the results of job 333 to a file, select the results of the last job, then export it.
plunify> results add job 333 plunify> results export /tmp/backup.export -local_db
Export Data To InTime Server Database¶
To backup the data on the InTime Server Database, in the GUI, just select the option "Export to the InTime Server".
For Tcl, use the
-server_db option. There is no need to specify a filename.
plunify> results export -server_db
Import Data From Local Database File¶
Import Results menu option. This will start the Import Results Wizard below.
You can choose to import data into the current project or into another project.
The list of available results will be displayed. Use the checkboxes to select the project whose data you want to import into your current database. Click 'Next' to continue.
Importing via Tcl commands for this option is not supported.
Import From InTime Server Database¶
The steps are the same as "Import Data From Local Database File", except that the data source is from the InTime Server Database. Importing via Tcl commands for this option is not supported.
Import From External Database File¶
Similar to the previous 2 options, except that the filename of the data source is required.
In Tcl console, to import from an external file, using the
plunify> results import -local_db /tmp/backup.export
/tmp/backup.exportis the filename of the data source.