21 June 2014 Author: Jean-Claude Dauphin [email protected] J-ISIS Reference Manual The latest J-ISIS Distribution zip file can be downloaded from: http://kenai.com/projects/j-isis/downloads (Version 1.3) 21/06/2014 J-ISIS Reference Manual – 21 June 2014 Page 1 Other documents providing details on specific J-ISIS features: Data Entry with Pick Lists, Validation Rules. BLOB Images. Plus Digital Data Entry Documentation Library documents. How to transfer a WinISIS Step-by-Step Instructions for moving a WinISIS or DOS CDS/ISIS Database database to J- ISIS to J-ISIS J-ISIS Network Client Server This document explains how to use J-ISIS in a network. This document explains how to install and customize J-ISIS on Mac OS X J-ISIS Intallation On Mac OSX Mountain Lion This document explains how J-ISIS is related to Web technologies and how to J-ISIS and Web Technologies use J-ISIS formats (CDS/ISIS formatting language) for creating HTML/XHTML display formats that contain hypertext. Pick Lists Validation Pick Lists For Data Entry and Data Validation Documentation Retrieving MARC Format Step by Step Instructions for Retrieving MARC Format Bibliographic Bibliographic Records from Records from Z39.50 Servers using J-ISIS Z39.50 client and Importing them Z39.50 Servers using J-ISIS Z to J-ISIS 39.50 client Step by Step Instructions for As an example, the public domain Gutenberg MARC format bibliographic Importing MARC Format records are imported to J-ISIS and it is shown how to update a record for Bibliographic Records to J-ISIS displaying html hyperlink to the original document. Playing with new Web This document explains and demonstrates how some of the features offered technologies in J-I SIS rev 1 by HTML5, CSS3, and JavaScript can be used inside J-ISIS print formats Web-JISIS Documentation Web-JISIS Documentation for the first alpha release of Web-JISIS J-ISIS Reference Manual – 21 June 2014 Page 2 Foreword J-ISIS is a new multiplatform Free and Open Source Software (FOSS) ISIS that provides the same successful concepts and functionalities as the actual UNESCO CDS/ISIS FOR WINDOWS (WinISIS) software. J-ISIS removes many of WinISIS limitations and restrictions, uses a Client/Server architecture, is fully UNICODE, and benefits of the latest software developments. J-ISIS follows the CDS/ISIS concepts to keep the assets and experience of the users, such that users familiar with the CDS/ISIS software family will also be familiar with J- ISIS and will retrieve the same concepts. On the developer side, the main objective is to develop a long-term solution that would be modular, easy maintainable and extensible. One of the requirements was that J-ISIS should be usable by small libraries and document centers in developing countries that don't have Internet access, or the necessary IT infrastructure and knowledge for installing a Web server. They need an easy to install application that provides a rich user interface. J-ISIS uses the client/server pattern and is a desktop application that acts as a database server as well as a rich client application. J-ISIS is a rich client application written to communicate with a specifically designed database server that is accessible as a stand-alone application and over some local network. It can be used on a single host machine, over a small local network, without Internet access or a Web server installed. A second requirement was that the J-ISIS application should be usable as a rich desktop application as well as a Web application. Today, a number of technologies are vying to add interactivity to Web applications, technologies such as Ajax are becoming more mature and JavaScript libraries such as jQuery, YUI, GWT, Dojo, etc. provide GUI widgets that would allow to develop better interactivity for Web applications. Around the J- ISIS desktop application that includes a database server, Web-JISIS is a Web application that uses the Struts 2 framework, Sitemesh, Ajax and jQuery. Please note that the J-ISIS desktop and Web-JISIS applications are complementary. J-ISIS is not an Integrated Library System (ILS) as ABCD, it's a non relational (NoSQL) database management system that uses the ISIS concepts and that is particularly well suited for the storage and retrieval of bibliographic information. While it is possible to use J-ISIS for publishing an OPAC, Managing Acquisitions, Loan and Patrons/Users as it is done with WinISIS, there are some specific ILS modules under development. J-ISIS Databases and all related files such as indexes, FDT, FST, Worksheets, etc are fully UNICODE using UTF-8 encoding and are interoperable between different platforms (i.e. you can copy databases without conversion between Windows, Mac OS X and Linux. As CDS/ISIS, J-ISIS is a flexible Information Storage and Retrieval system designed specifically for the computerized management of structured non-numerical data bases. One of the major advantages offered by the generalized design of the system is that J-ISIS is able to manipulate an unlimited number of data bases each of which may consist of completely different data elements. Furthermore J-ISIS uses TCP/IP protocol to communicate between computers and is a database server that follows the Client/Server architecture. For advanced users, J-ISIS offers a wide range of programming facility allowing the development of specialized applications through the use of its powerful print formats. The J-ISIS embedded Web browser and Web server offer the possibility to use the new Web technologies such as HTML5, CSS3, JavaScript inside ISIS print formats. The Groovy programming language has replaced ISIS Pascal offering the same functionalities and much more. For real computer programmers, the ISIS_DLL is replaced by the J-ISIS core library (jisis-core.jar), which is interoperable between different platform and which provide all necessary tools for developing J-ISIS based applications. And we may say that J-ISIS is one of today‘s available software based on the CDS/ISIS technology. Acknowledgements. First of all, CDS/ISIS technology would not exist if Giampaolo Del Bigio would not have created the CDS/ISIS technology. The original CDS/ISIS ran on an IBM mainframe and was designed in the mid-1970s under Mr Giampaolo Del Bigio for UNESCO's Computerized Documentation System (CDS). It was based on the internal ISIS (Integrated Set of Information Systems) at the International Labour Organization in Geneva. For many years, Abel L Parker from BIREME/PAHO/WHO and now Director of SciELO has given strong support to CDS/ISIS technology. Ernesto Spinak from BIREME and Egbert de Smet of the University of Antwerp have always been key CDS/ISIS technology experts also providing their help to J-ISIS project. Also many people from the ISIS User community have provided constructive criticism, suggestions and took the time to test J-ISIS. I would like to thank most particularly Tigran Zargaryan, Francesco Dell'Orso, Renate Morgensten, Bridgette Heron, Family Britz, Sara Diana Telias, María Mercedes MacLean, Vladimir Rubtsov, Nguyen Hue, Gerhard Riesthuis, Albert Lemort, Marie-Christine de Bouët du Portal, Philippe Cousson, Amjad Ali Malik and Prakash R. J-ISIS Reference Manual – 21 June 2014 Page 3 Table Of Content OTHER DOCUMENTS PROVIDING DETAILS ON SPECIFIC J-ISIS FEATURES: 2 1. SYSTEM OVERVIEW 9 A. The J-ISIS Data Base 9 B. System functions 9 C. Data base structure 10 1. DATA BASE DEFINITION FILES 10 2. DIRECTORY STRUCTURE FOR A DATABASE NAMED CDS 11 3. MASTER FILE 11 4. INVERTED FILE/ INDEXES 11 5. RELATIONSHIPS BETWEEN THE FILES 12 D. System architecture 12 E. Web Technologies 13 1. J-ISIS WEB BROWSER 13 2. J-ISIS WEB SERVER 14 2. INSTALLATION 15 2.1 Updating from a previous release 15 2.2 UNIX/Linux Special Setting 16 2.3 Configuration Files 16 3. J-ISIS THEORETICAL LIMITS 17 4. STARTING J-ISIS 18 5. J-ISIS – CLIENT/SERVER APPLICATION 20 A. The Application Main Window 20 B. Output Console Window 20 C. Database menu 22 6. J-ISIS DATABASE SERVER 24 7. OPENING DATABASES 25 8. VISUALIZING DATABASE CONTENT 28 8.1 Data Viewer 28 8.2 DB Browser 33 J-ISIS Reference Manual – 21 June 2014 Page 4 8.3 Dictionary Browsing 35 9. THE FORMATTING LANGUAGE 38 A. Field Selectors 39 1. FIELD COMMAND 40 2. SUBFIELD COMMAND 40 3. EXTRACTING A FRAGMENT OF A FIELD OR SUBFIELD 41 4. FIELD OCCURRENCES 42 5. INDENTATION COMMAND 43 6. MFN COMMAND 44 B. Mode command 45 C. Horizontal and vertical spacing commands 46 D. Literals 47 E. Dummy field selectors 50 F. Expressions 51 1. NUMERICAL EXPRESSIONS 51 2. STRING EXPRESSIONS 53 3. BOOLEAN EXPRESSIONS 53 G. Functions 55 1. NUMERICAL FUNCTIONS 55 2. STRING FUNCTIONS 61 3. BOOLEAN FUNCTIONS 73 H. IF command 74 I. Repeatable groups 75 J. Format errors 78 K. Including an external format 79 L. Format variables 80 M. WHILE command 80 N. CISIS functions 82 O. The XHTML/CSS/JavaScript Display environment 85 P. Adding Hypertext links to formats: the LINK command 88 Q. WinISIS Windows commands not implemented in J-ISIS 90 R. Differences with WinISIS 91 10. FIELD DEFINITION TABLE (FDT) 92 A. Introduction 92 B. General data base design guidelines 93 1. DATA ELEMENTS 94 2. FIELDS AND SUBFIELDS 94 3. REPEATABLE FIELDS 94 4. CONTROL CHARACTERS 95 C. J-ISIS Databases And MARC Records 96 1. ISO 2709 MARC RECORDS 96 2. ALL ISO 2709 MARC FORMATS USE THE SAME MARC RECORD STRUCTURE 97 4. INFORMATION INTERCHANGE FORMAT (IIF), ANSI Z39.2, ISO STANDARD 2709 97 5.