AuraPlayer Server Manager User Guide

Transcription

1 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.

2 Contents Introduction... 4 Main Menu... 4 Services (5) Service types... 5 Viewing services... 5 Oracle Forms Services (6) Service Manager Toolbar... 6 Creating a New Service... 6 Service Details... 8 Running AuraPlayer Externally... 9 Editing a Service... 9 Create Test Case HTML Services (18) Recording HTML Services AuraPlayer dedicated recordings Importing a recoding to the ServiceManager Executing, editing and using HTML services Supported commands DB Services (25) Creating DB Services DB queries / statements Testing queries and acquiring output parameters Executing, editing and using DB services HTML Pages (30) Creating an HTML Page - Visualize Running a HTML Page with the created Business Process HTML Page Manager Editing HTML Page Applications (42) Application wizard: creating new application AppVisualizer Step 1: General AppVisualizer Step 2: Design AppVisualizer Step 3: Page Editor - Fields AppVisualizer Step 4: Page Editor Actions P a g e C o n f i d e n t i a l

3 AppVisualizer Step 5: Pages AuraTester (52) Test Cases Creating a new Test Case Test Groups Creating a new Test Group Running a Test Group Creating a Test Agent MCS Integration (61) Creating a MCS Resource Exporting an API Admin and Support (68) Recordings Manager Create a new service from a recording file Getting Support Advanced features (77) Roles and user management Securing your Service Manager System Properties P a g e C o n f i d e n t i a l

4 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: Services HTML Pages Applications AuraTester Monitoring agents Integration Admin Support Create and manage Services View current services, create new services, and perform various operations such as recording, testing and more. Manage HTML pages created by AuraPlayer s Visualizer View existing HTML pages, edit and download them. Group your Services and Pages to applications An application defines a business logic or process, spread across multiple HTML pages. Create, edit and run Test Cases & Test Groups Test your services by creating Test Cases. Assemble multiple Test Cases to Test Groups, to help you test complex scenarios. Create, run and monitor Test Agents Create monitoring Agents that run predefined Test Cases or Test Groups in constant intervals. Charts and logs provide you information on the result of each run as well as performance. Export your services to external providers. Currently, only an export to Oracle Mobile Cloud Service (MCS) is supported. Perform administrative tasks and set your preferences. Backup your data, customize system behavior and manage ORP files. Get support Read our guides, FAQs, "How To" and more. 4 P a g e C o n f i d e n t i a l

5 Services Service types AuraPlayer s ServiceManager supports 3 types of services. All services execute the backend implementation at background, exposing only input and output fields. - Oracle Forms service: executes an Oracle Forms recording. - HTML service: executes a recording of any website, for example: EBS or PeopleSoft. - DB service: executes a database statement or query. Viewing services All kinds of services are displayed under the Services tab from the main menu (left toolbar). Click on the Services tab and the services list will be displayed. The type of the service is listed under the Type column. You may use the dropdown box under the column name to filter and display a particular type only. 5 P a g e C o n f i d e n t i a l

6 Oracle Forms Services This section introduces services wrapping Oracle Forms. For other types of services, see the HTML Services and DB Services sections bellow. Service Manager Toolbar Record/Create Upload Action Activate/Disable Export Print Delete Record/Create a new service Upload a service from an existing ORP/HTML file Perform batch operations on a set of selected services. To select services, check the box next to the service/s Activate or disable the selected services Export selected services to a csv file Print a list of the selected services Delete the selected services. Creating a New Service 1. On the Service Manager Toolbar, click on "Create" Forms service. The "Service Record" dialog will be opened. 2. Fill in the service information: 6 P a g e C o n f i d e n t i a l

7 Service Name Form URL A unique name for the new service. Name should reflect the business process. The URL of the Oracle Form you wish to connect and record from. You can only record from a Forms server that has AuraPlayer installed. See the install guide for details. 3. Click Begin to start creating your service. 4. The "Recording Toolbar" and the "Oracle Forms" windows will appear. Recording Toolbar The Recording Toolbar has the following components: Service Name Recording Time Capture Parameters Save & Continue Cancel Save & Exit The name you selected for this recording The duration of the recording Capture all the form's current fields and values as output parameters Saves the recorded service, allowing you to continue recording later on. You may use this option to capture a set of values mid-way through recordings. Cancel the current recording Stop the recording, and save your new service 5. Creating Input Parameters To create an input parameter simply input text into the text box, click on a check box, select an option etc. In general, any insertion of values during the Forms session will mark the field and value as an input field. 7 P a g e C o n f i d e n t i a l

8 6. Creating Output Parameters a. To capture specific output parameters - Click on the desired text fields in the Form, once clicked, they will be captured as output parameters. b. To capture ALL of the output parameters on a specific form - 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 the service, 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: Capture Parameters The "Capture Parameters" feature allows you to capture all fields in the Form that is being recorded, marking them as output parameters. 1. Once you reach the Form that has the fields you would like as output fields on your mobilized application, click the Capture Parameters button on the Recording Toolbar. 2. Upon success, your recording toolbar will display a success message on the top left corner. For more details about editing parameters, see the "Edit a Service" Section. Service Details To view the service s details, click on the service name or use the Details button. 8 P a g e C o n f i d e n t i a l

9 The "Service Details" section displays the following information: Service Name Description Service URL WSDL URL Form URL Status The name of the service A brief description of what the service does 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, copy the relevant URL from the service 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. For an example of consuming the SOAP Service in ADF Mobile in the Oracle Jdeveloper development tool, see this video: Editing a Service To edit an existing service, click on the "Edit" button Service Details 9 P a g e C o n f i d e n t i a l

10 Service Name Description Form URL The name of the service A brief description of what the service does (Optional) The URL of the Form server. You may enter a different URL than the one used at the time of recording. Input Parameters The Input Parameters are the parameters that the service receives from the end-user. Drag parameters up or down to change their order Visible Name Label Default Value Move Choose whether the parameter will be visible in the application or not. For example, you may set a hidden parameter with a fixed predefined value. Unique name of an input filed, as captured from the Oracle Form Label to be displayed to the end-user near this field Value to be set as the initial value of this field (Optional). Copy the current parameter to the Output Parameters list Output Parameters The Output Parameters are the parameters the form returns in response to the input parameters. Drag parameters up or down to change their order 10 P a g e C o n f i d e n t i a l

