Versions Compared

Old Version 5

changes.mady.by.user Team Kolibri (Unlicensed)

Saved on

compared with

New Version 6

changes.mady.by.user Technische Redaktion

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents

Setting

...

up a Photo Archive in

...

yuuvis®

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

...

You need two things to get started:

  1. A working version of enaio® redline the yuuvis® Community Edition. Download it here and follow the Installation Guide 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 enaio® yuuvis® system and that nothing was configured in enaio® yuuvis® designer yet.

Installation

Deploying the Scenario

...

to your yuuvis® System

  • Unzip the project file (see Requirements) to the Documents folder.
  • Start enaio® yuuvis® designer.
  • Click Open.
  • Navigate to the folder where the scenario was unzipped. Select the .eoproj file and confirm the selection with Open.
  • Navigate to enaio > 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 enaio® yuuvis® system by right-clicking the project name in the navigation tree on the left and selecting Deploy. 
  • Open the Windows Task Manager (where the enaio® yuuvis® 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 enaio® yuuvis® service-manager. (This step will not be necessary from version for versions 4.7 or later.)

Assigning Roles

  • In a browser, open enaio® yuuvis® management-studio at <servername>/enaio/management and log in with your administrator account.
  • Go to main Main menu > Organization.
  • Create a new user:
    • Select default-suborganization in the list.
    • Click the action 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 action 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 into enaio® to yuuvis® 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.

...

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

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

...

  • Log in to the client at <servername>/enaio/client with a user with the role Photo Archive Administration, e.g. , root.
  • Click the + symbol in the enaio® barupper  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.

...

The action described above creates the unique context folder of the enaio® yuuvis® system. Then, assigns it the name Photo album and files it into is assigned to this context folder and it is filed to the location General (= Root), as can be seen in the schema definition in enaio® yuuvis® 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.

...

  • Log in to the client at <servername>/enaio/client with a user with the role Photo Archive Usage.
  • Click the magnifying glass symbol in the enaio® barupper 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 enaio® yuuvis® system, which offers a different set of actions, e.g., creating photos.

Filing a New Photo Into the Album

  • From within the photo album, click the + symbol the Plus icon in the enaio® barupper toolbar. This opens the Create object dialog.
  • Select Photo.
  • Upload a file and enter title, occasion and keywords for the new photo. Separate multiple keywords with Enter.
  • Click File and Open to see the new photo.

...

You can search for photos in different ways. The easiest is to enter attributes into the search field on the main page. If you want to go into more detail, you can use the expert search by clicking on the magnifying glass in the enaio® barupper toolbar.

In the photo album folder, you can also use the structure tree on the left to filter by occasions or keywords. This tree always reflects the current state of your photo album, i.e., the occasions and keywords used as well as the number of photos assigned to them.

...

You may have noticed that the photo document contains more attributes than you entered. enaio® yuuvis® automatically extracted them from the file you uploaded and added them to the document, which . This gives you more information to filter your photos by. You can edit both these attributes and the ones that you add added manually in enaio® yuuvis® designer.

There are two types of object definitions in enaio®yuuvis®:

  • Abstract object types define a basic set of properties.
  • Object types are the blueprints for actual objects in the enaio® yuuvis® system. They can be derived from abstract object types, inheriting all their properties, and add more specific ones as well. You can see the hierarchy in enaio® yuuvis® designer via Photo > Properties > Parent Types.

Adding Fields

  • Start enaio® yuuvis® designer.
  • Click Open.
  • Navigate to the folder where the scenario was unzipped. Select the .eoproj file and confirm the selection with Open.
  • Select Schema > Object types > Photo Archive - Community Edition > Photo.
  • In the detail details view in the center, click Fields.
  • At the top of the table, enter a technical name (without blanks), a display name (that will appear in the user interface) and a data type for the new field. Click the + to the Plus icon to add it to the object type.
  • Select the new field in the list and edit the properties on the right.

...

  • Find an attribute that you want to add:
    • To see which system attributes are available, start the enaio® yuuvis® Services Admin at <servername>: 7273
    • Find extraction in the list and click Details.
    • Click the Service URL on the upper right to start the Swagger UI.
    • From the dropdown drop-down menu at the top, select extraction-api.
    • Click extraction-resource to expand the operations list.
    • Click POST /extraction/api/xmp.
    • Under Parameters and file, open a file.
    • Click Try it out! to start the extraction process. Once it is finished, the result is displayed below in JSON format. All keys shown here can be used as aliases in enaio® yuuvis® designer. Choose one that you want to add.
  • Add a new alias:
    • In enaio® yuuvis® designer, open Abstract object type > Photo by double-clicking it.
    • In the detail details view in the center, click Fields.
    • Add a new field by entering a technical name, display name and type and clicking +clicking the Plus icon.
    • Select the new field and, in the properties on the right, expand Type > Aliases.
    • Click on the + next to Aliassesthe Plus icon next to Aliases.
    • In the field Namespace, enter extract.
    • In the field Name, enter the key of the attribute from the extraction service.
  • Add the new field to the user interface:
    • In enaio® yuuvis® designer, open Object type > Photo by double-clicking it.
    • In the detail view in the center, click Form.
    • Find the new field in the list and add it to the form via drag and drop.
    • Deploy the scenario to your enaio® yuuvis® system by right-clicking the project name and selecting Deploy.
    • Select a photo to verify if your new field is displayed correctly.

...

The structure tree shown in the photo album folder contains two main elements called Occasion and Keywords. The children of these top level nodes are the actual values that photo users assigned to their photos, i.e., the occasion descriptions and keywords stored in the index data of the photo documents.

To configure an additional top level element, procede proceed as follows:

  • Go to the documentation and copy one of the examples for the standard configuration of the structure tree, e.g.:

    Code Block
    {
    "title" : "Modification range",
    "title_locales" : {
      "de":"Bearbeitungszeitraum",
      "es":"Rango de modificación",
      "fr":"Plage de modification",
      "it":"Gamma di modifica",
      "pt":"Faixa de modificação",
      "ru":"Диапазон модификации",
      "zh":"修改範圍"
    },
    "key" : "ModifiedRange",
    "method" : "daterange",
    "field" : "modified"
  }


  • In enaio® yuuvis® designer, open Object type > Photo album.

  • In the detail details view in the centermiddle, click Structure tree.

  • At the end of the structure tree definition, insert a comma (,) after the last }.

  • Paste the copied code snippet between , and ].

  • Test the new structure tree with the structure testing tool as described in the documentation.

  • Save the project and deploy it to your enaio® yuuvis® system by right-clicking the project name in the navigation tree on the left and selecting Deploy.

  • Open the Windows Task Manager (where the enaio® yuuvis® 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 enaio® yuuvis® service-manager. (This step will not be necessary from version for versions 4.7 .or later)

  • In the client, open the Photo album or refresh by pressing F5.

...