Skip to main content

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.

standortexplorer.png

Abb.: Konfigurierte Übersicht der Assets pro Standort

Unter Lokationen 1.png 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 die im Contentbereich 2.png anzuzeigenden Assetklassen sowie die in der Sidebar anzuzeigenden Informationen 3.png anpassen.

Voraussetzung

Die Tabellen im Modul Locationen 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 im Contentbereich 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.

  1. Navigieren Sie im Explorer des Admin Moduls zu Assets → Asset Klassen.

    Im Contentbereich wird eine Tabelle geöffnet, welche alle im System hinterlegten Asset-Klassen auflistet.

  2. Doppelklicken Sie auf die betreffende Assetklasse, um deren Detailansicht zu öffnen.

  3. Klicken Sie in der Titelzeile der Detailansicht auf Bearbeiten.

  4. 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
},

  5. Optional: Ändern Sie den Verknüpfungstyp (ReferencedCIClassLinkType) und die Verknüpfungs-Richtung (ReferencedCIClassLinkDirection)

  6. 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).

  7. Klicken Sie abschließend auf Speichern.

Mit dem Speichern wird eine neue Version angelegt. Danach kann den Assets dieser Klasse eine 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 Tabellenwidgets für die Anzeige zusätzlicher Assetklassen hinzufügen.

  1. Stellen Sie sicher, dass an der betreffenden Assetklasse ein Standort hinterlegt werden kann (s. Voraussetzungen).

  2. Navigieren Sie im Explorer des Admin Moduls zu System → GUI Konfiguration → Agentenportal.

  3. Suchen und Öffnen Sie den SysConfig-Schlüssel CMDBLocation.

  4. 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"
}

  5. Alternativ: Soll anstatt "Netzwerk" eine andere Assetklasse angezeigt werden, gehen Sie wie folgt vor:

    standortexplorer_konfig_neues_widget.png

    1. Ändern Sie die Parameter instanceId, configurationId, id, name und title (gelbe Markierungen)

      • Ersetzen Sie die Bezeichnung network durch den Namen der anzuzeigenden Assetklasse.

      • Anstelle von kixpro-cmdb-location-network-list-widget können Sie auch einen anderen, aber eindeutigen, Bezeichner verwenden.

    2. Ersetzen Sie unter objectType die ID der Assetklasse (blaue Markierung).

      Der objectType definiert, welche Assetklasse in der Tabelle angezeigt wird.

      Geben Sie die ID (Nummer) Assetklasse an, deren Assets im Widget angezeigt werden sollen (z. B. für Software: ConfigItem.10).

      Tipp

      Navigieren Sie im Admin Modul zu 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.

  6. Optional: Sie können die loadingOptions des Contexts ändern (limit, searchLimit, sortOrder usw.)

    Achten Sie darauf, dass die ConfigItem.ID mit der vom objectType übereinstimmt.

    standortexplorer_loading-options.png

  7. Klicken Sie abschließend auf Speichern.

  8. Klicken Sie 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 (siehe Voraussetzung).

Weiterführende Informationen:

Konfiguration der Sidebar

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

  1. Navigieren Sie im Explorer des Admin Moduls zu System → GUI Konfiguration → Agentenportal.

  2. Suchen und Öffnen Sie den SysConfig-Schlüssel CMDBLocation.

  3. Suchen Sie im Quellcode innerhalb des Abschnitts sidebars den Abschnitt rows.

    Im Abschnitt rows werden die im Widget anzuzeigenden Inhalte pro Zeile definiert.

  4. 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>"
},

  5. Klicken Sie abschließend auf Speichern.

  6. Klicken Sie auf Lade Frontend-Konfigurationen neu, um die Ansicht im Frontend zu aktualisieren.

Weiterführende Informationen:

In diesem Abschnitt: