merge request id	709
Titel	MyCompetence API Integration
Beschreibung	Bei diesem PR handelt es sich um die Integration der MyCompetence v2 API in die UWL. ## Setup Damit UWL mit der MyCompetence API kommunizieren kann, muss ein "Master API Key" erzeugt und konfiguriert werden. Dieser API Key wird anschließend genutzt um die UWL Mandanten als Affiliates bei MyCompetence zu erzeugen, darüber Buchungen auszuführen, Reports zu ziehen, usw. Nachdem man auf MyCompetence einen neuen Affiliate mit der v2 API angelegt hat, muss man die Daten in der `.env` Datei konfigurieren. Beispiel: ``` MYCOMPETENCE_KEY="15|B8LN0QMIOX64m4GOFz78f2HycKmGEF5I9pzcxWUC" MYCOMPETENCE_API_URL=https://mycompetence.test/api/v2 ``` Im Hauptmenü gibt es nun einige neue Menüpunkte, für die man individuelle Berechtigungen benötigt. ## Fortbildungen Der Menüpunkt Fortbildung verlinkt auf den MyCompetence Katalog, welcher über die API integriert ist. Über die MyCompetence API Integration kann nun der Katalog durchsucht und gefiltert werden. Der Einzelpreis eines Trainings wird mit auf der Kachel angezeigt.  ### Offene Fragen Aktuell ist hier noch die gleiche "Nur Vorschau" Banner Logik integriert. Benötigen wir das hier? Für die eigentliche Buchung wird das aktuell nicht berücksichtigt - die Buchungsprüfung steckt aktuell nur hinter einem Permission check. ## Fortbildungen - Detailseite Wählt man nun eine Fortbildung aus, kommt man auf die Detailseite. Auch diese Daten werden alle live über die API gezogen.  Die Zuweisung der Benutzer und Gruppen erfolgt wie bisher auch. Der einzige Unterschied ist, dass nun über die MyCompetence Warenkorb API ein Warenkorb mit dem Training mit der Anzahl der ausgewählten Benutzer (die das Training noch nicht zugewiesen haben) erzeugt wird. Die Preise des Warenkorbs werden anschließend angezeigt.  ### Offene Fragen Wie soll der "Warenkorb" genau aussehen? ## Meine Fortbildungen Hier werden alle MyCompetence Trainings aufgelistet, die dem aktuell eingeloggten Benutzer zugewiesen wurden.  ## Meine Fortbildungen Detailseite Hier hat der Benutzer die Möglichkeit die Fortbildungen zu starten.  Sobald das Training gestartet wird, öffnet sich der UCP mit der MyCompetence Seite. Der Benutzer ist sofort eingeloggt und innerhalb MyCompetence (im iframe) öffnet sich ebenfalls sofort der UCP. ## "MyCompetence Orders" Hierüber können alle getätigten Bestellung eingesehen werden. Der Report kann nach Mandant und Zeitraum gefiltert werden.  ### Offene Fragen: Wie soll der Export aussehen? Welche Felder sollen dort drin stehen? Reichen die Daten? ## "Training Requests" Wenn ein Benutzer nicht die Berechtigung hat ein Training selbst zu buchen, kann er dieses anfragen.  Hier fehlen noch einige Texte bzw. grundsätzlich ein Layout. Nachdem ein Training angefragt wurde, sieht der Supervisor des Mandanten die Anzahl der offenen Anfragen im Menü.  Die Detailansicht hiervon sieht aktuell so aus:  ### Offene Fragen Wie soll der Freigabeprozess aus dem Backend ablaufen? Was passiert wenn man den Prozess ableht?
Status	merged
Created at	2022-12-01T14:05:41.437Z
Updated at	2023-02-06T08:17:03.558Z
Source branch	feature/mycompetence-api-integration
Target branch	develop
Author	Marcel Pociot
Assignee	Sascha Immig

Discussion notes

