# Project

**Project** — a collection of diagram files, where one of the diagrams is designated as the main one. The project is described by a file with the extension “.sherpa”.

On the “Project” tab, you can view the diagrams of the current project, as well as add, delete, rename diagrams, and change their order.

Only one project can be open in the program at a time. When opening another project, the previous one will be closed. However, you can launch another Designer to load a different project, and there is also the option to copy blocks from one Designer to another.

It is allowed to open diagram files in the program that are not part of the current project.\
\
There are three types of robot files:

* File with the extension **.sherpa** – project file. To edit the project in the Designer, you need to select a file with this extension.
* Files with the extension **.process** – diagrams of specific processes that make up the project or individual diagrams.
* File with the extension **.robot** – the final file representing the assembled robot. To obtain this file, you need to use the “Publish” function, during which all source files are compiled into one final file. This file is provided as input to the execution program – Sherpa Robot.

> A fully assembled and debugged Robot does not need files with the extensions .sherpa and .process; they are only needed during the development stage.

## Interface Elements on the “Project” Tab

<table data-header-hidden><thead><tr><th width="57" valign="top"></th><th width="193" valign="top"></th><th width="314" valign="top"></th></tr></thead><tbody><tr><td valign="top"><strong>No.</strong></td><td valign="top"><strong>Interface Element</strong></td><td valign="top"><strong>Description</strong></td></tr><tr><td valign="top">1.</td><td valign="top">Button <img src="https://3212714295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FI0zUnKkOuy6lWt7DZ46u%2Fuploads%2Fgit-blob-2aa85e44d312a65b2c573cc0a81a1d442a40f34b%2F2025-08-05_20-19-34.png?alt=media" alt=""></td><td valign="top">Allows you to make the selected diagram the main one in the project.</td></tr><tr><td valign="top">2.</td><td valign="top">Button <img src="https://3212714295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FI0zUnKkOuy6lWt7DZ46u%2Fuploads%2Fgit-blob-7a23e0cf73fe74aae2500b3c9d37d03801ea841c%2F2025-08-05_20-28-04.png?alt=media" alt=""></td><td valign="top">Allows you to add the selected diagram to the project.</td></tr><tr><td valign="top">3.</td><td valign="top">Button <img src="https://3212714295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FI0zUnKkOuy6lWt7DZ46u%2Fuploads%2Fgit-blob-d196a5f519dd089ca945b484ed95d306528dc702%2F2025-08-05_20-28-54.png?alt=media" alt=""></td><td valign="top">Allows you to add a new diagram to the project.</td></tr><tr><td valign="top">4.</td><td valign="top">Button <img src="https://3212714295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FI0zUnKkOuy6lWt7DZ46u%2Fuploads%2Fgit-blob-5ab4dd3e93bc76863282fade9ebe101bb22dd402%2F2025-08-05_20-29-14.png?alt=media" alt=""></td><td valign="top">Allows you to add a new folder to the project.</td></tr><tr><td valign="top">5.</td><td valign="top">Button <img src="https://3212714295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FI0zUnKkOuy6lWt7DZ46u%2Fuploads%2Fgit-blob-b9264c6d39fb32f346ec8a3df13ac9edae7a7896%2F2025-08-05_20-29-52.png?alt=media" alt=""></td><td valign="top">Allows you to cut the selected diagram or folder.</td></tr><tr><td valign="top">6.</td><td valign="top">Button <img src="https://3212714295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FI0zUnKkOuy6lWt7DZ46u%2Fuploads%2Fgit-blob-aa82fd9edee252084f4406a82dae1cd4f2e1fc37%2F2025-08-05_20-30-14.png?alt=media" alt=""></td><td valign="top">Allows you to copy the selected diagram or folder.</td></tr><tr><td valign="top">7.</td><td valign="top">Button <img src="https://3212714295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FI0zUnKkOuy6lWt7DZ46u%2Fuploads%2Fgit-blob-40545ead358f09b3899413d0ccf842d2ab11dd4c%2F2025-08-05_20-30-42.png?alt=media" alt=""></td><td valign="top">Allows you to paste the previously cut or copied diagram or folder.</td></tr><tr><td valign="top">8.</td><td valign="top">Button <img src="https://3212714295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FI0zUnKkOuy6lWt7DZ46u%2Fuploads%2Fgit-blob-ae79c6f85fa82515045f0def20b7b7108c022dd3%2F2025-08-05_20-31-10.png?alt=media" alt=""></td><td valign="top">Allows you to delete the selected diagram or folder.</td></tr><tr><td valign="top">9.</td><td valign="top">Button <img src="https://3212714295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FI0zUnKkOuy6lWt7DZ46u%2Fuploads%2Fgit-blob-7b43ea6e7e6b886badac312cc02e6293eef3af4c%2F2025-08-05_20-31-40.png?alt=media" alt=""></td><td valign="top">Allows you to rename the selected diagram or folder.</td></tr><tr><td valign="top">10.</td><td valign="top">Virtual folder “Links” <img src="https://3212714295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FI0zUnKkOuy6lWt7DZ46u%2Fuploads%2Fgit-blob-7541c3eac3da1489fd8f16e96fed6828b3e25a2f%2F2025-08-05_20-27-00.png?alt=media" alt=""></td><td valign="top">Contains links to ready-made library assemblies (DLL files) and allows you to connect your own.</td></tr></tbody></table>

