From version < 19.1 >
edited by Petr Blšťák
on 2020/04/30 14:10
To version < 12.1 >
edited by Petr Blšťák
on 2020/04/30 10:40
< >
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -1,3 +1,8 @@
1 +(% class="box errormessage" %)
2 +(((
3 +This section is currently under construction... please wait until is finished
4 +)))
5 +
1 1  = Software to be installed =
2 2  
3 3  //Unless stated otherwise, newer stable versions of the program should work.//
... ... @@ -9,11 +9,11 @@
9 9  
10 10  = Introduction =
11 11  
12 -//On this page we use the term "Course" for both: course and test in iTrivio.//
17 +//On this page we use the term "course" for both: course and test in iTrivio.//
13 13  
14 14  The integration of Competent and iTrivio provides features from both softwares merged together and accessible through Competent.
15 15  
16 -When specific objects are created (and deleted) in Competent, they are automatically created (and deleted) in iTrivio as well. Competent stores the ID references to the iTrivio objects in it's database.
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 it's database.
17 17  
18 18  This applies to creation of:
19 19  
... ... @@ -54,8 +54,8 @@
54 54  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.
55 55  
56 56  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.
57 -1*. If you want new Users and Activities to be of default subtype, you don't need to create anything.
58 -1*. If you want new Users and Activities to be of some other subtype
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
59 59  1**. Log into Competent as the admin user
60 60  1**. switch to the Admin view
61 61  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).
... ... @@ -62,7 +62,6 @@
62 62  1. Furthermore we need to create a folder, that would hold all the iTrivio courses in case of synchronization from iTrivio, so
63 63  1*. Log into Competent as the admin user and switch to the Admin view (if you didn't already)
64 64  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).
65 -1. If you want some other user than the default Competent admin to be able to edit the iTrivio courses, create this user. Note that this user should have appropriate admin rights. We recommend to use the default admin for now.
66 66  
67 67  === __iTrivio__ ===
68 68  
... ... @@ -74,28 +74,31 @@
74 74  1. Go to **Administration **to the section **Users**
75 75  1. **Create new user** that will be responsible for manipulating all objects in iTrivio (courses and users). Fill just his email, name and surename and assign him the role Administrator.
76 76  1. Optionally you can create another new user that will be responsible only for creating new users in iTrivio
77 -1. Go to the **Usergroups administration** and create new usergroup (for example Competent users) - this is where all your new users will be assigned.
81 +1. Go to the **Usergroups administration** and create new usergroup (for ecample Competent users) - this is where all your new users will be assigned.
78 78  
79 79  === __Databases info__ ===
80 80  
81 -Now we need to write down IDs of all the objects we just created (and some more). If you have both systems as fresh installations, you did not create any specific subtypes in Competent and users in iTrivio, you can just use the default values from brackets.
85 +Now we need to write down IDs of all the objects we just created (and some more). If you have both systems fresh installations, you did not create any specific subtypes in Competent and users in iTrivio, you can just use the default values from brackets.
82 82  
83 -1. __Competent__ database, in the table __subtype__ write down
87 +1. In __Competent__ database, in the table __subtype__ write down
84 84  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
85 85  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
86 -1. __Competent__ database, in the table __activity_set__ write down
90 +1. In __Competent__ database, in the table __activity_set__ write down
87 87  1*. **ACTIVITY_FOLDER **(by default 1) = ID of the folder you created for new itrivio courses (find by name in the column "name")
88 -1. __iTrivio__ database, in the table __company__ write down
92 +1. In __iTrivio__ database, in the table __company__ write down
89 89  1*. **COMPANY_ID **(by default 1) = ID of the company that will be synchornized with Competent (find by name in the column "name")
90 90  1*. **COMPANY_URL **(by default empty) = value from the column "urlContext" of the company that will be synchornized with Competent (find by name in the column "name")
91 -1. __iTrivio__ database, in the table __course__ write down
95 +1. In __iTrivio__ database, in the table __course__ write down
92 92  1*. **COURSE_FOLDER **(by default 1) = ID of the folder that you created for new courses created from Competent (find by name in the column "name")
93 -1. __iTrivio__ database, in the table __itrivio_user__ write down
97 +1. In __iTrivio__ database, in the table __itrivio_user__ write down
94 94  1*. If you skipped the steps 4) - 6) in iTrivio preparation and you are using fresh iTrivio instalation, just write down the default values
95 95  1*. **ADMIN_CREATOR **(by default 2) = ID of the user that will be creating all the users and courses in iTrivio
96 96  1*. **ADMIN_USER_CREATOR **(by default 2) = ID of the user that will be creating all the users in iTrivio
97 -1. __iTrivio__ database, in the table __usergroup__ write down
101 +1. In __iTrivio__ database, in the table __usergroup__ write down
98 98  1*. **USERGROUP **(by default 1) = ID of the usegroup that all your new users will be assigned to
103 +1. In __iTrivio__ database, in the table __playerskintemplate__ write down
104 +1*. **PLAYER_TEMPLATE **(by default 1) = ID of the player that will play your iTrivio courses (this is optional as the system has a default player)
105 +1. **TODO - IMPORTANT BUT CHECK WITH ONDREJ** - manually connect the two admins in Competent DB by external ID??? And generally who can EDIT the courses...?
99 99  
100 100  = Configuration =
101 101  
... ... @@ -103,14 +103,8 @@
103 103  
104 104  === __Competent__ ===
105 105  
106 -First we need to manually connect the first two users:
113 +In the application.properties, or in your own application-yourNameShortcut.properties file set the following propeties:
107 107  
108 -* Go to the Competent database once more, to the table __user_mt__ and find either the default Competent admin (by login "admin" and typically it will be the user with ID=1) or the other user you created in the Competent preparation step, to edit your iTrivio courses.
109 -* Find the column external_id and instead of NULL fill in the <ADMIN_CREATOR> value.
110 -* For now, this user will be the **only one** in your company that will be able to edit the iTrivio courses. Other users with appropriate rights can only create/delete/run them.
111 -
112 -Now open the **application.properties** file and set the following propeties:
113 -
114 114  {{code language="properties"}}
115 115  #-# set to true if enabled
116 116  competentItrivioIntegration.enabled=true
... ... @@ -165,7 +165,7 @@
165 165  * **COMPETENT_INTEGRATION_TARGET_FOLDER_ID** = <COURSE_FOLDER>
166 166  * **COMPETENT_INTEGRATION_API_URL **//(url where Competent is running eg.: //[[http:~~/~~/localhost:9000/>>url:http://localhost:9000/]]//)//
167 167  * **COMPETENT_INTEGRATION_USERGROUP_ID** = <USERGROUP>
168 -* **COMPETENT_INTEGRATION_COURSE_TEMPLATE** = //leave this option blank, for now it has no effect on the system//
169 +* **COMPETENT_INTEGRATION_COURSE_TEMPLATE** = <PLAYER_TEMPLATE> TODO This doesn't seem to have any effect
169 169  
170 170  Save the setting with the **Odeslat **button (nothing visible will happen, don't be worried, it was saved)
171 171  
... ... @@ -178,13 +178,13 @@
178 178  # secret part of you JWT key - used for communication with the Competent system and creating auto-login links
179 179  # see also jwt.expiration
180 180  # (must match the competentItrivioIntegration.auth.key property from Competent)
181 -jwt.key=xxxsecret
182 +jwt.key=aaasssddd
182 182  {{/code}}
183 183  
184 184  = Final setting test =
185 185  
186 -* Now run (or restart) both Systems, **but from now on do not touch iTrivio **apart from making changes in the course creator tool when redirected there from Competent.
187 -* Log into Competent (as the user able to edit iTrivio courses), go to the Admin view to the Activities page.
187 +* Now run both Apps, **but do not touch iTrivio app** apart from making changes in the course creator tool when redirected there from Competent.
188 +* Log into Competent, go to the Admin view to the Activities page.
188 188  * Create an Activity (of whatever subtype) and go to it's tab Details
189 189  * Edit the Launch type property, set it to iTrivio and hit the Save and Create in iTrivio button
190 190  * If you get any errors, check the configuration if all is set properly