When two Image Windows are overlapping in Print Template, the common part will become empty white space. When a user needs one big Image Window with a smaller "preview / overview" window, the only way to make it work is to place another image window on top.

We have added three new parameters to control behavior of Image Window - they can be controlled via with Template Editor, HyperDoc Options and INI entry:

Parameter in Configuration INI file

Section: [TSLRVC Library Settings]

Parameter: DefaultVportsOverlapMode:

Possible values:

Default value is 1 and it's recommended for most scenarios.

Caution

Please see the section called “Common problems” for problem with reading this parameter in HIS.

Parameter in HyperDoc

To control clipping from HyperDoc change value of Fill/clear overlapping viewports parameter.

This can be done by clicking Tools menu and then choosing Options.... In HyperDoc Options dialog select Advanced tab. There you will find this parameters.

Possible values:

  • False - overlapping parts of viewports will be painted and printed with white solid brush,

  • True - overlapping parts are defined by most top defined viewport and only this viewport should be visible.

Changes done to this parameter will take immediate effect in HyperDoc. This will also modify DefaultVportsOverlapMode parameter in INI file.

Parameter in Template Editor

Clipping mode can also be defined in Template Editor (installed along with HyperDoc installation) by choosing proper option from dropdown menu.

This will only influence specific template and will overwrite general settings (controlled by parameters described above) but only for this specific template.

If you choose option Undefined template will use parameters described above from INI file or HyperDoc.

Tip

You can set this parameter different for both orientation: Landscape and Portrait.

HIS version

Java version

4.95

java 7 update 3, 4, 5, 6, 7*

java 6 update 26, 27, 28, 29, 30, 31, 32, 33, 34, 35

java 7 update 1

java 6 update 30 and newer with Safari browser

4.92

java 7 update 3, 4, 5

java 6 update 26, 27, 28, 29, 30, 31, 32

java 7 update 1

java 6 update 30 and newer with Safari browser

4.91

java 7 update 3

java 6 update 26, 27, 28, 29, 30, 31

java 7 update 1

java 6 update 30 and newer with Safari browser

4.90

java 7 update 3

java 6 update 26, 27, 28, 29, 30, 31

java 7 update 1

java 6 update 30 and newer with Safari browser

* - Java 7 update: 6 and 7 have problems with HyperDoc Online certificates and require administration actions.

HIS version

Internet Explorer

Mozzila Firefox

Chrome

Opera

Safari

4.95

ver. 8, 9

IE 7 or earlier

ver. 9, 10, 11, 12, 13, 14, 15

ver. 16, 17, 18, 19, 20, 21

with java 6**

ver. 11, 12

ver. 5.x - with java up to java 6 up. 29

with java 6 up. 30 and newer

4.92

ver. 8, 9

IE 7 or earlier

ver. 9, 10, 11, 12, 13

ver. 16, 17

ver. 11, 12

ver. 5.x - with java up to java 6 up. 29

with java 6 up. 30 and newer

4.91

ver. 8, 9

IE 7 or earlier

ver. 9, 10

ver. 16, 17

ver. 11.x

ver. 5.x - with java up to java 6 up. 29

with java 6 up. 30 and newer

4.90

ver. 7, 8

IE 6 or earlier

ver. 9, 10

ver. 16, 17

ver. 11.x

ver. 5.x - with java up to java 6 up. 29

with java 6 up. 30 and newer

** - Chrome by default checks if plugins (like Java) are up to date. If not it blocks them. To use Java 6 with Chrome, please use those instructions.

Important

Browsers should always be kept up to date to maintain best compatibility.

Please note, that Advanced Printing is still available only in Internet Explorer.

Note

Due to some problems with Chrome, first run of HIS on this browser needs an additional refreshing of HIS initial page.

HyperDoc has been extended with possibility of using proprietary groups with already implemented Proprietary User List mode.

MSSQL users and groups can be also managed using HyperDoc Admin tool and HIS sites described above. But in this case, there are some limitations.

Here are some of them: fixed database roles couldn't be deleted, public role and dbo user shouldn't be managed using above tools. User used by HyperDoc Internet Server needs to have enough rights for users and groups handling (please refer to Microsoft MSDN to check rights requirements).

To enable using of proprietary groups with proprietary users one has to use “Check and Create Extra Tables” option from HyperDoc Configuration Manager's File menu. Then they would be available after setting Proprietary User List mode in HyperDoc Admin from User list mode menu.

