iNet Documents Tree and Front Page

• 1. Introduction
• 2. Installing iNet Documents Tree and Front Page
  • 2.1 Installation steps
  • 2.2 Upgrading
• 3. General
  • 3.1 iNet Documents Tree objects
    • 3.1.1 Folders
    • 3.1.2 Files
    • 3.1.3 Pages
    • 3.1.4 Bookmarks
  • 3.2 Access permissions system
  • 3.3 iNet Documents folder tree and Front Page
• 4. Interface description
  • 4.1 Viewing objects in iNet Documents Tree
    • 4.1.1 Viewing folders (browsing your folder tree)
    • 4.1.2 Viewing files
    • 4.1.3 Viewing pages
    • 4.1.4 Viewing bookmarks
    • 4.1.5 hidden items
    • 4.1.6 Read / unread marking
  • 4.2 Creating / editing objects in iNet Documents Tree
    • 4.2.1 Creating / editing folders
      • 4.2.1.1 Setting permissions to folders
      • 4.2.1.2 Logging events
    • 4.2.2 Uploading / editing files
    • 4.2.3 Creating / editing pages
    • 4.2.4 Creating / editing bookmarks
  • 4.3 Moving objects in iNet Documents Tree
  • 4.4 Searching objects in iNet Documents Tree
  • 4.5 Deleting objects in iNet Documents Tree
  • 4.6 Mirroring objects in the Inet Front Page

1. Introduction

iNet Documents is a web file system, that is a system providing an interface to your files and directories stored on a web-server. Actually, they are stored in a database while iNet Documents system emulates a usual file system working with them. Comparing to any other file system, iNet Documents gives you an invaluable advantage of remote access to your files and directories via internet with the same interface. Besides this, iNet Documents has a number of little smart features including flexible file viewing and searching tools, reliable access control system etc.

In your iNet Front Page some folders of your iNet Documents tree are mirrored. It is an alternative convenient viewer of files and folders on your iNet server.

2. Installing iNet Documents and Front Page

2.1 Installation steps

2.2 Upgrading

3. General

3.1 iNet Documents objects

• Folders (section 3.1.1)
• Files (section 3.1.2)
• Pages (section 3.1.3)
• Bookmarks (section 3.1.4)

3.1.1 Folders

iNet Documents Tree folders are very similar to folders (directories) in any other file system, only the are stored in a different way. They have the usual tree structure (see also section 3.3 "iNet Documents folder tree and Front Page") and contain subfolders, files, pages and bookmarks.

3.1.2 Files

iNet Documents Tree files are usual text or binary files of any type. They are uploaded from your local disk and stored on iNet server. Files can be accompanied with any commenting string called legend.

3.1.3 Pages

On the other hand, pages are files of special types, including

• HTML pages
• Plain text files
• TX format files

• Name
• Title
• Keywords
• Show without banner (Yes / No)
• Page type (Plain text / Plain text from file / HTML page / HTML page from file / TX page / TX page from file)
• Page body (Typed text or file name, depending on the "Page type" field)
• Photo/Attachment

The page name is an identifier, consisting of letters (including '_' symbol) and digits; no spaces are allowed. The page title is a string containing the detailed description of the page. Unlike the page name it can contain any text symbols. The "Show without banner" field specifies whether or not the page must be viewed with the usual iNet Documents Tree banner. The page body can be either uploaded from a local disk or typed manually.

The iNet Documents Tree HTML and TX pages can contain links to any addressable resources located within the Tree as well as outside. As usually, you use full URLs (e.g. "http://www.rbc.ru/meteo.shtml") to specify outside resources. Please note that you also can use local paths such as "/Inet/Manuals" to specify objects in the iNet Documents Tree. Due to these properties, the iNet Documents Tree application allows you to {create your personal web-pages} easily. See section 4.2.3 "Creating / editing pages" for the instructions on how to do this.

3.1.4 Bookmarks

iNet Documents bookmarks are links to internet addressable resources. Each bookmark has three fields, namely "Name", "Title" and "URL".

3.2 Access permissions system

The iNet Documents Tree system provides an access permission check to all the folders. No check is performed in file/page level. The access rights can be granted to iNet users as well as groups.

