MODIFY_UC_OBJECT

Verwenden Sie die Script-Funktion MODIFY_UC_OBJECT, um bestimmte Attribute eines aktivierten Objekts zu ändern. Wenn Sie diesen Attributen neue Werte zuweisen, sind diese Werte nur für die aktuelle Ausführung der Aufgabe gültig und werden nicht im Objekt gespeichert.

Syntax

MODIFY_UC_OBJECT (RunID, Attribut, Wert)

Parameter

• MODIFY_UC_OBJECT
  Ändert das Attribut eines aktivierten Objekts
• RunID
  Ausführungsnummer des aktivierten Objekts
  Format: Script-Literal, Zahl oder Script-Variable
  Hinweis: Wenn Sie das Attribut EARLIEST_STARTTIME verwenden, müssen Sie die RunID des Workflows angeben, zu dem die Aufgabe gehört, und nicht die RunID der Aufgabe.
• Attribut
  Attribut, welches geändert werden soll. Die Liste der verfügbaren Attribute finden Sie unten.
  Format: AE-Name oder Script-Variable
• Wert
  wert, der für das Attribut festgelegt werden soll, das Sie ändern möchten
  Format:AE Name, Script-Literal, Zahl oder Script-Variable

Attribute

Abhängig vom Objekttyp können Sie die Werte verschiedener Attribute ändern:

• CALL
  Attribut: RESPONSE
  Reagiert auf eine Benachrichtigung
  Werte:
  • OK
    Bestätigt eine Benachrichtigung (Meldung)
  • YES
    Reagiert auf eine Benachrichtigung (Meldung)
  • NO
    Reagiert auf eine Benachrichtigung (Meldung)
  • ACCEPT
    Akzeptiert eine Benachrichtigung (Warnmeldung)
  • REJECT
    Weist eine Benachrichtigung zurück (Warnmeldung)
  • DONE
    Löst eine Benachrichtigung auf (Warnmeldung)

  Rückgabewerte:

  • 20539
    Die Benachrichtigung mit der angegebenen RUN# existiert nicht.
  • 20538
    Der Wert ist nicht korrekt.
  • 11151
    Der Wert für das Attribut RESPONSE trifft nicht für den Benachrichtigungstyp (Alarm, Anfrage, Meldung) zu.
  • 11060
    Die Kombination Benachrichtigung/Wert wird nicht unterstützt.
  • 11061
    Die Benachrichtigung wurde schon von einem anderen Benutzer akzeptiert.
  • 11062
    Die Bestätigung der Benachrichtigung kommt von einem Benutzer, der nicht im Benachrichtigungs-Objekt vorhanden ist.
  • 1064
    Die Ablehnung der Benachrichtigung kommt von einem Benutzer, der nicht im Benachrichtigungs-Objekt vorhanden ist.
  • 20859
    Die Reaktion auf die Benachrichtigung kommt von einem Benutzer, der inaktiv im Benachrichtigungs-Objekt vorhanden ist.
    
• JOBG
  Attribut: GR_MAX_PAR_JOBS
  Definiert die maximale Anzahl parallel ausgeführter Aufgaben in einer Gruppe
  Wert: 1-999
  Rückgabewerte:
  • 11121
    Die RUN# wurde nicht gefunden.
  • 20460
    Der Wert liegt nicht zwischen 1 und 999.
• JOBP
  Attribute:
  • RELEASE
    Gibt einen blockierten Workflow frei
    Wert: RUN# der blockierten Aufgabe im Workflow
    Rückgabewerte:
    • 11016
      Der zu ändernde Workflow existiert nicht
    • 11510
      Der Workflow ist nicht aktiv
    • 20540
      Die RUN# wurde nicht gefunden

Für die folgenden drei Workflow-Attribute muss sich die zu ändernde Aufgabe im Zustand Warten auf Vorbedingung befinden.

• GOIMM
  Startet eine Workflow-Aufgabe sofort
  Wert: Der Name der Aufgabe, der nur einmal im Workflow verwendet werden darf.
