Wiki source code of 02 Spezifikation
Version 2.1 by Dimitri Rupp on 2026/06/11 11:00
Hide last authors
| author | version | line-number | content |
|---|---|---|---|
 |
1.1 | 1 | {{toc/}} |
| 2 | |||
| 3 | = BluePath — 02 Spezifikation = | ||
| 4 | |||
| 5 | == Akteure == | ||
| 6 | |||
| 7 | |=Rolle|=Identität|=Beteiligung | ||
| 8 | |Auftraggeber|Christian Richert|Sign-Off, Sponsor | ||
| 9 | |Ãœbergeordnet|David Planner (CDO)|Informiert | ||
| 10 | |Projektleiter|Dimitri Rupp|Bot-Bau, RIMO-User im PoC | ||
| 11 | |Heutiger manueller Bearbeiter|Olbrich, Miguel|Wird entlastet | ||
| 12 | |Absender HR-Mails|Linienmanager|Markovic, Kranawetter, … | ||
| 13 | |Empfänger HR-Mails|##it-support@spl-tele.com##|Postfach-Zugang erforderlich | ||
| 14 | |Bot-User PoC|ruppd (Dimitri)|Erfasser = Antragsteller | ||
| 15 | |||
| 16 | == Mail-Erkennungslogik == | ||
| 17 | |||
| 18 | Drei Bedingungen müssen alle erfüllt sein: | ||
| 19 | |||
| 20 | |=Filter|=Pattern|=BVL | ||
| 21 | |Subject|Regex ##^.*Personaleinstellung.*[A-Z][a-z]+ [A-Z][a-z]+.*\d{2}\.\d{2}\.\d{4}.*\$##|0.5 | ||
| 22 | |Sender-Domain|##@spl-tele.com## oder Konzern-Subdomain|0.5 | ||
| 23 | |Body enthält HTML-Tabelle|##<table>## mit mindestens 10 Zeilen|0.5 | ||
| 24 | |||
| 25 | Mails, die nur 1 oder 2 Filter erfüllen, gehen in Subordner ##Manual_Review##. | ||
| 26 | |||
| 27 | == Idempotenz-Schlüssel == | ||
| 28 | |||
| 29 | {{code language="text"}} | ||
| 30 | hash = SHA256(normalize(Subject) + "|" + InternetMessageId) | ||
| 31 | {{/code}} | ||
| 32 | |||
| 33 | Vor jeder Ticket-Erstellung prüft der Bot: | ||
| 34 | |||
| 35 | 1. UiPath-Queue: Existiert bereits ein Item mit diesem Hash und Status Successful? → Skip | ||
| 36 | 1. RIMO: Existiert bereits ein Ticket mit identischer Bezeichnung? → Skip + Mail nach Verarbeitet | ||
| 37 | |||
| 38 | == UI-Automation — 10 Schritte == | ||
| 39 | |||
| 40 | |=#|=Aktion|=UI-Element|=Anchor|=BVL | ||
| 41 | |1|Sidebar links anklicken|Ticket erstellen Button|Sichtbarer Text + grünes Plus-Icon|1 | ||
| 42 | |2|Modal-Bestätigung|OK-Button (grün)|Text OK im Modal Bestätigen|1 | ||
| 43 | |3|Warten auf Editor-Öffnung|Editor-Header mit neuer RI-Nummer|Text RI26.*, (ProductTicket)|1 | ||
| 44 | |4|Vertrag-Dropdown → IT Support|Combobox *Vertrag|Label-Text *Vertrag als Anchor|1 | ||
| 45 | |5|Bezeichnung füllen|Textfeld *Bezeichnung|Label-Text *Bezeichnung als Anchor|1 | ||
| 46 | |6|HTML-Tabelle in Text-Editor einfügen|Rich-Text-Editor *Text|Label-Text *Text als Anchor|0.5 | ||
| 47 | |7|Speichern|Button Speichern [s]|Sichtbarer Text|1 | ||
| 48 | |8|Warten auf Erfolgs-Indikator|Editor-Bearbeitungs-Modus|Tag-Icon klickbar|0.5 | ||
| 49 | |9|Tag-Icon → Eintritt Mitarbeiter → OK|Tag-Icon + Modal Select tag|Modal-Header Select tag|0.5 | ||
| 50 | |10|Final speichern|Speichern [s] Button|Sichtbarer Text|1 | ||
| 51 | |||
| 52 | == Werte für Pflichtfelder == | ||
| 53 | |||
| 54 | |=Feld|=Wert | ||
| 55 | |*Vertrag|IT Support | ||
| 56 | |*Bezeichnung|Personaleinstellung <Vorname> <Nachname> <DD.MM.YYYY> | ||
| 57 | |*Text|HTML-Tabelle aus Mail-Body | ||
| 58 | |Priority|Kleiner Fehler (Default, kein Eingriff) | ||
| 59 | |Tag|Eintritt Mitarbeiter | ||
| 60 | |||
| 61 | == Erst-Kommentar-Marker == | ||
| 62 | |||
| 63 | Jedes Bot-Ticket erhält am Anfang des Text-Felds: | ||
| 64 | |||
| 65 | {{code language="text"}} | ||
| 66 | [BluePath-Bot v1.0 — automatisch erfasst am 2026-05-21 14:39, Mail-Hash a3f2…] | ||
| 67 | |||
| 68 | (Original-Mail-Body folgt unverändert) | ||
| 69 | {{/code}} | ||
| 70 | |||
| 71 | == Fehler-Behandlung == | ||
| 72 | |||
| 73 | === Business-Exceptions === | ||
| 74 | |||
| 75 | |=Situation|=Aktion|=Mail-Ziel | ||
| 76 | |Subject erfüllt Pattern nicht|Ignorieren (bleibt ungelesen)|Inbox | ||
| 77 | |Mail hat keine HTML-Tabelle|BusinessException|Manual_Review | ||
| 78 | |Pflichtfelder leer in Tabelle|BusinessException|Manual_Review | ||
| 79 | |Doppeltes Ticket erkannt|Skip|Verarbeitet | ||
| 80 | |||
| 81 | === System-Exceptions === | ||
| 82 | |||
| 83 | |=Situation|=Aktion|=Retry | ||
| 84 | |RIMO nicht erreichbar|5 Min warten, retry|3x | ||
| 85 | |SSO-Session abgelaufen|Login-Sequenz, retry|1x | ||
| 86 | |Selektor-Timeout|Sleep 30s, retry|2x | ||
| 87 | |Editor reagiert nicht|Refresh, retry|1x | ||
| 88 | |Tag-Modal öffnet nicht|Adaptive Card an Dimitri|0x | ||
| 89 | |||
| 90 | == Offene Punkte == | ||
| 91 | |||
| 92 | |=#|=Offen|=Wer klärt|=Bis wann | ||
| 93 | |O-01|HR-Mail-Subject-Pattern bestätigen|Dimitri nach Postfach-Zugang|2026-05-22 | ||
| 94 | |O-02|Strg+V-Paste-Verhalten im RIMO-Editor|Dimitri (30-Sek-Test)|heute oder morgen | ||
| 95 | |O-03|MFA-Status für ruppd (Bot-Login)|Dimitri/IT|2026-05-22 | ||
| 96 | |O-04|Postfach-Subordner anlegen|Dimitri/IT|2026-05-22 | ||
| 97 | |O-05|Adaptive-Card-Webhook-URL|Dimitri|2026-05-23 | ||
| 98 | |||
| 99 | ---- | ||
| 100 | **Maintainer:** Dimitri Rupp · **Erstellt:** 2026-05-21 · **Version:** v0.1 | ||
| 101 | |||
| 102 | ---- | ||
| 103 | |||
| 104 | == Verwandte Themen == | ||
| 105 | |||
| 106 | //Kuratiert — kann direkt im Editor ergänzt werden:// | ||
| 107 | |||
| 108 | * [[01 README>>doc:IT-Wiki.02-Tools.UiPath.BluePath.01-README.WebHome]] | ||
| 109 | * [[03 UiPath Projektstruktur>>doc:IT-Wiki.02-Tools.UiPath.BluePath.03-Projektstruktur.WebHome]] | ||
| 110 | |||
| 111 | {{include reference="IT-Wiki.Makros.Verwandte-Themen.WebHome"/}} | ||
| 112 | |||
| 113 | ---- | ||
| 114 | **Status:** Migriert — Team-Review ausstehend · **Owner:** //(festlegen)// · **Letzter Review:** 2026-06-11 | ||
| 115 |