added 1 commit 965c10b2 - Show training name in request table list Compare with previous version	Marcel Pociot	2022-12-01T15:11:27.681Z
added 1 commit ae86548e - Remove preview text Compare with previous version	Marcel Pociot	2022-12-14T11:26:48.096Z
added 1 commit 5388d338 - Place myc order when accepting a training request Compare with previous version	Marcel Pociot	2022-12-14T11:53:47.683Z
# Rückfragen zu MyCompetence Orders # > Wie soll der Export aussehen? Welche Felder sollen dort drin stehen? Reichen die Daten? 1) Sichtbarkeit: * Der Report "MyCompetence Orders" soll auch für Clients sichtbar sein. * Ein Client sieht immer nur seine Buchungen. * Bitte mittels eigenem Recht (für die Nutzung in Rollen) die Sichtbarkeit gewähren. 2) Anpassungen: * Spalte "Gesamtpreis" soll "Listenpreis" heißen * Spalte "Unterweisung" soll "Fortbildung" heißen. (Gleiches Wording wie in der Anzeige des Katalogs.) * Sortierung nach "Fortbildung" und "Mandant" hinzufügen 3) neue Spalten: * Spalte "Teilnehmer" mit Namen in UWL hinter "Mandant" als neue Spalte 2 einfügen. * Spalte "Benutzer MYC" hinter "Teilnehmer" als neue Spalte 2 einfügen. Diese Spalte ist nicht für Clients sichtbar * Spalte "TrainingsID" mit ID auf MYC hinter "Fortbildung" einfügen. Die Spalte ist nicht für Client sichtbar. * Spalte "Trainingsstand" mit Fortschritts-Status aus MYC am Ende als letzte Spalte einfügen. 4) Filter: * Zeitraum-Filter bitte als "von / bis" mit ´daterangepicker´ umbauen. (Inkl. Kalender für Benutzerdefinierten Zeitraum) * Filter "Mandant" soll ein `selectize` sein um tippen und suchen zu ermöglichen. Der Filter "Mandant" ist nicht für Clients verfügbar.	Sascha Immig	2023-01-06T07:04:07.220Z
# Rückfragen zu Training Requests # > Wie soll der Freigabeprozess aus dem Backend ablaufen? Was passiert wenn man den Prozess ablehnt? 1) Benachrichtigung * Es wird der Request immer an die direkt vorgesetzte Person gestellt. Existiert diese nicht (nicht vorhanden oder dauerhaft deaktiviert), so wird in der OE-Hierarchie die nächsthöhere vorgesetzte Person informiert. * Final wird - wenn keine vorgesetzte Personen gefunden werden (z.B. wenn im Mandant keine OE-Strukturen angelegt sind) der Client-Admin informiert. * Die Benachrichtigung erfolgt im System und via Mail. * Mail über neuen Request an die vorgesetzte Person soll einen Direktlink zur Liste der Request enthalten. * _Ist die direkte Annahme / Ablehnung des Request aus der Mail heraus möglich?_ 2) Freigabeprozess: * Annehmen löst direkt die Order in MYC aus und benachrichtigt den Mitarbeiter * Ablehnen setzt den Status des Request und benachrichtigt den Mitarbeiter * MA erhält eine Mail / Notification, sowohl bei Annahme als auch bei Ablehnung. ("Bei Rückfagen wenden sie sich bitte direkt an XY.") * Annahme-Mail soll ähnlich wie die Mail zu "neues Training zugewiesen" aufgebaut sein und einen direkten Link zur Fortbildung enthalten * Berechtigte Personen haben statt Request eine Buchungsmaske * die Person kann für die eigenen "Untergebenen" und sich selber direkt buchen. (Multiple Auswahl von Nutzern) * hier ist keine weitere Freigabe notwendig. 3) Layout: * Hilfetext zum Anfragen von Fortbildungen soll den/die Namen des/der benachrichtigten vorgesetzten Person im Text (ähnlich wie bei Trainingsrückfragen) enthalten. Genaues Wording folgt noch. 4) Detailansicht der Requests: * Listenpreis aufnehmen * "Unterweisung" soll "Fortbildung" heißen * neuer Filter "Mitarbeiter" als `selectize` um tippen und suchen zu ermöglichen. * Wording auf den Buttons.	Sascha Immig	2023-01-06T07:52:11.187Z
added 2 commits 7d8faab6 - request and reporting modifications 873c87d7 - Properly decode hashids Compare with previous version	Marcel Pociot	2023-01-23T12:35:23.173Z
added 389 commits 873c87d7...18e00769 - 383 commits from branch develop 44659960 - use a default date range, show reports in the menu for clients/users as well 5f1d3076 - Merge branch 'develop' into feature/mycompetence-api-integration 112da9f3 - add return types 12525abb - Merge branch 'develop' into feature/mycompetence-api-integration 41470069 - fix menu, apply code style f37eed11 - create new language file for myc specific translations Compare with previous version	Marcel Pociot	2023-02-01T12:09:19.985Z
added 1 commit c7cfb5b5 - Update permissions and laroute Compare with previous version	Marcel Pociot	2023-02-02T11:47:55.101Z
added 1 commit f7f7b4f7 - add selectize filter Compare with previous version	Marcel Pociot	2023-02-02T11:59:14.717Z
added 2 commits c3cf746d - added english translation and corrected wording from training / Unterweisung to… 88bbad73 - updated localization for regualr training catalog according to scheme from mycompetence courses Compare with previous version	Sascha Immig	2023-02-03T10:57:55.334Z
added 1 commit 2e6abf38 - restored accidently deleted quote mark Compare with previous version	Sascha Immig	2023-02-03T11:15:05.674Z
added 1 commit 61e6c6a1 - removed spare quote mark Compare with previous version	Sascha Immig	2023-02-03T12:06:03.453Z
merged	Sascha Immig	2023-02-06T08:17:03.676Z
mentioned in commit 0ce0908f3bfdd3aa9403f61dee1c109bb958acf4	Sascha Immig	2023-02-06T08:17:04.083Z

