Erstellen Sie ein geskriptetes Audit

  • Freigeben Version: Australia
  • Aktualisiert 12. März 2026
  • 7 Minuten Lesedauer

    • Ein geskriptetes Audit ist ein Audit, dessen Bedingungen durch ein Skript definiert werden.

    Prozedur

    1. Navigieren zu Alle > Compliance > Geskriptete Audits > Auditsan.

      Ein Audit-Typ von Geskriptet Filtert die Liste.

    2. Klicken Sie auf Neu.
    3. Füllen Sie das Formular aus (siehe Tabelle).
    4. Erstellen Sie das Audit-Skript.

      Die Führen Sie dieses Skript aus Das Feld enthält ein Beispielskript mit Anweisungen zum Ausführen des Audits und zum Generieren der Folgeaufgaben. Dieses Feld wird nur angezeigt, wenn Sie über das Modul „geskriptete Audits“ auf Audits zugreifen.

    5. Klicken Sie auf Absenden.

      Beispielskript:

      /*
/////////////////////////////////////////////////////
/// This script works with Data Center Zones filter //
/////////////////////////////////////////////////////
 
var desiredFloorSpaceUsage = 30;		// Value to audit against
var assignToUser = '46d44a23a9fe19810012d100cca80666';	 // Beth Anglin
var assignToGroup = '8a5055c9c61122780043563ef53438e3';	// Hardware group
var taskMsg = 'See the audit results below for the discrepancies that must be addressed';
 
// API call to retrieve records based on the filter
var gr = new SNC.CertificationProcessing().getFilterRecords(current.filter);
 
// Loop over all records defined by the filter
while(gr.next()) {
	var sysId = gr.getValue('sys_id');	// Sys ID of audited record
	var floorSpaceInUse = gr.getValue('floor_space_in_use');	// Value to audit
 
	// Determine if certification condition passes or fails
	if (floorSpaceInUse < desiredFloorSpaceUsage) {
		var columnNameSpace = gr.floor_space_in_use.getLabel();	// String value of column audited against
 
		// Call create Follow on Task API and save the returned sys_id for use in logging audit result fail
		// Params: 
		// auditId - Sys id of the audit record executed
		// ciId Sys - id of the configuration item.  Empty string if not a cmdb ci
		// assignedTo - Sys id of user to assign task to.  Can be empty
		// assignmentGroup - Sys id of group to assign task to.  Can be empty
		// shortDescr - Short description for the Follow On Task.  Can be empty
		// Return value: Sys id of the created follow on task
		var followOnTask = new SNC.CertificationProcessing().createFollowOnTask(current.sys_id, sysId, assignToUser, '', taskMsg);
 
		// Call log failed result API
		// Params:
		// auditId - Sys id of audit record executed
		// auditedRecordId - Sys id of the record audited
		// followOnTask - Sys id of the follow on task associated with the audited record(@see auditedRecordId). Can be empty
		// columnDisplayName - Label of the column audited(ex. Disk space (GB)).  Can be empty
		// operatorLabel - Label of the operator used to audit the column(ex. is not empty, greater than). Can be empty
		// desiredValue - Desired value of the column.  Can be empty
		// discrepancyValue - Discrepancy value.  Can be empty
		// isCI - True, if audited record is a CI. False, otherwise.
		// domainToUse - Sys domain of the "cert_audit" record.  Can be empty
		new SNC.CertificationProcessing().logAuditResultFail(current.sys_id, sysId, followOnTask, columnNameSpace, 'greater than', desiredFloorSpaceUsage, floorSpaceInUse, true);
	} else { // If certification condition pass, write a Audit Result Pass via API
		// Params:
		// auditId - Sys id of audit record executed
		// auditedRecordId - Sys id of the record audited
		// isCI - True, if audited record is a CI. False, otherwise.  Can be empty.
		// domainToUse - Sys domain of the "cert_audit" record.  Can be empty.
		new SNC.CertificationProcessing().logAuditResultPass(current.sys_id, sysId, true);
	}
}
*/
      Tabelle : 1. Neue geskriptete Audit-Tabelle
      Feld Beschreibung
      Name Name für dieses Audit.
      Filter Filter, der verwendet werden soll, wenn der Audit-Typ „geskriptet“ ist. Dieses Feld ist für geskriptete Audits erforderlich, ist jedoch für alle anderen Audit-Typen ausgeblendet.
      Vorlage [Erforderlich] Vorlage, die bei der Ausführung dieses Audits verwendet werden soll. Der Audit-Typ filtert die Liste der verfügbaren Vorlagen, und nur die aktiven Versionen einer Vorlage können ausgewählt werden. Dieses Feld ist ausgeblendet, wenn der Audit-Typ „Skriptbasiert“ ist.
      Tabelle [Schreibgeschützt] zeigt die Tabelle für die Vorlage an.
      Aufgaben erstellen Erstellt Folgeaufgaben zum Korrigieren von Diskrepanzen, wenn diese Option ausgewählt ist. In einem geskripteten Audit können Sie die Logik für entweder den Aufgabenstatus erstellen, indem Sie „wahr“ verwenden, um eine Aufgabe zu erstellen, oder „falsch“, wenn keine Aufgabe erstellt wird. Standardmäßig ist dieses Kontrollkästchen in einem neuen Audit-Datensatz deaktiviert (falsch).
      Zuweisungstyp
      Eine Auswahlliste, um auszuwählen, wie das Audit die Folgeaufgaben zuweist. Dieses Feld ist nur sichtbar, wenn das Kontrollkästchen Aufgabe erstellen aktiviert ist. Die Auswahlmöglichkeiten lauten wie folgt:
      • Anwenderfeld: Wählen Sie ein Anwenderreferenzfeld in der Tabelle aus, die geprüft wird. Wählen Sie beispielsweise den Anwender aus, der im Feld „verwaltet von“ im fehlgeschlagenen Datensatz benannt ist, um die Aufgaben auszuführen. Diese Auswahl zeigt die leeren Felder „Zugewiesen an“ und „Zuweisen an“ an. Wenn das Referenzfeld im Datensatz leer ist, wird der Wert im Feld „Zuweisen an leer“ verwendet.
      • Bestimmter Anwender: Wählen Sie einen bestimmten Anwender aus, um die Aufgaben auszuführen. Diese Auswahl zeigt das Feld Anwender an.
      • Gruppenfeld: Wählen Sie ein Gruppenreferenzfeld in der Tabelle aus, die geprüft wird. Wählen Sie beispielsweise die Supportgruppe aus dem fehlgeschlagenen Datensatz aus, um die Aufgaben auszuführen. Diese Auswahl zeigt die Felder „der Gruppe zuweisen“ und „Zuweisen an“ an. Alle Mitglieder der Gruppe aus dem Referenzfeld im fehlgeschlagenen Datensatz werden den Aufgaben zugewiesen. Wenn das Referenzfeld im Datensatz leer ist, wird der Wert im Feld „Zuweisen an leer“ verwendet.
      • Bestimmte Gruppe: Wählen Sie eine bestimmte Gruppe aus, um die Aufgaben auszuführen. Diese Auswahl zeigt das Feld Gruppe an. Alle Mitglieder der ausgewählten Gruppe werden den Aufgaben zugewiesen.
      Anwender
      Der spezifische Anwender, den dieses Audit Folgeaufgaben zuweist. Dieses Feld ist unter diesen Bedingungen verfügbar:
      • Zuweisungstyp ist auf „bestimmter Anwender“ festgelegt.
      • „Zuweisen an leer“ ist auf „zugewiesene Aufgabe erstellen“ festgelegt, und der Zuweisungstyp ist auf „Anwenderfeld“ festgelegt.
      Hinweis:
      Stellen Sie sicher, dass der angegebene Anwender über verfügt Zertifizierungsrolle .
      Zuweisen an Gruppe Das Gruppenfeld, das definiert, welche Gruppe dieses Audit der Folgeaufgabe zuweist. Dieses Feld ist nur verfügbar, wenn der Zuweisungstyp das Feld „Gruppe“ ist.
      Gruppe Die spezifische Gruppe, die dieses Audit Folgeaufgaben zuweist. Dieses Feld ist nur verfügbar, wenn der Zuweisungstyp „bestimmte Gruppe“ ist und Sie das Feld „Gruppe“ als Zuweisungstyp ausgewählt haben.
      Zuweisen an Das Anwenderfeld, das definiert, welchen Anwender dieses Audit der Folgeaufgabe zuweist. Dieses Feld ist nur verfügbar, wenn der Zuweisungstyp das Feld „Anwender“ ist.
      Zuweisen an leer
      Das zu verwendende Verhalten, wenn das Feld, das in der Gruppe „Zuweisen an“ oder „Zuweisen an“ ausgewählt wurde, im zu auditierenden Datensatz leer ist. Wenn beispielsweise eine Folgeaufgabe einem Manager zugewiesen werden muss, aber kein Manager identifiziert wird, bestimmt der Wert in diesem Feld, was geschieht. Dieses Feld wird nur angezeigt, wenn der Zuweisungstyp „Anwenderfeld“ oder „Gruppenfeld“ ist. Die möglichen Auswahlen sind:
      • Aufgabe nicht erstellen: Es wird keine Folgeaufgabe erstellt, wenn das Feld „Zuweisen an“ oder „Zuweisen an Gruppe“ leer ist.
      • Nicht zugewiesene Aufgabe erstellen: Erstellen Sie eine Folgeaufgabe, aber weisen Sie sie keinem Anwender oder keiner Gruppe zu. Die Aufgabe kann später manuell zugewiesen werden.
      • Zugewiesene Aufgabe erstellen: Erstellen Sie eine Folgeaufgabe, und weisen Sie sie dem angegebenen Anwender oder der angegebenen Gruppe zu. Wenn Sie einen Zuweisungstyp des Felds „Anwender“ ausgewählt haben, wird das Feld „Anwender“ verfügbar. Wenn Sie den Feldtyp „Gruppe“ ausgewählt haben, wird das Feld „Gruppe“ verfügbar.

      Das Audit erstellt automatisch Folgeaufgaben für alle Datensätze, für die „Zuweisen an“ ausgefüllt ist, unabhängig davon, welche Auswahl Sie für „Zuweisen an leer“ treffen.
      Kurzbeschreibung Kurze Beschreibung des Zwecks des Audits.
      Aufgabenbeschreibung Allgemeine Beschreibung der Arbeit, die für die von diesem Audit erstellten Folgeaufgaben erforderlich ist. Alle von diesem Audit erstellten Folgeaufgaben erben diese Beschreibung.
      Aktiv Aktiviert diesen Audit-Zeitplan und generiert Folgeaufgaben zum geplanten Datum und zur geplanten Uhrzeit. Deaktivieren Sie dieses Kontrollkästchen, um Zeitplanfelder im Formular auszublenden (außer letztes Ausführungsdatum) und keine Folgeaufgaben zu generieren.
      Ausführen Wie oft der Zeitplan ausgeführt werden soll, der das Audit generiert.
      • Täglich
      • Wöchentlich
      • Monatlich
      • Regelmäßig
      • Einmal
      • Bei Bedarf
      Tag
      • Wenn „Ausführen“ auf „Wöchentlich“ festgelegt ist, der Wochentag, an dem das Audit ausgeführt wird.
      • Wenn „Ausführen“ auf „monatlich“ festgelegt ist, der Tag des Monats, an dem das Audit ausgeführt wird. Wenn der Tag 29, 30 oder 31 ist, wird der Audit für kürzere Monate am letzten Tag des Monats ausgeführt.
      Wiederholungsintervall Wenn „regelmäßig ausführen“ ist, die Häufigkeit, die der Audit-Lauf eingegeben hat, in Zeit, Tagen oder beidem. Legen Sie beispielsweise Tage auf 10 und Stunden auf 14:00:00 fest, um das Audit alle 10 Tage um 14:00 Uhr auszuführen.
      Wird gestartet Wenn „Ausführen“ regelmäßig oder einmal ist, Datum und Uhrzeit der Ausführung des Audits.
      Zeit Wenn „Ausführen“ „täglich“, „Wöchentlich“, „monatlich“ oder „einmal“ ist, die Tageszeit auf 24-Stunden-Uhr, zu der das Audit ausgeführt wird.
      Letztes Ausführungsdatum [Schreibgeschützt] Datum und Uhrzeit der letzten Ausführung des Audits, entweder im regulären Zeitplan oder manuell. Audit-Vorschauen aktualisieren dieses Feld nicht.
      Nächste geplante Ausführung [Schreibgeschützt] das nächste Datum und die nächste Uhrzeit, zu der das Audit ausgeführt wird. Das System berechnet dieses Feld neu, wenn Sie den Zeitplan ändern.
      Audit-Typ [Schreibgeschützt] der diesem Audit zugewiesene Typ. Das System wählt den Audit-Typ basierend auf der Anwendung aus, aus der das Audit erstellt wurde, und kann:
      • Gewünschter Zustand
      • Architektur-Compliance
      • Compliance
      • Geskriptet
      Dieses Skript ausführen Auszuführendes Audit-Skript. Dieses Feld ist nur verfügbar, wenn der Audit-Typ „Skriptbasiert“ ist. Das Audit-Formular enthält ein Beispielskript mit Anweisungen zum Ausführen des Audits und zum Generieren der Folgeaufgaben. Siehe Skriptmethoden Für eine Liste der bereitgestellten Methoden und der akzeptierten Parameter.