Includes (JOBI)

{"URL":["/*.*/awa/pa_view_JOBI"],"heroDescriptionIdentifier":"ice_JOBI_intro","customCards":[{"id":"ice_jobi_def_and_conf","title":"Defining Include Objects","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/AWA/Objects/obj_include.htm","languages":["en-us"]},{"id":"ice_ConfigIncludeForExternalInterpreters","title":"Configuring Include Objects for External Interpreter Calls","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/AWA/Objects/obj_include.htm","languages":["en-us"]},{"id":"ice_jobi_using_in_trailers_and_headers","title":"Include Objects in Headers and Trailers","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/AWA/Objects/obj_JobUsingIncludes.htm","languages":["en-us"]},{"id":"ice_jobis_list","title":"List of Header and Trailer Includes with User Includes","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/AWA/Objects/obj_JobUsingIncludes.htm","languages":["en-us"]},{"id":"ice_ExecutingObjects","title":"Executing Objects","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/AWA/Executions/obj_Executing_overview.htm","languages":["en-us"]},{"id":"ice_scripting_and_the_ae_scripting_language","title":"The Automation Engine Scripting Language","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/Script/Writing/AE_Scripting_Language.htm","languages":["en-us"]},{"id":"ice_JOBIExplainer","title":"Analyzing the Code in Include Objects Using Gen AI","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/AWA/Objects/obj_include_GenAI.htm","languages":["en-us"]},{"id":"ice_script_processing","title":"Script Processing","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/Script/Writing/Script_Processing_Order.htm","languages":["en-us"]},{"id":"ice_writing_scripts","title":"Writing Scripts","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/Script/Writing/Script_Writing.htm","languages":["en-us"]},{"id":"ice_working_with_script_editor","title":"Working with the Script Editor","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/Script/Writing/obj_Wkg_ScriptEditor.htm","languages":["en-us"]},{"id":"ice_arithmetic_calculations_in_scripts","title":"Calculations","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/Script/Writing/Script_Arithmetics.htm","languages":["en-us"]},{"id":"ice_script_elements_for_editing_strings","title":"Editing Strings","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/Script/Reference/Overview/Strings_Script.htm","languages":["en-us"]},{"id":"ice_error_handling_in_scripts","title":"Error Handling","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/Script/Writing/Script_Error_Handling.htm","languages":["en-us"]},{"id":"ice_reusing_script_components","title":"Reusing Scripts","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/Script/Writing/Script_Reuse.htm","languages":["en-us"]},{"id":"ice_ae_script_reference","title":"Automation Engine Script Reference","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/Script/Reference.htm","languages":["en-us"]},{"id":"ice_working_with_objects","title":"Working with Objects","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/AWA/Objects/obj_WorkingWithOverview.htm","languages":["en-us"]},{"id":"ice_AWIs_CommonFunctions","title":"Common Functions","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/_Common/CommonFunctions/CF_OverviewOfChapter.htm","languages":["en-us"]},{"id":"ice_UnderstandingPA","title":"Understanding the Process Assembly Perspective","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/AWA/Objects/ProcessAssembly.htm","languages":["en-us"]},{"id":"ice_Overview_AWI","title":"Understanding the User Interface","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/_Common/GettingStarted/GS_OverviewAWI.htm","languages":["en-us"]}]}

Verwenden Sie Include-Objekte, um Codeblöcke zu speichern, die Sie häufig benötigen und die Sie in mehreren Scripts wiederverwenden möchten. Include-Objekte helfen Ihnen dabei, sicherzustellen, dass Ihre Scripts konsistent sind. Sie reduzieren Ihren Entwurfs- und Wartungsaufwand. Sie verwenden diese Codeblöcke wieder, indem Sie in den Scripts ausführbarer Objekte :INCLUDE oder :INC eingeben und ein Include-Objekt auswählen. Damit wird das Include-Objekt in das Script eingefügt.

Weitere Informationen zur Verwendung von Include-Objekten im Script-Editor finden Sie unter Include-Objekte in Scripts verwenden.

Mit Gen AI von Automic Automation können Sie den Code in Ihrem Include-Objekt zusammenfassen und analysieren. Wenn Probleme gefunden werden, weist sie darauf hin und bietet potenzielle Lösungen. Weitere Informationen finden Sie unter Analysieren von Code in Include-Objekten mithilfe von Gen AI.

Tipps:

Schränken Sie die Berechtigung zum Bearbeiten von Include-Objekten ein, wenn diese Objekte in unterschiedlichen Aufgaben von unterschiedlichen Benutzern verwendet werden
Ein Beispiel für die Wiederverwendung von Codezeilen finden Sie unter Script-Komponenten wiederverwenden

Objektklasse: Passives Objekt

Objekttyp/Kurzname: JOBI

Diese Seite beinhaltet Folgendes:

Include-Objekte definieren

Klicken Sie in der Perspektive Process Assembly auf Objekt hinzufügen. Wählen Sie im Dialogfeld Objekt hinzufügen die Option Include (JOBI) aus. Weitere Informationen zum Hinzufügen von Objekten finden Sie unter Hinzufügen von Objekten.

