Document toolboxDocument toolbox

profacto OTA-Integration Konfigurationsdatei

Owned by Ulf Roettger (Unlicensed)
Last updated: Apr. 02, 2024 by Nicolas Goutte
2 min read

Übersicht

Die Integration wird über die Datei namens profactorest.json gesteuert. Die Datei befindet sich im Unterordner interiorcad im Vectorworks-Benutzerordner.

In lokalen profacto + interiorcad-Umgebungen kann die Datei von profacto aus direkt dorthin aus dem Tokenmanager der Voreinstellungen gespeichert werden.

Diese Datei muss vorhanden sein, damit diese Form der Integration eingeschaltet wird.

Es muss beim Ändern der Datei darauf geachtet werden, dass diese Datei immer noch die JSON-Syntax entspricht.

Inhalt und Zeichensatz

Diese Datei enthält JSON-Daten mit dem Zeichensatz UTF-8.

Unterstützte Schlüssel

Bitte achten Sie darauf, wirklich die angegeben Typen zu nutzen. Es gibt keine Konvertierung, z.b. zwischen String und Ganzzahl.

Nötige Schlüssel

  • token (String) Token wie in profacto für den Benutzer eingestellt
  • baseurl1 (String) URL zum Server - IP oder Servername im LAN - wird von profacto automatisch durch den Servernamen besetzt
  • baseurl2 (String) URL zum Server - IP oder Servername im WAN - in profacto manuell in den Voreinstellungen:Administration zu erfassen.
  • baseurl3 (String) URL zum Server - Serveradresse - in profacto manuell in den Voreinstellungen:Administration zu erfassen. (berücksichtigt ab profacto 2020.3.0 und interiorcad 2020.VF7)

Optionale Schlüssel

  • serverpingtimeout (Ganzzahl) Timeout in Sekunden, um eine Antwort eines der beiden Servers beim Starten von Vectorworks interiorcad zu bekommen (Default: zwei Sekunden)

  • pf_personalnr (String) PersonalNummeraus profacto ERP

  • pf_tokenowner (String) Name des Personals
  • pf_profactomaterialsync (Boolean) profacto-FLag, ob der Tokenowner überhaupt einen Sync des Materials wünscht
  • pf_workplanner (Boolean) profacto-Personal-Eintrag, ob der Tokenowner als Arbeitsvorbereiter deklariert ist
  • pf_projectmanager (Boolean) profacto-Personal-Eintrag, ob der Tokenowner als Bauleiter deklariert ist
  • pf_creationdate - Datum der Dateierstellung
  • pf_creationtime - Uhrzeit der Dateierstellung
  • pf_profactotype: {
    "PF": false,
    "SB": false,
    "SU": true,
    "DEMO": false
    } - PF = profacto, SB = profacto SmallBusiness, SU = profacto StartUp, DEMO = profacto Edu/Demo-Version
  • pf_serial: profacto Seriennummer
  • pf_dbversion - profacto Datenbankversion
  • pf_profactoversion: profacto Version
  • pf_createdbyapptype: Datei erzeugt durch Single oder Client/Server

  • apipingertoken: API-Pinger-Token von profacto für das Logging

  • pf_getlogzip: Aufruf zum Zip-File des Logs - ein adaptierter Aufruf ist ebenso möglich - siehe dazu API - Allgemein
  • pf_viewlogfilter: Aufruf zum Log-Filter-UI - ein adaptierter Aufruf ist ebenso möglich - siehe dazu API - Allgemein
  • active: true | false // zeigt den Zustand profacto seitig zum Zeitpunkt der Erstellung der Datei an und dient somit auch der Steuerung im CAD. CADs mit Remote-Verbindungen müssen dieses Attribut also selber pflegen.

Schlüssel fürs Debuggen

  • debuglogurls  (Boolean) Genutzte URLs bei der Kommunikation mit profacto ins Log schreiben (Default: abgeschaltet; ab interiorcad 2020 F5 verfügbar)

Performance-kritische Schlüssel

Nur zum Testen!

Diese Schlüssel sind per Default ausgeschaltet, weil diese performancekritisch sind.  Falls sie eingeschaltet werden, werden bei Benutzung (fast) jedes interiorcad-Objektes oder -Menubefehls die entsprechenden Importe durchgeführt, was ein flüssiges Arbeit in interiorcad nahezu unmöglich macht:


  • autoimportprojectpositions (Boolean) Projekt-Position-Historie des Projekts des aktuellen Dokuments soll gecheckt werden (Default: abgeschaltet)
  • autoimportmaterials (Boolean) Materialien aus profacto automatisch importieren (Default: abgeschaltet)

Beispiel

profactorest.json
{
"token": "F80C911F2B3A4099ACB0A8F365590CEB",
"baseurl1": "http://192.168.188.25:8080/4DAction/",
"baseurl2": "http://mimr.selfip.biz:8080/4DAction/",
"baseurl3": "http://alfheimr.fritz.box:8080/4DAction/",
"serverpingtimeout": 2,
"debuglogurls": true,
"pf_personalnr": "1",
"pf_tokenowner": "Ulf Röttger",
"pf_profactomaterialsync": true,
"pf_workplanner": false,
"pf_projectmanager": false,
"pf_creationdate": "16.10.2020",
"pf_creationtime": "08:10:59",
"pf_profactotype": {
"PF": false,
"SB": false,
"SU": true,
"DEMO": false
},
"pf_serial": "U189FC",
"pf_dbversion": 251,
"pf_profactoversion": "2020.3.0",
"pf_createdbyapptype": "Single"
}