11 Visible Name Label Multi Record Actions Whether this parameter will included in the output Unique name of the input filed, as captured from the Oracle Form Label to be displayed to the end-user near this field Delete this output parameter. See Service validation below. Service validation (advanced feature) You may add validations to the returned values of output parameters. Click the button next to a parameter, and select one of the validations in the displayed popup. The service will return an error if validation condition is not filled. You may control the returned HTTP code in case of failure in the Advanced details section: Advanced Details Filename Partial Service Enabled Service Use Labels As Keys Name of the ORP file the service is saved from Partial Service is a recording that does not start from the beginning of the scenario and is not independent. It relies on a previous service to run in order to succeed Enable or disable the service Call the service with the labels as the parameter names, instead of using the recorded names from the Oracle Form 11 P a g e C o n f i d e n t i a l

12 Number of Rows Authentication Use JSON Handle Pop-ups Validation Failure Status Total number of rows you wish to display in the result set None service could be activated simply by accessing its url. Basic Authentication service will require a valid ServiceManager username & password before running (in Authentication header). Field Encryption - service will require a username & password in Authentication header, passing them to 2 of its input parameters. Check to receive responses from your REST Service in JSON format Deals with pop-ups displayed over the Form during service playback. Check this box if you would like to have the service automatically click on the default button & continue with the playback. See the Service validation section on the previous page. Finally, click Update Service to save your changes to this service. 12 P a g e C o n f i d e n t i a l

13 Testing the Service 1. To test your service, click the test button in the actions column. The 'Test Service' page is displayed. 2. To change the input parameters default values, change the values in the "Default Value" column. 13 P a g e C o n f i d e n t i a l

14 3. Once all values are set, click the 'Test' button. The XML response will appear in the text box below The Forms error-messages, status-bar messages and pop-up messages can be found at the top of the response. Create Test Case To create a test case, click on the Create Test Case button on the Service Details page. The "Test Case Configuration" page is displayed. 14 P a g e C o n f i d e n t i a l

15 Test Case Details Test case name Description Response format Response level Unique name for the test case. A brief description of what the TestCase tests. (Optional) Either JSON or XML. ERROR or DEBUG. ERROR - Shows the data only if there is an Error - if the test case succeeded - it shows just the response time. If the test case fails, it shows the error details. DEBUG - shows the above plus all the input data and all the output data including status bar messages and popup messages. Service Details - Displays the details of the service being tested. Batch Configuration Choose File: Uploads a Parameters file. 15 P a g e C o n f i d e n t i a l

16 A batch parameters file is typically a csv file. It provides input for multiple iterations of the TestCase. You may generate csv files via Microsoft Excel or even via a simple text editor. Example csv file: Name,Id Alex,200 Joey,202 Alice,203 Bob,204 The first line is irrelevant input, and therefore the Use first line as header option should be selected. Assuming that Run until end of file option is selected, the TestCase will run 4 iterations, iteration per line, and the values in each line will be used by some of the input parameters. To set input parameter to receive its value from the batch file, set the Parameterized Value of the input parameter to the name/index of the column of the csv file. Input Parameters - Input parameters to be used in this test. Output Parameters - Output prameters returned by this test. You may turn on validation on output fields. The values returned in these fields will be validated against a predefined condition. Click on the validation button to open the Validation Options window. 16 P a g e C o n f i d e n t i a l

17 Select the failure condition for this field. Meaning, that in case this condition satisfies the TestCase will report failure. If you select one of the two last options, you should also fill in a value to compare with. Click on the save button. Advanced Validations Timeout Validation The maximal time allowed for this Test Case to run. Click Save to save this Test Case. After saving, a new set of options becomes available: Click Run to launch the test and see the outcome. Click Export to Junit to generate and download a java file with sample Junit code. 17 P a g e C o n f i d e n t i a l

18 HTML Services The HTML Service plays recording of a website instead of a Form. Your ServiceManager operates with HTML Services in a very similar way to Oracle Form Services. Recording HTML Services First, download and install the Selenium IDE plugin for Firefox: Once the installation is complete, open the Selenium IDE from the Tools menu (or press Ctrl+Alt+S): Make sure that the Record button is pressed, and you are ready to go with your recording. 18 P a g e C o n f i d e n t i a l

19 Operate the open Firefox browser window, and perform the actions you would like to record: start by entering an URL to the address bar and continue with the rest of your business process (for example enter username and password, click on a login button, click on some links ). For more information about recording websites with Selenium IDE, refer to the official manual at: AuraPlayer dedicated recordings To support our unique functionality, we require some minor adjustments to the recordings generated by the Selenium IDE. They are mandatory to support the service structure, as well as allow the optimizations we apply for better performance. This screenshot of an example recording will be referenced from the next paragraphs. 19 P a g e C o n f i d e n t i a l