Merge Commits

Title	Id	Author	Created at	Message
add return types	112da9f3373c7c6fd6fa46441a47c8ddd0649f20	Marcel Pociot	2023-02-01T09:57:09.000Z	add return types
Merge branch 'develop' into feature/mycompetence-api-integration	12525abbfc459da3c199c1e9049a218649336ef9	Marcel Pociot	2023-02-01T09:57:28.000Z	Merge branch 'develop' into feature/mycompetence-api-integration
restored accidently deleted quote mark	2e6abf38f71f4362ffb7dfed17b4d7442f6f7c3d	TUV\immigs	2023-02-03T10:59:33.000Z	restored accidently deleted quote mark
fix menu, apply code style	41470069c31b9f8e9828ad2eb9dbeb6d7f35f452	Marcel Pociot	2023-02-01T10:21:03.000Z	fix menu, apply code style
use a default date range, show reports in the menu for clients/users as well	44659960842c2061ff528046c33e472810988d00	Marcel Pociot	2023-02-01T09:03:03.000Z	use a default date range, show reports in the menu for clients/users as well
Place myc order when accepting a training request	5388d338d9b44df42a06711830de95ca66a25770	Marcel Pociot	2022-12-14T11:53:36.000Z	Place myc order when accepting a training request
Merge branch 'develop' into feature/mycompetence-api-integration	5f1d307696e6ba137106cb0ef6519ed32031bf09	Marcel Pociot	2023-02-01T09:56:55.000Z	Merge branch 'develop' into feature/mycompetence-api-integration
removed spare quote mark	61e6c6a129fedba0441d37400f4dbfb948d8e87e	TUV\immigs	2023-02-03T12:05:51.000Z	removed spare quote mark
request and reporting modifications	7d8faab6ffae7efcba54924d347b58bee8cf9642	Marcel Pociot	2023-01-18T13:24:51.000Z	request and reporting modifications
Add placeholder to .env.example	868d316d22de3939077deb089c09687fed9453fc	Marcel Pociot	2022-12-01T13:32:36.000Z	Add placeholder to .env.example
Properly decode hashids	873c87d7bc1c2c8dcf73cd5bfdd2c00e2e2ce74c	Marcel Pociot	2023-01-23T12:35:07.000Z	Properly decode hashids
updated localization for regualr training catalog according to scheme from mycompetence courses	88bbad73456ac250e33a37a9f76273bc58bb3b4f	TUV\immigs	2023-02-03T10:57:42.000Z	updated localization for regualr training catalog according to scheme from mycompetence courses
Show training name in request table list	965c10b24ade4e7f221c65f1e836a64b0ac6f875	Marcel Pociot	2022-12-01T15:11:17.000Z	Show training name in request table list
Remove preview text	ae86548e109929a8162436729d77681db20057c5	Marcel Pociot	2022-12-14T11:26:38.000Z	Remove preview text
ensure that myc_id is fillable	c10a67720e678d25d77c7f017c2d4411f1059272	Marcel Pociot	2022-12-01T13:43:09.000Z	ensure that myc_id is fillable
added english translation and corrected wording from training / Unterweisung to…	c3cf746d787cf2d3ec6b9a1566a29c374be85a61	TUV\immigs	2023-02-03T10:57:00.000Z	added english translation and corrected wording from training / Unterweisung to (additional) course / Fortbildung
Update permissions and laroute	c7cfb5b591748d1cffa8dda23346a2ef279a7e8f	Marcel Pociot	2023-02-02T11:47:40.000Z	Update permissions and laroute
Remove unneeded variable	e838a1df766e8cf13094a1100dd8335aedac7022	Marcel Pociot	2022-12-01T13:26:08.000Z	Remove unneeded variable
create new language file for myc specific translations	f37eed1129fd1658614bdeb8dde1bca3921f32eb	Marcel Pociot	2023-02-01T12:09:03.000Z	create new language file for myc specific translations
add selectize filter	f7f7b4f7dc687662cb60a9ba158d323eb13c8106	Marcel Pociot	2023-02-02T11:59:06.000Z	add selectize filter