# Welcome to the FSI Server web interface!

This tab provides an overview on how to use the web interface to manage and publish your images.

1 Overview 2 Tree View 2.1 Folder Tab 2.2 Search Tab 3 File View 3.1 File and Folder Operations 4 Working Area 4.1 View Tab 4.2 Metadata Tab 4.3 Color Tab 4.4 Publish to Web Tab 4.4.1 Further Publishing Options 4.4.2 Effects Tab 4.4.3 Hyperlink Tab 4.4.4 Hotspot Tab 4.5 Upload Tab 4.6 Download Tab 4.7 Batch Tab 4.8 Licence Tab 5 Enabling search |  |
## 1Upload your pictures | ## 2Choose your viewer | ## 3Paste codesnip into your website
Open the 'Upload' Tab and upload your pictures to the web interface via Drag & Drop or by clicking the Browse button to add files. | Within the 'Publish to Web' Tab you can choose from a variety of viewers available in JS and Flash. | Copy the HTML code which is displayed within the publish dialogue and simply paste it into your website in order to implement the viewer.

## 1 Overview

The interface consists of 3 main sections: tree view, file view and working area.
The dimension of these sections can be changed by dragging the splitter bars between the sections.

## 2 Tree View

The tree view contains tabs for browsing the folder structure and for searching.
At the top, the root directory name (server name) is visible.
The root directory contains all available Source Connectors (profiles) on this specific FSI Server, listed below the root directory.
The following source connector types are possible within the root directory:

- Static: (for static files only, e.g. style graphics you want to use on your website)
- Storage: (images will be imported to the storage for high performance Single Source Imaging)
- Multi Resolution: (profile contains multi resolution TIFF files only)

New source connectors can be set up via FSI Administrator interface, as well as the administrative privileges (read only, write, etc) and user profiles.
It is also possible to determine different permissions for each folder (Read, Write, List, Tasks), the set permissions for the currently selected folder can be viewed via More information... at the bottom of the tree view.
It is also possible for the administrator to define customized comments (e.g. what kind of files are recommended to put into a certain folder) for each source connector type, which will show up at the bottom of the tree view. These comments can be defined via FSI Administrator or a XML file.

## 2.1 Folder Tab Below the root directory, the following built in folders exist: Favorite Folders: Contains shortcuts to folders which are marked as favorites by the user. Recycle Bin: Contains deleted files. In order to delete files permanently, right click in the file view to access the context menu and select "Delete Permanently". In order to restore files, click "Restore selected items" in the context menu. Downloads: Contains downloads created by the user. Using the context menu you can cancel or restart the download job, download a selected item, or delete items. The root directory also contains the following fixed profiles: FSI Viewer: Here all data which is needed for the FSI Viewer software is stored. Profile type: Static (you can upload XML and skin files for your FSI Viewer here) Service Images: Contains images required for FSI Software, like the instructions on FSI Pages mobile and fallback pictures. Profile type: Storage Service Files: Contains files required for FSI Software, e.g. sample audio and video. Profile type: Static Samples: Contains sample pictures. Profile type: Storage On the bottom of the tree view the type of the selected folder is visible (Name of folder, Source Connector Types: Storage, Static or Multi Resolution) as well as the permissions overview (via More information...) and total amount of images contained in the selected source connector. ## 2.2 Search Tab The search tab allows you find files on the server that match certain criteria. At the top you can find a simple text input. Typing keywords into the text input you can search for items that have matching keywords in any data field. Alternatively you can setup your search criteria using the search conditions below the input: Use the check box located directly under the input to limit the search to the current selected directory Use the check box to include or exclude a search condition Choose the desired data field of the condition Choose whether a condition should be equal or unequal. Some fields additionally offer the option to comparatively search items (less than, greater than). Enter the value for the search condition To add another condition click the "Add Condition" button at the bottom right. To remove conditions, click the "x" button at the top right of each condition. Note that using multiple conditions you can define each condition as "mandatory" or "optional". "alternatively" means that the condition extends the range of possibly matched items. "mandatory" usually reduces the range of possibly matched items. Example:
Condition 1 | Condition 2
mandatory field: "File Suffix" "equal" value: ".jpg" | alternatively field: "File Size" "less than" value: "550kb"
These conditions will return all files with a ".jpg" file suffix and additionally all files less than 550 kb in size. Switching Condition 2 to "mandatory" would return all files with a ".jpg" file suffix that are additionally less than 550 kb in size. |

