Host Publisher Studio:  Chaining Example

This is an example of how to create an application using the Host Publisher Studio.  The original objects were created in Host Access using chaining.  See the accompanying Host Access Chained Example.

Chaining_Example1 Integration Object:  This object requires an input variable consisting of an author's last and first name.  After the author's last and first names are entered, the Search Results page in the Library Database is viewed.  The author's list of books is then captured as a table and displayed as output.  The Search Results page remains visible after the titles display.

Chaining_Example2 Integration Object:  This object starts from the Search Results page.  It also requires an input variable that selects a particular title for additional information.  This information is then captured as plain text for display.

We will now publish these Integration Objects (created in Host Access) in the Host Publisher Studio.

The Welcome to Host Publisher Studio screen appears.  Click on Create Application.

The New Application window asks for the name of this application.  Fill in a name to identify the application, and click Next.

Indicate I prefer to start with data, and click Next.

We have already created the Integration Objects in Host Access.  Therefore, click Import to obtain a list of the existing Integration Objects and select the object for this application.

Highlight the Integration Object (Chaining_Example1.jar) to import into the application.  Then click Open (Open selected file).

You are presented with the New Application screen again.  In this example, we are working with two Integration Objects; therefore, to obtain the subsequent object, continue to select Import and select the Integration Object.

Now that both of the Integration Objects are imported, we will define how the objects are used.  Highlight the first object in the chain (Chaining_Example1) and click Define.  The Chaining_Example1 object becomes the initial starting point of the application.  An author's name is used as input to access the title application, and the search results are displayed as output text.  Both an input and output page will be created.

Read the text in the Wizard carefully.  You are being asked to choose the name of the page to run the Integration Object and display its output.  Therefore, you must name the OUTPUT page.  To help distinguish between input and output pages, use the word in the name of this page.  After you have selected Create a new page and supplied a name, click Next.

Host Publisher has determined that your Integration Object requires an input page as well.  Therefore, you are now presented with the input variable.  Click Define to specify how to obtain the input data.  Note the field, setAuthor, is the name of the input method which was created in the Host Access for the author variable.

Indicate that the data is obtained from A new input field, and click Next.

If there was already an input page defined, you could add this input to an existing form.  However we want to create a new form to request the user for the input.  Select Create a new form and click Next.

You are now asked to Type a name for the new input form page.  This will be the name of the Input page which will ask the user for the name of an author for the University of Michigan's Library Database.  There is also a Label for the submit button.  You can rename this button, or use the default Submit.  When you have finished, click Next.

You are now going to create the type of control to be used for the input.  In this example, we will create an Edit box into which the name can be entered.  After making your selection, click Next.

A label (caption) can be used.  Use this space to tell the user what type of data to input in the provided edit box.  Then click Finish.

You are now back to the screen where you started defining the input.  Click Next  since you have completed defining the input data.

We are now back to working with the Output page.  You need to specify how the output will be presented on the page.  Since we are creating a table, select the output which supports multiple values, then click Render.

The Insert Output Control page appears.  Our output page will have a table containing the list of books, the numbers that correspond to them, and some submit buttons.  Select Table, then click Next.

If you want a descriptive caption for the output, type the text here and click Next.

To change the text in the column header, click Modify.

You are now presented with the Edit Column Name window.  Modify the column name and click OK.

You are now returned to the Insert Output Control - Table window.  If you had more columns, you could reposition them, and Modify the header text.  When you are finished, click Finish.

We are finished specifying how the output is represented on the output page.  The author_results now has a control type of Table and the Label identifies the caption previously created.  The input and output pages for this Integration Object are complete.  Click Next.

You can now preview the input and output pages.  When you are finished, click Finish.

We have one more Integration Object to define.  Select the Chaining_Example2 Integration Object, then click Define.

Read the text in the Wizard carefully.  You are being asked to choose the name of the page to run the Integration Object and display its output.  Therefore, you must name the OUTPUT page.  After you have selected Create a new page and supplied a name, click Next.

Host Publisher has determined that your Integration object requires an input page as well.  Therefore, you are now presented with he input variable.  Click Define to specify how to obtain the input data.

Indicate that the data is obtained from A new input field, then click Next.

If there was already a form defined, you could add this to an existing form.  However we want to create a new form to request the user for the input.  Select Create a new form and click Next.

You are now asked to type or select the following information for the new form.  Select Use an existing page for the input form and choose the output page from the previous Integration Object.  This page will ask the user for the number of the particular title they want additional information for.  There is also a Label for the submit button.  You can rename this button, or use the default Submit.  When you have finished, click Next.

You are now going to create the type of control to be used for the input.  In this example, we will create an Edit box into which the name can be entered.  After making your selection, click Next.

A label (caption) can be used.  Use this space to tell the user what type of data to input in the provided edit box.  Then click Finish.

You are now back to the screen where you started defining the input.  Click Next since you have completed defining the input data.

We are now back to working with the Output page.  You need to specify how the output will be presented on the page.  Select getBook_information, then click Render.

You have the option of creating an Edit box, Normal text, or Password box.  In this example, select Normal text then click Next.

If you want a descriptive caption for the output, type the text here and click Finish.

You are finished rendering the data.  Click Next.

You can now preview the input and output pages.  When you are finished, click Finish.

The Integration Object is this application now shows up as Defined.  Click Finish.

The application can be saved and transferred to the server.  From the File menu, select Transfer to Server, and transfer the application to a Host Publisher Server that you specify.

Once this is successful, go to Host Publisher Administration and deploy the application.

For more information on deploying and running your Web application, refer to the Administrator's and User's Guide.