Vorwärtspfad-Spezifikationen

Skriptsprache

Standardmäßig werden alle Szenario- und Aufgabenskripts als Visual Basic.NET 2.0 (VB.NET) kompiliert. Eine umfassende Visual Basic.NET-Dokumentation finden Sie unter http://msdn.microsoft.com/en-gb/library/2x7h1hfk.aspx.

Sie können Taskskripts (aber keine Szenarien) als C # 2.0 kompilieren. Starten Sie dazu das Task-Skript mit der folgenden Zeichenfolge:

Language CSharp

Der AppDNA-Skripteditor unterstützt jedoch die Syntaxhervorhebung nur für Visual Basic.NET.

Baugruppenreferenzen

Szenario- und Aufgabenskripts werden im Speicher zu einer .NET-Assembly kompiliert. Sie können daher das gesamte .NET Framework und alle anderen Assemblys im Global Assembly Cache (GAC) verwenden. Sie können beispielsweise eine der Klassen verwenden, die im Namespace System.Collections.Generic verfügbar sind. (SieheMSDN-BibliothekDokumentation zu diesem Namespace.)

Aufgabenskripts verfügen über einen automatischen Verweis auf die Assembly AppDNA.Apptitude.Scripting.

Sie können Assemblys mithilfe der Syntax der LoadAssembly Extension angeben. Zum Beispiel:

LoadAssembly System.Windows.Forms.dll

Wenn sich die Assembly nicht im GAC befindet, müssen Sie den vollständigen Pfad angeben. Dies hat keine Auswirkungen auf die Verwendung von Import mit Namespaces.

<multiline_string>VB-.NET-Erweiterung

Wenn die Sprache VB.NET ist, können Sie die folgende Syntax für Zeichenfolgen verwenden:

<multiline_string>xxxx</multiline_string>

Dabei ist xxxx eine Zeichenfolge. Vor der Kompilierung wandelt der Parser dies in ein VB-.NET-Zeichenfolgenliteral um. Dies macht es einfacher, Zeichenfolgen anzugeben, die mehrere Zeilen innerhalb des Skripts umfassen, als mit der standardmäßigen VB-.NET-Syntax möglich ist.

Zum Beispiel:

Dim s As String  = <multiline_string>;
   '---Some vbscript
   Option Explicit
   Wscript.Echo "string"
   </multiline_string>

Wird:

Dim s As String  = "" & Microsoft.VisualBasic.Constants.vbCRLF & __
"   '---Some vbscript" & Microsoft.VisualBasic.Constants.vbCRLF & _
"   Option Explicit" & Microsoft.VisualBasic.Constants.vbCRLF & _
"   Wscript.Echo ""string""" & Microsoft.VisualBasic.Constants.vbCRLF & _
"   "

Erforderliches Szenario-Skriptformat

Ein einfaches Forward Path Szenario Skript besteht aus einer Funktion, die die Ausgabespalten im Forward Path Bericht definiert. Das folgende Beispiel ist das grundlegende Szenario, das erstellt wird, wenn Sie auf der Hauptsymbolleiste auf Neues Szenario klicken.

Public Function ForwardPath(ByVal currentApplication As Application) As Output

' TODO: Your new Forward Path Logic definition must be defined here.
' For Help, please refer to the sample Forward Path scripts which
' have been provided.

    Dim myForwardpathresult As New Output()

    myForwardpathresult.Outcome = "Sample Outcome"
    myForwardpathresult.Cost = 100
    myForwardpathresult.RAG = RAG.Green

    ForwardPath = myForwardpathresult

End Function

Die Signatur der Funktion ist wichtig, und die Funktion muss ein Output-Objekt zurückgeben, das mindestens eine Ausgabespalte definiert. Wenn Sie dem Szenario Aufgabenskripts zuordnen möchten, müssen Sie die Ausgabespalte Ergebnis definieren.

Beachten Sie, dass ein Application -Objekt an die Funktion übergeben wird. Die Funktion wird für jede aktuell ausgewählte Anwendung ausgeführt, und das Application -Objekt, das an die Funktion übergeben wird, stellt die aktuell verarbeitete Anwendung dar.

Verwenden Sie den Property Explorer auf der rechten Seite des Fensters Forward Path Logic Editor, um die Struktur der Objekte Application und Output zu erkunden. (Das Output -Objekt wird im Property Explorer als ForwardPathReportOutput angezeigt.)

Das Szenarioskript kann zusätzliche Funktionen enthalten, mit denen Sie Anwendungsdaten nach Gruppe aggregieren und Summen auf Berichtsebene generieren können. Weitere Informationen finden Sie unter Gruppierte Forward-Pfad-Berichte.

Erforderliches Aufgabenskriptformat

Aufgabenskripts müssen das folgende Formular haben:

Imports AppDNA.AppTitude.Scripting

Public Class ScriptClass

    Public Function Start(controller As IActionController) As TaskStatusEnum
        ' Do stuff
        Start = TaskStatusEnum.Complete
    End Function

End Class

Die Namen und Zugänglichkeit der Klasse und die Signatur der Funktion sind wichtig. Darüber hinaus sind alle VB-.NET-Konstrukte gültig.

Klicken Sie auf der Symbolleiste auf Task-Skripthilfe, um die Dokumentation der AppDNA-APIs anzuzeigen, die für Task-Skripts verfügbar sind.