Konfiguration des Moduls Lokationen

Konfigurationsschlüssel

CMDBLocation

Agenten mit den Rollen CMDB-Reader bzw. CMDB-Maintainer finden im Modul Lokationen eine nach Standorten und Assetklassen gruppierte Übersicht der Assets.

Die Anzeige der in einem Standort, Gebäude oder Raum enthaltenen Assets beachtet explizite, direkte Zuordnungen am Asset. Die Aufstellung der Informationen erfolgt nach den im System hinterlegten Standorten und ihrer Struktur. Dabei wird auf die Vorgabeklassen und -hierarchie gesetzt: Standort > Gebäude > Raum.

Abb.: Konfigurierte Übersicht der Assets pro Standort

Unter Lokationen werden alle im System angelegten Standorte aufgelistet sowie die untergeordneten Gebäude und Räume. Diese werden im Modul Assets angelegt und den entsprechenden Asset-Klassen zugewiesen. Änderungen an der Konfiguration der Lokationen sind in der Regel nicht erforderlich.

Sie können jedoch anzuzeigende Assetklassen im Contentbereich sowie die in der Sidebar anzuzeigenden Informationen anpassen.

Voraussetzung

Die Übersichten im Modul zeigen nur Assets, die einem Standort (Standort, Gebäude, Raum) zugeordnet sind. Nicht alle Assetklassen verfügen initial über das Attribut "Standort" (z. B. Klasse "Netzwerk"). Sollen auch diese Assetklassen angezeigt werden, muss das Eingabefeld "Standort" in die betreffende Assetklasse integriert werden.

Hinweis

Möchten Sie die Assetklasse Gebäude oder Raum integrieren, benötigen diese ein Attribut des Typs CIClassReference und als Key ParentLocation mit entsprechendem ReferencedCIClassName auf die Eltern-Assetklasse.

Navigieren Sie im Admin Modul zu Assets > Asset Klassen.
Doppelklicken Sie auf die betreffende Assetklasse, um deren Detailansicht zu öffnen.
Klicken Sie auf Bearbeiten.

Fügen Sie den nachfolgenden Codeabschnitt an gewünschter Position in die Klassendefinition ein.

{
   'CountDefault' => 1,
   'CountMax' => 1,
   'CountMin' => 1,
   'CustomerVisible' => 0,
   'Input' => {
      'ReferencedCIClassLinkDirection' => 'Reverse',
      'ReferencedCIClassLinkType' => 'Includes',
      'ReferencedCIClassName' => [
         'Location',
         'Building',
        'Room'
      ],
      'Type' => 'CIClassReference'
   },
   'Key' => 'Location',
   'Name' => 'Location',
   'Searchable' => 1
},

Optional: Ändern Sie den Verknüpfungstyp (ReferencedCIClassLinkType) und die Verknüpfungs-Richtung (ReferencedCIClassLinkDirection)
Optional: Ändern Sie Typ, Key und die Angaben unter ReferencedCIClassName, wenn Sie anstelle eines Standorts einen Raum oder ein Gebäude integrieren möchten (s. Hinweis oben).
Speichern Sie die Änderung. Dabei wird eine neue Version angelegt.

Danach kann den Assets dieser Klasse ein Standort zugewiesen werden.

Weiterführende Informationen:

Konfiguration des Contentbereichs

Der Contentbereich enthält den Gerätebestand für den gewählten Standort nach Assetklassen gruppiert. Jede Assetklasse wird in einem separaten Tabellenwidget angezeigt. Sie können weitere Widgets hinzufügen.

Navigieren Sie im Explorer zu System > GUI Konfiguration > Agentenportal.
Suchen und Öffnen Sie den SysConfig-Schlüssel CMDBLocation.

Suchen Sie im Quellcode den Abschnitt content[...] und fügen Sie nachfolgenden Codeblock innerhalb dieses Abschnittes ein.

Dieser erzeugt ein neues Widget für die Assetklasse "Netzwerk"

Platzieren Sie den Codeblock an gewünschter Stelle, z. B. unterhalb des Widgets "Hardware". Die Reihenfolge der Codeblöcke definiert die Reihenfolge in der Ansicht.

