AppDNA

Especificaciones de Forward Path

Lenguaje del script

De forma predeterminada, todos los scripts de caso y tarea se compilan como Visual Basic .NET 2.0 (VB .NET). Para obtener documentación completa de .NET de Visual Basic, consulte http://msdn.microsoft.com/en-gb/library/2x7h1hfk.aspx.

Puede elegir compilar scripts de tareas (pero no casos) como C # 2.0. Para ello, inicie el script de tarea con la siguiente cadena:

Language CSharp

Sin embargo, el editor de scripts AppDNA admite el resaltado de sintaxis solo para Visual Basic .NET.

Referencias de ensamblaje

Los scripts de caso y tarea se compilan en memoria en un ensamblado.NET. Por lo tanto, pueden utilizar toda la de.NET Framework y cualquier otro ensamblado en la caché de ensamblados global (GAC). Por ejemplo, puede utilizar cualquiera de las clases disponibles en el espacio de nombres System.Collections.Generic. (Consulte la Biblioteca MSDN para obtener documentación de este espacio de nombres.)

Los scripts de tareas tienen una referencia automática al ensamblado AppDNA.apptitude.scripting.

Puede especificar ensamblajes mediante la sintaxis de extensión LoadAssembly. Por ejemplo:

LoadAssembly System.Windows.Forms.dll

Si el ensamblaje no está en la GAC, debe especificar la ruta completa. Esto no afecta al uso de Importar con espacios de nombres.

Extensión <multiline_string> de VB .NET

Cuando el lenguaje es VB.NET, puede usar la siguiente sintaxis para cadenas:

<multiline_string>xxxx</multiline_string>

Donde xxxx es una cadena. Antes de la compilación, el analizador convierte esto en un literal de cadena VB .NET. Esto hace que sea más fácil especificar cadenas que abarcan varias líneas dentro del script de lo que es posible mediante la sintaxis VB.NET estándar.

Por ejemplo:

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

Se convierte en:

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 & _
"   "

Formato de script de caso requerido

Una script básica de caso de Forward Path consiste en una función que define las columnas de salida en el informe Forward Path directa. El siguiente ejemplo es el caso básico que se crea al hacer clic en Nuevo caso en la barra de herramientas principal.

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

La firma de la función es importante y la función debe devolver un objeto Output que defina al menos una columna de salida. Si quiere asociar scripts de tareas con el caso, debe definir la columna Resultados.

Observe que un objeto Application se pasa a la función. La función se ejecuta para cada aplicación seleccionada actualmente y el objeto Application que se pasa a la función representa la aplicación que se está procesando actualmente.

Utilice el Explorador de propiedades en el lado derecho de la pantalla Editor de lógica de Forward Path para explorar la estructura de los objetos Application y Output. (El objeto Output se muestra como ForwardPathReportOutput en el Explorador de propiedades.)

El script de caso puede incluir funciones adicionales que permiten agregar datos de aplicación por grupo y generar totales a nivel de informe. Consulte Informes de Forward Path agrupados para obtener más información.

Formato de script de tareas requerido

Los scripts de tareas deben tener la siguiente forma:

Imports AppDNA.AppTitude.Scripting

Public Class ScriptClass

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

End Class

Los nombres y la accesibilidad de la clase y la firma de la función son importantes. Más allá de eso, cualquier construcción de VB .NET es válida.

Haga clic en Ayuda de script de tarea en la barra de herramientas para ver la documentación de las API de AppDNA que están disponibles para los scripts de tareas.

Especificaciones de Forward Path