## 3 File View

In the file view the directories and files of the selected folder are visible.
In the bar at the top several actions for managing files and directories are selectable via icons:

Create Folder, Rename, Copy, Cut, Paste, Delete

The sorting drop down menu allows you to sort items by certain criteria . With the arrow button beneath, the order of the chosen sorting feature can be changed.
On the right of the sorting menu you can change the appearance of folders and items within the file view. In order to change the sizing of thumbnails, either click on the smaller/larger thumbnail button to change the view or slide the thumbnail controller in the desired direction.
The buttons on the left let you choose between

- Page View: Items will be displayed as double Pages, with the first as cover and the last as back (single) page (helpful for displaying catalogues)
- Thumbnail View: Each picture will be shown as a thumbnail
- List View: items will be show in a list featuring File Name, Width x Height, File Size, Last Modified Date and Status and can be sorted by those features by clicking on the name of the feature

With the location bar below you can browse through the directory structure. Go to previous/ next location or go to the parent folder by using the buttons. For accessing a folder directly, type in the folder destination in the input field.
By using the right mouse-button within the file view area, more actions can be accessed via the context menu, such as re-importing selected items, adding files to a download archive, downloading the selected item, creating a favorite, etc. Drag & Drop is possible within the file view and the tree view. Files or folders can be dragged from the operating system's file browser to the file or tree view in order to upload them to the server.) In addition you can copy or move items by dragging them to the target folder in the tree or file view.
By clicking on a specific file in the file view, the upper working area will be activated.

## 3.1 File and Folder Operations

Creating a new directory The root of the tree view contains different source connectors. In order to create a folder within one of these source connectors, either

- Right click on the profile name and choose "Create new folder"
- Right Click in the directory overview on the lower right, choose "Create new folder"
- Click on the folder button in the directory overview and the "Create Folder" window pops up

Note: If you want to add a source connector to the root directory, you need to create a new source connector using FSI Administrator.

## 4 Working Area

Within the Working Area, different tasks and information concerning the selected items are displayed. Depending on the file format, you can choose between the following tabs:

View, Metadata, Color, Publish to Web, Upload, Download, and Help.

The window button on the far left enables you to seperate the working area and opens it in another window.

## 4.1 View Tab

On this tab, you can see the selected image using FSI Viewer, in which you can use all standard features including a full screen option.

## 4.2 Metadata Tab

The metadata of the image will be shown and is divided into three sections: General, IPTC, and EXIF data.
All metadata fields - except for those in the "General" group - can be edited, deleted or added. In order to change existing data, click on the corresponding field value and type in the desired value. By clicking the "Add fields" button in the Options menu at the bottom of the page you can add IPTC or EXIF data fields.
You are able to apply the tasks in the options menu at the bottom to all editable meta data (which are characterized by the check boxes in front of the Data name).
You can choose to check or uncheck all editable meta data, to empty the values which are currently displayed in the data fields, re-import meta data from the source file or to delete all selected fields. The changes will be saved automatically.
By holding Shift while selecting check boxes, you are able to select multiple check boxes at once.
If you select multiple images or files at once, you can apply changed field values to all by selecting the "Apply to all selected files" task in the options menu.

## 4.3 Color Tab

This tab provides information on the dye distribution, color histograms, and the ICC Profile if applicable.

- Dye Distribution: Both pie chart and histogram show the distribution of each color in the image in percentage.
- Histograms: Here the RGB, Red, Green, Blue and Saturation histograms are provided.
- ICC Profile: The ICC profile is a color reference profile, which describes the characteristics of the device it correspondents to. They are used to enable the best possible color rendering and to provide color consistency independent of the device used. In this tab you can see the media points (the color space which is used for the picture) as well as the profile data such as Description, CMM (color management module), manufacturer, creator and the creation date. You also have the possibility to download the profile in order to use it in your further workflow.

