1   MyRepositoryClient 1.1

1.1 Create new category
1.2 Create new album
1.3 Insert files to album
1.4 Add new version of file
1.5 Play, create or delete voice comment
1.6 Modify image
1.7 Search in MyRepository
1.8 Sort in MyRepository
1.9 Custom attributes(Tags)
1.10 Custom attributes validation - regular expression samples
1.11 Category security permissions
1.12 How to: create your own MyRepository client plugin

2   MyRepositoryServer 1.1

2.1 Users Management
2.2 MyRepository server configuration
2.3 How to: create your own MyRepository server plugin
2.4 Backing up MyRepository server
2.5 MyRepository restoration

1 MyRepositoryClient 1.1

1.1 Create new category

To create a new category, follow these steps:

• In the category/album explorer, click the right mouse button and then click to New category.
  NOTE: You must be logged on to the MyRepository using an account that has administrator privileges in order to create new category.

• Fill in category name and then click to Save button.

1.2 Create new album

To create a new album, follow these steps:

• In the category/album explorer, use the right mouse button to click a category and then click to New album.

• Fill in album name and then click to Save button.

1.3 Insert existing files to album

If you want insert files to album, follow these steps:

• In album list, click the right mouse button and click to Add files.
  As an alternative to using Add files, you can drag files from an windows explorer window
  and then drop files to MyRepository client.

1.4 Add new version of file

• In MyRepository client, use the right mouse button to click a file, point to Add new version on the menu that appears, and then click.
  As an alternative to using Add new version, you can drag(only one) file from an windows explorer window
  and then drop file to existing file in MyRepository client.

1.5 Play, create or delete voice comment

• In MyRepository client, use the right mouse button to click a file and then choose 'Detail'.
  

• In file detail window, you can replay, create or delete voice comment.

1.6 Modify image(s)

• In MyRepository client, use the right mouse button to click a file(s) and then choose 'Modify images'.
  

• When you click on the apply button, MyRepository automatically creates a new version of image file(s).

1.7 Search in MyRepository

MyRepository supports two types of search:

• Full-text search is available in online mode only. Full text indexes are placed and managed on MyRepository server. This search is useful, when you want to find words or phrases in documents.
• Parameterized search is available in online and offline mode.

1.8 Sort in MyRepository

MyRepository supports asc/desc sorting by attributes in details view:

1.9 Custom attributes(Tags)

Custom attributes provide support for recording additional, user-defined information for a files and you can later perform searches and sorting based on custom attributes. Custom attributes are similar to Tags.
Each custom attribute has a name, and an attribute type. The type can be a string or number(64-bit floating-point value).You can define error message and regular expression, which is used to validate custom attribute value.
NOTE: You must be logged on to the MyRepository using an account that has administrator privileges in order to manage custom properties.

• To edit custom attribute value, open file detail window and select 'Custom attributes' page.
  

1.10 Custom attributes validation - regular expression samples

Title	Regular expression	Matches
URL	^http://([a-zA-Z0-9_\-]+)([\.][a-zA-Z0-9_\-]+)+([/][a-zA-Z0-9\~\(\)_\-]*)*([\.][a-zA-Z0-9\(\)_\-]+)*$	http://jpinsoft.com http://jpinsoft.com/DeepSound
IP Addresses	^\b\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}\b$	81.2.195.145
Telephone numbers	^\+?[\d|-]{7,20}$	+421-903-123-456 00421903123456 1-223-123-1232 01-46-70-89-12
Number 0-999	^[0-9]{1,3}$	123
Money	^\d{0,8}[.]\d{2}$	12345678.12
Mail address	^[_a-z0-9-]+(\.[_a-z0-9-]+)*@[a-z0-9-]+(\.[a-z0-9-]+)*(\.[a-z]{2,4})$	someaddress@mailserv.com some.address@mailserv.com
Yes or No	^[Y|N]$	Y N
DateTime(dd-MM-yyyy HH-mm-ss)	^(0[1-9]|[12][0-9]|3[01])[-/.](0[1-9]|1[012])[- /.](19|20)\d\d(?:( [0-2][0-9]):([0-5][0-9]):([0-5][0-9]))?$	29-12-2008 16:42:09 29.12.2008 16:42:09
Date(dd-MM-yyyy)	(0[1-9]|[12][0-9]|3[01])[- /.](0[1-9]|1[012])[-/.](19|20)\d\d$	29-12-2008
Date(MM-dd-yyyy)	(0[1-9]|1[012])[- /.](0[1-9]|[12][0-9]|3[01])[-/.](19|20)\d\d$	29-12-2008
Date(yyyyMMdd)	^((19|20)\d\d)(0[1-9]|1[012])(0[1-9]|1[0-9]|2[0-9]|3[01])$	20081229

