Messreihen und Tabellen

import { Injectable } from 'injection-js';
import { Script, StepsService } from '@script';

@Injectable()
export class SkriptName extends Script {

  constructor(private steps: StepsService) {}

  public Run(): void {

    this.steps.Add("Parameter 1", async () => {
      // TODO Benutzerinteraktion anlegen
    }, {});
  }
}

import { Injectable } from 'injection-js';
// NEU: Zusätzliche Funktionsimporte von `delay` und `ScriptUI`
import { Script, StepsService, delay, ScriptUI } from '@script';

@Injectable()
export class SkriptName extends Script {

  // NEU: wir speichern zusätzlich den Dienst zur Benutzerinteraktion in der Variable `ui`.
  constructor(private steps: StepsService, private ui: ScriptUI) {

  }

  public Run(): void {
    this.steps.Add("Parameter 1", async () => {
      // Zuerst wollen wir dem Benutzer den Messaufbau vornehmen lassen:
      // Dazu benutzen wir die Methode `this.ui.ConfirmationBox()`, welche eine Bestätigung vom Benutzer einfordert.
      // Da diese Aktion im Hintergrund passiert, müssen wir ebenfalls mit `await` das Ergebnis der Aktion abwarten.

      // ConfirmationBox gibt dem Benutzer die Auswahl zwischen "Weiter" und "Abbrechen", für den Fall, dass Abbrechen geklickt wird,
      // wird die Ausführung des gesamten Makroschritts abgebrochen und man kann ihn wiederholen oder die Kalibrierung beenden.
      await this.ui.ConfirmationBox(
        "Messaufbau vornehmen", // Erster Parameter: Titel der Box
        [ // Zweiter Parameter: Liste an Inhalt, Inhalt wird im UI untereinander in der gegebenen Reihenfolge angezeigt
          {
            kind: "text", message: `Bitte folgenden Messaufbau vornehmen und foldende Einstellungen an Gerät 2 vornehmen: 
        Einstellung Wellenlänge: 1310 nm
        Einstellung Pegel: 10 dBm` // Textinhalt der Box. Ein String kann entweder einzeilig mit " oder ', alternativ mehrzeilig mit `. Zeilenumbrüche werden beibehalten.
          }, 
          {
            kind: "image", 
            data: "MESSAUFBAU.PNG", // Zeige das Bild "MESSAUFBAU.PNG" im gleichen Ordner wie die Skriptdatei in der Benutzeroberfläche an. Achtung: Dateinahmen berücksichtigen Groß/Kleinschreibung.
          }
        ],
      );

      // Wir wollen eine Benutzerinfo an den Benutzer geben, damit er sich nicht wundert, was gerade passiert, während wir z.B. eine langlaufende Messung im Hintergrund haben:
      // Dazu nutzen wir `this.ui.PushStatusMessage`, was lediglich eine Information zum Anzeigen an die Benutzeroberfläche sendet.
      await this.ui.PushStatusMessage([{ kind: 'text', message: `Achtung: Warte auf Standard und Messgerät (10s)` }]);
      // Warte 10s ab.
      await delay(10000);

      const userInput = await this.ui.InputBox(
        "Messwert erfassen", // Erster Parameter: Titel
        [{ kind: "text", message: "Bitte lesen Sie den Messwert vom Prüfling ab und tragen ihn ein" }], // Zweiter Parameter: Inhaltselemente
        "dBm", // 3. Parameter: Einheit des Messwerts, hier dBm
        -21, // 4. Parameter: Minimum 
        -19, // 5. Parameter: Maximum
      );

      // in userInput steht jetzt der Zahlenwert, welchen der Nutzer ins Textfeld eingegeben hat.
      // Im nächsten Schritt wollen wir diesen Zahlenwert jetzt ins Protokoll einfügen.

    }, { });
  }
}

import { Injectable } from 'injection-js';

// NEU: Zusätzlicher Import von `ProtocolManager`, Interaktion mit dem Kalibrierprotokoll
import { Script, StepsService, delay, ScriptUI, ProtocolManager } from '@script';

// NEU: Zusätzlicher Import von `SeriesTemplates`, enthält vordefinierte Tabellenformate
import { SeriesTemplates } from '@script/table';

@Injectable()
export class SkriptName extends Script {

  constructor(private steps: StepsService, private ui: ScriptUI, private proto: ProtocolManager) {

  }

