1. Ontology Application Management (OAM) Framework User Tutorial http://lst.nectec.or.th/oam/ Part 1: Database to Ontology Mapping & Semantic Search System Part 2: Recommender Application Management Part 3: Recommender Web API Management Last updated: Feb 4, 2016 © LST Lab, NECTEC, Thailand

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

3. Software used by and bundled with OAM Framework user’s package Apache Jena (http://jena.apache.org/)http://jena.apache.org/ D2RQ (http://d2rq.org/)http://d2rq.org/ Hozo ontology editor (http://www.hozo.jp/)http://www.hozo.jp/ Apache Tomcat (http://tomcat.apache.org/)http://tomcat.apache.org/ 3 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. OAM Tutorial: Part 1 - Database to Ontology Mapping & Semantic Search System Semantic KM Tools Workshop LST Lab, NECTEC

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

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

7. Step 1/5: Preparing OWL Ontology File

8. Export OWL Ontology from Hozo Ontology Editor 8

9. 9

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

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

12. Import database data to MySQL Database using Navicat 12

13. Create New Database 13

14. Import Data from Excel 14

15. 15

16. 16

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

18. Set up Environment Variable 18

19. Set up internal database 19

20. Start Apache Tomcat 20

21. Start Mapping Web Interface Open Firefox or Chrome http://localhost:8080/config/ http://localhost:8080/config/ 21

22. DB and Ontology Configuration 22

23. Class - Table Mapping 23

24. List of Class – Table Mapping 24

25. Property – Column Mapping 25

26. Datatype Property Mapping 26

27. Object Property Mapping 27

28. List of Property Mapping 28

29. Vocabulary Mapping 29

30. List of Vocabulary Mapping 30

31. Vocabulary Mapping 31

32. Save Configuration 32

33. Create/ Update RDF Data 33

34. Step 4/5: Search Application Configuration

35. Application Config 35

36. Search Property Properties that are allowed in Search Condition 36

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

38. Change Search/Display Property 38

39. Save Configurations 39

40. Step 5/5: Start Search Application

41. Start Semantic Search Web Interface Open URL: http://localhost:8080/search/http://localhost:8080/search/ 41

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

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

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

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

46. Add recommendation class in ontology 1 2

47. Export OWL Ontology from Hozo Ontology Editor 47

48. 48

49. Start Mapping Web Interface Open Firefox or Chrome http://localhost:8080/config/ http://localhost:8080/config/ 49

50. Update New Ontology File 50

51. Save Configuration 51

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

53. Step 2/6: Recommender Application Configuration

54. Add a new class in Application Config Player_Recommendation

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

56. Save Configurations 56

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

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

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

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

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

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

63. Step 4/6: Mapping rules with ontology

64. Start Rule Management System Open Firefox or Chrome http://localhost:8080/rule/ http://localhost:8080/rule/ 64

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

66. Upload rules in Excel file 66

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

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

69. Finish Creating Rules 69

70. Step 5/6: Apply rules

71. Apply rules 71 ** Please restart Tomcat after this step.** http://localhost:8080/config/

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

73. Update Application Config 73

74. Add Display Property 74

75. Change Search/Display Property 75

76. Save Configurations 76

77. Search to view recommendation results http://localhost:8080/search/ 77 Search conditions Recommendation results

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

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

80. Recommender Web Service Example 80 Input Output

81. 5-Step Process 1.Connect to Web API config database 2.Create config profile 3.Web API input parameter config 4.Web API Output config 5.Test Web API results

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

83. Initialize configuration database Start Web Browser at URL: http://localhost/ws_adm/http://localhost/ws_adm/ 83

84. Initialize configuration database 84

85. Step 2/5: Create config profile

86. Create new config profile 86

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

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

89. Web API Input Parameter Config 89 Class name Table name

90. Web API Input Parameter Config (2) 90

91. Step 4/5: Web API Output config

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

93. Step 5/5: Test Web API results

94. Create test form 94 form_test.html URL: http://localhost:8080/rec_api/WS/state/reccommend/football/Football_clubhttp://localhost:8080/rec_api/WS/state/reccommend/football/Football_club

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

96. End of Tutorial http://lst.nectec.or.th/oam/ 96