20 Input parameters The input parameters of your service are automatically deduced from data you type, links you click, etc. Some types of actions generate input parameters, while other actions do not. Some of the actions that produce input parameters, produce them only when used with particular kinds of locators. The locator is displayed at the Target field of an action. In the example above, the selected action (action #7) clickandwait locates the element to click by id (id=myreqstable:requisitionnumber:2). By clicking on the down arrow in the Target field, you may see alternative locators to be used by the action all refer to the same element. If you require the data to be configurable, always prefer a simple locator: * link=14305 Generates an input parameter with default value * //span[@id='myreqstable']/table[2]/tbody/tr[4]/td/a Does NOT generate an input parameter since it is too complex and hard to identify the part to be configured. In general, XPath expressions will NOT generate input parameters. Unsafe targets (locators) You should never use the following kinds of locators: * Image-based locators - Images are ignored by the ServiceManager for performance reasons. For example: //img[id= expanseslist ]. Output parameters Output parameters cannot be implicitly inferred from the recording, you will have to explicitly define them. AuraPlayer uses the storetext action to declare on the output parameters of a service. On the example above, the textual value of the element located by id=n12:functionalamount:0 is an output parameter of the service. You will have to manually add a storetext action for each value you would like to capture. To add a new action from the Selenium IDE, right click on any existing action > Insert New Command. A new empty line will be added before the clicked action select in by clicking on it. To add an action at the end of the list, click on the empty line after your last action. Type storetext at the Command field. 20 P a g e C o n f i d e n t i a l

21 Now click on the Select button next to the Target field, and click on the value you wish to capture in the Firefox browser window that displays your website. In the Value field enter a name for the output parameter to capture the value into. In-table output parameters should be marked in the same way, but also later before saving the service at the Service Editor they should be checked as Multi Record. You may mark any value in the column to capture the entire column, and therefore to capture the entire table you should define a storetext action for one value from each column of the table. Note that there is also a new Table has header checkbox at the Advanced section of the Service Editor, which should be checked if the resulting table returns the column names as the first output line of the table. A cheatsheet of Selenium command that your ServiceManager supports is attached at the end of this section. Finish your recording Once you done recording your scenario, click on the Record button in the Selenium IDE window to stop the recorder (see screenshot above). Open the File menu, and click on Save TestCase As Choose a name for your recording (with.html extension), and save it in convenient location. Importing a recoding to the ServiceManager Open your ServiceManager at the Services tab, and click on the Upload Recording button. Select the recording file you created, and the Service Editor will be displayed. When creating a HTML service, you must copy the URL that you start your scenario with to the Base URL field in the ServiceEditor. Fill it in the rest of the ServiceEditor page as described in the "Edit the Service" section. Viewing recorded HTML services All services are listed in the Services tab from the left toolbar. The Type column in the services list, distinguishes HTML Services from other services. 21 P a g e C o n f i d e n t i a l

22 Executing, editing and using HTML services All actions are to be performed in the same manner as with the regular Oracle Form Services. Consult this manual for further instructions. HTML Services output The HTML Services maintain the same response structure as the Oracle Form Services: The contents of the 3 special output parameters are: Error HTML playback errors, if any. PopupMessages Unused at the moment (always returns an empty string). StatusBarMessages The title of the page at the execution of the last command. 22 P a g e C o n f i d e n t i a l

23 Supported commands We support the following Selenium-IDE commands (other commands will be ignored during playback). Note that some commands might have additional configuration or functionality compared to their Selenium IDE implementation. Command assertlocation (regex) asserttitle assertnottitle (regex) (regex) check checkandwait (locator) click clickandwait (locator, optionalaction*) pause (millistowait) runscript runscriptandwait (script, placeholdervalue*) select selectandwait (selectlocator, optionlocator) selectwindow (name) Usage Get the absolute URL of the current page and assert that it matches a regex. If not matches - abort execution. Get the title of the current page and assert that it matches/notmatches a regex. If match result is different from expected - throw an exception, aborting execution. Get the title of the current page and assert that it matches a regex. If not matches - abort execution. Check a toggle-button (checkbox/radio). Generates an input parameter. Clicks on a link, button, checkbox or radio button. If the click action causes a new page to load wait for it to finish. optionalaction an optional JavaScript code to be injected as the onclick action of the button. Wait for the specified amount of time (in milliseconds). If argument is null an unlimited wait for all background JavaScript jobs. Creates a new "script" tag in the body of the current test window, and adds the specified text into the body of the command. script if starts by // (meaning comment), the script won t be executed by Selenium IDE, but will be executed by the ServiceManger. placeholdervalue all ${something} tokens in script will be replaced with placeholdervalue before running the script. Selects an option on <select> element. Currently we support selection of values identified by <b>label=</b> only. Selects a popup/window using a window locator; once a window has been selected, all commands go to that window. To select the main window again, null as the target. 23 P a g e C o n f i d e n t i a l

24 storechecked (locator, variablename) storehtmlsource (variablename) storetext (locator, variablename) submitandwait (locator, optionalaction*) type (locator, value) uncheck uncheckandwait (locator) waitforelementpresent (locator, shouldwait*) waitforpagetoload (timeout) Get whether a toggle-button (checkbox/radio) is checked, and store it in an output parameter called variablename. Returns the entire HTML source between the opening and closing "html" tags. Save it in the temp folder, in a file called variablename. Get the text of an element, and store it in an output parameter called variablename. Submit the specified form. optionalaction - an optional JavaScript code to be injected as the action attribute of the form. Sets the value of an input field, as though you typed it in. Same as check checkandwait but the generated input parameter is initialized to false value. Waits until the specified element appears, or a timeout is reached. shouldwait playback will ignore this command if set to false (in order to save performance). Waits for a new page to load (with max wait time). 24 P a g e C o n f i d e n t i a l

25 DB Services The DB Service executes database queries/operations, and returns the result set. Your ServiceManager operates with DB Services in a very similar way to Oracle Form Services. Creating DB Services 1. On the Service Manager Toolbar, click on "Create" DB service. 2. The Service Editor will be opened, with dedicated database configuration view. 3. Enter a service name and description (optional). 25 P a g e C o n f i d e n t i a l

26 4. Configure the database connection: - Fill in the hostname of the database server. - Fill in the database port. Default ports are: 1521 for Oracle databases, 3306 for MySQL, and 5432 for PostgreSQL. - Enter the database Name or SID. - Select the database type. 5. Click on Test connection to ensure that your connection is properly configured. 6. A username/password dialog will open, enter your credentials to the database server and confirm. Your username and password will be automatically stored as the values of the corresponding input parameters. You may clear or hide them if you do not wish them to be exposed in your service. 7. Success/failure status will be displayed in popup message. If the connection failed, do not continue any further - check your DB configuration and retry. 8. Enter a Query as described in the following section. DB queries / statements The last field under Service details of a Database Service is the Query field. Enter a valid SQL statement. You should enter a single statement (without semicolon). In order to execute multiple commands, wrap them in function or procedure and call it from here. Examples: - SELECT STATE FROM CITIES WHERE POPULATION < P a g e C o n f i d e n t i a l

27 - INSERT INTO CITIES (STATE, CITY, POPULATION, WHITE, BLACK, HISPANIC, ASIAN, OTHER) VALUES ('DE', ' Muenchen', , 0, 0, 0, 0, 0) Dynamic queries (injecting input parameters) Your query may vary according to input provided to the service. For example, assuming that you are managing a CITIES table, and your service updates the population of the city, then the city name and population are probably input provided by the user executing the service. Meaning, instead of writing: - UPDATE CITIES SET POPULATION=40000 WHERE CITY='Muenchen' You may write: - UPDATE CITIES SET POPULATION=${population} WHERE CITY='${city}' Now, the population and city values are expected to be found in the input parameters of the service. You should add an input parameter named population and and input parameter named city to the input parameters table: Click on the add button, to append a new row at the bottom of the input parameters table. Fill in the name (must match to the query; use population in our example), label and default value for parameter. Finally click on the save icon. You may now add more input parameters add city for this example. 27 P a g e C o n f i d e n t i a l

28 Query examples SELECT UPDATE INSERT DELETE Calling a function Executing a procedure SELECT * FROM ${table} WHERE POPULATION < ${max_population} UPDATE CITIES SET POPULATION =0 WHERE CITY='${city}' INSERT INTO CITIES (STATE, CITY, POPULATION, WHITE, BLACK, HISPANIC, ASIAN, OTHER) VALUES ('${state}', '${city}', ${population}, 0, 0, 0, 0, 0) DELETE FROM CITIES WHERE state = '${state}' SELECT GET_POPULATION('${city}') as result FROM dual Since the name of the selected value is dynamic, we have to add "as result" (or any other name) so the output will be returned by that name and we would be able to capture the value with an output parameter named result. EXECUTE INCREASE_POPULATION('${city}') Testing queries and acquiring output parameters After configuring your database connection and query, click on the Get output button to execute your query for the first time. In addition to executing the query, it also adds any table columns returned from the query to the Output parameters table. Your query may not return any values, and no output parameters will be added (except from the traditional Error, PopupMessages, and StatusBarMessages). The number of new output parameters added to the table will be displayed in a popup message: You may also manually add, hide, or delete any output parameters. Finish by saving the service. Viewing recorded DB services All services are listed in the Services tab from the left toolbar. The Type column in the services list, distinguishes DB Services from other services. 28 P a g e C o n f i d e n t i a l

29 Executing, editing and using DB services All actions are to be performed in the same manner as with the regular Oracle Form Services. Consult this manual for further instructions. DB Services output The DB Services maintain the same response structure as the Oracle Form Services: The contents of the 3 special output parameters are: Error DB errors, if any. StatusBarMessages Number of affected rows if the executed statement has no output. 29 P a g e C o n f i d e n t i a l

30 HTML Pages Creating an HTML Page - Visualize To create an HTML page (visualize), Click the visualize button from the actions column. The generation of HTML page consists of 5 simple steps, click Next to advance to the next step. Your progress is displayed in the progress bar at the top of the page. Step 1: General Page Description Form URL HTML Name The URL of the Form the HTML page will access. Name of your choice for the HTML page. 30 P a g e C o n f i d e n t i a l

31 Application Title Request format The title that will be displayed at the top of the browser window. Choose the format for the response either JSON or XML Step 2: Request Form The input parameters are the fields the the end-user enters Form Title Button Label The form title is displayed at the top of the HTML page The label for the action button Use the arrows icon to drag input parameters up or down to change their order Visible By checking the box, the parameter becomes visible to the end user. You may set a hidden parameter with a fixed predefined value. Name The name of the input filed, as captured from the Forms system Label The label displayed to the end-user Default Value The default value to be set as the initial value. May be left blank. Data Type Set the field data type - read only / text / password / date / slider / checkbox / LOV. 31 P a g e C o n f i d e n t i a l

32 Step 3: Response Form The output parameters are the values returned to the user from the Forms system by the service Use the arrows icon to drag input parameters up or down to change their order Visible By checking the box, the parameter becomes visible to the end user. You may set a hidden parameter with a fixed predefined value. Name The name of the output filed, as captured from the Forms system Label The label displayed to the end-user Multi Record Set this checkbox if this field is in table, and you would like to get the response as a list Data Type Set the field data type - read only / text / password / date / slider / checkbox / LOV. Status Bar & Checking this box will display the messages from the Form in the Messages response page. If box is not checked, any popup messages, error messages, or status bar messages will be displayed in the results page. 32 P a g e C o n f i d e n t i a l

33 Step 4: Design This step controls the look and feel of your HTML page. Direction Layout Theme Color Header Text Header Color Footer Text Footer Color Logo in Footer Logo Path Page alignment: Right-to-left or Left-to-right. Layout of the page. Gray or black. Free text that will appear at the top of the page. Header text color. Free text that will appear at the bottom of the page. Footer text color. Check to include a logo image at the footer. Choose the logo image file. Step 5: Confirm Confirm your preferences by clicking on the Create page button. You will be redirected to the 'HTML Page Manager' where you can see your newly created HTML page 33 P a g e C o n f i d e n t i a l

34 Running a HTML Page with the created Business Process After creating your HTML page, you may access it from the HTML Page Manager tab. It allows you to visually test your service. 1. Click on the HTML Page Manager from the main menu. 2. Click on the name of your HTML page. Your page will now be opened in a new tab. This page wraps your service. 3. Enter some values in the input fields, and click on the "Execute" button. The response form will now be displayed, with results from your service. 34 P a g e C o n f i d e n t i a l

35 HTML Page Manager The HTML Pages tab is located at the Main Menu. The "HTML Page Manager" allows you to download, upload, and edit HTML pages, created using the Visualize wizard. The top toolbar supports the following actions: Upload a new HTML file. Download Print Delete Perform operations on a set of services. First, you will need to check a service or more from the list below. Download all selected HTML files as a zip file. Print selected pages. Deletes selected HTML files. The.orp file (business logic file) that is attached to service will not be deleted. The Actions toolbar, located under the Actions column, provides additional functions per-page: 35 P a g e C o n f i d e n t i a l

36 Editing HTML Page To edit HTML page, click on the HTML Page Manager tab. 1. Click on the Edit icon in the actions bar to the right of the HTML page. The HTML Page editor is now displayed. It consists of several sections: Actions toolbar, followed by handlers, JavaScript and HTML editors. 2. The top toolbar allows the following actions: Save Restore Download Open Page Save your changes. Discard your changes and reload the last saved version. Download the page, including its handlers and JavaScript. Open the generated page. 3. The Handlers allows the page perform various actions. For example, your handler may call a service once the user clicks a button, or navigate to other page when a certain keyboard key is pressed. Bound Key Bound Element Handler Action Attribute Initialization Handler Keyboard shortcut that triggers the action. The element receiving the action. The Handler's action type. For example: Calling a service or function, navigating to other page, etc. The name of the action to be triggered. Callback being called prior to calling the service. In this callback you may set parameters, run actions (for example start spinner), write 36 P a g e C o n f i d e n t i a l

37 Response Handler Edit Delete business logic, or decide if you want to run the service or not. The handler responsible for handling the response from the service. It may be used to analyze the data, perform error handling, etc. Modify this action. Delete this action. 4. The JavaScript frame allows you to write custom JavaScript functions that may be called by action handlers. See Adding Page Handlers below. 5. The HTML frame allows you to edit the HTML code of the page. Remember: Always click Save to your changes. 37 P a g e C o n f i d e n t i a l

38 Adding Page Handlers to an HTML Page By creating a handler, you define functionality for a button on the page or keyboard key. The Handlers section has the following buttons toolbar: Add Show JSON Add a new handler. Display the handler in JSON format. After pressing Show JSON, it will be replaced by Show Table button. Show Table Display the handlers in table. After pressing Show Table, it will be replaced by Show JSON button. 1. To add a handler, click on the Add button on the Edit HTML page. 2. A new line is added at the bottom of the handlers table, and the Action field appears. Select an action (Function / Web Service / Navigate / Web Service (On load)), and the rest of the form will become visible. 38 P a g e C o n f i d e n t i a l

39 "Function" action Select function in the Action field to trigger a JavaScript function. Key Bound Element Function Name To bind a keyboard shortcut key for this action, click on the "Key" field and hit the desired key on your keyboard. Note: If the bound element is a button on the page, leave this field blank. An element on the HTML page to be attached to this action. 1. Global: The action will be triggered when the key is pressed anywhere on the page. 2. Specific field/element: The action will be be triggered when the user interacts with this specific field. For example, if the bound element is set to Global, and the key to "Tab", then pressing the Tab key anywhere on the HTML page will call the function. If the bound element is set to "Customer ID", then pressing Tab only when the cursor is in the Customer ID field will trigger the action. Name of existing function, or new function that will defined in the JavaScript editor. "WebService" action Select WebService in the Action field to call a Service. 39 P a g e C o n f i d e n t i a l

40 Key Bound Element WebService Name Initialization Handler Response Handler Same as the Key field for a Function action. Same as the Bound Element field for a Function action. The name of the service this handler will call. Callback to be called prior to calling the service. In this callback you may set parameters, run actions (for example start spinner), write business logic, or even decide if you want to run the service or not. The handler responsible for handling the response from the service. It may be used to analyze the data, perform error handling, etc. Click create to generate a sample handler in the JavaScript editor below. You may wish to customize this handler. "Navigate" action Select Navigate in the Action field to redirect the user to another page. 40 P a g e C o n f i d e n t i a l

41 Key Bound Element Target Page Same as the Key field for a Function action. Same as the Bound Element field for a Function action. The HTML page to redirect to. This page can be a service on the Service Manager server or any other web page. "WebService (On load)" action Select WebService (On load) in the Action field to call a service when the page is loaded. WebService Name Initialization Handler Response Handler The name of the service you wish to call. servicesame as the Initialization Handler field for a WebService action. Same as the Response Handler field for a WebService action. 41 P a g e C o n f i d e n t i a l

42 Applications An application is a container of HTML pages working together. It defines a multi-page program, including input & output fields, actions and design. The Applications tab is located at the Main Menu. Click on it to open the Application Manager. The Application Manager allows you create applications, edit and regenerate them. The applications are created using the AppVisualizer wizard, resulting in one or more HTML pages. Application name Description #Services/Pages Modified Created By Actions Name of the application. A brief description of what this application is. (Optional) Number of services/pages associated with the application. Modification date. User that created the application, and defined as its owner. Details: Display the application details. Edit: Edit the wizard configuration and regenerate the application. Duplicate: Create a copy. Rename: Choose a different name for the application. 42 P a g e C o n f i d e n t i a l

43 You may also perform the following operations by selecting one or more Applications, and using the menu: Backup Delete Download a backup of the selected applications. The corresponding services and pages will be backed up as well. You may later restore the backup from the Admin page -> Restore. Delete selected applications. Application wizard: creating new application Click on the New App button, located at top of the Applications table. The AppVisualizer wizard will open. The AppVisualizer wizard consists of 5 steps, displayed at the progress bar on the top: General Design PageEditor: Fields PageEditor: Actions Pages Name of the application, and services it will be using. Pages in the application, and general styling. Input and output fields single or multi-record (table) fields. Actions and event handlers, as well as advanced JavaScript functionality. Summary of added pages. 43 P a g e C o n f i d e n t i a l

44 AppVisualizer Step 1: General 1. Under Application Details, Enter a unique name, and (optionally) a description for the application. 2. Under Services, add any services the application will be using click on the button. The table displays all existing services, select services by checking right next to them. The pages generated by the application will use the selected services. 3. Click on the Next button to continue to step 2. AppVisualizer Step 2: Design 44 P a g e C o n f i d e n t i a l

45 1. Select alignment of the page to left or right. 2. Choose whether the application will be Android or ios style, and colors scheme. The generated application will fit all devices, Android and ios. Your selection here is only whether your application will look more Android-like or ios-like. 3. You may upload your own logo for the application. By default, the AuraPlayer logo will be used. 4. Enter names for pages in your application. Click on the button to add a new page, and press Enter key to confirm and continue adding more names. Finally click on the Cancel/Done. After adding names, you may: - Rename a page by clicking inside its textbox, and entering a new name. - Click the button to edit the page. - Click the button to delete the page (cannot be undone). - Click on the button to enter more names, as described above. Each page name will be preceded with an indicator about its state: - A page you finished editing will be marked with green check mark. - Page that still requires editing will be marked with red new icon. 5. Click on the Next button to continue to step 3. You will be forwarded to editing the first unedited page of the application. 45 P a g e C o n f i d e n t i a l

46 AppVisualizer Step 3: Page Editor - Fields Before editing your page, notice the current page selector located at the top-center of the screen, between the Back and Next buttons (displayed only in steps 4 and 5). It shows the current page you are editing, and allows you to switch to editing of another page. For beginners, you probably would not change the current page using this selector, but only use the Next button to continue to editing of other pages. 1. Enter a title for the application. The title will be displayed at top of the generated page. 2. Select input and output fields to be visible in this page. Click on the button to select fields. The fields selection dialog will be opened. Fields are grouped by services (first level), input or output parameters, and finally the field name is displayed. Clicking on the button expands the category, and so does clicking on its name. Select a field by clicking on its name, or by checking the checkbox right next to it. 46 P a g e C o n f i d e n t i a l

47 For example, in the screenshot bellow: we selected the MAIN_USERNAME_0 and MAIN_PASSWORD_0 fields all occurrences of a selected field in all services of the app are selected/deselected simultaneously. Finally click Confirm to close the dialog and save your selection to wizard. 3. Similarly, you may add multi-record (table/list) fields to the page. When selecting muti-record fields, the field selection dialog will only allow section of fields that were recorded as muti-record fields. Upon adding your first fields, you will be able to choose between table or list layout, as well as additional special configuration for it (you may choose to include search field in list layout). 4. Click on the Next button to continue to step P a g e C o n f i d e n t i a l

48 AppVisualizer Step 4: Page Editor Actions In step 4 you will continue editing the page you started editing in step 3. You will be adding actions and event handlers to elements in the page behavior for buttons, table, keypresses and more. Add an action using the button. The ActionEditor dialog will be opened. 48 P a g e C o n f i d e n t i a l

49 Start filling in the action form from top to bottom the form will adjust to your choices as you edit it. The OK button will become available once all required fields are set. Incomplete or invalid fields will be marked with a red frame. Event Action type Actions types Execute a service Navigate to page Call custom function The event the action will respond to. Choices: clicking on a button, table, pressing a key, or page initialization. Additional fields will appear depending on your choice. Action to be performed. Choices: execute a service, navigate to page, or call a custom function. Additional fields will appear depending on your choice. Execute a service when the event occurs. Select the name of the service to execute, and define what happens if the service succeeds or fails (due to validation or any other error). Success/failure options are almost identical: do nothing, display popup message with custom text, navigate to other page, or call custom function. Failure options also allow choosing to display popup with the errors that occurred. Navigate to other page when the event occurs. Select the name of the page. Call user defined JavaScript function when the event occurs. Enter the name of the function to generate. After confirming the dialog, such function will be generated in the JavaScript editor at the bottom of the page write your code there. Table click event ontableclick() is a special event. You would usually want to store the clicked row before performing an action, and therefore such code will be automatically generated in the JavaScript editor. When you select Call custom function action type, it will be generated as the function body, otherwise a pre-function will be generated with this code. A pre-function is called prior to the execution of the selected action. 49 P a g e C o n f i d e n t i a l

50 Certainly you may delete this code (but not the function itself!) if it doesn t fit you. To edit or delete an existing action, use the buttons in the actions table. The JavaScript editor will contain auto-generated code required by your actions. You may add additional JavaScript code as you wish. The page HTML source code is not generated yet, and therefore you would be able to edit the HTML code only when you finish the wizard. You might want to hold advanced JavaScript scripting that requires editing the HTML to after the application is generated. Click on the Confirm page button to continue to the next step. The current page will be marked as finished indicated by green check mark at step 2 near its name, and in the current page selector in steps 3 and 4. If there are more unedited pages, you will be redirected to the next page to edit (step 3). Otherwise, you will be redirected to step 5. AppVisualizer Step 5: Pages This is a summary of your application. You may go back to previous wizard steps if needed. 1. Review the pages you added to your application. 50 P a g e C o n f i d e n t i a l

51 - Use the table buttons to edit, duplicate, rename or delete pages. - Click the edit button next to a page to go back editing it in step 3. - Clicking Back will open step 2. Notice that clicking Next in step 2 once all pages are edited will forward you to step 5 - The Next button in step 2 takes you to the next page that was not edited yet! From step 2, to edit again page you ve already edited, you must use the name. button next to its 2. Finally, click on the Create application button to confirm the application and generate it. The PageManager will be opened, and you ll see the generated pages as the top table rows. The Owner app column may assist you to identify the pages belonging to each app. The generated HTML pages may be edited as any other HTML page. The AppVisualizer wizard generates an initial template of the HTML pages in your application, according to the configuration you ve entered. If you edit the generated pages, your changes will be overwritten if you choose to regenerate the application again using the AppVisualizer wizard. 3. In the PageManager, click on the name of the first page of your application to open it. 51 P a g e C o n f i d e n t i a l

52 AuraTester The AuraTester tab is located at the Main Menu. The AuraTester Manager allows you to create, edit and run Test Cases / Test Groups. Test Groups allow you to group together several Test Cases in order to test complex scenarios. You may see that the AuraTester window has two tabs: Test Cases and Test Groups. Click on one of them to get started. 52 P a g e C o n f i d e n t i a l

53 Test Cases The AuraTester Test Cases tab displays the existing Test Cases, allows you to create new ones, edit and run them. Name Test Groups Web Service Modified Modified By Actions Name of the Test Case. Test Groups using this Test Case. Service tested by this Test Case. Modification date. User that modified the Test Case. Details: Display the Test Case details. Edit: Edit the Test Case. Duplicate: Create a copy. Run: Run the Test Case. You may also perform the following operations by selecting one or more Test Cases, and using the menu: Backup Delete Add to Test Group New Test Group Download a backup of the selected Test Cases. You may later restore the backup from the Admin page -> Restore. Delete selected Test Cases. Add selected Test Cases to existing Test Group (Test Groups introduced below). Create a new Test Group, adding the selected Test Cases to it. 53 P a g e C o n f i d e n t i a l

54 Creating a new Test Case There are two methods for creating a Test Case: 1. From the Service Editor page, by clicking on the Create Test Case button. This method was widely explained under the Services section above. 2. From AuraTester, Test Cases tab, by clicking on the add button. You will be asked to select a service, and the rest is the same as in the first method. 54 P a g e C o n f i d e n t i a l

55 Test Groups The AuraTester Test Groups tab displays the existing Test Groups, allows you to create new ones, edit and run them. Name Description Stop Sleep Actions Run Name of the Test Group. A brief description of what this Test Group tests. (Optional) If checked, the Test Group stops if one of its tests fail. Sleep time between tests. Edit / Save / Delete / Cancel the Test Group. Details: Display the Test Group details. Edit: Edit the Test Group. Run: Run the Test Group. You may also perform the following operations by selecting one or more Test Groups, and using the menu: Backup Delete Download a backup of the selected Test Groups. You may later restore the backup from the Admin page -> Restore. Delete selected Test Groups. 55 P a g e C o n f i d e n t i a l

56 Creating a new Test Group 1. Click on the Add button, located at the top of the Test Groups table. The Test Group Editor page will be opened. 2. Under Details, fill in the required fields, as described in the previous page. 3. Under Test Cases, add Test Cases for this Test Group. - Add Test Cases using the button. You may add existing Test Cases, or create new ones. - Drag & Drop: Reorder Test Cases by clicking and dragging them to the requested position. - Delete Test Cases by selecting them and using the menu. 4. Save your Test Group using the Save button. Running a Test Group You may run a Test Group only if it contains one or more Test Cases. 1. Run the Test Group by clicking on the Run icon right next to the Test Group s name. 56 P a g e C o n f i d e n t i a l

57 2. The test will run, and a Test Report will be displayed. The results include success/failure indication, response time and more. Success/failure indication is also reported per Test Case, in the Test Cases table: 57 P a g e C o n f i d e n t i a l

58 Monitoring Agents The Monitoring Agents tab is located at the Main Menu. The Monitoring Manager allows you to create, run and monitor Test Agents. Test Agents periodically test your services by running predefined Test Cases or Test Groups in constant intervals. Later on, you may examine their results as well as performance. Test Name Execution Interval Status Mail Recipient Mail Error Description Actions Options The Test Case or Test Group this agent executes. Time interval between subsequent executions. Active or Paused. address that will be notified of failures. Error message that will sent to the Mail Recipient. Edit / Save / Delete / Cancel the Test Agent. Reset, Activate, or pause the Test Agent. 58 P a g e C o n f i d e n t i a l

59 Creating a Test Agent 1. Click on the Add button, located at the top of the Test Agents table. A new editable line will be added at the bottom of the table. 2. A popup dialog will be displayed, asking to choose a Test Case / Test Group: Make your selection, and click Select. 3. A new Agent will be created and added to the table. The agent will be initialized with default configuration change it by clicking Edit. The Test Agent starts automatically. The results will be updated in the chart and logs bellow. You may switch to the results of other agent by clicking on its name in the Test Agents table. Monitor Chart The monitor chart displays the response time for each run. Logs 59 P a g e C o n f i d e n t i a l

60 The logs table includes the response time, success/failure indication (including fail reason - if failed) - for each Timestamp. Advanced details Calculates the average, max and min response time. Editing a Test Agent To edit a Test Agent, click on the edit icon right next to the Test Agent s name. When you finish editing, click on the save icon. 60 P a g e C o n f i d e n t i a l

61 Integration The Integration tab is located at the Main Menu. The Integration manager allows you to export your services to external platforms, such as MCS (Oracle Mobile Cloud Service). Clicking on Integration opens the MCS Resources view. The table displays existing MCS Resources these resources match to the Resources of Orcale s MCS. 61 P a g e C o n f i d e n t i a l

62 Creating a MCS Resource 1. Click on the Add button, located at the top of the MCS Resources table. The MCS Exporter wizard will be opened. 2. Step #1 is the method selection: Enter name for the resource, and select which methods this resource should support. Each method has a dedicated role, which would be display near it as you start typing the resource name. Click on the Enabled / Disabled switches to alter method support. Hit the Next button once you finished. 3. Step #2 is the method definition: you would go over each of the enabled methods, and define its functionality. 62 P a g e C o n f i d e n t i a l

63 4. You ll start by editing the GET (ALL) method. The method url and role is displayed at the top row. Select which service provides this functionality in our case it is mcs_getallcustomers. * Some methods require additional Request Id parameter, such as the GET method. This parameter identifies the data being handled, for example regarding GET method, it answers the question which customer to retrieve? 5. Once you select a service, a sample request (in JSON format) will be generated. You may edit the request (it is strongly recommended that you change only values of the request fields). 6. Click on the Get Response button. 7. The service is being executed, with the data provided in the Request example section as input, and the service response would be displayed in a few moments. Examine the response - make sure that it is the response you was expecting for, that it includes all needed output fields, and that their values are correct. If not, change the input data at the Request example and click on the Get response button again. Note that some responses are altered by default, by the MCS Wizard see bellow. 63 P a g e C o n f i d e n t i a l

64 8. MAX (Oracle Mobile Application Accelerator) compatibility: MAX have special demands regarding the structure of the GET and GET (ALL) methods. By default, the MCS Wizard applies transformations on the retrieved response in these methods, to fulfill this requirement. However, if it is irrelevant to you, or you wish to add/omit fields anyway you may do this by clicking on the Edit response button. In this case it not guaranteed that MAX would work correctly with such resource contact the AuraPlayer support team for more information. 9. Edit Response dialog: Check/uncheck response components to display/hide them in the response. - Unchecking an item, hides it from the response. - Unchecking an item with children, removes a single nesting level, promoting the children higher in the response tree. To the restore the original response from the service, select all checkboxes. The MAX compatibility slider indicates whether the response structure matches the response expected by MAX, switch the slider to the Yes value to set the structure required by MAX (the slider might be disabled if the response have no special structure requirements), 64 P a g e C o n f i d e n t i a l

65 Click Confirm to close the dialog. The response at the Response example section will be transformed to the new structure. 10. Notice the MAX Compatibility indicator near the Edit Response button, which indicates whether the selected structure is the structure required by MAX or custom (which might be accepted by MAX or not). It might say MAX compatible or Custom structure. 11. Click on the Next button. The current method will be marked as finished indicated by green check mark at step 1 near its name, and in the current method selector in steps 2. If there are more unedited methods, you will be redirected to the next method to edit. Otherwise, you will be redirected to step 3. At any stage you may click Back to go to step 1, or use the current method selector in step 2 (between the Back and Next buttons) to edit another method. Notice that clicking Next in step 1 once all methods are edited will forward you to step 3 - The Next button in step 1 takes you to the next method that was not edited yet! From step 1, to edit again method you ve already edited, you must use the its name. button next to 12. Finally, click on the Confirm button (step 3) to save the resource. Parent resources: the standard method URL is /RESOURCE_NAME or /RESOURCE_NAME/{id}. You might want to create resources with more complex URL like /RESOURCE1/{id1}/Resource2/{id2}. This may be achieved with Parent relation. For example, by defining in resource Orders a parent resource Customers you will be making all Orders URLs in the following format: /Customers/{customerId}/Orders, or /Customers/{customerId}/Orders/{orderId}. Exporting an API Once you created all your resources, you should export them as API to MCS. 65 P a g e C o n f i d e n t i a l

66 1. In the Integration Manager, MCS tab, select the relevant resources, and click on the Actions button -> Export API. The MCS Export dialog will be opened. 2. Enter name for the API, and a predefined connector. The connector must exist on MCS. 3. Click on the Export button to export the API and download it. 4. Extract the downloaded zip file to new folder. The extracted contents contain 2 files. - API_NAME.raml: raml file defining endpoints and request/response structures. - API_NAME_impl.zip: implementation file. 66 P a g e C o n f i d e n t i a l

67 5. Open the MCS website. 6. In Applications > APIs > New API > API, drag and drop the.raml file to the open dialog. 7. Open the API configuration, Implementation tab, drag and drop the _impl.zip file here. 67 P a g e C o n f i d e n t i a l

68 Admin The Admin tab is located at the Main Menu. The "Admin" allows you to backup data, customize system behavior, and manage services ORP files. Recordings Manager Manages recording files (AuraPlayer's business process files -.ORP or.html files). 68 P a g e C o n f i d e n t i a l

69 The Recordings Manager provides the following actions: Upload a.orp or.html file(s) to the server. Download Delete Perform operations on a set of recordings. First, you will need to check a recording or more from the list below. Downloads all selected recording files as a zip file. Deletes the selected recording files. Recording files that are attached to a service cannot be deleted. When deleting a service from the Service Manager, the.orp/.html file it was created with, is not deleted. The "Recordings Manager" table has the following columns: File Name Services using file Type Modified Actions Name of the ORP file on the AuraPlayer server. Services that use this specific recording file. If the field is black, the file is unused. Meaning, if a service was deleted, the orphaned ORP file still exists and listed here. ORP for Oracle Form recordings. HTML for website recordings. Modification date of the file. Create a new service from this recording file. Create a new service from a recording file There are 2 ways to create a new service from the Recordings Manager. 1. Click on the "New Service" button right next to any recording file in the list. 2. Create a new service using the "Upload Recording" button. This will import a recording file that was generated from another AuraPlayer service manager, or from the AuraPlayer client server toolbar. a. Click on the Upload Recording icon and choose the file you wish to upload. b. Once uploaded, click on the "New Service" button right next to it. The Service Editor page will be displayed, which you should fill in as described in the "Edit the Service" section above. 69 P a g e C o n f i d e n t i a l

70 Backup, Restore and Reset Backup Save a backup of your data as zip file. Restore Restore your data from a previously created backup file. Reset Reset your entire database. You will need to confirm this action. System Management System Properties Update your preferences and global system configuration. Manage Form Domains 70 P a g e C o n f i d e n t i a l

71 Add or edit form domains. Mail Server Update the mail server details. The Mail configuration applies for the sender of messages, which are sent by Test Agents to report errors. The messages are sent to the Mail Recipient as defined per Test Agent (see 'Creating a Test Agent' section). 71 P a g e C o n f i d e n t i a l

72 Log Management View Log Displays log of administrative events. You can filter the log by Keywords: You may skip to the beginning of the log by clicking the 'go to top' button, or to the end by the 'go to end' button. You may also filter the log by severity: ANY, TRACE, DEBUG, INFO, WARN, ERROR. 72 P a g e C o n f i d e n t i a l

73 The Log Viewer Toolbar Click on Download button to download the manager.log file Click on Rotate button to clear the log file. Click on Refresh button to refresh the view log. Download Download the log file. Rotate Clear the log. This event is logged in the new log file: 73 P a g e C o n f i d e n t i a l

74 License Management Request License Renewal Sends an request for license renewal. License Upload a license file. License Properties, Server Information and Client Information You may see License Properties, Server Information and Client Information in the Admin tab. 74 P a g e C o n f i d e n t i a l

75 Support The Support tab is located at the Main Menu. Getting Support Search for information in the "Need Help?" textbox: The search results will be displayed in a new page. Watch video introducing the AuraPlayer company and products. Contact the support team: Watch the Video Training Gallery 75 P a g e C o n f i d e n t i a l

76 How-To Guide includes the Service Manager User Guide file. Browse FAQs Prerequisites & install guides Thank you for choosing AuraPlayer. 76 P a g e C o n f i d e n t i a l

77 Appendix Roles and user management As part of the ServiceManager installation, you have defined the following three security Groups: ServiceManagerAdmins members can fully administer the Service Manager. ServiceManagerManagers members can administer their own data only. ServiceManagerUsers members have limited accessibility. Service Manager Admins The highly privileged users group. Members of this group view data of all users, and may perform all supported operations. Service Manager Managers May perform operations on its own data only. By default, may view its own data only. A Service Manager Admin may allow Managers to view data of all users (but not modify it), by setting the MANAGER_VIEWS_ALL_ENTITIES=true property in the System Properties. Operations that do not change the data (such as running a service/test, visualizing a service, etc.), may be performed on all visible data. Service Manager Users Limited users group. May view all data but cannot edit any of it. Some operations that do not change the data (such as running a service/test, etc.), may be performed on all visible data. 77 P a g e C o n f i d e n t i a l

78 Securing your Service Manager The Service Manager consists of a client side UI and a server side API. The client side is password protected by the login screen, but the Service Manager API is exposed and does not require authentication by default. An open API allows you easier access to the Service Manager functionality from any external tools you may use. However, it might not always be necessary and you should consider adding extra security by preventing unauthorized access to the server API. 1. Open the Admin tab. 2. Click on the System Properties button. The System Properties Manager will open. 3. Scroll down utill you find the SERVICEMANAGER_API_PROTECTED setting. 4. Change the set value from false to true. NOTICE: Your services won t be affected by this setting to add authentication to services you created, refer to the Authentication Type setting in the Service Editor page. 78 P a g e C o n f i d e n t i a l

79 System Properties The System properties editor is available from the Admin page, under the System Management section. It allows you to customize system behavior and control its configuration. Editing the System Properties is recommended for advanced users only! Basic users are suggested to use the graphical interface to perform any customizations (some properties could be set only using the System Properties editor). Disabled properties: Some properties might be removed or disabled (lines starting with # are commented out). In this case internally hardcoded default values will be used. Directories USER_HOME DAILY_BACKUPS Local storage directory for the ServiceManager. A place for all recordings, services, html pages and other data. Storage directory for periodical daily backups. DB configuration 79 P a g e C o n f i d e n t i a l