1. Ontology Application Management (OAM) Framework User Tutorial
Part 1: Database to Ontology Mapping & Semantic Search System
Part 2: Recommender Application Management
Part 3: Recommender Web API Management
© LST Lab, NECTEC, Thailand
Last updated: Dec 22, 2016

2. About OAM Framework
To simplify creation and adoption of a semantic web application.
Provides common application templates that can process the user's published RDF data.
User's programming skill is NOT REQUIRED in building a prototype application.
Supports both RDF data publishing from databases and building ontology-based applications
Semantic search, Recommender system applications.

3. Software used by and bundled with OAM Framework user’s package
Apache Jena (
D2RQ (
Hozo ontology editor (
Apache Tomcat (
Note: OAM framework was originally developed as a companion application framework for OWL ontologies developed using Hozo ontology editor. It also works with OWL ontologies created using Protege 4.x Ontology Editor (although with some limitation).

4. Semantic KM Tools Workshop LST Lab, NECTEC
OAM Tutorial: Part 1 - Database to Ontology Mapping & Semantic Search System
Semantic KM Tools Workshop
LST Lab, NECTEC

5. Required Software Java Development Kit (JDK) 6 AppServ
Navicat for MySQL
Notepad++ or EditPlus
Mozilla Firefox or Google Chrome Web Browser
OpenOffice Calc or Microsoft Excel

6. 5-Step Process Preparing OWL Ontology File Create a Database in MySQL
Database to Ontology Mapping Configuration
Search Application Configuration
Start Search Application

7. Step 1/5: Preparing OWL Ontology File

8. Export OWL Ontology from Hozo Ontology Editor

10. Step 2/5 - Create a Database in MySQL

11. Create database data using Microsoft Excel or Openoffice Calc
player_sample.xls
club_sample.xls
country_sample.xls

12. Import database data to MySQL Database using Navicat

13. Create New Database

14. Import Data from Excel

17. Step 3/5: Database to Ontology Mapping Configuration

18. Set up Environment Variable

19. Set up internal database

20. Start Apache Tomcat

21. Start Mapping Web Interface
Open Firefox or Chrome

22. DB and Ontology Configuration

23. Class - Table Mapping

24. List of Class – Table Mapping

25. Property – Column Mapping

26. Datatype Property Mapping

27. Object Property Mapping

28. List of Property Mapping

29. Vocabulary Mapping

30. List of Vocabulary Mapping

31. Vocabulary Mapping

32. Save Configuration

33. Create/ Update RDF Data

34. Step 4/5: Search Application Configuration

35. Application Config

36. Search Property
Properties that are allowed in Search Condition

37. Display Property
Properties that are allowed to display search results

38. Change Search/Display Property

39. Save Configurations

40. Step 5/5: Start Search Application

41. Start Semantic Search Web Interface
Open URL:

42. Search Conditions and Results
Class to search
Search property
Search condition
Display property

43. Using New Search Interface
Open URL: 2 4 1 3 5

44. New functions RESTFul Web API Keyword search over datatype properties
Search property displayed as labels or property names
Menu language switch (English or Thai)
CSV or JSON export

45. Using Web API
&property=has_country&operator=ISA&value=&valueRelation=europea n&property=&value=&limit=100&offset=0
Request URL
Result in JSON format

46. OAM Tutorial: Part 2 - Recommender Application Management
Semantic KM Tools Workshop
LST Lab, NECTEC

47. 6-Step Process Prepare OWL ontology and update RDF data
Recommender Application Configuration
Create rules in Microsoft Excel
Mapping rules with ontology
Apply rules
Start search application to view results

48. Step 1/6: Prepare OWL ontology and update RDF data

49. Add recommendation class in ontology2 1

50. Export OWL Ontology from Hozo Ontology Editor

52. Start Mapping Web Interface
Open Firefox or Chrome

53. Update New Ontology File

54. Save Configuration

55. ** Please restart Tomcat after this step.**
Update RDF Data
** Please restart Tomcat after this step.**

56. Step 2/6: Recommender Application Configuration

57. Add a new class in Application Config
Player_Recommendation

58. Define a Recommendation Class
Click to define that this is a recommendation class

59. Save Configurations

60. Step 3/6: Create rules in Microsoft Excel

61. Using Excel to create rules
Advantages
No need to learn new tools
Can create a large number of rules
User can use any vocabulary

62. 3-Step process Create headers for criteria name
Create headers for criteria range
Create rules in table format

63. Create headers for criteria name
Criteria name for ‘Football Club’
สโมสรอยู่ในประเทศ (club country)
Criteria name for ‘Player’
อายุ (player age)
เล่นในประเทศ (player’s club country)

64. Create headers for criteria range
สโมสรอยู่ในประเทศ (club country)
=> ‘เอเชีย’ (Asia), ‘ยุโรป’ (Europe)
อายุ (player age)
=> ‘<23’, ‘>=23’
เล่นในประเทศ (player’s club country)
=> อเมริกาใต้ (South America), ยุโรป (Europe), เอเชีย (Asia)

65. Create rules in table format
IF (club’s country in Europe) THEN recommend (players who have ages >= 23 and have club country in Asia) to the club.
IF (club’s country is Asia) THEN recommend (players who have ages >= 23 and have club country in Europe) to the club.

66. Step 4/6: Mapping rules with ontology

67. Start Rule Management System
Open Firefox or Chrome

68. 2-step process Upload rules in Excel file
Mapping rule criteria with ontology

69. Upload rules in Excel file

70. Mapping rule criteria with ontology
Mapping criteria name
Object property
Mapping criteria values
Class names

71. Mapping rule criteria (2)
Datatype property
Operator + Value
Object property
Class names

72. Finish Creating Rules

73. Step 5/6: Apply rules

74. ** Please restart Tomcat after this step.**
Apply rules
** Please restart Tomcat after this step.**

75. Step 6/6: Start search application to view results

76. Update Application Config

77. Add Display Property

78. Change Search/Display Property

79. Save Configurations

80. Search to view recommendation results
Search conditions
Recommendation results

81. OAM Tutorial: Part 3 - Recommender Web API Management
Semantic KM Tools Workshop
LST Lab, NECTEC

82. Related Tools Recommender Web Service
Recommender Web Service Configuration Tool

83. Recommender Web Service Example
Input
Output

84. 5-Step Process Connect to Web API config database
Create config profile
Web API input parameter config
Web API Output config
Test Web API results

85. Step 1/5: Connect to Web API config database
* copy “ws_adm” from “OAM_Tools\software\add-on” to “C:\AppServ\www”

86. Initialize configuration database
Start Web Browser at URL:

87. Initialize configuration database

88. Step 2/5: Create config profile

89. Create new config profile

90. Initialize config profile
Database setting (the same database used in DB-ontology mapping)
SKAF_HOME setting

91. Step 3/5: Web API input parameter config

92. Web API Input Parameter Config
Class name
Table name

93. Web API Input Parameter Config (2)

94. Step 4/5: Web API Output config

95. Web API Output Config XML tag name property linked to ‘Player’ class
property of ‘Player’ class to show in result

96. Step 5/5: Test Web API results

97. Create test form form_test.html
URL:
form_test.html

98. View Web API result Input Parameters Class name Profile name
Web API Outputs

99. End of Tutorial