Eine Include-Objektdefinition besteht aus den folgenden Seiten:
- Standardseiten, die unabhängig von dem von Ihnen definierten Objekttyp zu jeder Zeit verfügbar sind:
- Seite Prozess
Hinweis: Sie können Periodenobjekte auch direkt über die Kombinationsfelder erstellen, die zur Auswahl von Objekten dienen, siehe AWI-Kombinationsfelder verwenden.
Geben Sie im Dialogfeld Objektname den Namen des neuen Objekts ein. Wählen Sie ihn mit Bedacht aus. Weitere Informationen finden Sie unter Best Practices: Namenskonventionen für Objekte.
Klicken Sie auf OK, um die Objektdefinitionsseiten zu öffnen.
Schreiben Sie den Code-Block auf die Seite Prozess.

Wichtig!
- Variablen in Include-Objekten
  
  Wenn das Include-Objekt Variablen enthält, müssen die Variablen in dem Objekt, in das das Include eingefügt wird, definiert und initialisiert werden. Andernfalls können Sie die Variable nicht vom Include an das Objekt übergeben.
- Script-Funktionen im Include-Objekt
  
  Script-Funktionen im Include-Objekt beziehen sich auf das Objekt, in das Sie es eingefügt haben.
- Include-Objekte verschachteln
  
  Sie können bis zu 16 Includes in Includes schachteln.
- JCL in Include-Objekten
  
  Sie können JCL-Zeilen (Job Control Language) verwenden, wenn das Include-Objekt in einen Job eingefügt wird.
Weitere Informationen finden Sie auch unter Include-Objekte (JOBI) in Headern und Trailern.

Konfigurieren von Include-Objekten für externe Interpreter-Aufrufe

Mandant 0 beinhaltet zwei Objekte, die Sie in Ihren Scripts verwenden können, um externe Interpreter und deren Scripts zu definieren:

REGISTER_VARIABLE.WINDOWS
REGISTER_VARIABLE.UNIX

Rufen Sie diese Objekte mithilfe der Anweisung _REGISTER_VARIABLE auf. Diese Anweisung muss mit den Anweisungen :BEGIN_EXT_INTERPRETERS und :END_EXT_INTERPRETERS auf der Prozessseite des Jobs kombiniert werden. Beide Anweisungen sind unter Windows und UNIX verfügbar.

Wichtig! Kontaktieren Sie Ihren Administrator, um diese beiden Objekte zu konfigurieren, da ihre Einstellungen systemweit verfügbar sind.

Beispiele

Default-Script (Windows)

Das Include-Objekt REGISTER_VARIABLE.WINDOWS enthält das folgende Standard-Script:

: set &uc_register_varname = sys_last_registered_varname()
:set &uc_register_valuename = sys_last_registered_valuename()
:set &uc_register_otype# = sys_act_me_type()
:if &uc_register_otype# = 'JOBS'
: set &uc_windows_typ = get_att(win_typ)
: IF &UC_WINDOWS_TYP = "BAT"

&UC_JOBMD JNR=&UC_REALNR MNR=&UC_MANDANT PNR=&UC_IP_PORT IPA=&UC_IP_ADR TYP=V VTYPE=T NAME=&uc_register_varname VALUE=&uc_register_valuename
: ENDIF
!:DATA @set retcodemsg=%errorlevel%
!:DATA @set retcode=0
!:DATA @if NOT %retcodemsg% == 0 GOTO :MSGABORT
: ENDIF
:endif

Perl als externer Interpreter unter Windows

Wenn Sie Perl als externen Interpreter unter Windows verwenden möchten, geben Sie folgendes Script im Standard-Script für Windows (siehe Beispiel oben) zwischen den Anweisungen :IF und :ENDIF ein und definieren Sie die Variable &UC_WINDOWS_TYP:

: IF &$EXT_INTERPRETER# = 'PERL'
: SET &UC_PATH_JOBMD# = STR_SUB("&UC_JOBMD", "\", "\\")
system("&UC_PATH_JOBMD# JNR=&UC_REALNR MNR=&UC_MANDANT PNR=&UC_IP_PORT IPA=&UC_IP_ADR TYP=V VTYPE=T NAME=&uc_register_varname
VALUE=&uc_register_valuename");
: ELSE

Standard-Scripts für UNIX

Das Include-Objekt REGISTER_VARIABLE.UNIX enthält das folgende Standard-Script:

: set &uc_register_varname = sys_last_registered_varname()
:set &uc_register_valuename = sys_last_registered_valuename()
:set &uc_register_otype# = sys_act_me_type()
:if &uc_register_otype# = 'JOBS'
&UC_JOBMD JNR=&UC_REALNR MNR=&UC_MANDANT PNR=&UC_IP_PORT IPA=&UC_IP_ADDR TYP=V VTYPE=T NAME=&uc_register_varname VALUE=&uc_register_valuename
:endif

Siehe auch: