📖 Dokumentation & Hilfe

Alles was Sie über ProjRadar wissen müssen - von der Installation bis zur Konfiguration.

🚀 Installation ⚙️ Konfiguration ✨ Features ❓ FAQ

🚀 Installation

Schritt 1: Package herunterladen

Laden Sie das aktuelle ProjRadar Package herunter:

📥 Zum Download

Schritt 2: App-Katalog

Öffnen Sie Ihren SharePoint App-Katalog:

https://IHRTENANT.sharepoint.com/sites/AppCatalog

Falls noch nicht vorhanden, erstellen Sie einen App-Katalog über:

SharePoint Admin Center → More features → Apps → App Catalog → Create a new app catalog site

Schritt 3: Package deployen

  1. Navigieren Sie zu: Apps for SharePoint
  2. Laden Sie die project-radar.sppkg hoch
  3. Aktivieren Sie: "Make this solution available to all sites in the organization"
  4. Klicken Sie auf "Deploy"
  5. Bestätigen Sie die Berechtigungen

Schritt 4: WebPart hinzufügen

  1. Öffnen Sie eine SharePoint-Seite
  2. Klicken Sie auf "Edit"
  3. Klicken Sie auf "+" um ein WebPart hinzuzufügen
  4. Suchen Sie nach "ProjRadar"
  5. Fügen Sie das WebPart zur Seite hinzu

⚙️ Konfiguration

Lizenzschlüssel eintragen

  1. Öffnen Sie das Property Pane (⚙️ Icon rechts)
  2. Tragen Sie Ihren Lizenzschlüssel ein
  3. Der Schlüssel wird automatisch validiert
💡 Tipp: Sie haben noch keinen Lizenzschlüssel? Jetzt anfragen →

SharePoint-Liste verknüpfen

Option 1: SharePoint-Liste verwenden

  1. Aktivieren Sie: "Use SharePoint List"
  2. Geben Sie den Listen-Namen ein
  3. Konfigurieren Sie das Feldmapping (siehe unten)

Option 2: Test-Daten nutzen

Deaktivieren Sie "Use SharePoint List" um mit 50+ Test-Projekten zu arbeiten.

Feldmapping konfigurieren

Passen Sie die Feldnamen an Ihre SharePoint-Liste an:

💡 Wichtig: Alle Felder müssen im Property Pane konfiguriert werden (Feldname angeben). Die Felder in der SharePoint-Liste dürfen jedoch leer sein - ProjRadar zeigt dann Standardwerte an.
ProjRadar Feld Standard SharePoint Spalte Property Pane Konfiguration
Title Title ✅ Erforderlich
Description Description ✅ Erforderlich
Quadrant Quadrant ✅ Erforderlich
Status Status ✅ Erforderlich
Complexity Complexity ✅ Erforderlich
IsStrategic IsStrategic ✅ Erforderlich
Visible Visible ✅ Erforderlich
ProjectNumber ProjectNumber ✅ Erforderlich
PlannedYear PlannedYear ✅ Erforderlich

Quadranten-Namen anpassen

Passen Sie die Quadranten-Bezeichnungen an Ihre Bedürfnisse an:

  • Quadrant 1 (oben rechts): Standard: "Strategisch"
  • Quadrant 2 (oben links): Standard: "Innovation"
  • Quadrant 3 (unten links): Standard: "Betrieb"
  • Quadrant 4 (unten rechts): Standard: "Support"

Weitere Einstellungen

  • Radar-Größe: Standard 1000px (empfohlen: 800-1200)
  • Standard-Ansicht: Radar, Matrix, Kanban oder List
  • Sprache: Automatische Erkennung oder manuell DE/EN

✨ Features im Detail

🎯 Radar-Ansicht

  • 4 Quadranten für Kategorisierung
  • 4 Ringe für Status (automatisch aus Status-Feld)
  • Strategische Projekte als Sterne dargestellt
  • Größe basierend auf Komplexität (niedrig/mittel/hoch)
  • Tooltips beim Hovern über Projekte
  • Filter: Jahr, Status-Checkboxen, Nur strategische Projekte
💡 Ring-Zuordnung: Ring 1 = Erledigt | Ring 2 = In Arbeit | Ring 3 = In Planung | Ring 4 = Backlog

📊 Matrix-Ansicht

  • Tabellarische Darstellung: Quadranten × Ringe
  • Projekte in Zellen gruppiert
  • Schneller Überblick über Verteilung
  • Click-Handler öffnen SharePoint-Formular

📋 Kanban-Ansicht

  • 4 Spalten basierend auf Ring/Status
  • Karten-Design mit allen Details
  • Ideal für Status-Tracking

📄 Listen-Ansicht

  • Detaillierte Tabelle mit allen Feldern
  • Sortierbare Spalten
  • Kompakte Darstellung für viele Projekte

