Empfohlene Vorgehensweisen für die Analyseentwicklung

Analyseskripts unterstützen die meisten Befehle, die Sie in einem gewöhnlichen Skript verwenden können. Sie müssen jedoch sicherstellen, dass Analyseskripts ohne einen Benutzereingriff ablaufen und keine Befehle beinhalten, die in der Robots-App in Diligent One von der zur Verarbeitung des Analyseskripts verwendeten Engine nicht unterstützt werden.

Analyseskripts unterstützen alle ACLScript-Funktionen.

Allgemeine empfohlene Vorgehensweisen

Lokal testen

Testen Sie alle Analyseskripts lokal, bevor Sie sie in der Robots-App bereitstellen. Stellen Sie sicher, dass die Analyseskripts wie erwartet laufen und keine Benutzereingriffe benötigen.

Weitere Informationen finden Sie unter Analyseskripts entwickeln.

Konsistente Datenverbindungen für Tests verwenden

Falls ein Analyseskript eine ODBC-Datenquelle verwendet, müssen Sie für einen lokalen Test der Analyse eine mit der Verbindung identische ODBC-Datenquelle auf Ihrem lokalen Computer konfigurieren, wo die Analyse ausgeführt wird.

Absolute Dateipfade vermeiden

Vermeiden Sie in Analyseskripts die Verwendung absoluter Dateipfade (z.B. C:\Ergebnisse), es sei denn, Sie sind sich sicher, dass identische Dateipfade in der Umgebung bestehen, in der das Analyseskript ausgeführt wird.

Die Verwendung relativer Dateipfade (z.B. \Ergebnisse) ermöglicht Ihnen eine lokale Entwicklung und das lokale Testen von Analyseskripts, die Sie dann später in einer anderen Umgebung bereitstellen können, ohne dass es notwendig ist, dass die andere Umgebung über eine identische Verzeichnisstruktur verfügt.

SET für Konfigurationseinstellungen verwenden

Stellen Sie sicher, den SET-Befehl für Konfigurationseinstellungen zu verwenden, die das Analyseskript benötigt. Wenn Sie keine spezifischen Einstellungen in Ihrem Analyseskript festlegen, werden die Standardeinstellungen von Analytics verwendet. Positionieren Sie den SET-Befehl nach dem Analysekopf, jedoch vor der Analyseskriptlogik.

Keine Kalkulationsfelder in Ergebnissen oder Datenausgabetabellen verwenden

Verwenden Sie keine Kalkulationsfelder in Ausgabetabellen, die Sie auch nach der Sitzung, während der das Analyseskript ausgeführt wird, behalten möchten.

Ergebnisse und Datentabellen, die zur Nutzung in Interpretationen oder als Eingaben für spätere Skripts behalten werden, können unerwartete Werte darstellen, falls sie Kalkulationsfelder enthalten. Kalkulationswerte hängen von Einstellungen ab, die in der Einstellungsdatei (.prf) oder durch den SET-Befehl definiert werden. Unterschiedliche Umgebungen können daher zu unterschiedlichen Werten führen.

Falls Sie die Werte eines Kalkulationsfelds aufbewahren müssen, verwenden Sie den EXTRACT-Befehl mit der Option FIELDS oder ALL, um das Feld in der Ergebnis- oder Datentabelle in ein physisches Feld zu konvertieren. Weitere Informationen finden Sie unter EXTRACT-Befehl.

Datenverbindungskennwörter verschlüsseln

Um kein unverschlüsseltes Kennwort für eine Datenquelle in einem Analyseskript zu verwenden, nutzen Sie das Analysetag //PASSWORD. Es fordert den Benutzer vor der Ausführung des Analyseskripts zur Eingabe eines Kennworts auf und verschlüsselt den eingegebenen Wert.

Kennwort für Im- und Exporte aus/nach Diligent One verwenden

Der Parameter PASSWORD wird für jeden Befehl benötigt, der aus bzw. nach Diligent One importiert/exportiert:Diligent One

• IMPORT GRCRESULTS
• IMPORT GRCPROJECT
• EXPORT... ACLGRC
• EXPORT... HBDATA

Ohne den Parameter PASSWORD wird der Befehl in Robots scheitern.Robots

Wenn Sie den Parameter PASSWORD in einem Befehl verwenden, müssen Sie im Analysekopf auch das zugehörige //PASSWORD-Tag angeben. Weitere Informationen finden Sie unter PASSWORD-Tag.

Benutzereingriff vermeiden

Analyseskripts müssen ohne Benutzereingriff ablaufen können. Falls ein Befehl in einem Analyseskript versucht, ein Dialogfeld zu erstellen, beendet die Engine in der Bereitstellungsumgebung die Verarbeitung des Analyseskripts und im Protokoll wird eine Fehlermeldung eingegeben.

