Back to Scheduler Binding Component Application Variables, or Scheduler Binding Component Application Variables Info
| At line 14 changed 2 lines. |
| ** \\ |
| * [Configuring Redelivery and Throttling for the Scheduler Binding Component|ConfiguringRedeliveryAndThrottlingForSchedulerBC] |
| ** Application Variables\\ |
| ** Using Application Variables in a Trigger Message |
| ** Using Admin Console and asadmin to Create Application Variables |
| * [Configuring Redelivery and Throttling for the Scheduler Binding Component|ConfiguringRedeliveryAndThrottlingForSchedulerBC]\\ |
| At line 23 added 39 lines. |
| !!Application Variables |
| 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 message sent by the Scheduler Bonding Component when a trigger is fired can reference Application Variables. These Application Variables are set at the time of deployment and are appraised each and every time a message is sent. This allows that variables to be changed dynamically, on the fly. |
| This feature allows the administrator to control confidential information in a message, such as passwords, by allowing them to add this information after a project's design time, and allowing changes to this information without changing a project's business logic. |
| !!Using Application Variables in a Trigger Message |
| Application Variables are created using the Scheduler Binding Component runtime properties editor. They can also be created using the GlassFish Admin Console and the asadmin Command Line Interface (CLI). |
| !Creating and Using Application Variables |
| # Reference the Application Variable in the Message field of the trigger editor, using the dollar-sign curly braces format, as highlighted in the figure below.[{Image src='ep-sch-bc-appvar.gif' width='' height='' alt='Image shows the Cron trigger editor and demonstrates using Application Variables in the Message field' align='left|center|right' }] |
| %%warning |
| Caution - Any defined Application Variable is available to all JBI applications deployed in a GlassFish server, therefore care must be taken to qualify Application Variables for different deployments. Typically, you can do this by adding a unique prefix to the Application Variable name, such as the name of the WSDL binding. For example, in the image above, the prefix “cronBinding.” is used as a prefix. \\ |
| %% |
| # Next, prior to deployment time, set the referenced Application Variables. To do this |
| # From the Services window, right-click the sun-scheduler-binding, under GlassFish V2 → JBI → Binding Components, and choose Properties from the pop-up menu. |
| The sun-scheduler-binding Properties editor appears. |
| # Click the edit button for the Application Variables property. |
| The Application Variables dialog box appears. |
| # Click Add, and select the type of variable type for your Application Variable: String, Number, Boolean, or Password. Click OK[{Image src='ep-sch-bc-apvar-prop.gif' width='' height='' alt='Image shows the Scheduler runtime properties editor as described in context' align='left|center|right' }]\\ \\A new row is added to the Application Variables dialog box.\\ |
| # For each Application Variable, enter the name, exactly as referenced in the Message field of the trigger editor, omitting the dollar sign and curly braces. |
| # Enter the Application Variable's corresponding value in the Value field. Password values are masked for confidentiality.[Image shows the Application Variables dialog box with two Application Variables configured|figures/ep-sch-bc-appvar-ok.gif] |
| %%information |
| Note - The value field cannot reference another Application Variable.\\ |
| %% |
| # Once you have completed all of your Application Variables, Click OK.\\ \\The Application Variables are added to the sun-scheduler-binding Properties Editor's Application Variables field, and are ready to use. |
| !!Using Admin Console and asadmin to Create Application Variables |
| In addition to the NetBeans IDE, you can also use these other tools to create Application Variables for the Scheduler Binding Component. |
| ;GlassFish Admin Console: |
| To access the Admin Console, from the NetBeans Services window, right-click GlassFish V2 under Servers and choose View Admin Console from the pop-up menu. You can also access the Admin Console at http://localhost:4848/login.jsf.\\ \\To open the Manage Application Variables window in the Admin Console, select the sun-scheduler-binding, under Common Tasks → JBI → Components. Select the Application tab and the Variables sub-tab.\\[{Image src='ep-sch-bc-appvar-admin.gif' width='' height='' alt='Image shows the Manage Application Variables window of the GlassFish Admin Console' align='left|center|right' }] |
| ;asadmin Command Line Interface: |
| For information on using the Command Line Interface (CLI) to create, update, and delete Application Variables, see [http://wiki.open-esb.java.net/Wiki.jsp?page=Create JBI Application Variables|CreateJbiApplicationVariables], [Update JBI Application Variables|UpdateJbiApplicationVariables], or [Delete JBI Application Variable|DeleteJbiApplicationVariable].\\ |