🌍 Multi-Language

  • Deutsch und Englisch
  • Automatische Browser-Erkennung
  • Manueller Sprachwechsel über DE/EN Buttons
  • Alle UI-Texte übersetzt

❓ Hilfe-System

  • Eingebaute Hilfe per "❓ Hilfe" Button
  • Vollständige Dokumentation in Deutsch/Englisch
  • Troubleshooting-Guide

❓ Häufig gestellte Fragen (FAQ)

Wie viele Projekte kann ProjRadar darstellen?

ProjRadar ist für bis zu 500 Projekte optimiert. Die REST API lädt standardmäßig die ersten 5.000 Items. Bei sehr vielen Projekten empfehlen wir, den Visible-Filter zu nutzen.

Muss ich für jedes Projekt einen Ring auswählen?

Nein! Der Ring wird automatisch aus dem Status-Feld berechnet. Sie müssen nur den Status pflegen (completed/active/planning/on-hold).

Kann ich die Quadranten umbenennen?

Ja! Im Property Pane können Sie alle 4 Quadranten-Namen frei anpassen (z.B. "IT-Projekte", "Marketing", "Sales", "Operations").

Was bedeutet "Honor-Based Licensing"?

Wir vertrauen darauf, dass Sie den Plan wählen, der Ihrer Unternehmensgröße entspricht. Es gibt keine technische Limitierung - wir setzen auf Fairness.

Funktioniert ProjRadar auch ohne SharePoint-Liste?

Ja! Deaktivieren Sie "Use SharePoint List" und ProjRadar lädt 50+ Test-Projekte zum Ausprobieren. Wichtig: Die Test-Projekte können nicht bearbeitet werden, da sie nur zur Demonstration dienen. Für die vollständige Nutzung wird eine gültige Lizenz und eine verknüpfte SharePoint-Liste benötigt.

Kann ich mehrere Tenants mit einer Lizenz nutzen?

Nein. Jede Lizenz ist für einen SharePoint-Tenant gültig. Beim ersten Einsatz wird der Tenant mit dem Lizenzschlüssel verknüpft.

Was passiert wenn meine Lizenz abläuft?

Sie erhalten 30 Tage vor Ablauf eine E-Mail-Benachrichtigung. Das WebPart zeigt eine Warnung an. Nach Ablauf + 72h Kulanzfrist wird das WebPart deaktiviert.

Werden meine Projektdaten gespeichert?

Nein! Wir speichern nur Lizenz-Metadaten (Lizenzschlüssel, Tenant-ID, Firma). Ihre Projektdaten bleiben ausschließlich in Ihrem SharePoint.

Unterstützt ProjRadar SharePoint On-Premises?

ProjRadar benötigt SPFx 1.17.4 und ist daher nur mit SharePoint Online und SharePoint Server Subscription Edition (SPSE) kompatibel. SharePoint Server 2019/2016 werden nicht unterstützt.

Kann ich ProjRadar anpassen/erweitern?

Das WebPart ist closed-source. Für Custom-Entwicklungen kontaktieren Sie uns: project-radar@jm-services.de

Welchen Support erhalte ich?

  • SMALL/MEDIUM: E-Mail-Support (48h Response Time)
  • LARGE: Prioritäts-Support (24h Response Time)
  • ENTERPRISE: Dedicated Support (8h Response Time)

🔧 Troubleshooting

Problem: "License validation failed"

Lösung:

  1. Prüfen Sie die Schreibweise Ihres Lizenzschlüssels
  2. Kontrollieren Sie Ihre Internetverbindung
  3. Öffnen Sie die Browser-Konsole (F12) und prüfen Sie Netzwerk-Fehler
  4. Kontaktieren Sie uns: project-radar@jm-services.de

Problem: "No projects found"

Lösung:

  1. Prüfen Sie den Listen-Namen im Property Pane
  2. Stellen Sie sicher, dass die Liste Items enthält
  3. Prüfen Sie das Visible-Feld (muss "true"/"ja"/"yes" sein)
  4. Kontrollieren Sie die Berechtigungen auf die Liste

Problem: Projekte werden nicht angezeigt

Lösung:

  1. Öffnen Sie die Browser-Konsole (F12)
  2. Suchen Sie nach Fehlermeldungen
  3. Prüfen Sie das Feldmapping (Groß-/Kleinschreibung beachten!)
  4. Testen Sie mit Test-Daten (deaktivieren Sie "Use SharePoint List")

Problem: Feldmapping funktioniert nicht

Lösung:

SharePoint escaped Sonderzeichen in Feldnamen automatisch:

  • "Projekt-Nr" wird zu "Projekt_x002d_Nr"
  • "Status (aktiv)" wird zu "Status_x0020__x0028_aktiv_x0029_"

Sie können entweder den escaped Namen verwenden ODER die Spalte in SharePoint umbenennen.

Weitere Hilfe benötigt?

Unser Support-Team hilft Ihnen gerne weiter.

📧 Support kontaktieren