Neues empfohlenes Steuerelement hinzufügen

Sie können ein neues empfohlenes Steuerelement für Benutzeroberfläche definieren, indem Sie dessen Namen der Liste vorhandener Steuerelemente für Benutzeroberfläche hinzufügen und dann die Eigenschaften des neuen empfohlenen Steuerelements definieren.

1. Führen Sie das folgende Ziel aus, um die Datei controls_v2.properties zur Anpassung abzurufen:

   
   sdk customize WEB-INF/properties/controls_v2.properties

   Bei der Ausführung dieses Ziels wird die Datei controls_v2.properties im Verzeichnis <VM_installdir>/projects/matrix/WEB-INF/properties gespeichert.

2. Erstellen Sie eine neue Eigenschaftendatei für angepasste Steuerelemente, z. B. custom_controls_v2.properties, und fügen Sie die empfohlenen Steuerelementdetails in dieser Datei hinzu. Informationen dazu, wie Sie die Details zum neuen empfohlenen Steuerelement in der neu erstellten Datei custom_controls_v2.properties eingeben, finden Sie in der Basiskonfigurationsdatei controls_v2.properties , die von der Anwendung bereitgestellt wird.
3. Bearbeiten Sie die neu erstellte Datei custom_controls_v2.properties und führen Sie die folgenden Aufgaben durch:
   1. Fügen Sie den Namen des UI-Steuerelements, für das Sie dieses neue empfohlene Steuerelement hinzufügen möchten, zur durch Kommas getrennten Liste der Werte für das Attribut controls_v2 hinzu.

      Wenn Sie beispielsweise das neue empfohlene Steuerelement für Steuerung der Mehrfachauswahl hinzufügen, kann das Attribut controls_v2 wie folgt definiert werden:

      
      controls_v2=ABC_CUSTOM,MULTISELECTION

   2. Fügen Sie den Namen des neuen empfohlenen Steuerelements MY_WIDGET zur durch Kommas getrennten Liste der Werte für das Attribut <UICONTROL>.recommendations hinzu.

      Um beispielsweise ein neues empfohlenes Steuerelement "MY_WIDGET" für Steuerung der Mehrfachauswahl hinzuzufügen, kann das Attribut MULTISELECTION.recommendations wie folgt definiert werden:

      
      MULTISELECTION.recommendations=CHECKBOX,MULTISELECTIONLISTBOX,MULTISELECTIONTABULARDISPLAY,MY_WIDGET

   3. Definieren Sie die Eigenschaften des neuen empfohlenen Steuerelements.

      So können Sie z. B. die Eigenschaften des neuen Steuerelements "MY_WIDGET" wie folgt definieren:

      MY_WIDGET.name=My Widget
      MY_WIDGET.value=v2:myWidget

      Hinweis Stellen Sie sicher, dass Sie die Eigenschaften für das neue empfohlene Steuerelement an die vorhandenen Einträge anhängen. Löschen Sie NICHT die vorhandenen Eigenschaften für das Steuerelement, für das Sie dieses neue empfohlene Steuerelement hinzufügen.
4. Bearbeiten Sie die Datei <VM_wardir>/WEB-INF/properties/Comergent.xml (<VM-Verzeichnis> bezieht sich auf das WAR-Verzeichnis unter dem EAR-Verzeichnis in der implementierten Visual Modeler -Anwendung.) und geben Sie den Pfad der Datei custom_controls_v2.properties wie folgt an:

   <VisualModeler displayName="VisualModeler" visible="true">
   
                  <UIControls controlType="text" runtimeDisplayed="true" ChangeOnlyAtBootTime="false"
                   visible="true" boxsize="60"
                   displayQuestion="Custom UI Controls"
                   defaultChoice=""
                   help="Enter custom UI control property file(s)">WEB-INF/properties/custom_controls_v2.properties</UIControls>
                   
   </VisualModeler>

5. Erstellen Sie eine neue JAR-Datei, z. B. extensions.jar, die die Datei custom_controls_v2.properties enthält.
6. Kopieren Sie die in Schritt 5 erstellte JAR-Datei in das Verzeichnis <extensions_repository> . Falls dieses Zielverzeichnis nicht vorhanden ist, erstellen Sie es. Die Position des <USER_HOME> -Ausgangsverzeichnisses kann von Betriebssystem zu Betriebssystem variieren.
7. Legen Sie die folgende Eigenschaft in der Datei <property_repository>/configurator-ext.properties fest. Falls die Datei nicht vorhanden ist, erstellen Sie sie. Geben Sie im Wert für diese Eigenschaft die durch Kommas getrennte Liste mit Namen von Steuereigenschaftendateien an.

   control.handler.files = /controls.properties,/controls_v2.properties,/custom_controls_v2.properties

   Hinweis: Der Wert dieser Eigenschaft sollte immer zuerst auf die von der Anwendung bereitgestellte Datei verweisen, gefolgt von durch Kommas getrennten angepassten Dateien. Der Pfad für die benutzerdefinierte Datei ist der kontextrelative Pfad, über den die Datei in der Datei extensions.jar gespeichert ist.
8. Führen Sie das folgende Zielelement aus, um die Anpassungen in den Build aufzunehmen:

   
   sdk merge
   

9. Wenn Sie die Anwendung Visual Modeler als WAR-Datei implementieren, führen Sie die folgenden Schritte aus:
   1. Führen Sie das folgende Zielelement aus, um die WAR-Datei neu zu erstellen:

      
      sdk distWar
      

   2. Implementieren Sie die Datei .war auf Ihrem Anwendungsserver.
10. Starten Sie die IBM® Sterling Omni-Configurator-Anwendung neu.