Hapi Engine Manual
Hapi Engine Manual
Review (mpn: 1835CC for sale) 1835CC VW VOLKSWAGEN AERO Engine Hapi Accessory Drive Slick 4216 Magneto. Includes hapi accessory drive with 12v starter slick 4216 magneto. Don't have any history on this engine, picked up at estate sale. Steel tubular engine to airframe mount. Single port heads with manifold missing carb. 69mm stroke crank. 4.3, 14 April 2019 HITRAN Application Programming Interface (HAPI) User Guide Roman V. Kochanov rkochanov@cfa.harvard.edu Harvard-Smithsonian Center for Astrophysics.
GazelleHL7Validator is the part of the Gazelle platform dedicated to the validation of HL7 messages.
HL7v2.x messages are validating against HL7 conformance profiles. The validation engine is based on HAPI libraries and the conformance profiles are written by the Gazelle team (helped by NIST).
HL7v3 messages are validating using a model-based engine.
These validation services are available through a web service API so it can be integrated in your application.
If you wish to validate messages occasionally you can use the Gazelle Validation Front-End called EVS Client which puts at your disposal a user interface to validate HL7 messages, CDA documents, XD* requests and so on.
Concerning HL7v2 validation: the application also gathers the HL7 conformance profiles and the HL7 tables (codes) which can be browsed by any user. For each conformance profile, you will find information about its issuer (actor, domain, transaction) and the message type and HL7 version. Each conformance profile can be bound to one or several HL7 tables which gather a list of allowed values for a given field of the message.
As shown on picture below, the User Interface provides two validation tools: HL7v2.x Validation tool and HL7v3 Validation tool:
HL7v2.x Validation tool allows user to browse validation reports, HL7 messages profiles and resources:
And HL7v3 Validation tool allows user to access to validator documentation:
Both tools provide the possibility to display the validation request and result statistics chart forms:
Browse validation requests
Select option of HL7v2 validation tool menu.
It will display the list of validation requests received by the tool and the associated results:
For each validation request, the tool keeps trace of the IP address of the caller. This is the way we choose to “protect” your work. That means that, using this IP address we can restrain the access to the data you have submitted (message content) and the results of those validations. The access rules are the following:
Administrator users have access to all validation requests and are allowed to permanently delete some of them on user requests as shown on picture above.
Logged in users (Gazelle CAS) can ask the administrator of the tool to register a set of IP addresses they are allowed to see.
Not logged in users have only access to the validation requests coming from the same IP address as the one they are using when browsing the requests:
Browse HL7 message profiles
Select option of HL7v2 validation tool menu.
It will display the list of HL7 messages profiles:
All the HL7 message profiles available are gathered in the tool. You can either select a profile by its full OID (if known) or put filters on the table columns. Each profile is viewable inline and can also be downloaded.
Click on button to update the list of message profiles displayed.
Browse HL7 resources
Select option of HL7v2 validation tool menu.
It will display the list of HL7 resources:
An HL7 resource is an XML file gathering several HL7 tables.
An HL7 table is uniquely defined by an ID and contains the set of allowed values.
Those tables are referenced in the message profiles and at validation time, the validation engine can check that the value of a given field of the submitted message comes from the set of allowed codes for this field.
As for the message profiles, you can see those tables inline or download them.
Browse HL7v3 validation service documentation
Select entry of HL7v3 validation tool menu.
It will display the documentation of the constraints expressed in the model-based validation service:
Validation statistics
This option is accessible only for Administrator users.
Access from of HL7v3 validation tool menu.
It will display the validation requests received by the tool and the associated results presented in chart forms:
Gazelle HL7v2.x validation service
The web service API of the tool offers two methods:
- validate(): validates the given message against the given message profiles and sends back a validation report
- about(): gives information about the running version of the tool
The definition of the web service API is available here.
The validate() method has the following prototype:
public String validate(String, String, String) throws SOAPException;
The first parameter is xmlValidationMetadata, it is an XML formatted String respecting the XSD schema given at https://gazelle.ihe.net/xsd/MessageMetadata.xsd. By now, this parameter is not used but our intent is to add custom validation. That means that, in addition of the basic Hapi validator, the user will be able to put additionnal validation requests as constraints on field usage, component value…
The second parameter is xmlValidationContext, it is an XML formatted String respecting the XSD schema given at https://gazelle.ihe.net/xsd/ValidationContext.xsd. This parameter is mandatory since it gives information about the HL7 message profile to use for the validation process.
Finally, the third String stands for the message to validate itself. The message must use ER7 syntax (ie. pipe-based syntax).
As we also need the client side of this validation service, we have created a useful SoapUi project example available here.
Note that this validation tool is also available through the simulators based on HL7v2.x (the messages sent and received by the simulator can be validated) and the EVSClient.
Gazelle HL7v3 validation service
See: Model-based validation web services.
Error is human. We try to maintain the message profiles and HL7 tables doing our best but we may do mistakes. If you think there are errors in one/several of our message profiles, please report an issue in our bug tracking system with mention of the profie OID, error location, appropriate fix and reference to the documentation.
This part of the documentation is dedicated to the manager/administrator of the Gazelle HL7 Validator tool.
The validation of HL7v2 messages within the Gazelle platform is based on:
HL7 conformance profiles: XML files which describe the structure of the HL7 messages, they are constrainable. For each segment, field, component and subcomponent, the usage (required, optional, not allowed…), the cardinality and the datatypes are defined.
HL7 resources: XML files which declare a set of HL7 tables (kind of value sets). HL7 conformance profiles may reference HL7 table for a field, component or subcomponent, in order to constrain the set of allowed values for this element of the message.
Both HL7 conformance profiles and HL7 resources are stored in the database of the tool along with an OID as well as the links between the conformance profiles and the resources. Note that the conformance profile file only reference the number of the the HL7 table, that means that, for a given conformance profile,the tool must be able to know in which HL7 resources looking for the table.
For each HL7 conformance profile, we need to know to which part of the technical framework, which message it applies. That’s why, the HL7 conformance profiles are actually referenced in Gazelle Master Model. This enables us to link a conformance profile to a tuple (Domain, Actor, Transaction, HL7 version, message type [, order control code]). GazelleHL7Validator and Gazelle Master Model are two tools which have independent databases; as a consequence, the OID is used as a foreign key and two web services offered by Gazelle Master Model allow us to exchange data between those two applications:
IHEConcepts: This web service lists the different concepts (domain, actor, transaction) based on other parameters. For instance, you can get the list of all domains, the list of actors involved in a given domain and so on.
Hl7MessageProfile: This web service offers methods to retrieve the complete list of conformance profiles registered in GMM, a subset of these profiles which match certain parameters (actor, message type, HL7 version…). This web service also offers a method to add a new conformance profile reference into the database of GMM.
The URL of the Gazelle Master Model web services are configurable within the application preferences part of Gazelle HL7 Validator. Make sure to reference the correct instance of Gazelle Master Model.
The following sections detail the different actions you may need to perform to maintain the set of conformance profiles available in your instance of Gazelle HL7 Validator. In order to keep a consistency between the references in Gazelle Master Model and the conformance profiles actually available in Gazelle HL7Validator, only one instance of Gazelle HL7 Validator must be used per instance of Gazelle Master Model.
OID assignments
HL7 conformance profiles and HL7 tables are assigned OIDs. Remember that an OID must be unique through the world; that means that, the first thing to do when you install a new instance of Gazelle HL7 Validator is to update the root of the OIDs which will be generated by the application. Three OIDs are used which are defined in oid_generator table:
- One for the conformance profiles
- One for the HL7 resources
- One for the validation results (messages)
Currently, no user interface is available to perform this update, you will need to modify those values, manually, in the database.
Add a new conformance profile
Adding a new conformance profile consists in two things:
- Creating a new reference in Gazelle Master Model
- Importing the XML file representing the conformance profile to the database of GazelleHL7v2Validator
Then select option of Administration menu (you must be logged in as an administrator).
A form is displayed (see screenshot below). Fill out this form with the information that match the conformance profile you are working with. Note that, first, only the domain drop-down list is displayed, then the list of actors is computed depending on the domain you have selected and finally the transactions will be available depending on the actor/domain pair previously selected.
As you can notice it on the screenshot, a button is available on the right of the “Profile OID” field. Clicking on this button will ask the application to automatically assign an OID to this conformance profile.
Gazelle HL7 Validator uses HAPI as validation engine. At validation time, message to validate is converted to a java object. Although all the message structures defined by HL7 are available in HAPI, in some cases, you will need to generate your own java class describing the message and tell the application in which java package it will find it. That is the case when IHE defines a new segment or change the structure of a message.
A project called gazelle-hl7-messagestructures available on Gazelle’s forge and based on HAPI libraries is available to generate the java classes from the conformance profiles.
Finally, upload the XML file representing the conformance profile. As soon as the form is filled and the file is uploaded a button is available.
Click on this button, the file will be stored in database and the reference to the profile will be sent to Gazelle Master Model.
In order to facilitate the management of the registered profiles, we recommend to rename the XML file (on your file system) with the OID assigned to the conformance profile.
Add a new resource
Basically, one HL7 resource is registered for each version of HL7. In some cases, you will need to customize a table for a given conformance profile or for a set of conformance profiles. In that case, you may need to register a new resource.
Select option of Administration menu (you must be logged in as an administrator).
A new form is displayed (see screenshot below).
As for the conformance profile, you can ask the application to generate an OID. Once the form is filled out and the XML file is uploaded, click on the button and the HL7 resource will be stored in database.
Tip for filling out the weight attribute
When the tool initializes a validation, it retrieves all the HL7 resources linked to the selected conformance profile. Then, at validation time, for each reference to an HL7 table, it browses the selected resources to extract the set of allowed values. We have defined a mechanism of weight which allow us to tell the application in which order it must browse the resources. Actually, it may happen that you have overridden a table defined in several of the selected resources. The resource is the higher weight will be processed first. HL7 resources defined by HL7 have usually a weight equals to 1.
In order to facilitate the management of the registered resources, we recommend to rename the XML file (on your file system) with the OID assigned to the resource.
Link conformance profiles to resources
Select option of Administration menu (you must be logged in as an administrator).
It will display the page to manage links between profiles and ressources as shown below:
This page is composed of four parts:
- The list of available HL7 resources
- The list of selected HL7 resources
- A panel to select a set of conformance profile or a profile knowing its OID
- A panel which lists the selected conformance profiles
To link HL7 resources to conformance profiles, process as follows:
- First select the HL7 resource(s) you want to link to a set of profiles. Click on the blue plus icon of each row.
- Then, select a set of conformance profile (use filters)
Finally hit the button “Link the profiles displayed below to the selected profiles”
Update conformance profiles and resources
This section assumes that you have renamed your XML files according to the previous advices; that means that on your file system, you have a set of files named [profile_oid resource_oid].xml. Maintenance will be easier if you store the profiles and resources in two different directories.
It will display the definition of application preferences table and a section entitled HL7 message profiles and tables import as shown below:
To update the conformance profiles, configure the “Path to HL7 message profiles” and click on the button . The path must point to a directory on the server.
To update the conformance profiles, configure the “Path to HL7 tables” and click on the button . The path must point to a directory on the server.
In both cases, the application browses the given folder and lists all the XML files. For each file, it tries to retrieve the relative conformance profile / resource and compare the date of the file with the date of the last changed.
If the file on disk is newer than the last changed, then, the file will be imported into the database to replace the old content.
How conformance profiles and resources are organized on Gazelle’s forge
This section describes how we have chosen to organize the conformance profiles and resources on Gazelle’s forge and how they are maintained and managed.
Currently, both IHE Europe development team and the NIST contribute to maintain profiles.
A project is called Data and is available at https://gforge.inria.fr/scm/viewvc.php/Data/?root=gazelle.
This project is made of two main folders:
HL7MessageProfiles: In this folder, conformance profiles are organized by firstly actor keyword then transaction keyword and finally message type (messageType_triggerEvent). For instance, you will find the conformance profile for validating the ADT^A28^ADT_A05 message issued by the Patient Demographic Supplier actor in the context of the ITI-30 transaction at the following location: PDS/ITI-30/ADT_A28/profile/ADT_A28.xml. A sub-directory of HL7MessageProfiles is named ProfilesPerOid and contains a symbolic link to each profile. Name of the link is the OID assigned to the targeted message profile. In this way, when you want to update a profile you do not have to know its OID and in the same way, when updating the message profiles in the database of the tool, the mapping is correctly performed thanks to the symbolic links.
HL7Tables contains the HL7 resources all with a meaningful name and a child directory named TablesPerOid which contains a symbolic link to each resource. Name of the link is the OID assigned to the targeted resource.
Finally, this project has been checked out on the server hosting Gazelle HL7 Validator application and is periodically updated; which allows us to easily perform the update of the profiles and resources in the application.
Select option of Administration menu (you must be logged in as an administrator).
It will display the list of HL7v3 constraints as shown below:
From there, it’s possible to delete individually each HL7v3 constraint by clicking on the button .
It’s also possible to import an XML file with the constraints written inside. This file must be generated with “Topcased” software from the OCL constraints.
Select option of Administration menu (you must be logged in as an administrator).
It will display the page that allow the management of accesses for users:
You can restrict the messages an user is allowed to see in the logs page by editing the user preferences.
By adding an user, you can restrict the allowed IP addresses to constraint this user to see only the messages coming from this IP address.
You can add many IP addresses for a single user.
Gazelle HL7 Validator embeds a web service interface to query the HL7v3 validation service. This validation service has been developed using the model-based engine. All model-based validation service exposes a web service which uses the same definition.
Refers to the general documentation if you want to use this service from your application.
This service can be easily called using the EVS Client application:
Start a validation as shown on picture below:
The model has been generated from the HL7v3 schema available at ftp://ftp.ihe.net/TF_Implementation_Material/ITI/schema/HL7V3/NE2008. Constraints have been written in accordance with the IHE specifications available in ITI Technical Framework Appendix O and the section from the ITI Technical Framework volume 2 which deals with the HL7v3 protocol.
The following messages can be validated using this service :
- PDQv3 Accept Acknowledgement
- PDQv3 Patient Demographic Query
- PDQv3 Patient Demographic Query Cancellation
- PDQv3 Patient Demographic Query Continuation
- PDQv3 Patient Demographic Query Response
- PIXV3 Patient Identity Feed HL7V3 (Add Patient Record)
- PIXV3 Patient Identity Feed HL7V3 (Revise Patient Record)
- PIXV3 Patient Identity Feed HL7V3 (Patient Identity Feed)
- PIXV3 Patient Identity Feed HL7V3 (Acknowledgement)
- PIXV3 Query
- PIXV3 Query Response
- PIXV3 Update Notification
- PIXV3 Update Notification Acknowledgement
- XCPD Cross Gateway Patient Discovery Request
- XCPD Cross Gateway Patient Discovery Request (Deferred option)
Two additional messages can be validated with this tool though they are not HL7v3 based (but defined in the context of XCPD):
- XCPD Patient Location Request
- XCPD Patient Location Response
HAPI engines are Volkswagen auto engines converted to full or 1/2 VW aircraft engines by Homebuilt Aircraft Products, Inc. (H.A.P.I.), initially of Calexico, California and later of Eloy, Arizona. Although the firm preferred the H.A.P.I. abbreviation, the Compiler has chosen to use HAPI, as many others have done. HAPI was founded in 1977 by Rex Taylor and his son Patrick while they were designing a light aircraft kit, the Hapicraft. The aircraft never materialized, but they became deeply involved in VW conversions in both kit and completely assembled form. Rex Taylor wrote an extensive series of articles in the EAA Sport Aviation magazine about VW conversions in general, and HAPI conversions in particular. The articles can be found in SA2/79 and in a ten-part series from SA12/79 through SA9/80. HAPI continued in business until 1989, when the engine assets were sold to Mosler Motors and Rex Taylor retired.
O-66 - - {3.701 / 3.071 / 66.1} / {94 / 78 / 1083}
Same bore and stroke as O-132.
Same bore as O-117.
2cyl; HAPI Hornet; 25-35hp@3250rpm; 1983-1989; Wt = 74#.
Carbureted engine with single ignition.
BGP.
Applications: None found.
O-97 - - {3.366 / 2.717 / 96.7} / {85.5 / 69 / 1585}
Same stroke as O-102, O-112, O-117.
4cyl; HAPI Model 50; 50hp@3200rpm; 1979-1989; Wt = 152#.
Carbureted engine with optional single or dual ignition; starter and alternator were standard equipment except on Model 50-E.
SA2/79.
Applications: None found.
O-102 - - {3.465 / 2.717 / 102.4} / {88 / 69 / 1679}
Same stroke as O-97, O-112, O-117.
Hapi Engine Manual Download
4cyl; HAPI Model 55; 55hp@3200rpm; 1983-1989; Wt = N/A.
Carbureted engine with optional single or dual ignition; starter and alternator were standard equipment except on Model 55-E.
BGP.
Applications: None found.
O-112 - - {3.622 / 2.717 / 112.0} / {92 / 69 / 1835}
Same stroke as O-97, O-102, O-117.
4cyl; HAPI Model 60; 60hp@3200rpm; 1979-1989; Wt = 152#.
Carbureted engine with optional single or dual ignition; starter and alternator were standard equipment except on Model 60-E. A turbocharged version also was available.
SA2/79.
Applications: (US) Bounsall Super Prospector.
O-117 - - {3.701 / 2.717 / 116.9} / {94 / 69 / 1915}
Same bore as O-66, O-132.
Same stroke as O-97, O-102, O-112.
4cyl; HAPI Model 75 Magnum; 75hp@3200rpm; 1983-1989; Wt = N/A.
Carbureted engine with optional single or dual ignition; starter and alternator were standard equipment except on Model 75-E.
BGP.
Applications: None found.
O-132 - - {3.701 / 3.071 / 132.1} / {94 / 78 / 2165}
Same bore and stroke as O-66.
Same bore as O-117.
4cyl; HAPI Model 82 Magnum Plus; 82hp@3400rpm; 1983-1989; Wt = N/A.
Carbureted engine with optional single or dual ignition; starter and alternator were standard equipment except on Model 82-E.
BGP.
Applications: None found.
VW
CONTENTS
Toyota Engine Manual Download
Updated 8/9/05
Hapi Engine Manual Online
Hapi Engine Manual