  public Run(): void {
    this.steps.Add("Parameter 1", async () => {

      await this.ui.ConfirmationBox(
        "Messaufbau vornehmen", 
        `Bitte folgenden Messaufbau vornehmen und foldende Einstellungen an Gerät 2 vornehmen: 
        Einstellung Wellenlänge: 1310 nm
        Einstellung Pegel: 10 dBm`, 
        "MESSAUFBAU.PNG",
      );

      await this.ui.PushStatusMessage(`Achtung: Warte auf Standard und Messgerät (10s)`);
      await delay(10000);

      const userInput = await this.ui.InputBox(
        "Messwert erfassen",
        "Bitte lesen Sie den Messwert vom Prüfling ab und tragen ihn ein", 
        undefined,
        "dBm", 
        -21, 
        -19,
      );

      // NEU: Messreihe erzeugen, dabei wird hier ein STIA? (? = Q in KalibriWare) Format benutzt.
      const series = this.steps.createSeries(SeriesTemplates.STIAQ());

      // NEU: Daten in Messreihe einfügen, manuell:
      // s: Sollwert
      // t: Toleranz, hier +- 1dBm
      // i: Istwert, hier kopiert aus der vorherigen InputBox
      series.addRow({ s: -20, t: Tolerance.Absolute(1), i: userInput });

      // Wichtig: Nachdem alle Messungen hinzugefügt wurden, muss die Tabelle explizit ins Kalibrierprotokoll eingefügt werden:
      // Dazu verwenden wir `ProtocolManager.addMeasurementSeries()`
      this.proto.addMeasurementSeries(series);
    }, { });
  }
}

this.steps.createSeries({
  s: Columns.TargetValue(100, Unit.mega("Ohm")), // Sollwertspalte in MOhm, Standardwert 100MOhm
  t: Columns.Tolerance(100, Unit.one("Ohm")), // Toleranzspalte, hier standardmäßig symmetrische Toleranz von +- 100 Ohm
  i: Columns.ActualValue(Unit.kilo("Ohm")), // Istwert in kOhm, z.b. weil das Messgerät den Istwert so anzeigt.
  a: Columns.Deviation(Unit.kilo("Ohm")), // Abweichungsfeld in kOhm 
  q: Columns.Status(), // Statusfeld, dort kommt ok oder fehler rein
});

import { Injectable } from 'injection-js';

import { Script, StepsService, delay, ScriptUI, ProtocolManager } from '@script';
// NEU: Zusätzlicher Import von DisplayTable und TableColumn.
import { SeriesTemplates, DisplayTable, TableColumn, Fields, Tolerance } from '@script/table';

@Injectable()
export class SkriptName extends Script {

  constructor(private steps: StepsService, private ui: ScriptUI, private proto: ProtocolManager) {

  }

  public Run(): void {
    this.steps.Add("Parameter 1", async () => {

      await this.ui.ConfirmationBox(
        "Messaufbau vornehmen", 
        `Bitte folgenden Messaufbau vornehmen und foldende Einstellungen an Gerät 2 vornehmen: 
        Einstellung Wellenlänge: 1310 nm
        Einstellung Pegel: 10 dBm`, 
        "MESSAUFBAU.PNG",
      );

      await this.ui.PushStatusMessage(`Achtung: Warte auf Standard und Messgerät (10s)`);
      await delay(10000);

      const userInput = await this.ui.InputBox(
        "Messwert erfassen",
        "Bitte lesen Sie den Messwert vom Prüfling ab und tragen ihn ein", 
        undefined,
        "dBm", 
        -21, 
        -19,
      );

      const series = this.steps.createSeries(SeriesTemplates.STIAQ());
      series.addRow({ s: -20, t: Tolerance.Absolute(1), i: userInput });
      this.proto.addMeasurementSeries(series);

      // NEU: Anzeigetabelle anlegen. Dabei enthält dieser Aufruf die Kopfzeile(n), sowie die Anzahl der Spalten.
      const dt = DisplayTable.create("Parameter 1", "Untertitel", 5, [
        "Sollwert",
        "Toleranz",
        "Istwert",
        "Abweichung",
        "Status",
      ]);

      // NEU: Messreihe in die Anzeigetabelle einfügen, dazu benutzen wir `addSeries` und fügen die vorher angelegte Messreihe ein.
      // Für jede Verbindung von DisplayTable und MeasurementSeries muss festgelegt sein, welche Spalte der Messreihe in die Spalte der DisplayTable gehört.
      // Dazu dient `TableColumn.Manual()`, `TableColumn.Number()`, und `TableColumn.Status()`.

      dt.addSeries(series, [
        TableColumn.Number("s"), // Extrahiere die erste Spalte (Sollwert) der DisplayTable aus dem Feld namens `s` der Messreihe `series` und erwarte einen Zahlenwert.
        TableColumn.Number("t"), 
        TableColumn.Number("i"),
        TableColumn.Number("a"),
        TableColumn.Status("q"), // Extrahiere die letzte Spalte (Status) der DisplayTable aus dem Feld namens `q` der Messreihe Series und erwarte ein Statusfeld.
      ]);

      // Nach dem Erzeugen der DisplayTable, muss diese wieder ins Protokoll eingefügt werden:
      this.proto.addDisplayTable(dt);
    }, { });
  }
}