Version 6.1 by Ondřej Steffl on 2020/04/29 12:36
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
Ondřej Steffl 6.1 19 Integration of Competent with iTrivio provides features of both software merged and accessible through the Competent.
admin admin 5.1 20
Ondřej Steffl 6.1 21 When specific object is created in Competent, it is automatically created also in iTrivio. Competent then contains ID reference to its iTrivio counterpart.
admin admin 5.1 22
Ondřej Steffl 6.1 23 This applies to creation and deletion of
admin admin 5.1 24
Ondřej Steffl 6.1 25 * Users
26 * Courses (in Competent these are Activities with launch type iTrivio)
27 * User-Course assignments
28 * User-Course attempts
admin admin 5.1 29
Ondřej Steffl 6.1 30 iTrivio application is accessible only with specific links in Competent when
admin admin 5.1 31
Ondřej Steffl 6.1 32 * editing content of Course
33 * playing Course
34 * displaying specific User-Course reports
admin admin 5.1 35
Ondřej Steffl 6.1 36 The generated links to the iTrivio contains a one time auto-login security token which approves the current user's action in the iTrivio thus there is no need to the user to log in into the iTrivio. By default is password of an user in the iTrivio different (random) from his/hers Competent password to prevent direct access to the iTrivio. We recommend to disable iTrivio emailing and to keep iTrivio user's password secret to the user.
admin admin 5.1 37
Ondřej Steffl 6.1 38 (% class="box warningmessage" %)
39 (((
40 **Modifying iTrivio directly (out of Competent platform) can cause synchronization issues, especially when manipulating with Users, Courses, User-Course attempts and assignments.**
41 )))
admin admin 2.1 42
admin admin 5.1 43 This configuration describes the basic scenario where
admin admin 2.1 44
admin admin 5.1 45 * both iTrivio and Competent are fresh installations
46 * login with default iTrivio and Competent admin accounts were successfully tested
47 * Competent will be main platform to handle course creation/deletion, user management and user-course management.
admin admin 2.1 48
admin admin 5.1 49 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 50
51 = Competent part =
52
53
54 in application.properties, or in your own application-yourNameShortcut.properties file set the following propeties:
55
56 * **competentItrivioIntegration.enabled=true**
57 //(true to allow the connection between apps)//
58 * **competentItrivioIntegration.itrivioCompanyUrlContext=/test**
59 //(url name of the company for which you are setting the connection, leave empty if the only company is the root)//
60 * **competentItrivioIntegration.url=http:~/~/localhost:8080/**
61 //(url of the iTrivio app)//
62 * **competentItrivioIntegration.linkUrl=http:~/~/127.0.0.1:8080**
63 //(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)//
64 * **competentItrivioIntegration.itrivioCompanyId=1**
65 //(Id of the company you are setting it for)//
66 * **competentItrivioIntegration.userCreatorItrivioUserId=2**
67 //(ID of the user - existing in the system - in whos name the courses will be created. Someone with Admin roles)//
68 * **competentItrivioIntegration.newUserSubtypeId=1**
69 //(ID of subtype of user in Competent? - for when creating new users - probably)//
70 * **competentItrivioIntegration.newActivitySubtypeId=2**
71 //(ID of subtype of Activity? - when creating new activities - probably)//
72 * **competentItrivioIntegration.newActivityTargetFolderId=20**
73 //(ID of folder in iTrivio in which to create new Activites)//
74 * **competentItrivioIntegration.auth.userId=2**
75 //(ID of user in whose name the authorisation of running the course will be done?)//
admin admin 5.1 76 * **competentItrivioIntegration.auth.key=**
Ondřej Steffl 3.1 77 //(secret key for JWT token)//
78 * **competentItrivioIntegration.auth.environment=demo**
79 //(authentication environment, used in JWT token I think)//
80
81 = iTrivio part =
82
83
84 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.
85
86 Fill in the settings COMPETENT_INTEGRATION_:
87
88 * **COMPETENT_INTEGRATION_ENABLED**// (set to true)//
89 * **COMPETENT_INTEGRATION_TARGET_FOLDER_ID **//(ID of folder in iTrivio in which to create new Activites)//
90 * **COMPETENT_INTEGRATION_API_URL **//(url where competent is running eg.: //[[http:~~/~~/localhost:9000/>>url:http://localhost:9000/]]//)//
91 * **COMPETENT_INTEGRATION_USERGROUP_ID **//(ID of usergroup in iTrivio in which new users will be created)//
92 * **COMPETENT_INTEGRATION_COURSE_TEMPLATE **//(optional - ID of course template in which new courses will be created)//
93
admin admin 4.1 94 //(Save the settings... )//
Ondřej Steffl 3.1 95
96 Now open the file /com.itrivio/src/main/resources/settings.properties and set the two following properties:
97
98 **environment.id=croco**// (must match the **competentItrivioIntegration.auth.environment** property from Competent)//
99 **jwt.key=CCzzzQYDR1HTdfe67zoa **//(must match the **competentItrivioIntegration.auth.key** property from Competent)//
100
101 = Final setting test =
102
103 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.