Skip to Content

Wiki source code of Rimo Connector

Last modified by Dimitri Rupp on 2026/06/11 09:30
Show last authors
1 {{box cssClass="floatinginfobox" title="**On this page**"}}
2 {{toc/}}
3 {{/box}}
4
5 = Rimo Connector =
6
7 {{info}}
8 **Zweck:** Voll automatisierte Uebertragung von **MS-Daten** und **Dynamic Attributes** aus verschiedenen Quellen ueber Power BI an die **Rimo API**.
9 **Architektur:** Azure Function App + ADLS2 + Premium Power BI Workspace.
10 {{/info}}
11
12 == Infrastruktur ==
13
14 **Datenfluss:** Quelle → Power-BI-Datenaufbereitung → Rimo Connector (Azure Function App) → Rimo API
15
16 {{mermaid}}
17 flowchart LR
18 SRC[Quelle<br/>Excel / Datenbanken] -->|Power BI| DF[Premium Workspace<br/>Dataflow:<br/>'Rimo Connector' / 'Rimo Connector DynAttr']
19 DF -->|"CSV-Output"| ADLS[ADLS Gen2<br/>pro Projekt-Ordner]
20 ADLS -->|Function App lese| RC[Rimo Connector<br/>Azure Function App]
21 RC -->|"REST POST"| RA[Rimo API<br/>Prod / Test]
22 RC -.->|nach Verarbeitung| ARC[archive/-Ordner<br/>im ADLS]
23
24 classDef src fill:#e3f2fd,stroke:#1976d2,stroke-width:1px
25 classDef pbi fill:#fff3cd,stroke:#b85c00,stroke-width:1px
26 classDef azure fill:#bbdefb,stroke:#1976d2,stroke-width:1px
27 classDef rimo fill:#c8e6c9,stroke:#2e7d32,stroke-width:1px
28 class SRC,DF src
29 class ADLS,RC azure
30 class RA,ARC rimo
31 {{/mermaid}}
32
33 == Komponenten ==
34
35 === Quelle ===
36
37 Zu importierende Daten koennen aus **verschiedenen Quellen** kommen, solange sie per **Power BI** verarbeitet werden koennen — Excel, Datenbanken, etc.
38
39 === Datenaufbereitung in Power BI ===
40
41 In einem **Premium Workspace** muss ein **Dataflow** angelegt werden:
42
43 |=Use Case|=Dataflow-Name|=Query-Name
44 |MS-Import (Milestones)|(% style="font-family:monospace" %)Rimo Connector(%%)|(% style="font-family:monospace" %)Milestones(%%)
45 |Dynamische Attribute|(% style="font-family:monospace" %)Rimo Connector DynAttr(%%)|(% style="font-family:monospace" %)DynAttr(%%)
46
47 In dem Dataflow wird ein **Delta** zwischen den zu importierenden Daten **aus dem Kundensystem** und **Rimo** erstellt. Es sollen **nur Meilensteine / dyn. Attribute importiert** werden, die in Rimo **nicht gesetzt** sind, im Kundensystem aber Daten haben.
48
49 {{warning}}
50 **ACHTUNG! Dynamische Attribute muessen in Rimo aktiv sein**, um importiert werden zu koennen. Sind sie **inaktiv**, werden sie von der API **nicht gefunden**.
51 {{/warning}}
52
53 === Query-Format ===
54
55 Die Reihenfolge ist wichtig:
56
57 **Fuer Milestones (MS-Import):**
58
59 1. Externe ID SO
60 2. Externe ID MS
61 3. Timestamp Planned End (**Unix-Format**)
62 4. Timestamp End (**Unix-Format**)
63 5. Kommentar
64
65 **Fuer Dynamic Attributes:**
66
67 1. Externe ID SO
68 2. Technischer Dyn-Attr-Name
69 3. Value
70
71 Die **Namen der Header sind nicht relevant**, koennen aber bei der Wartung hilfreich sein — sprechende Header empfohlen.
72
73 Dieser Dataflow erzeugt im **ADLS2** ein (% style="font-family:monospace" %).csv(%%)-File, das vom Rimo Connector verarbeitet werden kann.
74
75 === Rimo Connector (Azure Function App) ===
76
77 * **Function App** in Azure.
78 * Daten werden nach der Datenaufbereitung in Power BI im **ADLS2** abgespeichert.
79 * Die Function App nimmt sich die Daten aus dem ADLS und schickt sie an die **Rimo API**.
80 * **Environment-Variablen** dienen zur **Steuerung** des Rimo Connectors:
81 ** Neue Projekte hinzufuegen / entfernen
82 ** Rimo-Authentifizierungs-User
83 ** Namen des Dataflow + Query, die vom Connector beruecksichtigt werden sollen
84 * **Verarbeitete Daten** werden archiviert — pro Projekt-Ordner im ADLS muss es einen (% style="font-family:monospace" %)archive(%%)-Unterordner geben.
85
86 Diese Konfiguration gilt **sowohl fuer Prod als auch fuer Test** — Unterschied: Env-Variables zeigen auf jeweilige API + Test-Dataflow. So koennen Prod und Test **separat behandelt** werden.
87
88 === Rimo API ===
89
90 |=Umgebung|=API-Dokumentation
91 |**Prod**|Rimo API (spl-tele.com)
92 |**Test**|Rimo API (spl-tele.com) — Test-Variante
93
94 Damit der **API-User**, welcher vom Rimo Connector verwendet wird, auf die benoetigten Projekte zugreifen kann, muss in **Rimo beim Userprofil das Projekt hinzugefuegt** werden — Doppelklick auf das Userprofil.
95
96 == Sonstiges ==
97
98 |=Bereich|=Ressource
99 |🗂️ **Mapping-File MS**|(% style="font-family:monospace" %)Projekte_MS Mapping.xlsx(%%)
100 |🗂️ **Mapping-File DynAttr**|(% style="font-family:monospace" %)Projekte_Dyn. Attr. Mapping.xlsx(%%)
101 |📊 **Monitoring**|//Rimo connector delta report// (Power BI) + //Rimo Connector Monitoring// (Power BI)
102
103 == Neues Projekt anlegen — Checkliste ==
104
105 1. **Mit PM abstimmen**, welche MS / Dyn. Attr. importiert werden sollen.
106 2. PM muss ggf. die **Logik bestimmen**, die benoetigt wird, um die richtigen Daten zu importieren.
107 3. **Dataflow fuer den Import** im Premium Workspace des Projekts erstellen — am besten einen bestehenden Dataflow **kopieren** und Sourcen / Mapping / projektspezifische Logik anpassen.
108 4. **Rimo Connector anpassen**: neues Projekt hinzufuegen + (% style="font-family:monospace" %)archive(%%)-Ordner erstellen.
109 5. **Rimo Connector User** in Rimo anpassen — Projekt im Userprofil hinzufuegen.
110
111 == Related pages ==
112
113 * [[Projektspezifische Arbeitsbereiche (Hub)>>doc:IT-Wiki.01-Data.Reporting.PowerBI.Projektspezifische-Arbeitsbereiche.WebHome]]
114 * [[Rimo connector dataflows>>doc:IT-Wiki.01-Data.Reporting.PowerBI.Projektspezifische-Arbeitsbereiche.Rimo-connector-dataflows.WebHome]] — konkrete Dataflows pro Projekt
115 * [[Rimo Lakehouse>>doc:IT-Wiki.01-Data.Ingestion.Bronze-Lakehouse.Rimo-Lakehouse.WebHome]]
116
117 ----
118
119 == Verwandte Themen ==
120
121 //Kuratiert — kann direkt im Editor ergänzt werden://
122
123 * [[70205063 Telefonica Richtfunk_2022>>doc:IT-Wiki.01-Data.Reporting.PowerBI.Projektspezifische-Arbeitsbereiche.70205063-Telefonica-Richtfunk-2022.WebHome]]
124 * [[Rimo connector dataflows>>doc:IT-Wiki.01-Data.Reporting.PowerBI.Projektspezifische-Arbeitsbereiche.Rimo-connector-dataflows.WebHome]]
125
126 {{include reference="IT-Wiki.Makros.Verwandte-Themen.WebHome"/}}
127
128 ----
129 **Status:** Migriert — Team-Review ausstehend · **Owner:** //(festlegen)// · **Letzter Review:** 2026-06-11