Befehle für Benutzereingriffe durch Analysetags ersetzen

Verwenden Sie keine Analytics-Befehle, die Benutzereingriffe benötigen. Ersetzen Sie sie durch entsprechende Analysetags im Analysekopf. Analysetags ermöglichen Benutzern die Bereitstellung von Eingabewerten vor der Ausführung des Analyseskripts.

Nicht verwenden	Ersetzen durch
DIALOG	//PARAM , //TABLE , //FIELD
ACCEPT	//PARAM , //TABLE , //FIELD
PASSWORD	//PASSWORD
PAUSE	keine Entsprechung

Richtlinien

• Interaktive Befehle Um das Scheitern einer Analyseskriptverarbeitung zu verhindern, entfernen Sie alle interaktiven Befehle.
• SET SAFETY Um sicherzustellen, dass Dateien, falls notwendig, ohne die Darstellung eines Bestätigungsdialogs überschrieben werden können, fügen Sie am Anfang eines Analyseskripts den Befehl SET SAFETY OFF hinzu.

  Am Ende des Analyseskripts fügen Sie den Befehl SET SAFETY ON hinzu, um erneut das Standardverhalten herzustellen.

• OK-Parameter Damit Bestätigungsdialoge das Analyseskript nicht zum Absturz bringen, fügen Sie nach jedem Befehl, der in der Regel eine Bestätigungsmeldung anzeigt, den Parameter OK hinzu:
  • UMBENENNEN
  • LÖSCHEN

Skriptsyntax prüfen

Analytics stellt ein Tool zur Verfügung, um Skriptsyntax zu entdecken, die ein Scheitern von Analyseskripts verursacht oder eine Anpassung zwischen Ihrer lokalen Umgebung und der Einsatzumgebung der Analyseskripts erfordert. Das Tool warnt Sie nur, und Sie können noch immer entscheiden, ob Sie Analyseskripts mit Warnungen übermitteln oder importieren möchten.

Was das Tool überprüft

Das Tool überprüft alle Skripts in einem Projekt auf die folgenden Elemente:

• Befehle, die Benutzereingriffe benötigen
• absolute Dateipfade
• Aufrufe externer Skripts

Wann die Überprüfung durchgeführt wird

Die Überprüfung von Skriptsyntax wird automatisch durchgeführt, wenn Sie Skripts an Robots übermitteln.

Die automatische Syntaxüberprüfung ist standardmäßig aktiviert. Wenn Sie sie ausschalten möchten, wählen Sie im Dialogfeld Optionen (Extras> Optionen > Schnittstelle) Überprüfung der Skriptsyntax vor dem Übermitteln von Skripts deaktivieren

Überprüfungen manuell durchführen

Sie können Überprüfungen der Skriptsyntax manuell durchführen. Möglicherweise müssen Sie zuerst die Schaltfläche Skripts überprüfen  der Analytics-Symbolleiste hinzufügen.

1. Falls notwendig, fügen Sie die Schaltfläche Skripts überprüfen der Analytics-Symbolleiste hinzu:
   1. Doppelklicken Sie auf einen leeren Platz in der Symbolleiste und das Dialogfeld Symbolleiste anpassen wird geöffnet.
   2. In der Liste Verfügbare Schaltflächen wählen Sie die Schaltfläche Skripts überprüfen, und klicken auf Hinzufügen.
   3. Wählen Sie die Schaltfläche Skripts überprüfen aus der Liste Aktuelle Schaltflächen, und klicken Sie auf Nach oben oder Nach unten, um die Position einer Schaltfläche zu ändern.

      Die Reihenfolge der Schaltflächen von oben nach unten entspricht ihrer Anordnung von links nach rechts in der Symbolleiste.

   4. Klicken Sie auf Schließen, um Ihre Änderungen zu speichern.

2. Auf der Symbolleiste klicken Sie auf Skripts überprüfen .

   Es erscheint eine Meldung, die Ihnen mitteilt, dass die Skriptsyntax des Projekts gültig ist, oder es werden ein bzw. mehrere Warnungen angegeben.

3. Führen Sie einen der folgenden Schritte aus:
   • Korrigieren Sie die Skriptsyntax, die Warnungen verursachte, und klicken Sie erneut auf Skripts überprüfen , um sicherzustellen, dass keine Warnungen mehr angezeigt werden.
   • Vergewissern Sie sich, dass die Bereitstellungsumgebung eine Verzeichnisstruktur oder externe Skripts enthält, die den in Analyseskripts angegebenen Pfaden oder externen Skripts entsprechen.