New object creator – selecting the main file of the object

Before adding an object to the library, the user should save all library files on the local drive of the computer on which the Editor Application is run.

In order to create a new object:

  1. From the element list, select the directory or group object in which the new object is to be placed.
  2. From the context menu, select the “New object” function. You can also use thebutton on the toolbar or select an appropriate option from the main menu (“New object...” from the Management menu). After the “New object” function has been selected, the new object creator will be initiated.
  3. The first step of the new object creator is to define the object content. By default it can be done in three ways, depending on the selected data source.

    1. The first data source is "Standard object", which is a main file selection form known from older versions of dLibra (see the image below). f the object only consists of one file, for example, a PDF document, that file should be selected. If the object consists of many files (for example, HTML files), the startup file for the document should be selected (for HTML, it is usually the index.html file).
      If the main object file is in the HTML format, DjVu format, or another format managed by the currently installed extensions, such as fileParser, then the creator will check if all files related to the main file are present and if they are consistent. If it turns out that the selected document is incomplete (files related to the main file are missing), then the transition to the next step will be blocked by default, and the "Warnings..." button can be used to show the list of detected problems. We can decide to purposefully put an inconsistent object in dLibra by clicking the "Ignore warnings" button and moving to the next steps.
      All other files from the directory of the main file (not only the object files found by the creator) will be put in the file table. By default, those files are not selected for uploading to the server. Therefore, the user can add files which have not been found by the creator but belong to the object.
      Please note: the main file of the object and the related files cannot be deselected. They will always be sent to the server.
      The user can additionally modify the type and encoding of a file, in the file tree. Those modifications should only be made when the application does not recognize a file type correctly (the correct value should be entered in the “Type” column). Encoding can only be modified for files which have it (for example, HTML files). If the application does not recognize the encoding of a file correctly, the editor can correct the value by selecting the actual encoding from the expandable list in the “Encoding” column.

       
      The New Object Creator - a standard main file selection panel

    2. The second data source is called "Multiformat Object" (see the image below) and it's mainly used to create objects that have the same content available in several formats. After clicking the "Select folder" button we need to choose a folder with the prepared files, divided into subfolders with names matching the formats. The formats that can be used depend on the server configuration and by default they are: DjVu, PDF, Galeria, Audio, Wideo, EPUB, MOBI. The recognized formats/folders along with the files within will be visible as a tree. For simplicity, in this mode the application does not try to analyze the file contents in order to choose the associated files - all the files placed in the folders will be included in the object. dLibra also doesn't check the types of files added to specific formats - the Editors need to take care of consistency in that regard in order to not confuse the Readers.
      In the "Default format" column the radio button should be checked next to the format that should be presented when the Reader clicks on the "Show content" button without selecting a specific format. In the next oclumn - "Main file" - for each format we can the file that the Reader will pointed to when they select that format (by default the Application tries to guess which of the files is the main one, based on their names).
      Nothing prevents us from using the multiformat form to create an object with only one format. The benefit of that over a standard object is that the object will appear in search results with applied filtering by this content format and it will be included in statistics related to that format.

      New Object Creator - defining multiformat objects

    3. The third data source is "Linking Ojbect", which is used to create objects content of which is available somewhere else on the Internet. In that case the dLibra server only stores a small file (names ulr-publication.xml) containing the address of the external resource. When the Reader tries to view the object content, the website behavior depends on the configuration (more precisely, the configuration of ContentBrowserComponent in the WEB-INF/components.xml file): it can show a panel with the external link that the Reader can click on, it can show the external resource directly in an iframe, or it can redirect to the external resource.
      To make it possible to find the created object by content, we need to also define URLs of the resources dLibra should use for object indexing. Usually it's enough to copy the main link to the external resource. dLibra is able to index resource of various formats (e.g. PDF, DjVu, HTML), same as with standard objects. Additionally, after the first URL is inserted and selected, the Editor's App content consistency check mechanism can be used to automatically add associated files (e.g. all the pages of a DjVu document or links in an HTML document) - it's invoked with the "Find related resources" button.

      image2020-6-14_0-49-7.png 
      Kreator nowego obiektu - wprowadzanie obiektu linkującego

  4. In the second step (see the image below), the user should describe the new object with the use of a set of attribute values. For details about it, see the Bibliographic Description Editor chapter. In order to be able to go to the next step, the user must enter the name of the new object (in the “Name” field). By default, the name is created on the basis of the bibliographic description, by combining the name of the author and the date of edition (for information about changing the method of creating a default name, see the Configuring the Editor Application section. For example, if the title is “Fables”, the author is “John Smith”, and the date of edition is “2004”, then the name will be “John Smith, 2004, Fables” – with the author first, followed by the date of edition and the title. Whenever a user changes the bibliographic description, the name is updated. Off course, a user can also enter a different name or modify the default name. In such a case, the automatic update will be blocked. In order to proceed to the next step of the creator, the user should click the “Next” button.

    New object creator – assigning attribute values

  5. The third step (see the image below) is to assign access permissions for the object to users. Permission assignment is described in the part about the permission editor. In order to proceed to the next step of the creator, the user should click the “Next” button.

    New object creator – assigning permissions for the object to users

  6. In the fourth step (see the image below), the user should assign the object to a collection. The way to do that is described in detail in the section about the Editor for Assigning Objects to Collections. In order to proceed to the next step of the creator, the user should click the “Next” button. 

    New object creator – adding an object to a collection


  7. In the fifth step (see the image below), the user can choose the thumbnail for the first edition of the object.

    A thumbnail is a graphical representation of an edition; it is shown to web page users next to the information about the edition. In order to upload a thumbnail from a graphics file on the drive, the user should click the “Select” button and indicate the file. If there is an extension of the miniatureProvider type installed in the application and if it supports the file types selected in the first step of the creator, the application will be able to automatically generate thumbnail suggestions. For that purpose, the user should click the “From object files” button. If the application has generated many thumbnails, the user can select the correct one by indicating its number on the expandable list (thumbnail numbers usually correspond to the numbers of the pages of the object) or review the subsequent thumbnails by clicking the “Previous page” and “Next page” options. The user can also paste an image from the clipboard (with the use of the “Paste” button). If the application is configured properly, it will automatically reduce the thumbnail size to the required size (for the configuration details, see here). The user can also make the thumbnails bigger or smaller by clicking the buttons labeled + and -.

    In order to proceed to the next step of the creator, the user should click the “Next” button.

    The metadata export window


  8. In the sixth step (see the image below), the user can provide some general information about the object, in the following sections:
  9. In the last step of the creator, the object files are sent to the server (see the image below). In order to create an object on the server, the user should click the “Start” button. That process can be paused and resumed by clicking the same button again. While the object is being created, all operations which have to be performed for the object to be created correctly are displayed on the “Progress” panel. The name of the operation being performed at the moment is in bold. For every operation, the program displays the time (in seconds) which has elapsed since the beginning of that operation. Progress bars show the user how advanced the performed operations are. Once the object has been created, a short summary is displayed. While the object is being created on the server, the operation can be canceled (by closing the window, for example, by clicking the “Cancel” button). Also, the editor can postpone the process of object creation by clicking the “Send later” button. When that button is clicked, all information related to the object is saved on the computer drive, and the creator window is immediately closed. All objects which are to be sent later are put on a special list which can be managed in the window for sending such objects. That mechanism is described in detail here. It makes it possible to prepare a set of objects for sending and then to start up the sending of all of them together (for example, to start up the sending at the end of one’s work). One advantage of it is the ability to potentially send more objects – the editor will not have to wait through the sending process because the files can be sent after working hours.

    New object creator – creating an object on the server