Skip to content

Server Profiles ​

Server profiles let you set certain parameters on the server side, without having to pass them as URL parameters. They are not visible to the caller and are only loaded with a valid token (/api/ofml.dll/ofml/profile.json).

Setup ​

Server profiles are maintained in the 3D office data portal under Profil → Server Profil. Where possible, they are meant to replace the URL parameters over time; that is why some settings can be made either way.

Precedence: URL parameters override the profile – except show_price: here the profile always applies; a link cannot switch disabled prices back on.

Available parameters ​

ParameterIn the data portalDefaultDescription
general_settings.show_price"Preise anzeigen"trueShow the price. With false, prices are not sent to the client (unlike the URL parameter showprice).
general_settings.open_catalogue"Öffne Katalog bei Start"falseOpen the catalog on startup
general_settings.allow_3d_download"3D-Modell Download"trueShow the download area for 3D models
styles.propertyEditorVariant–compactLayout: full or compact
styles.articleDrawerVariant–modularDrawer: single or modular
visibility.articleData.showPropertyHeaders–trueShow group headings in the property editor

The data portal also has the switch "XCF/PEC Knoten anzeigen" (show XCF/PEC nodes). It shows XCF/PEC-specific nodes in the catalog tree and is evaluated on the server.

Example ​

json
{
  "general_settings": {
    "show_price": true,
    "open_catalogue": false,
    "allow_3d_download": true
  },
  "styles": {
    "propertyEditorVariant": "compact",
    "articleDrawerVariant": "modular"
  },
  "visibility": {
    "articleData": {
      "showPropertyHeaders": true
    }
  }
}

Difference from URL parameters ​

AspectURL parametersServer profiles
VisibilityVisible in the URLNot visible
Tamper resistanceCan be changed by the clientCannot be changed by the client
PrecedenceWins, except for show_priceApplies where no URL parameter is set; show_price always applies
Price loadingLoaded, just not shownNot loaded at all (with false)

3D office WebKatalog 2.5 — ub.unitel GmbH