Last modified by Petr Blšťák on 2024/09/18 11:55
From version < 33.1
edited by Petr Blšťák
on 2024/09/18 11:55
To version < 16.1 >
edited by Petr Blšťák
on 2020/04/30 10:52
<
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.//
... ... @@ -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.//
... ... @@ -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  
... ... @@ -85,7 +85,7 @@
85 85  1. __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 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")
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 90  1. __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")
... ... @@ -95,12 +95,10 @@
95 95  1*. **ADMIN_USER_CREATOR **(by default 2) = ID of the user that will be creating all the users in iTrivio
96 96  1. __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. __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
... ... @@ -122,23 +122,15 @@
122 122  #-# itrivio company url context, leave empty if company has no url context
123 123  competentItrivioIntegration.itrivioCompanyUrlContext=<COMPANY_URL>
124 124  
125 -#-# url of iTrivio app (for integration API communication -accessible from browser of users, rather use full eg: https://demo.competent.cz/)
122 +#-# url of iTrivio app (for integration API communication - accessible from Competent server location)
126 126  competentItrivioIntegration.url=http://localhost:8080/
127 127  
128 -#-# url of iTrivio app (for generating user links - accessible from browser of users, rather use full eg: https://demo.competent.cz/)
125 +#-# url of iTrivio app (for generating user links - accessible from browser of users)
129 129  competentItrivioIntegration.linkUrl=http://localhost:8080
130 130  
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=xxxsecret
194 194  {{/code}}
195 195  
196 196  = Final setting test =
197 197  
198 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.
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