{
   "instanceId": "kixpro-cmdb-location-network-list-widget",
   "configurationId": "kixpro-cmdb-location-network-listwidget",
   "configuration": {
      "id": "kixpro-cmdb-location-network-list-widget",
      "name": "Network List",
      "type": "Widget",
      "widgetId": "table-widget",
      "title": "Translatable#Network",
      "actions": [
         "bulk-action",
         "csv-export-action"
      ],
      "configuration": {
         "id": "kixpro-cmdb-location-network-table-widget",
         "name": "Network Widget",
         "type": "TableWidget",
         "objectType": "ConfigItem.9",
         "sort": null,
         "subConfigurationDefinition": null,
         "headerComponents": null,
         "showFilter": true,
         "shortTable": null,
         "predefinedTableFilters": [
            {
               "name": "Expired",
               "criteria": [
                  {
                     "property": "CurDeplStateID",
                     "operator": "EQ",
                     "value": 11,
                     "useObjectService": false,
                     "useDisplayValue": false
                  }
               ]
            },
            {
               "name": "Maintenance",
               "criteria": [
                  {
                     "property": "CurDeplStateID",
                     "operator": "EQ",
                     "value": 13,
                     "useObjectService": false,
                     "useDisplayValue": false
                  }
               ]
            },
            {
               "name": "Pilot",
               "criteria": [
                  {
                     "property": "CurDeplStateID",
                     "operator": "EQ",
                     "value": 14,
                     "useObjectService": false,
                     "useDisplayValue": false
                  }
               ]
            },
            {
               "name": "Planned",
               "criteria": [
                  {
                     "property": "CurDeplStateID",
                     "operator": "EQ",
                     "value": 15,
                     "useObjectService": false,
                     "useDisplayValue": false
                  }
               ]
            },
            {
               "name": "Production",
               "criteria": [
                  {
                     "property": "CurDeplStateID",
                     "operator": "EQ",
                     "value": 16,
                     "useObjectService": false,
                     "useDisplayValue": false
                  }
               ]
            },
            {
               "name": "Repair",
               "criteria": [
                  {
                     "property": "CurDeplStateID",
                     "operator": "EQ",
                     "value": 17,
                     "useObjectService": false,
                     "useDisplayValue": false
                  }
               ]
            },
            {
               "name": "Review",
               "criteria": [
                  {
                     "property": "CurDeplStateID",
                     "operator": "EQ",
                     "value": 19,
                     "useObjectService": false,
                     "useDisplayValue": false
                  }
               ]
            },
            {
               "name": "Test/QA",
               "criteria": [
                  {
                     "property": "CurDeplStateID",
                     "operator": "EQ",
                     "value": 20,
                     "useObjectService": false,
                     "useDisplayValue": false
                  }
               ]
            }
         ],
         "cache": true,
         "resetFilterOnReload": true,
         "configuration": null,
         "valid": true,
         "application": "agent-portal"
      },
      "minimized": false,
      "minimizable": false,
      "icon": "kix-icon-network",
      "contextDependent": true,
      "contextObjectDependent": false,
      "formDependent": false,
      "formDependencyProperties": [],
      "valid": true,
      "application": "agent-portal"
   },
   "permissions": [],
   "size": "large"
}

Optional: Soll anstatt "Netzwerk" eine andere Assetklasse angezeigt werden, gehen Sie wie folgt vor:
1. Ändern Sie die Parameter instanceId , configurationId,name und title (gelbe Markierungen)
  - Ersetzen Sie die Bezeichnung network durch den Namen der anzuzeigenden Assetklasse.
  - Anstelle von kixpro-cmdb-location-myasset-list-widget können Sie auch einen anderen, aber eindeutigen, Bezeichner verwenden.
2. Ändern Sie ebenfalls den objectType (blaue Markierung).
  - Geben Sie die ID Assetklasse an, deren Assets im Widget angezeigt werden sollen.
    Die Assetklasse muss mit vorangestelltem "ConfigItem_" angegeben werden (z. B. "ConfigItem_Network" oder "ConfigItem_Software").
    Leerzeichen und Unterstriche können verwendet werden.
    Tipp
    Tipp: Navigieren Sie im Admin Modul zu KIX > Assets > Asset-Klassen. Führen Sie die Maus über die betreffende Asset-Klasse und lesen Sie die ID in der Fußzeile des Browsers ab.
    Alternativ: Klicken Sie die betreffende Asset-Klasse im Explorer des Asset-Moduls an und lesen Sie die ID in der Adresszeile des Browsers ab.
Optional: Sie können die loadingOptions des Contexts ändern (limit, searchLimit, sortOrder usw.)
Als Kenner ist der ObjectType anzugeben, der im Klassen-Widget verwendet wird.
Speichern Sie Ihre Änderungen am SysConfig-Schlüssel.
Klicken Sie im Header der SysConfig auf Lade Frontend-Konfigurationen neu, um die Ansicht im Frontend zu aktualisieren.

Danach ist das zusätzliche Widget in Lokationen enthalten und die der Klasse zugeordneten Assets werden darin angezeigt (sofern ein Standort angegeben ist - s. Voraussetzung).

Weiteführende Informationen:

Konfiguration der Sidebar

Die rechte Sidebar ist ein Object-Info-Widget, dessen anzuzeigende Inhalte Sie individuell konfigurieren können:

Navigieren Sie im Explorer zu System > GUI Konfiguration > Agentenportal.
Suchen und Öffnen Sie den SysConfig-Schlüssel CMDBLocation.
Suchen Sie im Quellcode innerhalb des Abschnitts sidebars den Abschnitt rows.
Im Abschnitt rows werden die im Widget anzuzeigenden Inhalte pro Zeile definiert.

Definieren Sie unter componentData die anzuzeigenden Inhalte und optional unter conditions die Bedingungen für die Anzeige.

Beispiel:

{
   "componentId": "object-avatar-label",
   "componentData": {
      "property": "AnzuzeigenderInhalt"
   },
   "conditions": [
      {
         "property": "<KIX_ASSET_Class>",
         "operator": "NE",
         "value": null,
         "useObjectService": false,
         "useDisplayValue": false
      }
   ],
   "routingConfiguration": {
      "contextId": "config-item-details",
      "objectType": "ConfigItem",
      "contextMode": "DETAILS",
      "objectIdProperty": "ConfigItemID",
      "history": false,
      "resetContext": true,
      "params": null,
      "additionalInformation": [],
      "contextType": "MAIN"
   },
   "routingObjectId": "<KIX_ASSET_ConfigItemID>"
},

Speichern Sie Ihre Änderungen abschließend mit Speichern.
Klicken Sie im Header der SysConfig auf Lade Frontend-Konfigurationen neu, um die Ansicht im Frontend zu aktualisieren.