The access levels are based on rights to perform elementary operations at folder contents:

• Read(R): view folder contents
• Update(U): edit the folder and objects in it
• Delete(D): delete the folder and objects in it
• List Rights(LsR): view other users' rights on the folder
• Change Rights(ChR): change other users' rights on the folder
• Create subentry(CrS): create subfolders

In Inet Documents Tree system you can grant any subset of the listed elementary rights to any user. Most popular subset have their own names:

• Create = {CrS}
• Read = {R}
• Read / Update = {R U D CrS}
• Full control = {R U D LsR ChR CrS}

You can also use a so-called "Special" subset that may contain any elementary rights.

After an access permission specification has been applied to the current folder, you can extend its effect to all subfolders of the current folder, that is apply it recursively. Granting access permissions to different users in several steps, one can achieve different combinationsm rather compicated, if necessary. For example, user irene can be granted with the viewing right to a folder and all its subfolders whilst user jack being granted full control right to the current folder only without any rights to its subfolders. See also section 4.2.1.1 "Setting permissions to folders".

3.3 iNet Documents folder tree and Front Page

By default, the iNet Documents folder tree looks as follows:

• Home
  • (personal home folders)
• Inet
  • Applications
    • Admin Apps
    • (iNet Applications bookmarks)
  • (common files and directories)

By default any member of iNet group has full control rights to his own personal home (is exists) and viewing rights (Read) to "Home", "iNet" and "Applications" folders. If a user is a member of Admins group, he has full control rights to his own personal home (if exists), "Home", "iNet", "Applications" and "Admin Apps" folders.

A user can browse a folder if he has "Read" right to it. This means, for example, that any iNet user has a right to enter Inet/Applications folder and view its contents. One can create subfolders in a folder if he has the "Create subentry" right to it. Thus, by default, only members of Admins group can create subfolders in Inet/Applications folder. See section 4. "Interface description" for the instructions on how to browse and edit folder tree.

The iNet Front Page mirrors some folders and their contents. Each folder can be mirrored in either brief or detailed mode (see section 4.6 "Mirroring objects in the iNet Front Page"). By default the mirrored folders are:

• Applications
• Admin Apps (if accessible)
• Inet
• Personal home (if exists)

4. Interface description

4.1 Viewing objects in iNet Documents

4.1.1 Viewing folders (browsing your folder tree)

At any moment, iNet Documents shows you the table view of a folder in your folder tree (figure 1), that is the list of all subfolders, files, pages and bookmarks in the folder. The path to the folder is shown in the left upper corner of the table view form. In the list, subfolders are marked with image, whilst files, pages and bookmarks being marked with , and images respectively. The items can be viewed in short, brief and full modes: select necessary mode in the combo-box in the table header.

To view an item, click its name. Clicking or icon leads to dowloading source of the corresponding item.

Figure 1. Browsing your folder tree

If you have the viewing ("Read") right to a folder, then its name is colored with navy. Click the folder name or the icon to get inside. Similarly, if you have the viewing right to the parent folder, you can go up by clicking back to the parent ... .

To see the folder tree structure click button in the banner. The folder tree form (figure 2) presents the subtree rooted in the current folder. If the parent / root folder is accessible, you can go up using / button. You can get the table view of any accessible folder in the tree by clicking its name.

Figure 2. Viewing folder tree

Also, if a folder is mirrored in the Front Page you can get inside from the front page immediately. To do so, just click the folder's name.

4.1.2 Viewing files

To view a file, click its name. For most file types, the iNet Documents Tree system just runs the web-browser's viewer. ...

MSWord documents ???

4.1.3 Viewing pages

To view a page, click its name. Plain text and tx-format pages are preprocessed into html-format pages before viewing. This means, for example, that all your formatting in a text document will be preserved if you use iNet Documents viewer to view it. A page can be shown either with the usual iNet Documents tree banner of without it (see section 4.2.3 "Creating / editing pages" for details).

4.1.4 Viewing bookmarks

Click bookmark name or the icon to go to the specified URL.

4.1.5 hidden items

4.1.6 Read / Unread marking

