Versionen im Vergleich

Schlüssel

  • Diese Zeile wurde hinzugefügt.
  • Diese Zeile wurde entfernt.
  • Formatierung wurde geändert.
Info

This tutorial explains how to install the Service Desk App into a newly installed UM 7.45 through 7.51.

Starting with release 7.52, the Service Desk App is shipped with the regular UM installer and does not need to be installed separately. See https://pinutswiki.atlassian.net/wiki/spaces/UMDOC/pages/4074635265 for information on how to active the Service Desk App in an existing UM installation.

Install Service Desk App

You can either

...

Either way you’ll need a license that covers de.pinuts.servicedesk to successfully install and use the Login App. Please contact support@pinuts.de when in doubt.

...

Install

...

If you need to install into an already existing UM you probably need to perform a manual installation as described in this section.

Go to https://www.universal-messenger.de/knowledge-base/intern/02_downloads/addons/index.html and download the Service Desk 2 App package (ZIP file).

Unzip the file right into your UM folder (where subfolders like cmsbs-conf/ and cmsbs-work/ live):

Codeblock
languagebash
(cd UM && unzip $DOWNLOAD_DIR/ServiceDesk2-x.y.z.zip)

Restart your UM instance.

Configure and install REST Proxy

Follow https://www.universal-messenger.de/knowledge-base/intern/doc-en/Administration/REST-proxy.html to install and configure your REST-Proxy.

Add the following endpoints to your REST-Proxy’s controller whitelist:

  • de.pinuts.servicedesk.widget

  • de.pinuts.servicedeskform.Widget

...

using UM Kickstarter

Start a new Kickstarter project

...

Codeblock
languagegroovy
dependencies {
    // ...runtime('de.pinuts.cmsbs:UM:7.51.4')
    runtime('de.pinuts.cmsbs:ServiceDesk2:4.1.9.193')
}

Configure REST Proxy

Create a file named rest-proxy/cmsbs-restproxy.properties that configures the REST Proxy:

...

Insert the following cp lines to your um/build.gradle file:

Codeblock
languagegroovy
setup.doLast {
    ...
    
    // Entry-Types:
    def entryTypesDir = new File(pinuts.um.cmsbsConfDir, 'entryTypes')
    fileTree('cmsbs-conf/entryTypes').each {target ->
        ln(target, entryTypesDir)
    }
    
    // UM REST Proxy
    cp('UM/web-integration/cmsbs-restproxy.war', new File(pinuts.um.webappsDir, 'p.war'))
    cp('rest-proxy/cmsbs-restproxy.properties', new File(pinuts.um.serverHome, 'cmsbs-restproxy.properties'))
}

Create configuration files

Create a new file um/cmsbs-conf/conf.d/sd.attributes:

Codeblock
include: cmsbs-conf/cse/plugins/de.pinuts.servicedesk/servicedesk.attributes

additional.attributes[] = entrytype
grp.std_intern.members[] = entrytype

entrytype.isPrimary = true
entrytype.title = "EntryType"
entrytype.dbSize = 32
entrytype.display.height = 1
entrytype.values[] = admin
entrytype.value.admin = Backoffice User
entrytype.default = admin# Disable Composite Unique Key
isUnique = ""

Create a new file cmsbs-conf/conf.d/sd.properties:

Codeblock
cmsbs.entrytypes.attribute = "entrytype"
cmsbs.gui.login = internal

Create a new file cmsbs-conf/conf.d/sd.config.js:

Codeblock
languagejs
// Pinuts File Encoding: UTF-8

var SERVICEDESK2_CONFIG = {
    baseUrl: 'http://localhost:8080/cmsbs',
};

...

Setup UM

Let gradle install all dependencies:

Codeblock
attribute.groups = *std_personal

attr.uid.title.de = "Login"
attr.uid.title.en = "Login"

grp.std_personal.title = "Admin User"
grp.std_personal.show = true
grp.std_personal.members = uid firstname lastname email password cmsbs.isadmin admin_role lang sd_memberofgradle setup

Create backoffice “admin” user

...

Codeblock
languagepowershell
(cd UM/scripts/ && ./userTool.sh cmsbs.properties -admin)

Startup UM

Let gradle install the new dependency and start Startup your UM instance:

Codeblock
gradle setup run

Login to http://localhost:8080/cmsbs as admin / admin

...