The runtime properties allow you to make changes to a project after the project's design time is completed, without touching the business logic. The runtime properties can be accessed from the Properties window or from the binding component's properties editor.
The runtime configuration for the HL7 Binding Component affects all HL7 Binding Components that are deployed on the domain you are configuring.
From the Services window of the NetBeans IDE, expand the Servers node.
If GlassFish is not started, start GlassFish. To do this, right-click GlassFish V2 and then select Start.
Under the application server, expand the JBI -> Binding Components nodes and select the HL7 Binding Component (sun-hl7-binding).
If sun-hl7-binding is not started, right-click it and then select Start.
Double-click the sun-hl7-binding.
The Properties Editor appears.
Edit the properties as needed.
Properties are described under HL7 Binding Component Runtime Properties.
Once you are finished editing your properties, click Close.
On the NetBeans toolbar, click Save All.
If you have any deployed HL7 Binding Component projects, redeploy the projects so the changes take affect.
The HL7 Binding Component's Application Configuration property allows you to change the configuration information for an endpoint without changing a projects business logic. The HL7 WSDL endpoint properties can be configured from the HL7 Binding Component Runtime Properties Editor.
To associate a Configuration Extension profile with the HL7 endpoint, open your project service assembly in the CASA Editor. To do this, from the Project window, right-click your composite application's Service Assembly node, and then select Edit.
The CASA Editor opens.
Right-click the HL7 consumer port icon, and then select Properties.
The HL7 WSDL Port Properties Editor appears.
From the Properties Editor, under Config Extension, enter a name for your profile, such as the name of the HL7 WSDL. Click Close.
From the NetBeans IDE Services window, make sure that GlassFish V2 server is started. If the GlassFish server is not started, right-click GlassFish V2 and then select Start. In the same way, make sure that the HL7 Binding Component (sun-hl7-binding) is also started.
Right-click the sun-hl7-binding and then select Properties.
The sun-hl7-binding Properties Editor appears.
From the sun-hl7-binding Properties Editor, click the edit button for the Application Configuration property.
The sun-hl7-binding Application Configuration Editor appears.
Click Add to add a new row to the Application Configuration Editor, representing all of the application configurable parameters for the HL7 Binding Component.
Enter the properties for your binding.
For more information about Application Configuration properties, see Application Configuration under Runtime Properties.
Click OK and Close to save properties.
When the composite application is deployed, the HL7 Binding Component will use the new application configuration that has been defined for the respective endpoint.
In addition to the NetBeans IDE, you can also use these other tools to edit the HL7 Binding Component Application Configuration.
GlassFish Admin Console: To access the Admin Console, from the NetBeans Services window, right-click GlassFish V2 under Servers and then select View Admin Console. You can also access the Admin Console at http://localhost:4848/login.jsf, if this setting was retained during installation.
To open the Application Configuration window from the Admin Console, select the sun-hl7-binding, under Common Tasks -> JBI -> Components. Select the Application tab and the Configuration sub-tab.
asadmin Command Line Interface: For information on using the Command Line Interface (CLI) to create, edit, or delete and application, see create-jbi-application-configuration, update-jbi-application-configuration, or delete-jbi-application-configuration.
The binding component Application Variables property allows you to define a list of name:value pairs for a given stated type. The application variable name can be used as a token for a WSDL extensibility element attribute in a corresponding binding. For example, if you were defining an application variable for the hostname as FOO, then the WSDL attribute would be ${FOO}. In the Application Variables property you would enter a String value of FOO for the name and the desired attribute as the value. When you deploy an application that uses application variables, any variable that is referenced in the application's WSDL is loaded automatically.
The Application Variables configuration property offers four variable types:
String: Specifies a string value, such as a path or directory.
Number: Specifies a number value.
Boolean: Specifies a Boolean value. The VALUE field provides a checkbox (checked = true).
Password: Specifies a password value. The password is masked and displays only asterisks.
Variables also allow greater flexibility for your WSDL files. For example, you can use the same WSDL for different runtime environments by using application variables to specify system specific information. These values can then be modified from the binding component runtime properties as needed.
When you deploy an application that uses Application Variables, all of the Application Variables that are referenced in the application's WSDL files are loaded automatically. If you attempt to start an application and an Application Variables value is not defined (no value is specified for the Application Variable) an exception is thrown.
To change a property when the application is running, change your Application Variable property value, then right-click your application in the Services window under Servers -> GlassFish -> JBI -> Service Assemblies, and click Stop in the popup menu. When you restart your project, your new settings will take effect.
To protect passwords that would otherwise appear as clear text in your WSDL file, you can enter a password Application Variable as a token. In the following example, a password Application Variable is created that uses the name SECRET and the password PROTECT.
In the NetBeans Servers window, expand Servers -> GlassFish V2 -> JBI -> Binding Components.
Right click sun-hl7-binding.
The sun-hl7-binding Properties appear in the Properties window.
Click the Application Variables property ellipsis (...) button.
The Application Variables editor appears.
Click Add, select Password as your variable type, and then click OK.
A new row is added to the Application Variables editor.
Enter SECRET as the name, and enter PROTECT as the value.
Because this is a password type, the characters of your password are displayed as asterisks.
Use the application variable name ${SECRET} as your WSDL password attribute, using the dollar sign and curly braces as shown.
The HL7 Binding Component properties specify Thread Count, Application Configuration, Application Variables, Statistics, Loggers, and reference the Binding Component's description, name, type, and state.
Header |
Header |
---|---|
Description |
Displays the description of the binding component. |
Name |
Displays the name of the binding component. |
State |
Indicates the state of the binding component as Started, or Stopped. |
Type |
Displays the component type. |
Build Number |
Displays the build version for the current component. |
Version |
Displays the components specification version. |
Number of Outbound Processor Threads |
Specifies the number of threads configured to concurrently process outbound HL7 requests. The value range is an integer from 1 to 2147483647. |
Number of Inbound Reply Threads |
Specifies the Maximum number of threads configured to process responses to HL7 client requests. The value range is an integer from 1 to 2147483647. |
Data Source Name |
Specifies the name of the data source where the sequence number and the HL7 acknowledgement message are persisted. |
Allow Dynamic Endpoint |
Specifies if Dynamic Endpoints are allowed for the HL7 Binding. For more information, see Dynamically Configuring HL7 Endpoints |
Application Configuration |
Specifies the values for a Composite Application's external connectivity parameters, which are normally defined in the WSDL service extensibility elements. You can apply these values to a user-named endpoint ConfigExtension Property. The Application Configuration property editor includes fields for all of the connectivity parameters that apply to that component's binding protocol. When you enter the name of a saved ConfigExtension and define the connectivity parameters in the Application Configuration editor, these values override the WSDL defined connectivity attributes when your project is deployed. To change these connectivity parameters again, you simply change the values in the Application Configuration editor, then shutdown and start your Service Assembly to apply the new values. |
The Application Configuration parameters include the following:
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Application Variable |
The Application Variables configured for the binding component. Application Variables allow you to define a list of name:value pairs for a given stated type. The application variable name can be used as a token for a WSDL extensibility element attribute in a corresponding binding. The Application Variables configuration property offers four variable types:
For more information about using Application Variables, see Using Application Variables to Define Name/Value Pairs and Using Application Variables for Password Protection. |
The Statistics properties provide a record of key statistics for the HL7 Binding Component.
Tracks the number of activated endpoints.
Tracks the number of active exchanges.
Tracks the average message exchange component time in milliseconds.
Tracks the average message exchange delivery channel time in milliseconds.
Tracks the average message exchange message service time in milliseconds.
Tracks the average message exchange response time in milliseconds.
Tracks the total number of completed exchanges.
Tracks the total number of error exchanges.
Tracks the number of received dones.
Tracks the number of received errors.
Tracks the number of received faults.
Tracks the number of received replies.
Tracks the number of received requests.
Tracks the number of sent dones.
Tracks the number of sent errors.
Tracks the number of sent faults.
Tracks the number of sent replies.
Tracks the number of sent requests.
Tracks the up time of this component in milliseconds.
The HL7 Binding Component runtime Logger properties include 13 different component activities that can be monitored and recorded at user-designated levels.
Each logger can be set to record information at any of the following levels:
FINEST: messages provide highly detailed tracing
FINER: messages provide reasonably detailed tracing
FINE: messages provide basic tracing
CONFIG: provides static configuration messages
INFO: provides informative messages
WARNING: messages indicate a warning
SEVERE: messages indicate a severe failure
OFF: no logging messages
The values for the HL7 Binding Component Loggers start with the location: sun-hl7-binding. The value text has been wrapped for display purposes.
Specifies the logging level for the entire group of component loggers. Individual logger levels can then be changed as desired. com.sun.jbi.hl7bc
com.sun.jbi.hl7bc.EndpointImpl
com.sun.jbi.hl7bc.HL7BindingComponent
com.sun.jbi.hl7bc.HL7BindingDeployer
com.sun.jbi.hl7bc.HL7Denormalizer
com.sun.jbi.hl7bc.HL7Normalizer
com.sun.jbi.hl7bc.InboundMessageProcessor
com.sun.jbi.hl7bc.InboundReceiver
com.sun.jbi.hl7bc.OutboundMessageProcessor
com.sun.jbi.hl7bc.OutboundReciever
com.sun.jbi.hl7bc.SchedulerEndpointManager
com.sun.jbi.hl7bc.DeploymentLookup
com.sun.jbi.hl7bc.MessagingChannel
For more information about the HL7 Binding Component Logging Codes, see Logging Codes By Component.