iNet Documents system automatically marks items bold if they are newly created and haven't been read yet. If an item was created more than a month ago it is considered as an old one and is not marked with bold no matter whether or not it has been read. You can also mark items as read / unread manually: check them and click / icon in the table header.

4.2 Creating / editing objects in iNet Documents

4.2.1 Creating / editing folders

You can create a subfolder in a folder of only you have the "Create Subentry" right to the folder (section 3.2 "Access permissions system"). To edit the folder properties, you need at least the "Update" right to it.
To create a subfolder in a current folder click "Create folder" button in the banner. To edit an existing folder enter the parent folder and click "Edit" icon in the corresponding line (figure 1). You can also edit the current folder properties by clicking "Edit" button in the banner. The new / edit folder form is presented in figure 3.

You are to fill it at least "Name" and "Title" fields. In the "Front Page Options" section you can specify whether or not the folder must be detached on Front Page by default, and if yes, then in which mode (brief or detail - see section 3.3 "iNet Documents folder tree and Front Page"). Click "Save" or "Apply" button in the banner to save changes.

Figure 3. Edit Folder form

4.2.1.1 Setting permissions to folders

You can view access permissions on a folder if only you have the elementary right to list rights on it (see section 3.2 "Access permissions system"), and change these permissions if you have "Change rights" right.

To view or change permissions on a folder, either enter it or open the edit form for it (figure 3) and click icon in the banner. The Object Permissions form is presented in figure 4.

Figure 4. Setting access permissions on a folder

The form contains the list of all groups (G) and users (U) permitted to access the folder with their access specification. You can view or edit the access specification for any user by clicking its name: this option allows one to create any subset of elementary rights (figure 5).

Figure 5. Editing access specifications

To add a new group or user to the list do the following steps:

1. Select necessary access specification in the "Add" combo-box
2. Select "group" or "user" in the "to" combo-box
3. If you add a group, select group name in the third box
   If you add a user, type user name in the edit or open "Select users" form by clicking image next to the edit
4. Click "Apply" button
5. If you want to extend the existing access specifications to all subfolders of the current folder, click "Apply recursively" button

To remove one or several groups / users from the list check them and click icon in the header of the list. Please note that some deleting actions are prohibited: you can not revoke "Read", "List Rights" and "Change Rights" from yourself. This is quite reasonable since these actions seem to be irreversible.

Each time you edit the list of users allowed to access the folder, all the changes previously made are preserved (if only they do not contradict the current action). For example, if you first added user john with the full control rights to the folder and all its subfolders (that is, used "Apply recursively" button) and then deleted him from the list and clicked "Apply" button, then john still possesses his full control rights to all subfolders of the current folder though loses rights to the current folder.

4.2.1.2 Logging events

The iNet Documents Tree system allows you to register all operations at folders you have the "Update" right on (section 3.2 "Access permissions system"). To switch this option on, use the "Audit" section in the new / edit folder form (figure 3). At the moment, only attempts to read items in the folder can be registered. Check "Log if result is success / unsuccess" if you want to register all successful attempts / failures to read an item in the folder.

To look through event log, open new / edit folder form (figure 3) and click button in the banner.

4.2.2 Uploading / editing files

To add new files to the contents of the current folder use "New file" icon in the banner. Click icon in the corresponding line of the table view form (figure 1) to edit an existing file. Please note that you can edit only file properties, not contents!

In the New / Edit File form (figure 6) you are to fill in the "Name", select a file name on a local disk and click "Upload" button. Then click "Save" or "Apply" button in the banner to save changes

Figure 6. Edit File form

For .tar.gz files there exist an Extract option. For example, to upload a large set of files from your local disk, you can compress them, upload the archieve and then extraxt it in the iNet Documents Tree. When extracting archieves, the system creates pages of all text files and files of all binary files. To extract a .tar.gz archieve, open Edit File Form (figure 6) and click "Extract" button in the banner.

4.2.3 Creating / editing pages

To create a page in the current folder click "New page" button in the banner. To edit an existing page click icon in the corresponding line of the table view (figure 1). The New / Edit Page form is presented in figure 7. Follow these steps to fill in the form:

