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.

Collaboration Scenarios¶

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.

Data Collaboration

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¶

1. Intimeruns.db¶

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.

Mode	File Location
User (default)	`<user home>/.plunify/<user_mac address>/intimeruns.db`
Project	`<project folder>/plunify.jobs/intimeruns.db`

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/

Project mode¶

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).

Important

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. WYSISWG

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.

Design Tag

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.

Tag Design

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.

auto upload data

For GUI, see Export Data to InTime Server

For Tcl, run this command results export –server_db

Note

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¶

GUI

Go to “File” > “Import with Design Tag”.

Import Design Tag

There are 3 fields:

Design Tag
Number of results to import - The maximum is 500.
“Only Successful Results” or “All Results”, which includes failed and not started.

Tcl Commands

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

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)
InTime Server
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¶

Export Data To Local File¶

To export data, select the File > Export Results menu option. This will start the Export Results Wizard.

Export_Result_Step_2

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

This will export the last ran job to a local file /tmp/backup.export.

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¶

Import Data From Local Database File¶

Select the File > Import Results menu option. This will start the Import Results Wizard below.

Import_Result_Step_1

You can choose to import data into the current project or into another project.

Import_Result_Step_2

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.

Import_Result_Step_3

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.

Import_Filename

In Tcl console, to import from an external file, using the -local_db option

plunify> results import -local_db /tmp/backup.export

where /tmp/backup.export is the filename of the data source.