<figure><img src="https://3212714295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FI0zUnKkOuy6lWt7DZ46u%2Fuploads%2Fgit-blob-31e01e38f01391a3b5860b6aaac1d3d77756483b%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20(44).png?alt=media" alt=""><figcaption></figcaption></figure>

## Links

**Links** – these are external libraries that the Robot can use during operation.

To add a new link, you need to right-click on the “Links” item and select “Add Link”.

<figure><img src="https://3212714295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FI0zUnKkOuy6lWt7DZ46u%2Fuploads%2Fgit-blob-c77ba2d2bafccfc5af5e76fee04fba8490a62411%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20(37).png?alt=media" alt=""><figcaption></figcaption></figure>

After that, the “Link Manager” window will open, allowing you to select the necessary assemblies (DLL files) provided by the Framework or add your own assembly.

<figure><img src="https://3212714295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FI0zUnKkOuy6lWt7DZ46u%2Fuploads%2Fgit-blob-24b1d2c82aff7133a92788ff69619d99361fff60%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20(38).png?alt=media" alt=""><figcaption></figcaption></figure>

### Video Demonstration of Using Links with an Example of Connecting Your Library in C\#

{% embed url="<https://sherparpa.ru/ucontent/?07>" %}

## Context Menu of the Project Folder

The context menu of the project folder offers the following options:

<table data-header-hidden><thead><tr><th width="59"></th><th width="240"></th><th width="375"></th></tr></thead><tbody><tr><td><strong>No.</strong></td><td><strong>Option</strong></td><td><strong>Description</strong></td></tr><tr><td>1.</td><td>“Add” item</td><td><p>Allows you to add:</p><ul><li>A new diagram;</li><li>An existing file;</li><li>A new folder;</li><li>An existing folder;</li><li>A link to a file;</li><li>A URL link to a file.</li></ul></td></tr><tr><td>2.</td><td>“Import all files from folder” item</td><td>Allows you to import all files from a folder from the selected directory.</td></tr><tr><td>3.</td><td>“Correct link paths” item</td><td>Allows you to correct the link paths within the selected folder to the specified folder.</td></tr><tr><td>4.</td><td>“Cut” item</td><td>Allows you to cut the selected project folder.</td></tr><tr><td>5.</td><td>“Copy” item</td><td>Allows you to copy the selected project folder.</td></tr><tr><td>6.</td><td>“Paste” item</td><td>Allows you to paste the selected project folder.</td></tr><tr><td>7.</td><td>“Delete” item</td><td>Allows you to delete the selected project folder.</td></tr><tr><td>8.</td><td>“Rename” item</td><td>Allows you to rename the selected project folder.</td></tr><tr><td>9.</td><td>“Open folder in Explorer” item</td><td>Allows you to open the project folder in Explorer.</td></tr><tr><td>10.</td><td>“Delete unused diagrams” item</td><td>Allows you to delete unused diagrams from the project.</td></tr><tr><td>11.</td><td>“Project properties” item</td><td>Allows you to open the “Project Properties” window.</td></tr></tbody></table>

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcPIcQrV_kT6ZR1RfZ79tyiT4HtI7CUnS5X4B2sFAMaySR_li_TX3WPpl5Uo2Pp260FmyURlHBJB-7etgEocwHxsh5RZliWUh1KLFX09iIPBg6h5Laf0X4uzCyz53vwSjY39TF-DgoSKuYZMK15ZvDdJ0Ux?key=hkb4d-2cPaGQ51ygcyhvzQ" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3212714295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FI0zUnKkOuy6lWt7DZ46u%2Fuploads%2Fgit-blob-5c28bbd6c6ac351d537f5b7539e2e64ba4a3e32a%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20(40).png?alt=media" alt=""><figcaption></figcaption></figure>