• EARLIEST_STARTTIME
  Ändert die früheste Startzeit einer Aufgabe in einem Workflow. Die Startzeit wird der Aufgabe zugewiesen bzw. ersetzt eine bereits gesetzte.
  Werte: Entweder die früheste Startzeit im Format HHMMSS, wenn kein bestimmtes Format definiert ist, oder das Schlüsselwort OFF, das eine vorhandene Startzeit entfernt. In beiden Fällen benötigt die Script-Funktion den Aufgabennamen:
  Syntax:
  Aufgabenname, [Zeitformat;]Zeit oder
  Aufgabenname, OFF
• REMOVE_DEPENDENCY
  Entfernt die Abhängigkeit zum direkten Vorgänger der Aufgabe. Die Aufgabe ignoriert den erwarteten Endstatus, der auf der Eigenschaftsseite Zeit und Abhängigkeiten des angegebenen Vorgängers festgelegt wird. Das hat zur Folge, dass die Verarbeitung der Aufgabe fortgesetzt wird, wenn diese Aufgabe erreicht wird, sofern alle anderen Vorgänger schon beendet wurden. Es wird kein bestimmter Vorgänger angegeben, alle Vorgänger werden ignoriert und die Aufgabe wird sofort gestartet. Weitere Informationen finden Sie unter Zeit und Abhängigkeiten.
  Syntax:
  Aufgabenname [, Vorgängername ]

Rückgabewerte:

• 11557
  Der Job '&01' (RunID: '&02') wurde bereits über die Option Sofort ausführen gestartet.
• 20378
  Der Workflow konnte nicht gefunden werden.
• 20840
  Die Aufgabe erscheint mehr als einmal im Workflow.
• 20841
  Die angegebene Aufgabe ist im Workflow nicht vorhanden.

• CALL, JOBF, JOBP, JOBS, JSCH, SCRI
  Attribut: PRIORITY
  Aufgabenpriorität
  Wert: 0-255
  Rückgabewerte:
  • 20591
    Die RUN# wurde nicht gefunden
  • 20587
    Der Wert liegt nicht zwischen 0 und 255
    
• Workflow-Aufgaben
  Attribute:
  • IGNORE_CONDITIONS
    Startet eine Workflow-Aufgabe sofort, die sich im Status Warten auf Vorbedingungen befindet.
    Wert: Nicht erforderlich.
    Weitere Informationen finden Sie unter Bedingungen, Vorbedingungen, Nachbedingungen.
  • CHECK_CONDITIONS
    Startet die Überprüfung der Bedingungen/Aktionen einer Workflow-Aufgabe, die sich im Status Warten auf Vorbedingungen befindet, vom Anfang an.
    Wert: Nicht erforderlich
• CALL, EVNT, JOBF, JOBG, JOBP, JOBQ,JOBS, JSCH, SCRI
  Attribute: IGNORE_QUEUE
  Startet eine Aufgabe, die sich in einer Wartebedingung befindet, sofort, weil ungenügend Queue-Slots vorhanden sind
  Wert: Nicht erforderlich
• JOBS, JOBF und JOBD
  Attribut: SET_EXPRESS
  Startet eine Aufgabe sofort, die sich im Status Warten auf Ressource befindet
  Werte: ON oder OFF
