AuraPlayer Server Manager User Guide AuraPlayer Support Team Version 2 2/7/2011 This document is the sole property of AuraPlayer Ltd., it cannot be communicated to third parties and/or reproduced without the written authorization from AuraPlayer Ltd.
Contents Introduction Introduction & Main Menu... 3 Service Manager Service Manager Toolbar... 4 Recording/Creating a Service... 4 Recording Toolbar... 5 Recording Feature: Parameters... 6 Recording Feature: Snapshot... 6 Service Details... 7 Running AuraPlayer Externally... 7 Editing the Service... 8 Testing the Service... 10 HTML Page Manager Creating an HTML Service - Visualize... 12 Running an HTML Page... 17 HTML Page Manager... 18 Editing an HTML Page... 19 Adding Page Handlers to an HTML Page... 21 File Manager (.orp) ORP File Manager Toolbar... 25 Create a New Service Using an ORP File... 26 2 P a g e C o n f i d e n t i a l
Introduction AuraPlayer's Service Manager is the tool used to create services and HTML pages as well as store, share and manage them. It also makes it possible to access the files from anywhere. Main Menu The Service Manager Menu has the following components: Service Manager: HTML Page Manager: Admin: Support: Area to create and manage Services - Services list, Service Creation, Service editing options, etc. Area to create and manage HTML Pages - HTML pages list and HTML page editing options Area to manage administrative tasks and preferences - ORP files, Backup data, restore data from a backup file, and system information. Support FAQ, videos, articles etc. 3 P a g e C o n f i d e n t i a l
Service Manager Service Manager Toolbar The Service Manager Toolbar has the following components: Record/Create: Upload: Actions: Activate/disable: Export: Print: Delete: To record a new service Upload a new service from an existing ORP file All actions can be done in batch by by checking the box next to all relevant Services. Activate or Disable a service. Export the list of services to a csv file. Print the list of services Delete a service. Can be used in batch by checking the box next to all relevant services. Recording/Creating a Service 1. Click Record/Create on the Service Manager Toolbar, the 'create a new service' window will appear. 2. Fill out the service information: 4 P a g e C o n f i d e n t i a l
Service Name: Form URL: The unique name you want to call your service. It should reflect the unique name for your business process. For example: CreateOrder The URL of the Forms system you wish to connect and record from. You can only record from a Forms server where AuraPlayer has been installed. See install guide for details. 3. Click Begin to begin creating your service. 4. The "Recording Toolbar" and the "Oracle Forms" windows will appear. Recording Toolbar The Recording Toolbar has the following components: File name: Status: Timer: Capture Parameters: Snapshot: Save & Continue: Cancel: Save & Exit: Service name goes here Indicates if the Service Manager is recording or on standby Shows the duration of the recording Capture all the Form's existing fields and assign them as output parameters for the service Create a replica of the existing Oracle Forms canvas screen as an HTML page Saves the recorded service so far and allows continuation of recording later. Used to capture list of values mid-way through recordings. Cancel the current recording Save the recorded service and stop recording 5 P a g e C o n f i d e n t i a l
5. Creating Input Parameters To create an input parameter simply input text into a text box, setting a value in a field, clicking on check box, selecting option, any entering of values in the Forms session will create the value as an input field. 6. Creating Output Parameters a. To capture specific output parameters - Click on the desired text fields in the Form, they will be captured as output parameters. b. To capture ALL of the output parameters on a specific canvas - Click the "Capture Parameters" button on the toolbar. All the fields in the Form will be captured as output parameters 7. To stop recording without saving as a webservice, click on the Cancel button. 8. To save and end the recording, click the Save & Exit button. The service is now saved and can be found in the 'Service Manager'. Once pressing the Save & Exit button, you will be routed to the 'Edit Service' page to finalize the creation of the Service. Recording Feature: Parameters The "Capture Parameters" feature allows the user to capture output parameters for all fields in the Oracle Form that is now being recorded. 1. Once you reach the Form that has the fields you would like as output fields on your mobilized application, on the Recording Toolbar, click the Capture Parameters button 2. Upon success, your recording toolbar will have a success message on the top right corner. These parameters will then be added to the output parameters list of your Service. For more details see the "Edit a Service" Section. Recording Feature: Snapshot The "Snapshot" feature captures the Oracle Form (showing during the recording process) and recreates it as an HTML page (without the Oracle Forms functionality). 1. To create a snapshot, begin the recording process. Navigate to the canvas you wish to convert to an HTML page. 2. Once you have reached the canvas you want to convert, click the Snapshot icon. Note: Make sure the status on the recording toolbar reads Recording. After clicking Snapshot, an HTML replica of the Forms canvas is created and can be found in the "HTML Page Manager. The HTML file created by the snapshot feature is pure HTML and has no functionality. To add functionality and edit the file, see the section Editing an HTML Page. 6 P a g e C o n f i d e n t i a l
Service Details In order to see the service details, click on the Details icon next to the service name in the "Service Manager". The Service "Details" section contains the following data: Service Name: Description: Service URL: WSDL URL: Form URL: Status: The service name Description of service set by the user when creating the Service The RESTful service URL. This URL will be used to create RESTful APi's SOAP URL for the service description file (WSDL) The URL of the Oracle Forms server that the service is running against. Service status - active or disabled Running AuraPlayer Externally To run the AuraPlayer Service externally, you can copy the relevant URL from the details page and create the Service client in any tool of your choice. It is also possible to copy the REST URL to your choice of browser. To see an example of consuming the SOAP Service in ADF Mobile in the Oracle Jdeveloper development tool see this video http://www.youtube.com/watch?v=6ptsaejuaps&hd=1. 7 P a g e C o n f i d e n t i a l
Editing the Service The 'Edit Service' option is nested within the 'Service Details' page. Service Manager -> Service Details -> Edit Service To edit the Parameters, click the Edit Service button on either the top or bottom right of the page. Details Service Name: File Name: Description: Form URL: Name given to the service at time of recording ORP file name What the service does The URL of the Form server where the Service will be run. It does not have to be the same URL that was used for recording. Advanced Parameters 8 P a g e C o n f i d e n t i a l
Partial Service: Enabled Service: JSON enabled: Handle Pop-ups: Number of Rows: Authentication: (Advance Feature) Partial Service is a recording that doesn't start from the beginning of the scenario and isn't independent. It relies on a previous service to run in order to succeed. By checking this box, you are enabling the Service to be accessible. By checking this box, your REST Service would return a JSON response. Handle Pop-ups deal with unexpected pop-ups that appear in the form while calling a service (during playback). Check this box if you would like to Click on the default button in the popup & continue with the playback. The total number of rows you wish to display in the result set (Advanced Feature) Authentication allows you to add an additional security authentication to specific service. Username & Password can be defined in weblogic. Input Parameters Output Parameters The output parameters are the parameters returned by the service. Once saved, you will be redirected back to the Service Manager. 9 P a g e C o n f i d e n t i a l
Testing the Service The 'Test Service' option is nested within the 'Service Details' page. Service Manager -> Service Details -> Test Service 1. In order to test the service created, click on the 'Test Service' button. 2. The "Test Service" page appears with the default input values set during service creation. 3. To change the input parameters default values, simply change the values in the "Default Value" column. 4. Once all values are set, click the "Test Service" button. The XML response will appear in the text box below 10 P a g e C o n f i d e n t i a l
The Oracle Forms error messages, status bar messages and popup messages can be found at the top of the response. HTML Page Manager Creating an HTML Page - Visualize The 'Create HTML Page' option is nested within the 'Service Details' page. Service Manager -> Service Details -> Create HTML Page 1. To create an HTML page, click on the "Create HTML Page button. You will be redirected to the General page of the HTML generator. 11 P a g e C o n f i d e n t i a l
2. Fill in the: Form URL: HTML Name: Application Title: Optimized destination: Request format: (Advanced) The URL of the Form on which the service will run The name you wish to give the HTML page. The Application Title appears at the top of the browser. Selecting the check box "Add service name" will change the Application Title to that of the service name Choose the desired platform styling for your HTML page. Options include iphone, Android, Desktop etc.. Choose the format for the response either JSON or XML 3. Click "Next" to move the Request Form page 4. Fill in the: Form Title: Button Label: The Form Title appears at the top of the HTML page. The label you wish to have showing on the button. 12 P a g e C o n f i d e n t i a l
5. The input parameters inserted into the service: You can use the arrows icon to change the order of the fields. Visible: Name: Label: Default Value: By checking this box, the field becomes visible to the end user The name as it appears in the Oracle Forms system FMB The title you wish to appear for this field on the HTML page The default value that will appear in that field if it is set to visible 6. Click "Next" to move to the Response Form page The output parameters are the values returned from the Forms system by the service You can use the arrows icon to change the order of the fields. Visible: Name: By checking this box, the field becomes visible to the end user The name as it appears in the Oracle Forms system FMB 13 P a g e C o n f i d e n t i a l
Label: In Table: Show Status bar and popup messages: The title you wish to appear for this field on the HTML page By checking this box, you will receive multiple results for this Field. In the HTML page this will be set as a table. Checking this box will add an additional fields to the response page, containing the messages from the Oracle Form. By default, any popup messages, error messages, or status bar messages will be found in the results page. 7. Click "Next" to move to the Design page here you can edit the layout of the HTML page. Here, you are able to use your creativity to design the basic look of your HTML page. You can change the color of the text and the background. Direction: Header Text: Header Color: Footer Text: Footer Color: Choose the direction of the page right-to-left or left-to-right This is free text that will appear at the top of your page Set the color of the header text defined above This is free text that will appear at the bottom of your page Set the color of the footer text defined below 14 P a g e C o n f i d e n t i a l
Logo in Footer: Background Color: Repeat Background Image: Logo Path: Background Image: Choose if the logo image should appear in the page footer Define the background color of the page If a background image is set. This will define if it is repeated Choose the logo image file to show at the top of the page Choose an image to appear as the background image. This is optional. You may choose simply a background color. 8. Once you designed the HTML page, click Create. 9. Go back to the 'HTML Page Manager' to see your newly designed HTML page. 15 P a g e C o n f i d e n t i a l
Running an HTML Page with the created Business Process After creating your HTML page, you can now visually test your Service. 1. Enter your input parameters then click on the "Execute" button 2. You will then see the response page with your service output values. 16 P a g e C o n f i d e n t i a l
HTML Page Manager On the "Page Manager" page, you can upload, download and delete HTML files. Created either using the visualization wizard or creating a snapshot during the recording process. The Page Manager allows the user to manage and edit the created HTML pages. The components of the Pages Management toolbar are: Upload: Action: Download Page: Print: Delete: Upload a newly selected HTML file(s) to the server All actions will be performed in batch by checking the check box next to the HTML page. Download all selected HTML files as a zip file Print selected page Deletes selected HTML files. The.orp file (business logic file) that is attached to service will not be deleted. Next to the page name there is a separate menu. This menu gives you all the toolbar actions seen above as well as: Rename Allows you to rename an existing HTML file Edit Edit an existing HTML file. See Editing HTML Feature section below. Duplicate: Duplicate the file Show Map (In Beta) This allows you to see a flowchart mapping of the connections between HTML pages 17 P a g e C o n f i d e n t i a l
Editing an HTML Page 1. To edit an HTML file, select the HTML Page Manager from the Main Menu. 2. Click on the Edit icon on the left of the HTML page Note: If you can't find the file you wish to edit, it might have not been uploaded to the server, use the "Upload" icon to find the HTML file and upload it manually. 3. On the Edit page, the first section is Handlers. They are the actions of the page. The Handler s table has the following components: Bound Key: Bound Element: Handler Action: Attribute: Initialization Handler: Response Handler: The key on the keyboard that will trigger the action to occur The action will only occur on this specifically designated element The Handler's action type. For example: calling a service, calling a function, navigating to a designated page, etc... The handler's action name. The name of the action that will be triggered. Initialization handler is a callback being called prior to calling the web service. In this callback you can set parameters, run actions (for example start spinner), write business logic in it, or decide if you want to run the web service or NOT. The handler responsible for the response returned from the service. This can be used to analyze the data, perform error handling or other functions on the Service results. 18 P a g e C o n f i d e n t i a l
Delete: Deletes the action Button menu Add: Save: Restore: Show JSON: Add a new handler by clicking the "Add" button To save all changes, click the Save button To go back to the default settings, click Restore To view the JSON code/response generated The JavaScript section allows you to create customized JavaScript functions that can be called using action handlers. See the adding handlers section below. The HTML section allows you to custom edit the HTML code of the page Note: Always remember to Click Save to save the changes made to your HTML page 19 P a g e C o n f i d e n t i a l
Adding Page Handlers to an HTML Page Actions can be created to be triggered by an HTML page using the "Create Handlers Wizard". The wizard automatically generates the JavaScipt / HTML code. 1. Click "Add" to create a new handler 2. Choose the selected action The actions that can be added as a handler are: Function, Service, Navigate, and Service (On Load). 1. The "Function" Action The function action are JavaScript functions that can be triggered by a keyboard key or a button to perform the action. Key: Bound Element: Function Name: To set the key click in the "key" field and type on the desired keyboard key. Note: If the bound element is a button on the HTML page, leave the key field blank The Bound Element is the element on the HTML page that will be attached to the action. 1. Global: Global will cause the action to be triggered when the key is pressed anywhere on the page. 2. Specific field/element: Specifying a specific field/element on the page will cause the action to be triggered when the cursor is in a specific field. Example: If the bound element is set to Global, and the key is "Tab", pressing the Tab key anywhere on the HTML page will perform the function. Otherwise if the bound element is the "Customer ID" only typing Tab when the cursor is in the Customer ID will trigger the action. The function name can already exist in the service manager or be customized in the Javascript editor 20 P a g e C o n f i d e n t i a l
2. The "WebService" action: The action calls a designated Webservice. Key: Bound Element: Service Name: Response Handler: To set the key, click in the "key" field and type on the desired keyboard key. Note: If the bound element is a button on the HTML page, leave the key field blank The Bound Element is the element on the HTML page that will be attached to the action. 1. Global: Global will cause the action to be triggered when the key is pressed anywhere on the page. 2. Specific field/element: Specifying a specific field/element on the page will cause the action to be triggered when the cursor is in a specific field. Example: If the bound element is set to Global, and the key is "Tab", pressing the Tab key anywhere on the HTML page will perform the function. Otherwise if the bound element is the "Customer ID" only typing Tab when the cursor is in the Customer ID will trigger the action. The name of the service you wish to call. This can be used to analyze the Service response, perform error handling or extra functions. When you click create, a template handler is written in the JavaScript editor below, where you can customize your response handler 21 P a g e C o n f i d e n t i a l
3. The "Navigate" action: Navigate Directs the user to a new web page upon action. Key: Bound Element: Target Page: To set the key, click in the "key" field and type on the desired keyboard key. Note: If the bound element is a button on the HTML page, leave the key field blank The Bound Element is the element on the HTML page that will be attached to the action. 1. Global: Global will cause the action to be triggered when the key is pressed anywhere on the page. 2. Specific field/element: Specifying a specific field/element on the page will cause the action to be triggered when the cursor is in a specific field. Example: If the bound element is set to Global, and the key is "Tab", pressing the Tab key anywhere on the HTML page will perform the function. Otherwise if the bound element is the "Customer ID" only typing Tab when the cursor is in the Customer ID will trigger the action. The name of the HTML page that will be called on performing the action. This target page can be a service on the Service Manager server or any other desired web page. 22 P a g e C o n f i d e n t i a l
4. The Service (On Load): Service (On Load) triggers the calling of a Service upon loading of the page WebService Name: Initialization Handler: Response Handler: The name of the service you wish to call. Initialization handler is a callback being called prior to calling the webservice. In this callback you can set parameters, run actions (for example start spinner), write business logic in it, or decide if you want to run the web service or NOT. This can be used to analyze the response received from the Service, perform error handling or other JavaScript functions. When you click create, a template handler is given in the JavaScript editor. Here, you can customize your response handler. 23 P a g e C o n f i d e n t i a l
ORP File Manager (Advanced) File Manager Toolbar Admin -> Manage ORP Files To manage the.orp files (AuraPlayer's Oracle Forms business process files) saved on the server, click "Admin" on the Main Menu. In the Admin page, click on the "Manage ORP files" button. The Files toolbar has the following icons: Upload: Actions: Download: Delete: Service: Enables you to upload a new.orp file(s) to the server Allows you to manipulate all ORP files in bulk by checking the check box Downloads all selected.orp files to a zip file Deletes the selected.orp files. Any.orp file that is attached to an existing service can't be deleted. Allows you to create a new service from the selected.orp file. You can create multiple services from a single.orp file 24 P a g e C o n f i d e n t i a l
When uploading the.orp files to the Service Manager, the files are saved on the server. When deleting a service from the Service Manager the.orp file that is was created with, will not be deleted. The "Files Management" list has the following columns: File Name: Services using this file: Modified: This is the name of the ORP file as it can be found on the AuraPlayer server machine. Here you will see the Services that use the specific ORP file. This will also allow you to see the unused files. Meaning, if a service was deleted, you can view the orphaned file here (an.orp file without any services). This is the modified date of the file. Create a new service from an ORP file There are 2 ways to create a new service from the File Manager. 1. Click on the "Create Service" button next to any of ORP files in the list. 2. Create a new service using the "Upload" button. This will import an ORP file that was generated from another AuraPlayer service manager or from the AuraPlayer client server toolbar. a. Click on the Upload icon and choose the file you wish to upload. b. Once uploaded, click the "Create Service" button. c. The Edit Service page will appear where you can do the following: i. Edit Page Data ii. Edit Request Page Input Parameters iii. Edit Response Page Output Parameters Please see the "Edit the Service" section above for step by step instructions. 25 P a g e C o n f i d e n t i a l