Proprietary groups and users memberships can be managed from within HyperDoc Admin tool or using hisUsers.asp and newly added hisGroups.asp web pages.

Option Print to PDF is available from Print Preview panel or by pressing Print to PDF button on toolbar.

It allows printing images into PDF files.

You can control PDF output normally, as with the normal printing. You can set template, orientation, scaling mode and print resolution. Check out the result by clicking on Preview button.

After you click on Print button new browser tab will open. Depending on browser you are using you may be prompted with various dialogs but generally you will be asked whether you want to Open, Save or Save as the PDF file.

Document ID will be used as default PDF name.

Below are parameters that can be set in HDocAsp.ini:

This functionality allows to define standard scales used in HyperDoc Online printing for displayed document.

To control standard scales for HyperDoc Online define standard_scales and general_scales parameters in [Configuration] section of INI file.

Sample entry in INI can look like this:

standard_scales="0.5,1,2,10,50,200,400,550,700";
general_scales="1.0,3.3,4.7,5.8,6.5,7.6,8.3";

The values of those parameters are sequences of ordered real numbers. The sequence from standard_scales parameter will be taken for printouts so it's have higher priority.

However if a scale of printed drawing is out of standard_scales range, for example: the drawing needs at least scale=1:800 to fit in Print Window (based of sample parameters given above), general_scales will be used and drawing scale will be set to 1:830.

general_scales parameter values "1.0, 2.5, 5.0, 8.0" can give scales of 1:1, 1:2.5:, 1:5.0, 1:8.0 but also 1:100, 1:250, 1:500, 1:800 or 1:1000, 1:2500, 1:5000, 1:8000;

The default values for standard_scales is "1.0,2.0,3.0,4.0,5.0,7.5".

The default values for general_scales parameter is "1.0,3.0,5.0,7.0".

This functionality allows to define standard scales used in HyperDoc Online Publishing Agent (HOPA) printing for displayed document.

To control standard scales for HOPA define standard_scales_hopa and general_scales_hopa parameters in [Configuration] section of INI file.

Sample entry in INI looks like this:

standard_scales_hopa="0.5,1,2,10,50,200,400,550,700";
general_scales_hopa="1.0,3.3,4.7,5.8,6.5,7.6,8.3";

The standard_scales_hopa parameter can be also defined in HOPA URL by adding StdScales / STDS parameter to HOPA call.

The general_scales_hopa parameter can be also defined in HOPA URL by adding GenScales / GENS parameter to HOPA call.

The values of those parameters are sequences of ordered real numbers. The sequence from standard_scales_hopa parameter will be taken for printouts so it's have higher priority - and also parameter given in HOPA Call will have priority over the one given in INI file.

However if a scale of printed drawing is out of standard_scales_hopa range, for example: the drawing needs at least scale=1:800 to fit in Print Window (based of sample parameters given above), general_scales_hopa will be used and drawing scale will be set to 1:830.

general_scales_hopa parameter values "1.0, 2.5, 5.0, 8.0" can give scales of 1:1, 1:2.5:, 1:5.0, 1:8.0 but also 1:100, 1:250, 1:500, 1:800 or 1:1000, 1:2500, 1:5000, 1:8000;

The default values for standard_scales_hopa is "1.0,2.0,3.0,4.0,5.0,7.5".

The default values for general_scales_hopa parameter is "1.0,3.0,5.0,7.0".

This parameter can be used in following HOPA calls:

By using this page you are able to retrieve list of all spots linked to given object (or objects – you can define collection by using parameters SearchField and SearchValue).

This is needed for creating multi-view HOPA calls as regular HOPA call can show single image at a time, so we could only obtain first, default view.

As a result of this function, an XML/JSON list is returned. You can either use this list and create a custom viewing solution, or use simple gallery Tesselet that will handle all of that automatically, with just a simple configuration

There are two typical situations, where we need to discover multiple links:

In both cases one can use either single object identification methods (Object class, Object ID) or search for objects by specific criteria to find one or more matching objects. This function will return all linked spots for each found object.

Param name

Abbr.

Req.

Def. Value

Description

ObjClass

OC

+

 

Object class

ID

ID

+

 

Object key

ObjID

OID

  

Object’s marshaled id

Search Field