## 4.4 Publish to Web Tab

While having an image or folder selected, you can see all possible publishing ways for the specific item here.
The Publishing Set option enables you to choose between publishing the images via FSI Server (Publishing Set: default) or to publish them via FSI Cache.
There are several presets provided for each publishing option, if there is a "more..." button provided underneath a preset, you are able to load additional configuration files.

FSI Viewer Flash: Requires a single high resolution image.

Presets provided:

- Common Tools: FSI Viewer will be equipped with the standard features
- No Navigator: Navigator window will not be displayed
- Minimal Interface: Interface will be minimized to Zoom, Minus, Plus and Stop button
- No User Interface: Image will be shown without interface; only zooming in via clicking is possible.

FSI Viewer Flash 3D: Requires two high resolution images of the left and right eye view to display a stereoscopic view of an item. You can activate this option by selecting both images required.

Presets provided:

- Common Tools: FSI Viewer will be equipped with the standard features
- No Navigator: Navigator window will not be displayed
- Minimal Interface: Interface will be minimized to Zoom, Minus, Plus and Stop button
- No User Interface: Image will be shown without interface; only zooming in via clicking is possible.

FSI Viewer Flash 360: Requires a folder containing series of high resolution images taken from different viewing angles. This option lets the user rotate the presented object to view it from different angles. You can activate this by either clicking on the folder that contains the 360 degrees image set or by clicking at one of the pictures within the folder.

Presets provided:

- Common Tools: FSI Viewer will be equipped with the standard features
- Spin and Blur: While pressing the spin button, the object can be spinned fast and appears blurred.
- Auto Spin Presenter: Image will spin automatically when FSI Viewer is loaded.

FSI Viewer Flash 3D 360: Requires two folders containing series of high resolution images taken from different viewing angles as well as the left and right eye view. This option allows you to publish a stereoscopic view of a spinable object. You can activate this by selecting both folders.

Presets provided:

- Common Tools: FSI Viewer will be equipped with the standard features.
- Spin and Blur: While pressing the spin button, the object can be spinned fast and appears blurred.
- Auto Spin Presenter: Image will spin automatically when FSI Viewer is loaded.

FSI Showcase Flash: Publish all images in a folder including preview thumbnails. You can activate this by either clicking on the folder that contains the image set or by clicking at one of the pictures within the folder.

Presets provided:

- Showcase with Info: Tumbnailbar is equipped with image info such as name, dimension and size.
- Floating Thumbnail bar: Thumbnail bar is integrated as a pop up within the viewer.
- Thumbnail bar outside: Thumbnail bar is placed outside the viewer window.
- Thumbnail bar inside: Thumbnail bar is placed inside the viewer window.

FSI Pages Flash / JS (mobile): Publish all images in a folder as a e-brochure or e-catalog. You can activate this by either clicking on the folder that contains the image set or by clicking at one of the pictures within the folder.

Presets provided:

- Catalog with links: If links are embedded on the TIFF files via FSI Pages Converter, these will be shown in FSI Pages.
- Catalog without links: An e-catalog without hyperlinks
- Hard Cover Book: Images will be published with the front and back as Hard Cover.
- Teaser Thumbnail: A small thumbnail e-catalog

FSI Viewer JS: Requires a single high resolution image. This option enables a Javascript based 2D Zoom.

Presets provided:

- 2D Zoom and Pan

FSI Viewer JS 360: FSI Viewer JS 360 is a JavaScript based tool to display 360° object spins in combination with zoom. Depending on the device capabilities it offers in place zoom or pinch zoom support. With using an optional video, the rotation of the object can be displayed extremely smooth on devices that support video capturing. Optional hot spots with HTML content can be added by providing 3D coordinates. This publishing option requires a folder containing a series of high resolution images taken from different viewing angles. You can activate this by either clicking on the folder that contains the 360 degrees image set or by clicking at one of the pictures within the folder.

