1 Themenübersicht
Die Anwendung „Entwicklungsobjekte“ dient der Erfassung und Ansicht von Entwicklungsobjekten verschiedenster Typen. In dieser Dokumentation wird der Typ „Externes Objekt“ beschrieben.
Allgemeine Informationen zur Anwendung „Entwicklungsobjekte“, beispielsweise die Beschreibung der anwendungsbezogenen Aktionen oder des Identifikationsbereichs, finden Sie in dieser Dokumentation: Entwicklungsobjekte
2 Beschreibung
Ein externes Objekt liefert die technische Festlegung zu einer betriebswirtschaftlichen Entität. Ein externes Objekt stellt im Wesentlichen einen Datencontainer ohne fachliche Logik dar. Die konkreten Daten gehören zu den referenzierten Business Objects und werden auch aus Datenbanktabellen gelesen und gespeichert. Attributfestlegungen externer Objekte beziehen sich immer auf die Attribute der referenzierten Business Objects.
Externe Objekte dienen in erster Linie als Schnittstelle für externe Daten. Ein externes Attribut entspricht einer Datenbankspalte eines Business Objects, kann jedoch einen völlig anderen Namen haben.
Als Schnittstellenattribute sind Business Keys vorzuziehen, als Fremdschlüssel sind in den Business Objects die technischen Schlüssel eingetragen. Hierfür besteht in den externen Objekten die Möglichkeit die Fremdschlüssel aufzulösen.
Bei der Generierung des externen Objects wird eine Java-Klasse erzeugt, die den Zugriff auf die Daten ermöglicht.
Die Felder im Einzelnen:
| Feld | Erläuterung |
| Business Entity | Erfassen Sie in diesem Feld das Business Object, auf das sich das externe Objekt beziehen soll. |
| Bezeichnung | Bezeichnung des externen Objekts. |
2.1 Unterer Karteireiter „Externe Spalten“
Die Spalten im Einzelnen:
| Spalte | Erläuterung |
| Name | Der Name des Business Objects, aus dem das Attribut stammt. In den meisten Fällen ist dies der Name des ausgewählten Business Entitys. Sollte das Attribut jedoch aus einem aufgelösten Fremdschlüssel stammen, dann ist dies der Name des Business Objects, auf den die entsprechende Beziehung zeigt. |
| Attributpfad | Name des Attributs bzw. der Spalte aus dem Business Object. |
| Primitiver Typ | Anzeige des Datentyps des Attributs. |
| Ausgewählt
(Checkbox) |
Mit dieser Funktion wählen Sie ein Attribut bzw. eine Spalte des Business Objects als Teil des externen Objekts aus. |
| Externer Name | Erfassen Sie in diesem Feld den Namen für das externe Attribut. Falls gewünscht, können Sie einen abweichenden externen Name angeben. Dies ist auch der Name des Attributes, mit dem Sie es programmatisch über die erzeugte Java-Klasse ansprechen. |
| aufgelöst durch | Wenn ein Fremdschlüsselattribut ausgewählt und aufgelöst wurde, dann wird in diesem Feld der Name des Schlüsselauflösers angezeigt. |
| erzeugt durch | Wenn ein Fremdschlüsselattribut aufgelöst wird, dann entstehen neue Attribute. Diese beziehen sich typischerweise auf ein anderes Business Object. In diesem Feld wird der Name des Schlüsselauflösers angezeigt, durch den dieses Attribut entstanden ist. |
| Kommentar | Kommentar zum Attribut. Die Eingabe ist auf 1000 Zeichen beschränkt. Die Beschreibung ist nicht übersetzbar. Die Kommentare werden in die generierten Java-Sourcen übernommen. Damit kann zum Beispiel ein Attribut als „@deprecated“ gekennzeichnet werden. |
Button „Bearbeiten“
Wenn in der Attributliste eine Zeile ausgewählt ist, für die eine Beziehung festgelegt wurde, dann öffnet sich mithilfe dieses Buttons ein Dialogfenster „Fremdschlüssel auflösen“. In diesem Dialogfenster ist eine Umschlüsselung z. B. auf den Business Key des Zielobjekts möglich.
Das Dialogfenster „Fremdschlüssel auflösen“ öffnet sich, wenn das Attribut in der ausgewählten Zeile in einer Beziehung verwendet wird.
Die Felder des Dialogfensters im Einzelnen:
| Feld | Erläuterung |
| Quell-Objekt | Der Name des Business Objects, das die Quelle der Beziehung darstellt. |
| Beziehung | Typischerweise ist die Beziehung eindeutig über das ausgewählte Attribut des Quell-Business-Objects bestimmt. Allerdings bestehen Ausnahmen, bei denen ein Attribut für mehrere Beziehungen verwendet wird. |
| Ziel-Objekt | Der Name des Business Objects, welches das Ziel der Beziehung darstellt. |
| Ziel-Objektindex | In diesem Feld werden die eindeutigen Schlüssel des Zielobjekts angeboten. Eine sinnvolle Auswahl ist ein besser lesbarer Schlüssel, typischerweise bietet sich der Business Key an. Die Attribute des so ausgewählten Indexes werden als Spalten in das externe Objekt mit aufgenommen. |
| Schlüsselauflöser | Der Name unter dem dieser Schlüsselauflöser bekannt gemacht wird. Der Name wird mit dem Namen der Beziehung und dem Namen des ausgewählten Ziel-Objektindexes vorgeschlagen. |
| Liste der Attribute | |
| Attribut | Anzeige der Attribute gemäß gewählten Ziel-Objektindex. |
Attribut-Filterfeld
Mit dem Attribut-Filterfeld können Sie die Menge der angezeigten Attribute reduzieren. Erfassen Sie dafür im Feld den Namen eines Attributs. Dabei können Sie Platzhalter verwenden.
Der Filter wird angewendet, wenn Sie den Button „Filter anwenden/entfernen“ aktivieren. Wenn der Filter angewendet wird, dann werden in der Liste nur solche Attribute angezeigt, die dem eingegebenen Filterausdruck entsprechen. Sie entfernen den Filter, indem Sie den Button „Filter anwenden/entfernen“ deaktivieren.
Button „Details“
In der Attributliste werden alle Attribute des angegebenen Business Objects angeboten. Dies kann jedoch z. B. auch Part-Attribute umfassen. Drücken Sie den Button „Details“, dann werden alle Attribute detailliert dargestellt, d. h. Sie können dann auch Spalten aus Parts auswählen.
Button „Verwendet“
Dieser Button bietet die Möglichkeit, die Anzeige auf bereits verwendete Attribute zu reduzieren.
2.2 Unterer Karteireiter „Fremdschlüssel“
Ein Fremdschlüssel verbindet über eine Beziehung ein Business Object mit einem anderen. Typischerweise sind Fremdschlüsselattribute technischer Natur und repräsentieren den Primary Key des Ziel-Business-Objects. Hat das Ziel-Business-Object auch lesbare Schlüssel, typischerweise einen Business Key, dann sind diese Attribute in Schnittstellen für die Datenübernahme besser geeignet. In dieser Liste werden die verwendeten Fremdschlüsselauflöser dargestellt.
Die Spalten im Einzelnen:
| Spalte | Erläuterung |
| 1. Überschriftenzeile | |
| Schlüsselauflöser | Name des Schlüsselauflösers. Bei der Erzeugung wird der Name mit dem Namen der Beziehung und dem Namen des verwendeten Zielindex vorgeschlagen. |
| Quell-Objekt | Der Name des Business Objects, das die Quelle der Beziehung darstellt. |
| Ziel-Objekt | Der Name des Business Objects, welches das Ziel der Beziehung darstellt. |
| 2. Überschriftenzeile | |
| Quell-Attribut | Der Name des Attributs im Quell-Business-Object der Beziehung. Eine Beziehung wird durch ein oder mehrere Kombinationen aus Quell- und Zielattributen beschrieben. |
| Ziel-Attribut | Der Name des Attributs im Ziel-Business-Object der Beziehung, auf das sich das Quell-Attribut bezieht. |
| 3. Überschriftenzeile | |
| Auflösendes Attribut | Die Definition eines Fremdschlüsselauflösers ist sinnvoll, wenn im Ziel-Business-Object ein für die Datenübernahme besser geeigneter, eindeutiger Schlüssel existiert, z. B. ein Business Key. Das oder die Attribute des so aufgelösten Schlüssels werden in dieser Spalte angezeigt. |
| Verwendeter Auflöser | Die Auflösung von Fremdschlüsseln kann mehrstufig erfolgen. Wenn z. B. der im ersten Schritt aufgelöste Schlüssel selbst ein Fremdschlüsselattribut enthält, dann kann man dieses Attribut ebenfalls auflösen. Dafür wird ein weiterer Fremdschlüsselauflöser benötigt, dessen Name in dieser Spalte angezeigt wird. |