Spécifications de Forward Path

Langue de script

Par défaut, tous les scripts de scénario et de tâche sont compilés en Visual Basic .NET 2.0 (VB .NET). Pour obtenir une documentation Visual Basic .NET complète, reportez-vous à la section http://msdn.microsoft.com/en-gb/library/2x7h1hfk.aspx.

Vous pouvez choisir de compiler des scripts de tâche (mais pas des scénarios) en C # 2.0. Pour ce faire, démarrez le script de tâche avec la chaîne suivante :

Language CSharp

Cependant, l’éditeur de script AppDNA prend en charge la coloration syntaxique uniquement pour Visual Basic .NET.

Références d’assemblage

Les scripts de scénario et de tâche sont compilés en mémoire dans un assembly .NET. Ils peuvent donc utiliser l’ensemble du .NET Framework et tous les autres assemblys dans le Global Assembly Cache (GAC). Par exemple, vous pouvez utiliser l’une des classes disponibles dans l’espace de noms System.Collections.Generic. (Voir leBibliothèque MSDNpour la documentation de cet espace de noms.)

Les scripts de tâche ont une référence automatique à l’assembly appdna.apptitude.scripting.

Vous pouvez spécifier des assemblages à l’aide de la syntaxe de l’extension LoadAssembly. Par exemple :

LoadAssembly System.Windows.Forms.dll

Si l’assembly n’est pas dans le GAC, vous devez spécifier le chemin complet. Cela n’affecte pas l’utilisation d’Importer avec des espaces de noms.

<multiline_string>Extension VB .NET

Lorsque le langage est VB .NET, vous pouvez utiliser la syntaxe suivante pour les chaînes :

<multiline_string>xxxx</multiline_string>

Où xxxx est une chaîne. Avant la compilation, l’analyseur transforme cela en un littéral de chaîne .NET VB. Cela rend plus facile de spécifier des chaînes qui couvrent plusieurs lignes dans le script que ce n’est possible en utilisant la syntaxe VB .NET standard.

Par exemple :

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

Devient :

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

Format de script de scénario requis

Un script de scénario Forward Path de base consiste en une fonction qui définit les colonnes de sortie dans le rapport Forward Path. L’exemple suivant représente le scénario de base créé lorsque vous cliquez sur Nouveau scénario dans la barre d’outils principale.

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 signature de la fonction est importante et la fonction doit renvoyer un objet Output qui définit au moins une colonne de sortie. Si vous souhaitez associer des scripts de tâche au scénario, vous devez définir la colonne Résultat en sortie.

Notez qu’un objet Application est passé dans la fonction. La fonction est exécutée pour chaque application actuellement sélectionnée et l’objet Application qui est passé dans la fonction représente l’application en cours de traitement.

Utilisez l’Explorateur de propriétés situé à droite de l’écran Éditeur logique Forward Path avant pour explorer la structure des objets Application et Sortie. (L’objet Output est affiché sous la forme ForwardPathReportOutput dans l’Explorateur de propriétés.)

Le script de scénario peut inclure des fonctions supplémentaires qui vous permettent d’agréger les données d’application par groupe et de générer des totaux au niveau du rapport. Pour plus d’informations, reportez-vous à la section Rapports Forward Path groupés.

Format de script de tâche requis

Les scripts de tâche doivent avoir la forme suivante :

Imports AppDNA.AppTitude.Scripting

Public Class ScriptClass

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

End Class

Les noms et l’accessibilité de la classe et la signature de la fonction sont importants. Au-delà de cela, toutes les constructions VB .NET sont valides.

Cliquez sur Aide du script de tâche dans la barre d’outils pour afficher la documentation des API AppDNA disponibles pour les scripts de tâche.