Seitenhistorie

Definition

...

Objektgenerierung

...

Menüaufruf: (Administration) - (Stammdaten) - (Sonstige) - (ArbeitsschrittObjektgenerierung)

Arbeitsschritte Objektgenerierungen dienen dazu, aus einem Entitätsobjekt einem Businessobjekt ein anderes, fachlich damit zusammenhängendes Entitätsobjekt zusammenhängendes Businessobjekt zu erzeugen, Daten aus dem Quellobjekt in das Zielobjekt zu übertragen und Quell- und Zielobjekt miteinander zu verknüpfen.

Reiter:

...

Objektgenerierung

Die Daten auf diesem Reiter dienen dazu, den Arbeitsschritt im System zu verankern und dabei zu bestimmen, wo und wann er angezeigt und ausgeführt werden soll. Es muss ein eindeutiger Name angegeben werden. Die Beschriftung legt den Text fest, der später in der Combobox Arbeitsschritt in der Detailmaske des Datensatzes angezeigt wird; falls Nur intern verwenden ausgewählt ist, wird dieser Arbeitsschritt nicht in der Combobox angezeigt, sondern kann nur von Regeln angestoßen werden.

Im Feld Quellentität Quellbusinessobjekt wird die Entität das Businessobjekt ausgewählt, für das dieser Arbeitsschritt angestossen werden soll. Im Unterformular kann der Arbeitsschritt jetzt noch für gewisse Status bzw. Aktionen erlaubt werden oder nicht: unter Status wird der Status eingetragen, Bemerkung ist frei für eigene Notizen und unter Aktion kann auch noch die Aktion gesetzt werden. Nur wenn der Datensatz sich in diesem Zustand befindet, ist die Combobox für den Benutzer sichtbar.

Unter Zielentität Zielbusinessobjekt wird angegeben, welcher Objekttyp hervorgehen soll und unter Aktion lässt sich auch hier die Aktion einschränken. Das neue Objekt wird mit der ausgewählten Aktion erzeugt. Die Bemerkung ist frei für eigene Notizen.

Sowohl die Quellentität das Quellbusinessobjekt als auch die Zielentität das Zielbusinessobjekt sind nur auswählbar, wenn sie über ein Statusmodell verfügen.

Die Parameterentität Das Parameterbusinessobjekt ermöglicht es, zusätzliche Felder aus dieser Parameterentität diesem Parameterbusinessobjekt zu übernehmen. Ist eine Parameterentität ein Parameterbusinessobjekt angegeben, wird der Anwender bei Ausführung des Arbeitsschrittes aufgefordert, einen Datensatz aus dieser Parameterentität diesem Parameterbusinessobjekt auszuwählen. Dieser wird dann per Definition entsprechend herangezogen.

Reiter: Zu übernehmende Attribute

In diesem Unterformular werden alle Attribute zur Auswahl angeboten, die in den Layouts sowohl von Quell- als auch Zielobjekt vorhanden sind. Der entsprechende Wert wird beim Ausführen des Arbeitsschrittes von dem Quellobjekt in das Zielobjekt kopiert.

...

Soll das Quellattribut aus der Parameterentität dem Parameterbusinessobjekt stammen, muss in der Spalte Quellobjekttyp zunächst 'parameter' ausgewählt werden. Im Quellattribut werden dann alle Felder der Parameterentität des Parameterbusinessobjekts vorgeschlagen. Lässt man dieses Feld leer, so werden die Felder des eigentlichen Quellobjektes vorgeschlagen.

Reiter: Zu übernehmende Unterformulare

Auf dieser Reiterkarte werden die Unterformular-Entitäten Businessobjekte sowohl vom Quell- als auch vom Zielobjekt zur Auswahl angeboten. Es werden alle Spalten übernommen, deren Feldnamen in beiden Entitäten Businessobjekte identisch sind. Soll das Quellattribut aus der Parameterentität Parameterbusinessobjekt stammen, muss in der Spalte Quellobjekttyp zunächst 'parameter' ausgewählt werden. Im Quellattribut werden dann alle Felder der Parameterentität des Parameterbusinessobjekts vorgeschlagen. Lässt man dieses Feld leer, so werden die Felder des eigentlichen Quellobjektes vorgeschlagen.

Reiter: Auszuführende Regeln

Es gibt Fälle, in denen es nicht ausreicht einfach ein Attribut oder Unterformular zu kopieren; z.B. wenn einzelne Felder aus einem Unterformular in Attribute oder umgekehrt kopiert oder Werte berechnet oder aus anderen Objekten ermittelt werden müssen.

...

In der Regel gilt das Serverobjekt immer für das neu zu erzeugende Objekt (Zielobjekt).

Ids von Quell- /Ziel- oder

...

Parameterbusinessobjekte setzen

Anwendungsfall: Im Zielobjekt befindet sich ein ID-Feld (Combobox oder LOV), dass eine Referenz zum Quellobjekt darstellen soll.

...

// Id des Quellobjektes
Integer probandId = server.getSourceObjectContainerCVO().getGenericObject().getId();
// Wert eines Feldes im Quellobjekt
String probandName = (String)server.getAttribute(probandId, "name").getValue();
 
//Id in Zielobjekt in dafür vorgesehenes ID Feld eintragen
server.setField("Kandidat", "proband", probandId, probandName);

ID von Parameterentität Parameterbusinessobjekt setzen -> Parameterentität Parameterbusinessobjekt besitzt ein Statusmodell !

// Id der ParameterentitätParameterbusinessobjekt
Integer kandidantenlisteId = server.getParameterObjectContainerCVO().getGenericObject().getId();   
// Wert eines Feldes in der ParameterentitätParameterbusinessobjekt
String kandidatenliste = (String)server.getAttribute(kandidantenlisteId, "namederliste").getValue();
 
//Id in Zielobjekt in dafür vorgesehenes ID Feld eintragen
server.setField("Kandidat", "kandidatenliste", kandidantenlisteId, kandidatenliste);

ID von Parameterentität Parameterbusinessobjekt setzen -> Parameterentität Parameterbusinessobjekt besitzt KEIN Statusmodell !

// Id der ParameterentitätParameterbusinessobjekt
Integer kandidantenlisteId = (Integer)server.getParameterObjectContainerCVO().getMasterData().getId();
// Wert eines Feldes in der ParameterentitätParameterbusinessobjekt
String kandidatenliste = (String)server.getFieldValue("Kandidatenliste", kandidantenlisteId, "namederliste");
 
//Id in Zielobjekt in dafür vorgesehenes ID Feld eintragen
server.setField("Kandidat", "kandidatenliste", kandidantenlisteId, kandidatenliste);

Objektgenerierung starten / ausführen

Im Detaildatensatz des entsprechenden Entitätsobjekts steht im definierten Status eine Combobox Arbeitsschritt zur Verfügung.

...

Nach Betätigung wird ein Objekt vom Typ des definierten Zielobjektes erzeugt. Die definierten Attribute und Unterformulardaten werden dabei übernommen und die definierten Regeln ausgeführt. Das Objekt wird, sofern alle Pflichtfelder durch die Übernahme gefüllt wurden, gleich gespeichert. Sind nicht alle Pflichtfelder gefüllt, so erscheint eine Hinweismeldung das nachzuholen. Das Objekt muss anschließend gespeichert werden.

Objektbeziehungen / Relationen

Durch den Arbeitsschritt wird automatisch eine Beziehung (Nachfolgebeziehung) zwischen den Objekten hergestellt.

...