Parametrar 

Förklaring:

• ClassId and ObjectID - pair of Object's class ID and Object ID field used in HDC internaly. Both parameters are required. 
  ClassId can be retrieved from (sv) Objektklasser configuration and Object ID is a value of Class Field marked as ID Field.

• DocumentForSpot - when set to 1, image contains document, on which spot is linked to this object.

• SpotMarginPercent - percent of area surrounding spot (e.g. “100” – spot only; “110” – add 10% margins around spot boundaries).

• Width and Height -  width and height ot returned spot.

• ClassName(or ClassId), FieldName, FieldValue - searching for object based on internal HDC metadata. 

• Domain - external domain name or ID. Matching object is searched using External Domain ID's. Can be used in two ways:

  • with CID or CN and ID which in this case (DN present in url) will represent External domain object class id and object id,

  • with ClassName, FieldName, FieldValue - than CID and ID is not needed

• contextObjects - in case there is a need to resolve macros or presentations in context of different object then added in HOPA locator, here they can be added. 
  When printing from HDC viewer, this is added automatically based what object is being selected in Tree. This is common for proper resolving macros, for instance when one document is linked to many floors. In case of presentations, you can simulate option "Only for selected object". 
  The value of this parameter should consists of pair or pairs of classID and objectID. With additional S letter when object is to be used for presentation. Examples:

Exempel

Generell struktur för URL

kodexempel på externa anrop:

Multipla fältvärden

Då ClassName/ClassId parametrarna används kan multipla fältvärden anges i anropet, separerade med kommatecken.

Om de anropade objekten finns på samma ritning så kommer de att markeras på en enda bild. Om anropet görs med parametern MV=1 så kommer resultatet att bli flera bildsidor om de anropade objekten finns på olika ritningar (OBS att flersidig utskrift endast kan göras om PDF är utformatet). 

Exempel:

Textmakron kommer bara att redovisa data för det först funna objektet i anropet.

Hantering av multipla vyer i utskriftsmall

För detaljerad beskrivning av vy parametrar var god se avsnittet Malleditor.

Vy-specifika parametrar i HOPA URL kräver vy-ID suffix enligt nedan:

• ViewportID = utan suffix - en sådan parameter gäller för samtliga vyer i en utskriftsmall (om inte samma parameter används igen med ett vy-ID suffix)

• ViewportID = 1 parametrar med suffix "1", t.ex. ScaleMode1 - påverkar bara vy med ID=1

• ViewportID = 2 parametrar med suffix "2", t.ex. ScaleMode2 - påverkar bara vy med ID=2

• ViewportID = 3 parametrar med suffix "3", t.ex. ScaleMode3 - påverkar bara vy med ID=3

• och så vidare...

Exempelsträng för ett objekt utan utskriftsmall:

(URL parametrarna är separerade med mellanslag för att kunna läsas enklare)

^{HopaGetView4Object ?classId=108 &objectId=76931 &DocumentForSpot=1 &Width=600 &Height=801 &SpotMarginPercent=122}

Open

Med utskriftsmall tillagd:

^{HopaGetView4Object ?classId=108 &objectId=76931 &DocumentForSpot=1 &SpotMarginPercent=122 &TID=3255}

Huvudvyn är fylld med det anropade objektet. Då inga specifika parametrar skickats med för de 2 övriga vyerna så används standardinställningar för dessa. 

Specifika parametrar för respektive vy kan adderas till HOPA URL:n för att visa olika skalor, maskningar av objekt eller t.o.m. andra dokument:

Exempelvis är en målklass angiven för Vy #3 (denna option finns bara tillgänglig i utskriftsmallen)

HOPA: Using HQL as search criteria

New parameter hql/HQL is added, that allows to locate objects via HQL statements.

Some examples by operator

• Equals: HopaGetView4Object?CID=118&HQL=hd_docdescr = "Italic"

• In Set: HopaGetView4Object?PSETID=493&TID=6405&classId=108&HQL=fi2space_id in ("000480000900059","000480000900051","000480000900040")&MV=1&DFS=1&SM=2

• Before: HopaGetView4Object?CID=118&HQL=hd_docdate before "1990-12-01"

• Contains: HopaGetView4Object?PSETID=493&TID=6405&classId=108&HQL=fi2space_id contains "48000090004"&DFS=1&MV=1

• Starts With: HopaGetView4Object?cid=108&HQL=fi2space_descr starts-with "RUM 2"&DFS=1

• Before and after (date): HopaGetView4Object?CID=118&hql=hd_docdate before "1996-11-05" and hd_docdate after "1996-11-03"

• In Set and Not In Set: HopaGetView4Object?cid=108&HQL=fi2space_class in ("02","ÖVA") and fi2space_function not in ("KOMMUNIKATION","03","02","00","PERSONAL","SERVICE","99","TEKNIK","01")&DFS=1