Ressourcen
Quick-Tipp - Dynamischer SharePoint Download
Zur Unterstützung von Werkern werden technische Zeichnungen und Betriebs- sowie Auftragsdaten auf Bildschirmen in manuellen oder halbautomatischen Produktionsumgebungen und im Qualitätsmanagement angezeigt. PDF ist häufig das bevorzugte Format für diese Dokumente.
Der Artikel vermittelt, wie eine SharePoint-Dokumentenbibliothek zur Speicherung von PDFs verwendet wird, einschließlich des Herunterladens dieser Dateien im Peakboard Designer und ihrer dynamischen Integration in Visualisierungen.
Die SharePoint-Dokumentenbibliothek
Der folgende Screenshot zeigt eine Standard-Dokumentenbibliothek in einer typischen Office 365-Umgebung. Innerhalb der Bibliothek gibt es ein Unterverzeichnis namens Current, das alle aktuellen Dokumente enthält. Die alten Dokumente werden in Archiv gespeichert.
Nehmen wir an, das Unternehmen stellt drei verschiedene Produkte mit den Namen P01 bis P03 her. Für jedes Produkt gibt es eine technische Zeichnung, deren PDF-Datei entsprechend benannt ist. Die Datei x.pdf enthält nur ein rotes Kreuz und wird als Platzhalter verwendet, wenn keine nützlichen Daten angezeigt werden.
Verknüpfung des Peakboard-Projekts mit SharePoint
Mache einen Rechtsklick auf [Ressourcen], wähle [Cloud-Ressource hinzufügen] und dann [SharePoint] (1) aus.
Authentifiziere dich mit deinem Office 365 Konto in dem Dialog, der sich geöffnet hat. Hierfür benötigt das Konto ausreichende Berechtigungen, um auf die gewünschten Dateien in der Dokumentenbibliothek zugreifen zu können.
Es öffnet sich der Dialog zur Dateiauswahl. Wähle die Datei x.pdf (1) als Platzhalterdatei für das Projekt aus.
Ziehe die PDF-Ressource per Drag-and-drop auf die Arbeitsfläche, um ein PDF Control zu erstellen. Aktiviere dann die Check-Box [In Skripten verwendet] (1) in den Attributen und gib dem Control einen Namen (2).
Aufbau der Datenstruktur für das dynamische Laden
Die Dateien mit den verschiedenen technischen Zeichnungen sollen von einem Fabrikarbeiter dynamisch aus einer Liste von Dokumentennummern ausgewählt werden können. Erstelle dazu eine Liste mit diesen Nummern. Mache dazu einen Rechtsklick auf [Variablen] und wähle [Liste hinzufügen] (1).
Gib der Liste einen Namen (1) und erstelle eine Spalte mit dem Datentyp [String] (2). Lege dann für jedes Produkt eine entsprechende Zeile an (3).
Ziehe als Nächstes ein Drop-Down Control auf die Arbeitsfläche. Du findest das Drop-Down Control im Bereich [Interaktiv] (1). Platziere dieses Drop-Down oberhalb des PDF Controls. Damit der Benutzer die Produktnummer auswählen kann, bindest du in den Attributen die Listen-Variable an das Drop-Down Control (2).
Aktiviere dann in den Attributen die Check-Box [In Skripten verwendet] (1) und gib dem Drop-Down Control einen Namen (2), um es im nächsten Schritt verwenden zu können.
Das Skript für dynamisches Laden
Um die dynamische Auswahl möglich zu machen, erstellst du ein Selection Changed Event Skript (1) für das Drop-Down Control durch einen Klick auf das entsprechende Symbol.
Mit den ersten drei Zeilen erstellst du den Dateipfad der gewünschten PDF-Datei relativ zum Stammverzeichnis deiner Dokumentenbibliothek mithilfe des Wertes, der in der Dropdown-Liste ausgewählt wird. Im vorliegenden Fall also beispielsweise /Current/ + P01 + .pdf.
Dazu erstellst du zuerst unter [BASICS] eine [Lokale Variable] vom Datentyp String.
Für die erste Zeile fügst du dem Building Block [Setzen] dieser Variable dann einen Building Block mit dem Verzeichnis /Current/ hinzu.
Die zweite Zeile besteht aus dem Building Block [Anhängen] der Variable in Kombination mit dem Building Block [Wert abrufen] des Drop-Down Controls unter [CONTROLS], [Bildschirmname], [Controlname] und [Selektierter Wert].
Für die dritte Zeile nutzt du erneut den Building Block [Anhängen] der Variable und kombinierst ihn mit der Dateiendung .pdf
Mit der letzten Zeile setzt du die Quelle des PDF Controls auf den neu erstellten Dateipfad. Dies löst eine Aktualisierung aus und lässt das PDF Control das Dokument aus SharePoint herunterladen und anzeigen.
Ziehe dazu den Building Block [Wert setzen] des PDF Controls aus dem Bereich [CONTROLS], [Bildschirmname], [Controlname] und [Quelle] unten an die bestehenden Building Blocks und kombiniere es mit dem Building Block [Abrufen] der anfangs erstellten lokalen Variable.
Nachdem du das Skript gespeichert hast, kannst du die Vorschau starten und deine Visualisierung testen. Jedes Mal, wenn der Wert in der Dropdown-Liste geändert wird, wird der Reload-Prozess ausgelöst und die PDF-Datei ändert sich. Im vorliegenden Fall haben wir eine feste Liste von Produkten. Im realen Anwendungsfall könnte die Liste der Produkte dynamisch aus einem ERP-System wie SAP abgerufen werden.
