Last modified by Petr Blšťák on 2024/09/18 11:55
From version < 32.1 >
edited by Ondřej Steffl
on 2024/09/13 07:01
To version < 13.1 >
edited by Petr Blšťák
on 2020/04/30 10:42
< >
Change comment: There is no comment for this version

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.osteffl
1 +XWiki.pblstak
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.//
... ... @@ -4,8 +4,9 @@
4 4  
5 5  ==== [[iTrivio 2.9.017>>doc:Main.Official manuals.iTrivio installation manual.WebHome]] ====
6 6  
7 -==== [[Competent 622>>doc:Main.Official manuals.Competent installation manual.WebHome]] ====
12 +==== [[Competent 33>>doc:Main.Official manuals.Competent installation manual.WebHome]] ====
8 8  
14 +
9 9  = Introduction =
10 10  
11 11  //On this page we use the term "Course" for both: course and test in iTrivio.//
... ... @@ -53,8 +53,8 @@
53 53  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.
54 54  
55 55  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.
56 -1*. If you want new Users and Activities to be of default subtype, you don't need to create anything.
57 -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
58 58  1**. Log into Competent as the admin user
59 59  1**. switch to the Admin view
60 60  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).
... ... @@ -61,7 +61,6 @@
61 61  1. Furthermore we need to create a folder, that would hold all the iTrivio courses in case of synchronization from iTrivio, so
62 62  1*. Log into Competent as the admin user and switch to the Admin view (if you didn't already)
63 63  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).
64 -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.
65 65  
66 66  === __iTrivio__ ===
67 67  
... ... @@ -73,34 +73,32 @@
73 73  1. Go to **Administration **to the section **Users**
74 74  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.
75 75  1. Optionally you can create another new user that will be responsible only for creating new users in iTrivio
76 -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.
77 77  
78 78  === __Databases info__ ===
79 79  
80 -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.
81 81  
82 -1. __Competent__ database, in the table __subtype__ write down
87 +1. In __Competent__ database, in the table __subtype__ write down
83 83  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
84 84  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
85 -1. __Competent__ database, in the table __activity_set__ write down
90 +1. In __Competent__ database, in the table __activity_set__ write down
86 86  1*. **ACTIVITY_FOLDER **(by default 1) = ID of the folder you created for new itrivio courses (find by name in the column "name")
87 -1. __iTrivio__ database, in the table __company__ write down
88 -1*. **COMPANY_ID **(by default 1) = ID of the company that will be synchronized with Competent (find by name in the column "name")
92 +1. In __iTrivio__ database, in the table __company__ write down
93 +1*. **COMPANY_ID **(by default 1) = ID of the company that will be synchornized with Competent (find by name in the column "name")
89 89  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")
90 -1. __iTrivio__ database, in the table __course__ write down
95 +1. In __iTrivio__ database, in the table __course__ write down
91 91  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")
92 -1. __iTrivio__ database, in the table __itrivio_user__ write down
97 +1. In __iTrivio__ database, in the table __itrivio_user__ write down
93 93  1*. If you skipped the steps 4) - 6) in iTrivio preparation and you are using fresh iTrivio instalation, just write down the default values
94 94  1*. **ADMIN_CREATOR **(by default 2) = ID of the user that will be creating all the users and courses in iTrivio
95 95  1*. **ADMIN_USER_CREATOR **(by default 2) = ID of the user that will be creating all the users in iTrivio
96 -1. __iTrivio__ database, in the table __usergroup__ write down
101 +1. In __iTrivio__ database, in the table __usergroup__ write down
97 97  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...?
98 98  
99 -Beside these ids from database you might need these two optional course ids:
100 -
101 -* **COURSE_TEMPLATE_ID** - a course id that will be used as a template for newly created courses.
102 -* **TEST_TEMPLATE_ID** - a test id for newly created tests
103 -
104 104  = Configuration =
105 105  
106 106  Now you can modify the systems configuration files, use the values written down from databases.
... ... @@ -107,14 +107,8 @@
107 107  
108 108  === __Competent__ ===
109 109  
110 -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:
111 111  
112 -* 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 (for editing your iTrivio courses).
113 -* Find the column external_id and instead of NULL fill in the **<ADMIN_CREATOR>** value.
114 -* 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.
115 -
116 -Now open the **application.properties** file and set the following propeties:
117 -
118 118  {{code language="properties"}}
119 119  #-# set to true if enabled
120 120  competentItrivioIntegration.enabled=true
... ... @@ -131,14 +131,6 @@
131 131  #-# integrated iTrivio db company ID
132 132  competentItrivioIntegration.itrivioCompanyId=<COMPANY_ID>
133 133  
134 -#-# iTrivio db course ID, which will be used as a template for new test
135 -# can be null, than the test will be empty
136 -competentItrivioIntegration.itrivioTestTemplateId=<COURSE_TEMPLATE_ID or EMPTY>
137 -
138 -#-# iTrivio db course ID, which will be used as a template for new course
139 -# can be null, than the course will be empty
140 -competentItrivioIntegration.itrivioCourseTemplateId=<TEST_TEMPLATE_ID or EMPTY>
141 -
142 142  #-# -------------- COMPETENT INTEGRATION ------------
143 143  #-# --- From Competent to iTrivio synchronization ---
144 144  
... ... @@ -152,7 +152,7 @@
152 152  competentItrivioIntegration.auth.environment=PROD
153 153  
154 154  #-# need to be same as "jwt.key" property in iTrivio "settings.properties" file
155 -competentItrivioIntegration.auth.key=SECRET_CODE_CHANGE_IT
144 +competentItrivioIntegration.auth.key=CHANGE_ME
156 156  
157 157  #-# -------------- COMPETENT INTEGRATION ------------
158 158  #-# --- From iTrivio to Competent synchronization ---
... ... @@ -177,7 +177,7 @@
177 177  * **COMPETENT_INTEGRATION_TARGET_FOLDER_ID** = <COURSE_FOLDER>
178 178  * **COMPETENT_INTEGRATION_API_URL **//(url where Competent is running eg.: //[[http:~~/~~/localhost:9000/>>url:http://localhost:9000/]]//)//
179 179  * **COMPETENT_INTEGRATION_USERGROUP_ID** = <USERGROUP>
180 -* **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
181 181  
182 182  Save the setting with the **Odeslat **button (nothing visible will happen, don't be worried, it was saved)
183 183  
... ... @@ -184,19 +184,19 @@
184 184  Now open the file "/com.itrivio/src/main/resources/settings.properties" and set the two following properties:
185 185  
186 186  {{code language="properties"}}
187 -# custom environment name, e.g. PROD,DEV,TEST...
188 -# (must match the competentItrivioIntegration.auth.environment property from Competent)
176 +# custom environment name, e.g. PROD,DEV,TEST... (must match the competentItrivioIntegration.auth.environment property from Competent)
189 189  environment.id=PROD
190 190  
191 191  # secret part of you JWT key - used for communication with the Competent system and creating auto-login links
180 +# see also jwt.expiration
192 192  # (must match the competentItrivioIntegration.auth.key property from Competent)
193 -jwt.key=SECRET_CODE_CHANGE_IT
182 +jwt.key=aaasssddd
194 194  {{/code}}
195 195  
196 196  = Final setting test =
197 197  
198 -* 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.
199 -* 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.
200 200  * Create an Activity (of whatever subtype) and go to it's tab Details
201 201  * Edit the Launch type property, set it to iTrivio and hit the Save and Create in iTrivio button
202 202  * If you get any errors, check the configuration if all is set properly