For more information about regular expressions visit this sites:

• RegExLib (http://regexlib.com)
• Regular Expressions Info (http://www.regular-expressions.info)
• Free Regular Expression Designer is a free tool that helps programmers learn, develop and test Regular Expressions

1.11 Category security permissions

On MyRepository, you can set security permissions on categories. Only accounts that has administrator privileges may insert, edit or remove categories.
You can view and manage security permissions for categories by completing the following steps:

• In the category/album explorer, click the right mouse button and then click to 'Edit category & Security permissions'.

• In the Security group box you can add, change and remove user permissions.
NOTE: If the category is public, everyone can view category, insert, edit or remove albums and insert, edit or remove files.

In the category/album explorer is category disabled, when you do not have permissions to access category.

1.12 How to: create MyRepository client plugin

If you need add specific abilities to a MyRepository client, you can write your own client plugin by completing the following steps:

• In Visual Studio, create Class library, or Windows Forms Control Library project and select
  .NET Framework 3.5 in the Target Framework drop-down list.
• Add a reference to the Common.dll assembly, located in MyRepositoryClient install folder.
• Create a derived class from Jospin.Common.Types.ClientPlugin abstract class.
• Build project and copy assembly to [MyRepositoryClient install path]/[ClientPlugins] folder.
• Restart MyRepositoryClient.
• To check the your plugin is successfully loaded, see MyRepositoryClient -> Help -> About.

2 MyRepositoryServer 1.1

2.1 Users Management

To manage user accounts, follow these steps:

• Run MyRepositoryServerConfig tool.
• In the Authentication group box you can add, modify and remove user. Click to Create user.

• Fill in user name, password and then click to Save button.To define user as administrator, check Administrator checkbox. Only administrator has special permissions for manage categories, edit category permissions and manage custom attributes via MyRepository client.

2.2 MyRepository server configuration

To modify server settings, follow these steps:

• Run MyRepositoryServerConfig tool.
• Stop server.
• Click to Server settings.

2.3 How to: create MyRepository server plugin

If you need add specific abilities to a MyRepository server, you can write your own server plugin by completing the following steps:

• In Visual Studio, create Class library, or Windows Forms Control Library project and select
  .NET Framework 3.5 in the Target Framework drop-down list.
• Add a reference to the Common.dll assembly, located in MyRepositoryServer install folder.
• Create a derived class from Jospin.Common.Types.ServerPlugin abstract class.
• Build project and copy assembly to [MyRepositoryServer install path]/[ServerPlugins] folder.
• Restart MyRepositoryServer.
• To check the your plugin is successfully loaded, see MyRepositoryServerConfig -> About.

2.4 Backing up MyRepository server

• Manual full backup of MyRepository folder (database and all documents).
  You can perform the backup manually by copying the MyRepository folder to a different location.
  
  
  
  
• Automatic backup of MyRepository database.
  This function will create a new compressed backup per day (if database has been changed). To enable automatic backup fill in backup destination folder.
  NOTE: This backup only includes MyRepository database without your documents.
  NOTE: If automatic backup destination folder contains more than 10 backups, all the oldest backups will be deleted on the next auto backup time and there will be only 10 stored backups.

2.5 MyRepository restoration

• Restore from full backup (database and all documents)
  
  1. Stop MyRepository server
  2. Copy backed up MyRepository folder to a destination location
  3. Select Server settings and ensure that Repository folder is set up correctly
  
  
  
  4. Select Server Status and start MyRepository server
  NOTE: You can also use this approach to restore complete MyRepository to a new server.
  
  
• Restore MyRepository database (Automatic backup)
  
  1. Stop MyRepository server
  2. Unzip and copy content of automatic backup to Repository folder from which backup has been created
  
  3. Select Server status and start MyRepository server