FSI Viewer JS 3D: JavaScript based stereoscopic zoom. Requires two images of the left and right eye view. You can activate this option by selecting both images required.

Presets provided:

- 2D Zoom and Pan

FSI Viewer JS 3D 360: Javascript based stereoscopic 360° object spin. Requires two folders with images containing the left and the right eye view of an object spin. You can activate this by selecting both folders.

Presets provided:

- 360° Spin and Zoom

FSI Showcase JS: FSI Showcase combines the benefits of FSI Viewer JS with FSI ImageFlow. It is created for viewing multiple images with an image carousel. By clicking on an image, it will be displayed in the FSI Viewer JS instance placed above the carousel. The option publishes all images in a folder including preview thumbnails.

Presets provided:

- Endless Scrolling: displays thumbnails as endless image carousel.
- With Scroll Bar: displays the thumbnails as a scroll bar slideshow-type presentation.

FSI ImageFlow:: FSI ImageFlow is created for publishing all images in a folder as an JavaScript based image carousel with optional built in mirror effect and full page zoom.

Presets provided:

- Mirror Effect: adds a mirror effect to the carousel.
- Transparent Images: Use this option if you would like to publish images with transparency.
- Simple: Images will be published as a plain image carousel

Image: Requires a single high resolution image. You can publish in different dimensions, formats and apply image effects. By choosing effects, formats and dimensions, the Rendering Query Parameters are set, which can be used in the Download section. With this Publishing Option, it is also possible to publish zoomable images for mobile devices via FSI TouchZoom. In order to activate the zoom, check "Enable FSI TouchZoom" within the HTML Image Publish tab.

Image 3D: Requires two single high resolution images. You can publish in different dimensions, formats and apply effects. You can activate this option by selecting both images required.

## 4.4.1 Further Publishing Options

After selecting a publishing option, tabs appear on the bottom of the publish section.

- Publish: Automatically selected, further configuration options are displayed as well as the HTML Code, which is needed to implement the viewer or image into websites.
- Preview: FSI Pages/ FSI Showcase/ FSI Viewer: depending on the selected publishing mode, the configured preview for the software appears. In order to see a preview on touch devices, please type [your server URL]/fsi/#preview into the browser of your device after setting up your configurations for the selected publishing option. This URL accesses the configurations of the user currently logged in into your FSI Server.
- Plug-Ins: Tab in which the plug-ins can be selected and customized.
- Crop: Provides the option to crop the image.
- Edit Hyperlinks: Only in FSI Pages publish mode, option to modify existing hyperlinks within the files.
- Edit Hot Spots: Provides the option to create and edit Hot Spots for the image.
- Effects: Only in HTML Image publish mode, options for creating effects on demand.
- Cancel: Return to the publishing option selection.

## 4.4.2 Effects Tab

Click on the desired effect in order to select it. Apply the effect on the picture by pressing the arrow button in the middle while the effect is selected (alternatively you can double click or drag the desired effect). You can adjust the options of the effect or delete it in the right column below the preview image. If more than one effect is applied, it is also possible to change the processing order of the effects by dragging the effect to the achieve the desired sequence.

## 4.4.3 Hyperlinks Tab

This tab provides access to the hyperlink and overlay editor for FSI Pages. In order to edit you can choose between Standard mode (normal catalogue view), Link mode (edit links) or Overlay mode (edit or add overlays such as videos or icons).

## 4.4.4 Hotspots Tab

This tab provides access to the hot spot editor. You can choose between Default Options and the Hotspot tab, where you can determine e.g. the color, target and behavior of the tooltip. In order to draw a hotspot on the image, you can either use the shape library button or use the freehand drawing tool on the right bottom of the Edit Hot Spots tab. You also have the possibility to save, test and delete the edited hotspots.

## 4.5 Upload Tab

Depending on the type of the selected source connector, you can upload different types of files. There are several possibilities to upload images into the interface.

- Choose the Upload tab, click the "Choose files" button to add files to upload to the list. The files will be uploaded to the current folder.
- Drag & Drop files to the file view or the tree view

The upload starts immediately once you add files. You can pause or continue the upload by using the pause upload button.

