Version 7.2 by Petr Blšťák on 2020/04/30 03:48
Hide last authors
admin admin 5.1 1 (% class="box errormessage" %)
2 (((
3 This section is currently under construction... please wait until is finished
4 )))
5
admin admin 2.1 6 = Software to be installed =
7
8 //Unless stated otherwise, newer stable versions of the program should work.//
9
10 ==== [[iTrivio 2.9.017>>doc:Main.Official manuals.iTrivio installation manual.WebHome]] ====
11
12 ==== [[Competent 33>>doc:Main.Official manuals.Competent installation manual.WebHome]] ====
13
14
admin admin 5.1 15 = Introduction =
16
17 //On this page we use the term "Course" for both iTrivio courses and tests.//
18
Petr Blšťák 7.1 19 The integration of Competent and iTrivio provides features from both softwares merged together and accessible through the Competent.
admin admin 5.1 20
Petr Blšťák 7.1 21 When specific objects are created in Competent, they are automatically created in iTrivio as well. Competent stores the ID references to the iTrivio objects in its database.
admin admin 5.1 22
Petr Blšťák 7.1 23 This applies to creation of:
admin admin 5.1 24
Ondřej Steffl 6.1 25 * Users
Petr Blšťák 7.1 26 * Courses (Activities with the specific launch type iTrivio)
Ondřej Steffl 6.1 27 * User-Course assignments
28 * User-Course attempts
admin admin 5.1 29
Petr Blšťák 7.1 30 iTrivio application is accessible only throught specific links in Competent when:
admin admin 5.1 31
Petr Blšťák 7.1 32 * editing a content of Course
33 * playing a Course
Ondřej Steffl 6.1 34 * displaying specific User-Course reports
admin admin 5.1 35
Petr Blšťák 7.1 36 The links to iTrivio contain a one time auto-login security token that approves the current user's action in iTrivio. There is no need for the user to log into iTrivio system manually.
admin admin 5.1 37
Petr Blšťák 7.1 38 By default the password of a user in iTrivio is different (random) from his password in Competent to prevent direct access to iTrivio. We recommend to disable iTrivio emailing and to keep iTrivio user's password secret to the user.
39
Ondřej Steffl 6.1 40 (% class="box warningmessage" %)
41 (((
42 **Modifying iTrivio directly (out of Competent platform) can cause synchronization issues, especially when manipulating with Users, Courses, User-Course attempts and assignments.**
43 )))
admin admin 2.1 44
Petr Blšťák 7.1 45 The configuration below describes the basic scenario where
admin admin 2.1 46
admin admin 5.1 47 * both iTrivio and Competent are fresh installations
Petr Blšťák 7.1 48 * login with the default iTrivio and Competent admin accounts were successfully tested
49 * Competent will be the main platform to handle course creation/deletion, user management and user-course management.
admin admin 2.1 50
Petr Blšťák 7.1 51 Contact Educasoft for specific configuration procedure in other, more complex scenarios (e.g. Competent is going to use existing iTrivio application already filled with course/user data).
Ondřej Steffl 3.1 52
Petr Blšťák 7.2 53 = Systems preparation =
54
55 In order for the two systems to work together, we first have to create the basic structures they will operate with - users, folders etc.
56
57 === __Competent__ ===
58
59 If you have both systems as a fresh installations and you will use them only throught the Competent system, you can skip this step and go to the iTrivio preparation.
60
61 1. We need to decide what subtypes we want to use for new Users and new Activites in the use case, when we would need to synchronize users and courses from iTrivio into Competent. This will not typically happen if you will use the systems as described above.
62 1*. If you want new Users and Activities to be of default subtype, you dont need to create anything.
63 1*. If you want new Users and Activities to be of some special subtype
64 1**. Log into Competent as the admin user
65 1**. switch to the Admin view
66 1**. go to the page Settings, to the tab Subtypes and create new subtypes for User and Activity (click on the green plus icon, fill in the new subtype name and hit the Create button).
67 1. Furthermore we need to create a folder, that would hold all the iTrivio courses in case of synchronization from iTrivio, so
68 1*. Log into Competent as the admin user and switch to the Admin view (if you didn't already)
69 1*. Go to the Competent page Activities and create a new folder named for example iTrivio Courses (click on the green plus icon, choose Folder, fill in it's name and click Save).
70
71 === __iTrivio__ ===
72
73 Here we need to create the users that will manipulate iTrivio courses and a folder to store them.
74
75 1. Log into iTrivio as admin user and go to the **Courses & Tests**
76 1. **Create a new folder** named for example Competent courses - this is where all your courses will be stored
77 1. Go to **Administration **to the section **Users**
78 1. **Create new user** that will be responsible for manipulating all objects in iTrivio (courses and users). Fill just his email, name and surename.
79 1. Optionally you can create another new user that will be responsible only for creating new users in iTrivio
80 1. Go to the **Usergroups administration** and create new usergroup (for ecample Competent users) - this is where all your new users will be assigned.
81
82 === __Databases__ ===
83
84 Now we need to write down IDs of all the objects we just created (and some more).
85
86 1. In __Competent__ database, in the table __subtype__ write down
87 1*. **USER_SUBTYPE **(by default 1) = subtype ID of the default_user (column "name") or if you created a specific subtype, find it by its name and write down it's ID
88 1*. **ACTIVITY_SUBTYPE **(by default 2) = subtype ID of the default_timeless_activity (column "name") that has "activity_type_id" = 1. If you created a specific subtype, find it by its name and write down it's ID
89 1. In __Competent__ database, in the table activity_set write down
90 1*. **CMP_ACTIVITY_FOLDER **= ID of the folder you created for new itrivio courses (fing by name in the column "name")
91
Ondřej Steffl 3.1 92 = Competent part =
93
94
95 in application.properties, or in your own application-yourNameShortcut.properties file set the following propeties:
96
97 * **competentItrivioIntegration.enabled=true**
98 //(true to allow the connection between apps)//
99 * **competentItrivioIntegration.itrivioCompanyUrlContext=/test**
100 //(url name of the company for which you are setting the connection, leave empty if the only company is the root)//
101 * **competentItrivioIntegration.url=http:~/~/localhost:8080/**
102 //(url of the iTrivio app)//
103 * **competentItrivioIntegration.linkUrl=http:~/~/127.0.0.1:8080**
104 //(probably the same as above, this will be the url where the iTrivio courses will run, leave out the final slash! or the course address will show wrong)//
105 * **competentItrivioIntegration.itrivioCompanyId=1**
106 //(Id of the company you are setting it for)//
107 * **competentItrivioIntegration.userCreatorItrivioUserId=2**
108 //(ID of the user - existing in the system - in whos name the courses will be created. Someone with Admin roles)//
109 * **competentItrivioIntegration.newUserSubtypeId=1**
110 //(ID of subtype of user in Competent? - for when creating new users - probably)//
111 * **competentItrivioIntegration.newActivitySubtypeId=2**
112 //(ID of subtype of Activity? - when creating new activities - probably)//
113 * **competentItrivioIntegration.newActivityTargetFolderId=20**
114 //(ID of folder in iTrivio in which to create new Activites)//
115 * **competentItrivioIntegration.auth.userId=2**
116 //(ID of user in whose name the authorisation of running the course will be done?)//
admin admin 5.1 117 * **competentItrivioIntegration.auth.key=**
Ondřej Steffl 3.1 118 //(secret key for JWT token)//
119 * **competentItrivioIntegration.auth.environment=demo**
120 //(authentication environment, used in JWT token I think)//
121
122 = iTrivio part =
123
124
125 Run the url [[http:~~/~~/localhost:8080/(companyUrl/)setCompanyConfig.html>>url:http://localhost:8080/setCompanyConfig.html?locale=cs]] of course on the domain your iTrivio runs and with the companyUrl of the comany you are setting this for.
126
127 Fill in the settings COMPETENT_INTEGRATION_:
128
129 * **COMPETENT_INTEGRATION_ENABLED**// (set to true)//
130 * **COMPETENT_INTEGRATION_TARGET_FOLDER_ID **//(ID of folder in iTrivio in which to create new Activites)//
131 * **COMPETENT_INTEGRATION_API_URL **//(url where competent is running eg.: //[[http:~~/~~/localhost:9000/>>url:http://localhost:9000/]]//)//
132 * **COMPETENT_INTEGRATION_USERGROUP_ID **//(ID of usergroup in iTrivio in which new users will be created)//
133 * **COMPETENT_INTEGRATION_COURSE_TEMPLATE **//(optional - ID of course template in which new courses will be created)//
134
admin admin 4.1 135 //(Save the settings... )//
Ondřej Steffl 3.1 136
137 Now open the file /com.itrivio/src/main/resources/settings.properties and set the two following properties:
138
139 **environment.id=croco**// (must match the **competentItrivioIntegration.auth.environment** property from Competent)//
140 **jwt.key=CCzzzQYDR1HTdfe67zoa **//(must match the **competentItrivioIntegration.auth.key** property from Competent)//
141
142 = Final setting test =
143
144 Thats it, you should be good to go. Now run both Apps, DO NOT TOUCH ITRIVIO FROM NOW ON. Go to Competent, create some Activity and in Detail, set the RUN_TYPE (Typ spouštění) to iTrivio, then select in type and hit **Save and Create in iTrivio** button. If it works, you are almost good to go. Now try to Edit the course, add one page and then try to run it. if THAT works, you are all set.