/
Photo Archive - Community Edition

Photo Archive - Community Edition

Nov 09, 2022

Setting up a Photo Archive in yuuvis® RAD

This scenario is one of the smallest you can design: a single photo album to manage all your photos.

You will learn how to:

  • create groups and users

  • assign roles

  • use the search function

  • create objects

  • change object types

  • use the structure tree

Requirements

You need two things to get started:

  1. A working version of the yuuvis® RAD Community Edition. Download it here and follow the installation guide that comes with it.

  2. The project file containing the object type definitions used in this scenario. Download it by clicking the paperclip below.

This guide assumes that you have a clean yuuvis® RAD system and that nothing was configured in yuuvis® RAD designer yet.

Installation

Deploying the Scenario to your yuuvis® RAD System

  • Unzip the project file (see Requirements) to the Documents folder.

  • Start yuuvis® RAD designer.

  • Click Open.

  • Navigate to the folder where the scenario was unzipped. Select the .eoproj file and confirm the selection with Open.

  • Navigate to yuuvis > Settings > Environment > Connections.

  • Click Add and set the following parameters:

    • Name — Enter a name for the new connection.

    • Server — Enter the IP of the machine where the server is running.

    • Port — Enter the port, usually 8080.

  • Click Apply and leave the settings by clicking OK.

  • Deploy the scenario to your yuuvis® RAD system by right-clicking the project name in the navigation tree on the left and selecting Deploy. 

  • Open the Windows Task Manager (where the yuuvis® RAD system is running) and go to Details.

  • Look for the structure-service.exe task and end it. After a few seconds, it will be restarted by yuuvis® RAD service-manager. (This step will not be necessary for versions 4.7 or later.)

Assigning Roles

  • In a browser, open yuuvis® RAD management-studio at <servername>/management and log in with your administrator account.

  • Go to 

    Main menu > Organization.

  • Create a new user:

    • Select default-suborganization in the list.

    • Click the 

      Actions menu on the right and select Add > New User.

    • Enter a user name and a real name and save.

  • Create a group for administrators of the photo album and one for users:

    • Select default-suborganization in the list.

    • Click the 

      Actions menu on the right and select Add > New Group.

    • Enter Photo Archive Administrators as the group name and save.

    • Add another group called Photo Archive Users.

  • Assign roles and users:

    • Select the group Photo Archive Administrators and click Role assignment.

    • In the Assigned area, click Roles on the right and start typing the name of the role you want to assign, in this case Photo Archive Administration. Once the name appears in the autocomplete list, click it to assign the role to the group.

    • Click Affiliation.

    • In the Contains area, click Roles on the right and start typing the name of the user you want to assign to this group, in this case root. Once the name appears, click it to assign the user to the group.

    • Repeat these steps in the Photo Archive Users group to assign the role Photo Archive Usage to the group and add your newly created users to the group.

Note: The roles are defined in the project that you imported to yuuvis® RAD designer. Photo Archive Administrators allows to create a photo album but no photos, while Photo Archive Users allows to create, edit and delete photos but not the photo album itself.

Note: Users will inherit the roles of the groups they are assigned to. These roles are not explicitly shown in the role assignment of the user.

Note: If you would like to allow every user in the system to use the photo archive, assign the role Photo Archive Usage to the main group default-suborganization.

To simplify the system for new users, you can limit the functionality:

  • In the 

    Main menu, select System and check the boxes as shown in the following screenshot:

Creating the Photo Album

  • Log in to the client at <servername>/client with a user with the role Photo Archive Administration, e.g., root.

  • Click the + symbol in the upper  toolbar. This opens the Create object dialog.

  • Select Photo album.

  • The Create form does not need any input, so click File and Open. This opens the empty photo album where the users with role Photo Archive Usage can file their photos or search for photos of others.

Background Information About the Photo Album

The action described above creates the unique context folder of the yuuvis® RAD system. Then, the name Photo album is assigned to this context folder and it is filed to the location General (= Root), as can be seen in the schema definition in yuuvis® RAD designer:

The object type Photo album contains only one field of type catalog which is named Photo album as well. This field is set to read-only in the default form and the standard value is set by the only catalog photoalbum entry Photo album. So, when creating the object Photo album, there is no need for further configuration and all that remains to do for the photo archive administrator is to click File and Open.

 

Use Cases

Opening the Photo Album

  • Log in to the client at <servername>/client with a user with the role Photo Archive Usage.

  • Click the magnifying glass symbol in the upper toolbar. This opens the Search dialog.

  • Check Photo album and click Search.

  • Open the photo album from the results list by double-clicking. You are now inside the context folder of the yuuvis® RAD system, which offers a different set of actions, e.g., creating photos.