Die Checkware Ereignisskripte sind ein Werkzeug, mit dem Benutzer automatisch Aktionen oder Benachrichtigungen auslösen können, wenn bestimmte Ereignisse eintreten, z.B. wenn eine Checkliste abgeschlossen wird. Oft wird dies dafür genutzt um Mails nach Checklistenabschluss abzusenden.


1) Wo lege ich neue Ereignisskripte an:

Suche → Ereignisskripte → Neu



2) Wie ordne ich einer Vorlage ein Ereignisskript zu:

Sie navigieren zur Vorlage über Suchen → Vorlagen wählen die Vorlage aus und unten bei Ereignisskript, können Sie dann Ihr erstelltes Ereignisskript auswählen. Sie können ein Ereignisskript für mehrere Checklisten nutzen. Zum Beispiel wenn bei Abschluss die Checklisten immer an eine ganz bestimmte Emailadresse gehen sollen.



3) Beispiel: Wie sende ich mit dem Ereignisskript eine Mail?


UnterpunktBeispiel
Versenden einer einfachen Mail bei Abschluss mit Anhang der Checkliste

if (checkware.event == "complete") {
    

    checkware.sendMail({ recipients: 'Emailadresse des Empfängers', subject: 'Betreff', message: 'Nachricht', attachPdf: true});    
   
}

Beispiel versenden bei NIO mit Text und Link zu Checkliste

if (checkware.event == "complete") {
    
    var evaluationId = checkware.EvaluationId;
    var link = 'https://mycheckware.com/700009/#/checkware/evaluation/' + evaluationId;

    // Matchcode Werte laden
    var subject = 'Reinigung und Inspektion der A180 wurde durchgeführt';
    var recipient = 'karl-konstantin.kasper@germanedge.com'; 
    var messageContent = '<br/>Link zur Checkliste: ' + link;

    // Überprüfen, ob der Matchcode "KONTROLLEDERMECHANIK" den Wert "0" hat
    var mechanicControlValue = checkware.getValue('KONTROLLEDERMECHANIK');
    if (mechanicControlValue == "0") {
        subject = 'Reinigung und Inspektion A180 - Problem';
        var mechanicIssueText = checkware.getValue('SICHTBAREPROBLEMEDERMECHANIKTEXT');
        messageContent += '<br/><span style="color:red;">Probleme mit der Mechanik: ' + mechanicIssueText + '</span>';
    }

    checkware.sendMail({
        recipients: recipient, 
        subject: subject,
        message: messageContent, 
        attachPdf: true
    });  
}


4. Was kann man noch alles damit machen


Grundsätzlich können Ereignisskripte zu unterschiedlichen Zeitpunkten ausgeführt werden:

  • init (wenn eine Checkliste erstmalig erstellt wird)
  • save (wenn eine Checkliste gespeichert wird)
  • complete (wenn eine Checkliste abgeschlossen wird)
  • delete (wenn eine Checkliste gelöscht wird)

und noch deutlich mehr wie die Checkliste einem anderen User, einer anderen Rolle zuordnen, Einträge auslesen oder Aufgaben erstellen:

  • checkware.userId (Benutzer)
  • checkware.roleId (Rolle)
  • checkware.username (Nutzername)
  • checkware.languageSymbol
  • checkware.mandatorId (Mandanten-ID)
  • checkware.eventScriptId (ID des ausgeführten Ereignisskripts)
  • checkware.EvaluationId (ID der Vorlage)
  • checkware.ChecklistId (ID der jeweiligen ausgefüllten Checkliste)
  • checkware.eventType
  • checkware.sendMail (Mails versenden)
  • checkware.debug
  • checkware.getValue (Werte abrufen aus der Checkliste und z.B. in der Mail darstellen)
  • checkware.setValue (Werte in der Checkliste setzen, z.B. nach dem speichern)
  • checkware.createEvaluation (Checklisten erstellen)
  • checkware.deleteEvaluation (Checklisten löschen)
  • checkware.completeEvaluation (Checklisten abschließen)
  • checkware.getEvaluations
  • checkware.assignTo (Neu zuweisen z.B. an einen Nutzer/Rolle)
  • checkware.createTask (Aufgabe erstellen)
  • checkware.deleteTask (Aufgabe löschen)
  • checkware.callConnector (Connector mit weiterführenden Logiken aufrufen)
  • checkware.setSetting



  • No labels