Dateianhänge
Es besteht die Möglichkeit, eine Datei an einem Datensatz im Monitor anzufügen. Somit haben Anwender die Möglichkeit, sich diese Datei anzuschauen oder die Datei herunterzuladen.
Datei Quelle
Dateien im Elasticsearch
Sie können Dateien im BPC-Elasticsearch speichern. Eine Datei wird in diesem Fall direkt im Monitor-Datensatz angehängt.
Die Dateien sollten als Base64-String encodiert sein und im Datensatz unter einem dataIndex hinterlegt werden.
Damit die Datei mit dem richtigen Namen sowie Format wiederhergestellt werden kann, muss der Datensatz folgende Informationen enthalten:
-
Name der Datei
-
MIME-Type
Der Datensatz, welcher die Datei beinhaltet, kann über einen BPC-Log-Service oder über einen Index-Request an Elasticsearch hinzugefügt werden. Folgendes Beispiel zeigt einen Datensatz mit Dateianhang:
{
"PROCESSID": "2",
"TEXT": "This is second test object",
"FILEID": "foodmenu.xml",
"filename": "foodmenu.xml",
"contentType": "application/xml",
"DATA": "PGJyZWFrZmFzdF9tZW51Pgo8Zm9vZD4KPG5hbWU+QmVsZ2lhbiBXYWZmbGVzPC9uYW1lPgo8cHJpY2U+JDUuOTU8L3ByaWNlPgo8ZGVzY3JpcHRpb24+VHdvIG9mIG91ciBmYW1vdXMgQmVsZ2lhbiBXYWZmbGVzIHdpdGggcGxlbnR5IG9mIHJlYWwgbWFwbGUgc3lydXA8L2Rlc2NyaXB0aW9uPgo8Y2Fsb3JpZXM+NjUwPC9jYWxvcmllcz4KPC9mb29kPgo8Zm9vZD4KPG5hbWU+U3RyYXdiZXJyeSBCZWxnaWFuIFdhZmZsZXM8L25hbWU+CjxwcmljZT4kNy45NTwvcHJpY2U+CjxkZXNjcmlwdGlvbj5MaWdodCBCZWxnaWFuIHdhZmZsZXMgY292ZXJlZCB3aXRoIHN0cmF3YmVycmllcyBhbmQgd2hpcHBlZCBjcmVhbTwvZGVzY3JpcHRpb24+CjxjYWxvcmllcz45MDA8L2NhbG9yaWVzPgo8L2Zvb2Q+Cjxmb29kPgo8bmFtZT5CZXJyeS1CZXJyeSBCZWxnaWFuIFdhZmZsZXM8L25hbWU+CjxwcmljZT4kOC45NTwvcHJpY2U+CjxkZXNjcmlwdGlvbj5MaWdodCBCZWxnaWFuIHdhZmZsZXMgY292ZXJlZCB3aXRoIGFuIGFzc29ydG1lbnQgb2YgZnJlc2ggYmVycmllcyBhbmQgd2hpcHBlZCBjcmVhbTwvZGVzY3JpcHRpb24+CjxjYWxvcmllcz45MDA8L2NhbG9yaWVzPgo8L2Zvb2Q+Cjxmb29kPgo8bmFtZT5GcmVuY2ggVG9hc3Q8L25hbWU+CjxwcmljZT4kNC41MDwvcHJpY2U+CjxkZXNjcmlwdGlvbj5UaGljayBzbGljZXMgbWFkZSBmcm9tIG91ciBob21lbWFkZSBzb3VyZG91Z2ggYnJlYWQ8L2Rlc2NyaXB0aW9uPgo8Y2Fsb3JpZXM+NjAwPC9jYWxvcmllcz4KPC9mb29kPgo8Zm9vZD4KPG5hbWU+SG9tZXN0eWxlIEJyZWFrZmFzdDwvbmFtZT4KPHByaWNlPiQ2Ljk1PC9wcmljZT4KPGRlc2NyaXB0aW9uPlR3byBlZ2dzLCBiYWNvbiBvciBzYXVzYWdlLCB0b2FzdCwgYW5kIG91ciBldmVyLXBvcHVsYXIgaGFzaCBicm93bnM8L2Rlc2NyaXB0aW9uPgo8Y2Fsb3JpZXM+OTUwPC9jYWxvcmllcz4KPC9mb29kPgo8L2JyZWFrZmFzdF9tZW51Pg=="
}
Die Felder filename und contentType sind verpflichtend und müssen genauso heißen.
|
Datei-Referenz aus INUBIT
Dateien können im INUBIT aufbewahrt werden. Wie Dateien dort gespeichert werden, hängt von der Einstellung im INUBIT ab.
Die Dateien sollen über einen REST-Endpunkt bereitgestellt werden, sodass diese sich vom BPC aus herunterladen lassen (siehe auch Konfiguration des Herunterladens von Dateien im Monitor).
Konfiguration des Herunterladens von Dateien im Monitor
Nachdem eine Datei oder eine Referenz zur Datei am Monitor-Datensatz gespeichert wurde, sind folgende Einstellungen nötig, um das Herunterladen der Datei zu ermöglichen.
Konfiguration: Datei-Spalte
Legen Sie in der Konfiguration fest, welche Spalte die Datei oder die Referenz zur Datei im INUBIT beinhaltet.
Die Einstellung heißt Monitor_FileReferenceColumn (ID: column_file).
Wenn die Datei im ElasticSearch aufbewahrt wird, wird der Inhalt der gesetzten Datei-Spalte beim Herunterladen als Base64-String decodiert.
Wenn die Datei im ElasticSearch nicht zu finden oder zu encodieren ist, wird der Inhalt der Datei-Spalte als Datei-Referenz im INUBIT verwendet.
Der Inhalt der Datei-Spalte wird in diesem Fall als URL-Parameter directory in der Abfrage zum INUBIT mitgeschickt.
|
Konfiguration: Herunterladen aus INUBIT
Falls die Datei vom INUBIT heruntergeladen werden soll, sind noch folgende Einstellungen notwendig:
-
Function_InubitBackendConnection(inubit_proxyId):
INUBIT Backend Connection. -
Function_InubitBaseURL(inubit_baseUrl):
Fester Bestandteil in allen URLs zum INUBIT. -
Function_FileDownloadEndpoint(inubit_referenceEndpoint):
Es soll gesetzt werden, unter welchem INUBIT-Endpunkt Dateien heruntergeladen werden können. -
Monitor_ProcessID(column_id):
Die Abfrage enthält Information zur Prozess-ID als URL-Parameter, deshalb soll die dazugehörige Spalte gesetzt werden. -
Monitor_HistoryID(column_historyId):
Falls das Herunterladen sich auf den Child-Prozess bezieht, soll die ID des Child-Prozesses in der Abfrage zum INUBIT als URL-Parameter enthalten sein. Die dazugehörige Spalte muss deshalb gesetzt werden.
Nachdem alles konfiguriert ist, hat die URL folgende Struktur:
{Protokoll}://{Domain}/{inubit_baseUrl}/{inubit_referenceEndpoint}?directory={Inhalt der Datei-Spalte}&processid={processId}&childid={childId}