• Fill in "Name" and "Title" fields
• Check "Show without banner" box if you want the page to be viewed without usual iNet banner
• Select page body type (one of Plain text / Plain text from file / HTML page / HTML page from file / TX page / TX page from file)
• For manually typed pages: type text in the text box. "Check Spelling" and "Clear" options are available for this box!
  For uploaded pages: specify a file name on your local disk and click the "Upload" button
• Upload attachments if necessary
• Click "Save" or "Apply" button in the banner to save changes

Figure 7. Edit Page form

iNet Documents Tree allows you to {create your personal web-pages} easily. This can be done in the following steps:

1. Create a set of necessary html-files and images in a directory on your local disk
2. Compress them using tar.gz
3. Upload the tar.gz file to the iNet Documents Tree and extract it in the tree (see section 4.2.2 "Uploading / editing files"). This will result in a set of HTML-pages with the "Show without banner" option set on.

The pages are stored in the iNet database, so the iNet Documents Tree system substitutes all necessary links in your html-files with links to the database objects. Thus, your pages look exactly as they looked on your local disk. After this, you are to grant the "Read" right on the folder to an unauthorized user "guest" and to send the URL to your friends all over the world :-)

4.2.4 Creating / editing bookmarks

To create a bookmark click "New bookmark" button in the banner. Type the bookmark name, title and full URL with the transfer protocol name (http, https or ftp). Click "Save" or "Apply" button in the banner to save changes (figure 8).

Figure 8. Edit Bookmark form

4.3 Moving objects in iNet Documents

To move one or several objects from a folder to another folder open the table view (figure 1), check necessary items and click "Move" icon in the table header. To the system request, type the destination folder name and click "OK".

You can also move any object in its Edit form (figures 3,6-8) by clicking "Move" button in the banner.

4.4 Searching objects in iNet Documents

The iNet Documents Tree provides flexible searching tools named simple search and advanced search. These tools are accessible in the table view (figure 1).

In simple search, the system searches for a word you type in in the input line in the "Name" and "Title" fields of the objects in the current folder. The desired word can include the pattern symbol '*' meaning any sequence of characters.

To switch to the advanced search mode click the "Advanced" button. In this mode (figure 9), you can specify several fields by typing words in the corresponding controls. Then the system constructs an SQL query checking each field in the form. Click the "Search" button to start searching and the "Simple" button to get back to simple search mode.

Figure 9. Advance Search tool

4.5 Deleting objects in iNet Documents

You can delete objects from a folder only if you have the "Delete" right to it. To delete one or several objects from a folder open the table view (figure 1), check necessary items and click "Delete" icon in the table header. You can also delete any object in its Edit form (figures 3,6-8) by clicking "Delete folder" button or "Delete" button in the banner. When deleting a folder, the system checks if it is empty; if not, you can answer "Delete recursively" in response to the system's request.

4.6 Mirroring objects in the iNet Front Page

You can get the iNet Front Page from any iNet application by clicking this Molsoft Logo in the left upper corner of any iNet window. In the Front Page, some folders of your iNet Documents tree are mirrored. By default these are the following folders:

• Applications
• Admin Apps (if accessible)
• Inet
• Personal home (if exists)

Each detached folder can be mirrored in either brief or detailed mode and makes a box on the Front Page (figure 10). In brief mode, only names of items in the folder are shown whilst item titles, creator and last modification date being shown in detailed mode. Folders in brief and detailed mode are presented in the left and right sides of the page respectively.

Figure 10. iNet Front Page

You can click a folder name to open table view for it (figure 1). Pages, files and bookmarks can also be viewed by clicking their names on the Front Page. Subfolders of the detached folders have the "Make brief view" icon near them: click this icon to detach the subfolder on the Front Page as well.

The following operations at folders are available in the iNet Front Page:

• create new bookmark in the folder: click "New bookmark" icon
• create new page in the folder: click "New page" icon
• change setting for the folder mirroring in the Front Page: click "Configure" icon In the Folder Configure form, you can specify the maximal number of items in the folder to be shown on the Front Page and set "Show only unread items" option (see section 4.1.6 "Read / unread marking")
• show in detailed mode (for the folders in brief mode): click "Make detailed view" icon
• close brief / detailed view for the folder: click "Close" icon

To restore default Front Page settings click "Auto Arrange" button in the banner.