• Alle ausführbaren Objekte
  Attribut: IGNORE_SYNC
  Sync-Objekteinstellungen werden ignoriert. Der Wert spielt dabei keine Rolle, dennoch ist dieser Parameter anzugeben.
  Beispiel: MODIFY_UC_OBJECT( &RUNNR#, IGNORE_SYNC, "")
  Rückgabewert:
  • 11191
    Die RUN# wurde nicht gefunden
    
• Periodische Aufgabe
  Attribut:GAP
  Ändert den Zeitabstand zwischen den Ausführungen in einer periodischen Aufgabe.
  Wert: In Minuten angegeben
  Rückgabewerte:
  • 20534
    Der Wert "0" ist nicht erlaubt
  • 20591
    RUN# wurde nicht gefunden.
  • 20860
    Dies ist keine periodische Aufgabe
  • 20861
    Die Option "Mit einem Abstand von...." wurde in der periodischen Aufgabe nicht ausgewählt.

Hinweise:

• Die Aufgabe, die Sie ändern möchten, muss bereits generiert worden sein, sich jedoch noch in einer Wartebedingung befinden. Die Aufgabe muss so konfiguriert werden, dass sie bei der Aktivierung generiert wird, nicht zur Laufzeit. Wenn Sie eine Aufgabe zum Zeitpunkt der Generierung ändern müssen, verwenden Sie stattdessen :PUT_ATT.
• Generierung zum Aktivierungszeitpunkt oder zur Laufzeit
• :PUT_ATT
• Die Script-Anweisung bewirkt, dass alle offenen Transaktionen des Scripts in die AE-Datenbank geschrieben werden. Weitere Informationen finden Sie unter Script-Verarbeitung.

Allgemeine Rückgabewerte

• 0
  Die Änderung des Attributs war erfolgreich
• 20342
  Das Attribut wird nicht unterstützt
  

Beispiele

Das erste Beispiel zeigt, wie Sie eine Benachrichtigung (Anforderung) bestätigen können. Der erste Schritt bestimmt die RUN# und speichert sie in der Script-Variablen &RUNNR#.

:SET &RUNNR# = ACTIVATE_UC_OBJECT("Nachtschicht")
!...
:SET &MODOBJ# = MODIFY_UC_OBJECT(&RUNNR#, RESPONSE, OK)

Das zweite Beispiel aktiviert eine Gruppe und speichert die RUN# in einer Script-Variablen. Die Anzahl der parallel ausgeführten Aufgaben in der Gruppe wird auf 1 gesetzt. Ausgewählte Aufgaben können nur nacheinander verarbeitet werden.

:SET &RUNNR# = ACTIVATE_UC_OBJECT("GRP7")
:SET &MODOBJ# = MODIFY_UC_OBJECT( &RUNNR#, GR_MAX_PAR_JOBS, 1)

Die folgenden Beispiele zeigen Änderungen in einer Aufgabe, die in einem Workflow läuft:

!Der Job "MM.CLOSING" soll sofort gestartet werden.
:SET &RUNNR# = GET_UC_OBJECT_NR(MM.DAY)
:SET &MODOBJ# = MODIFY_UC_OBJECT(&RUNNR#, GOIMM, "MM.CLOSING")

!Der Job "MM.CLOSING" soll nicht vor 15:00 Uhr ausgeführt werde.
:SET &RUNNR# = GET_UC_OBJECT_NR(MM.DAY)
:SET &MODOBJ# = MODIFY_UC_OBJECT(&RUNNR#, EARLIEST_STARTTIME, "MM.CLOSING","150000")

!Der Job "MM.CLOSING" soll die früheste Startzeit ignorieren.
:SET &RUNNR# = GET_UC_OBJECT_NR(MM.DAY)
:SET &MODOBJ# = MODIFY_UC_OBJECT(&RUNNR#, EARLIEST_STARTTIME, "MM.CLOSING", OFF)

!Der Job "MM.CLOSING" soll die Abhängigkeit vom Vorgänger "MM.DAY_END" ignorieren.
:SET &RUNNR# = GET_UC_OBJECT_NR(MAWI.TAG)
:SET &MODOBJ# = MODIFY_UC_OBJECT(&RUNNR#, REMOVE_DEPENDENCY, "MM.CLOSING", "MM.DAY_END")

Tipp: Verwenden Sie die Script-Anweisung :ON_ERROR, um Maßnahmen für den Fall zu definieren, dass der Export fehlschlägt. Weitere Informationen finden Sie unter Script-Elemente zur Fehlerbehandlung.

Siehe auch: