1. Documentation
2. 10.2 (Latest)10.110.09.109.99.89.79.69.59.49.39.29.19.08.28.18.07.6
3. Studio
4. Collaborate via Projects

Collaborate via Projects

To manage the workflow for a team working towards a common goal, most modern software provides some type ofversion control. RapidMiner providesProjects, with the following benefits:

• You get a step-by-step history of the work you have done.
• Each step in history is called aSnapshot.
• Each Snapshot provides an exact copy of the Project as it existed at one specific moment in time.
• Snapshots are shared with colleagues via theProject Server.
• You can stay synchronized with your colleagues bygetting updatesfrom the Project Server.
• You canroll backto a previous Snapshot at any time.
• The back end is based onGit, a standard tool for version control.
• Although the back end is based onGit,没有knowledge ofGitis required.

The following sections outline how to use Projects.

• Connect to a Project
• Create Snapshot
• Get updates
• Resolve conflicts
• Discard local changes
• History Panel

Connect to a Project

Before you can connect to a Project, it must first have been created within theRapidMiner AI Hub web interface.

In theRepository Panel, from thedrop-down menu next toImport Data, selectConnect to a Project.

Fill out the fields in the resulting dialog.

• TheProject URLcan be found in theRapidMiner AI Hub web interface, underRepository > Projects.
• TheAliasis the Project name you choose to display in the RapidMiner StudioRepository Panel.
• TheUsermust haveaccess rightsfor the Project.

Check the connection by clickingCheck connection settings. If the settings are correct, clickOK, and the complete content of the Project will be downloaded and stored locally in theStorage location.

Create Snapshot

You can think of a Project as a series ofSnapshots. EachSnapshotrepresents the whole state of a Project at one specific point in time; the record of a Project is identical to itsSnapshot History.

When you create a Snapshot, two things are accomplished:

1. You create a record of your version of the Project at that instant of time. Your Snapshot is saved as part of the Snapshot History.

2. Your Snapshot is automatically shared with the Project Server, so that it is available to your colleagues viaGet updates.

Note that within a Project, you can change as many processes and models as you like, and save them locally; nevertheless, none of your work is shared or saved to Snapshot History until you create a Snapshot.

To create a Snapshot, right-click on the Project in the Repository Panel and select创建快照,并将其添加到服务器.

Summarize your changes in the Snapshot description, and clickCreate Snapshot. Your Snapshot is stored on the Project Server, and it is available, viaGet updates, to others who haveaccess to the Project.

Get updates

SelectGet updatesto update your copy of the Project from the Project Server, where all existing Snapshots of a Project, both yours and your colleagues', are collected.Get updatessynchronizes your work with your colleagues'.

To check if there are new Snapshots on the Project Server:

• See if there is a notification in the Repository Panel, next to the Project name:(Project: 2 behind)
• Look for a number next to theGet updates (2)button in theHistory Panel

If you have made local changes, you must first take one of the following two actions:

• Create Snapshot
• Discard local changes

Resolve conflicts

A conflict occurs when you and a colleague have both changed the same file. RapidMiner Studio gives you the following options for each of the conflicting files:

• use my version
• 用我同事的版本

Note that nothing is ever lost!Allthe relevant information is saved in Snapshot History, as three different Snapshots: your Snapshot, your colleague's Snapshot, and the Snapshot containing the conflict resolution.

Discard local changes

If you do not want to include your local changes in aSnapshot, you canDiscard local changes.

In the Repository Panel, right-click on the Project and selectDiscard local changesfrom the context menu.

Afterwards, the state of the Project will be restored to your latest local Snapshot. To retrieve your colleagues' latest Snapshots, selectGet updates.

The History Panel

The快照历史面板gives quick access toCreate SnapshotandGet updates, and it contains a list of all locally-known Snapshots. There are two ways to open the History Panel:

• From the main menu, selectView >Show Panel >Snapshot History, or
• In the Repository Panel, right-click the Project and selectOpen Snapshot History

Every Snapshot in the Snapshot History includes a description and three small dots displayed on the right side, with two options:

• View Snapshotgives you a more detailed view of the Snapshot, including which files were changed. From there, you canviewany of those files individually, orrestorethem.

• Restore Snapshotreplaces all files in your local copy of the Project with the content of this Snapshot. If you only want to examine the Snapshot, but not permanently keep it, you canDiscard local changeswhen you are done looking at it. If on the other hand you prefer the old Snapshot, and you want to keep it, you shouldCreate a new Snapshot, to make it current.

Note that a single click on the Snapshot description has the same effect asView Snapshot.

View Snapshot

When you view a Snapshot, you have the option tovieworrestoreindividual files that were changed in that Snapshot.

View this file

When you view a file from within a Snapshot, the behavior is the same as when you open a file in a Repository:

• data sets are displayed in the Results View,
• processes appear in the Process Panel, and
• any other files are opened by the default program for that file type.

Restore file

Select a name and location for the file, and clickOK.

The same rule applies as when youRestore Snapshot. If you only want to examine the file, but not permanently keep it, you canDiscard local changeswhen you are done looking at it. If on the other hand you prefer the old file, and you want to keep it, you shouldCreate a new Snapshot, to make it current.