## 4.6 Download Tab

There are several possibilities to download images from the interface.

- Drag & Drop files or folders from the file view onto the download tab or
- Select items in the file view and choose Add to download archive from the context menu.

Once you have collected all files, you can choose the Download Configuration using the "Download as:" drop down menu.
You can optionally schedule the download start to a specific time and choose a file name.
Clicking the "OK" button starts the creation process and adds the download to My Downloads folder of the root directory.

## 4.7 Batch Tab

Within this tab, you can download batch processed images.

- Select items in the thumb view and choose Add the batch process from the context menu - or -
- Drag & Drop files from the file view to the Batch tab
Atemschutzunfälle

Once you have collected all files, you can choose the Download Configuration using the "Download as:" drop down menu. The Download Configuration determines how the files will be archived and if a batch rendering for the images to download images should be executed. Click the "Options" button to modify or add a Download Configuration:
Here you can choose the Configuration name and type of archive (ZIP, tar.gz, tar.bz2).
You can download either unmodified source files or processed images.
When you decide to download processed images, you can choose if you would like to replace or append the file extensions.
In the box you will see the Rendering Query Parameters, which can be generated interactively in the Publish to Web Tab choosing the HTML Image section, where you can add various effects, crop the image and look at the preview of the processed image. (see: Publish to Web). Once you finished choosing the operations to apply to the images you can copy the Rendering Query from the "Publish" tab.
You can optionally schedule the download start to a specific time and choose a file name.
Clicking the "OK" button starts the creation process and adds the download to My Downloads folder of the root directory.

## 4.8 Licence Tab

This tab gives you an overview of your licence information and enables you to enter your key either by uploading the corresponding licence file or by typing in the licence data manually.
The Licence Request Data is crucial for updating your licence.

## 5 Enabling search

FSI Server 3 uses Apache Solr as a database to allow searching in asset metadata. The Solr server is not embedded in FSI Server as the database was in FSI Server versions 1 and 2.
If you require searching, for example in FSI Pages or FSI Pages mobile, then you will have to provide a Solr instance for FSI Server to use. If you are running FSI Server on Microsoft Windows and have installed it using the Windows installer version from the FSI Viewer website then the Solr server is automatically installed together with FSI Server, FSI Administrator and FSI Cache. In that case the setup instructions are not relevant for your installation.
Solr can be downloaded from the FSI Viewer website at http://www.fsi-viewer.com. This minimizes the installation efforts and allows an easy installation even for unexperienced users. This package is a web archive (war) just like the FSI Server and can therefore simple be deployed in an arbitrary tomcat instance. As FSI Server and Solr/Lucene are both memory critical applications they should not be deployed under the same JVM other than for testing.
IMPORTANT:
For production environments it is highly recommended to deploy the Solr package in an own Tomcat/JVM instance. In high load environments you should consider installing the Solr instance on separate hardware.
Installation:
1. Download and deploy Solr by copying the downloaded WAR file to the tomcat webapps folder.
2. Configure access restrictions to Solr if needed.

- By default access to the Solr server is limited to connections from local ip addresses. If you are installing the package on a different machine, then you will have to disable this limitation
  by commmenting out the Valve- configuration in webapps/solr/META-INF/context.xml
- The access to the Solr server is not restricted to a specified user, but should be when the above limitation is removed. To enable this security feature, please uncomment the "security contraint" and the "login-config" blocks
  in webapps/WEB-INF/web.xml and add an appropriate user to your Tomcat installation, e.g. by adding the following lines to your tomcat-users.xml:
  <tomcat-users>
  <role rolename="solr_user"/>
  <user username="fsi" password="mypassword" roles="solr_user"/>
  </tomcat-users>

3. Enable the search in FSI Server

- Set the "enabled" attribute of the "search" sections to true in the sourcemanager.xml and requestprocessor.xml and set the login credentials according to the previous step if required.
- or: Log in to FSI Administrator, navigate to your FSI Server and enable the search sections in the Request Processor Settings and the Source Manager Settings screens. Configure login credentials if required.

4. Wait for the FSI Server to finish the automatic build of the search database.