### “Add” Menu

<table data-header-hidden><thead><tr><th width="53"></th><th width="187"></th><th width="388"></th></tr></thead><tbody><tr><td><strong>No.</strong></td><td><strong>Option</strong></td><td><strong>Description</strong></td></tr><tr><td>1.</td><td>“New Diagram” item</td><td>Creates a new diagram for visual representation of the process, scheme.</td></tr><tr><td>2.</td><td>“Existing File” item</td><td>Allows you to select and connect an already existing file from the system for use in the project.</td></tr><tr><td>3.</td><td>“New Folder” item</td><td>Creates a new folder for organizing and storing related items.</td></tr><tr><td>4.</td><td>“Existing Folder” item</td><td>Connects an already existing folder from the file system.</td></tr><tr><td>5.</td><td>“Link to File” item</td><td>Creates a link to an external file or resource, allowing access to it through the project. Also, all changes in this diagram will be applied to all projects. When performing a Push operation to the Orchestrator, this file will be automatically added to the project.</td></tr><tr><td>6.</td><td>“URL Link to File” item</td><td>Adds a hyperlink to an external file or internet resource by URL for quick access from the project.</td></tr></tbody></table>

<figure><img src="https://3212714295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FI0zUnKkOuy6lWt7DZ46u%2Fuploads%2Fgit-blob-147c056cac8ee9d8a07e2dd8460a7a83d9571024%2F2025-08-05_21-52-05.png?alt=media" alt=""><figcaption></figcaption></figure>

## Context Menu of the Project File

The context menu of the project file, which is invoked by right-clicking:

<table data-header-hidden><thead><tr><th width="53"></th><th width="187"></th><th width="388"></th></tr></thead><tbody><tr><td><strong>No.</strong></td><td><strong>Option</strong></td><td><strong>Description</strong></td></tr><tr><td>1.</td><td>“Set Diagram as Main” item</td><td>Allows you to set the selected diagram as the main one.</td></tr><tr><td>2.</td><td>“Cut” item</td><td>Allows you to cut the selected project file.</td></tr><tr><td>3.</td><td>“Copy” item</td><td>Allows you to copy the selected project file.</td></tr><tr><td>4.</td><td>“Delete” item</td><td>Allows you to delete the selected project file.</td></tr><tr><td>5.</td><td>“Rename” item</td><td>Allows you to rename the selected project file.</td></tr><tr><td>6.</td><td>“Show File in Explorer” item</td><td>Shows the path to the selected file on your computer.</td></tr></tbody></table>

<figure><img src="https://3212714295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FI0zUnKkOuy6lWt7DZ46u%2Fuploads%2Fgit-blob-91be472ef9a1fb9d726284ce0a31c993a341fa01%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20(39).png?alt=media" alt=""><figcaption></figcaption></figure>