SF

  

Name of field in given object class or document type

Search Value

SV

  

Value for Search Field

AncClass

AC

  

Name of ancestor's class to be used instead of specified object

ObjSet

OS

  

Object set ID

ObjSetName

OSN

  

Object set name

DocForObj

DFO

 

2

Use default document linked to object

DocForSpot

DFS

 

3

Use document containing spot for given object

HierName

HN

 

(first hierarchy)

Name of hierarchy

ClientFunc

CF

  

name of JavaScript function to be called when data is retrieved.

TPID

  

parameter with encrypted user, password and UTC time

Custom_xyz

C_xyz

  

Custom parameter with xyz name

Returned XML format:

<Objects>
  <Object ObjectID="ObjectID">
    <Document DocID="DocID">
      <Spot SpotID="SpotID" Layer="Layer_name" Available="0/1"/>
    </Document>
  </Object>
</Objects>

Attribute Available tells us, if the spot is on visible layer / can be called with HOPA calls (value 1) or on invisible layer / unavailable for HOPA calls layer (value 0).

This Tesselet component is a reference implementation that uses data returned by HOPAGetSpots4ObjectXml.asp function. It can be customized by providing configuration parameters and used on external website without any coding. Main goal of this viewer is to easily show all spots / views for given object(s).

Additionally, this Tesselet provides two printing buttons:

Requirements:

Installation

Parameters detailed description

Following parameters need to be set in order to receive positive results in Tesslet utilization:

Customer server configuration

To change layout of widget, you may redefine stylesheet: tessel_display_spots_widget.css.

PrintAllDocuments option detailed description

This function depends on whether GetSpots4objectXML was started with set 'Search Field' and 'Search Value' as input parameters. If so, 'Print All Spots' link will be prepared with utilization of 'MultiMatch' parameter with value 1 (MUM=1).

Otherwise, link will be prepared by utilization of 'SpotIDs' parameter with value 'all' (SI=all).

Example of utilizing getSpots4objectXml function

HOPAgetspots4objectxml.asp&ObjClass1=Rooms&SF1=Room_Status&SV1=Rented&ObjClass2=Rooms&SF2=Room_Status&SV2=Free" &ObjClass2=Rooms&SF2=Room_Status&SV2=Free  ObjClass=Floors&ID=Floor002

Sample HOPA Get Spots calls:

http://<server_name>/<HIS_name>/HOPAgetspots4objectxml.asp?ObjClass=Floors&ID=Floor002&ClientFunc=processData
http://<server_name>/<HIS_name>/HOPAgetspots4objectxml.asp?ObjClass1=Rooms&SF1=Room_Status&SV1=Rented&ObjClass2=Rooms&SF2=Room_Status&SV2=Free&ClientFunc=processData

Support for multi object printing has been added to HyperDoc's HOPA calls. New parameters have been added to enable this functionality:

SpotIDs - for specific object, identified by Object Class and Object ID one can use SpotIDs parameter that can be used in two modes:

In multiple view templates this parameters can supply multiple results only if applied for the main (first) image view.

Using Search Field / Search Value parameters gives those possibilities:

Constant image in multiple images printing

In multiple view templates current solution supports applying parameters for other template windows as it was before. If one does not applies images to other windows, they will not be shown. If constant image is not applied, the same image will appear in all image windows.

If one applies some parameters like DFO, MM to one image window (like window 2 or 3), this settings result will appear in each print page in this particular window. In this case one applies only multiple printing in main parameters set (t.m. Parameters without numbers), this parameter set will be valid for all image windows on current page.

Examples:

1. http://his-server/HOPAGetPrint4Object.asp?
2. PrintTemplate=PRINT3-A4
3. &OC=Rooms
4. &ID=Room6615
5. &HN=HDocHierarchyDefinition
6. &SpotIDs=all
7. &UV2=0 

In this example, lines 3,4,5 will be used to determine master object. Line 6 will enable finding all spots for that object. Each found object will be used to create separate print page. Additional parameters can be provided like in line 7, for each Image Window separately

1. http://his-server/HOPAGetPrint4Object.asp?
2. PrintTemplate=PRINT3-A4
3. &OC=Rooms
4. &SF=Room_Status
5. &SV=Free
6. &HN=HDocHierarchyDefinition
7. &MUM=1
8. &UV2=0
loading table of contents...