Skip to content

Latest commit

 

History

History
190 lines (139 loc) · 6.48 KB

chapter-08-packaging.md

File metadata and controls

190 lines (139 loc) · 6.48 KB

Kapitel 8 - Packaging - Verkaufspackung

In diesem Kapitel baust du die Packaging-Zelle. Sie liest die Stückliste zur Laufzeit und schreibt Quantity, Beutelname und Karton in die Werkeranweisung.

Eine Packaging-Activity ist wieder eine manuelle Cell wie Weighing. Der Unterschied liegt in Populate: Die Parameter kommen aus den PartLinks des Retail Packs, nicht aus festen Workplan-Texten.

Siehe auch Cells, Activities und Workplans.

Inhaltsverzeichnis | Vorheriges | Nächstes

Parameters: PartLinks zur Laufzeit lesen

Datei: src/TeaFactory/Activities/PackagingStep/PackagingParameters.cs

Ersetze das leere Populate der CLI. Hier wird aus dem aktuellen Produkt (Retail Pack) die Stückliste gelesen, Quantity, Beutelname und Karton landen in der Instruction.

public class PackagingParameters : VisualInstructionParameters
{
    public int BagQuantity { get; set; }
    public string BagName { get; set; }
    public string CartonName { get; set; }
    public CartonColor CartonColor { get; set; }

    protected override void Populate(Process process, Parameters instance)
    {
        base.Populate(process, instance);

        var parameters = (PackagingParameters)instance;
        var productionProcess = (ProductionProcess)process;
        var pack = (TeaRetailPackType)productionProcess.ProductInstance.Type;

        var bagLink = pack.TeaBag;
        var cartonLink = pack.Carton;

        parameters.BagQuantity = bagLink?.Quantity ?? 0;
        parameters.BagName = bagLink?.Product?.Name ?? "(no tea bag linked)";
        parameters.CartonName = cartonLink?.Product?.Name ?? "(no carton linked)";
        parameters.CartonColor = cartonLink?.Product?.Color ?? default;

        parameters.Instructions =
        [
            new VisualInstruction
            {
                Type = InstructionContentType.Text,
                Content =
                    $"Pack {parameters.BagQuantity} tea bag(s) of '{parameters.BagName}' " +
                    $"into carton '{parameters.CartonName}' ({parameters.CartonColor}). " +
                    "Confirm SUCCESS when the retail pack is complete."
            }
        ];
    }
}

Was passiert? Beim Start der Activity ist ProductInstance.Type das Retail Pack aus dem Auftrag. TeaBag / Carton sind die PartLinks.

Hinweis: Wenn du hier TeaBagType statt TeaRetailPackType castest, knallt es zur Laufzeit, der Packaging-Auftrag muss das Retail Pack sein.

Activity: Capabilities ohne Value

Datei: src/TeaFactory/Activities/PackagingStep/PackagingActivity.cs

public override ICapabilities RequiredCapabilities => new PackagingCapabilities();

(Value nicht setzen.)

Cell: Visual Instructor wie Weighing

Datei: src/TeaFactory.Resources.Packaging/PackagingCell.cs

Die CLI-Zelle hat oft schon IVisualInstructor und StartActivity. Stelle sicher:

  1. [ResourceReference(ResourceRelationType.Extension)] public IVisualInstructor VisualInstructor { get; set; }
  2. In OnInitializeAsync: Capabilities = new PackagingCapabilities();
  3. ProcessEngineAttached: Production + Push (wie Weighing)
protected override IEnumerable<Session> ProcessEngineAttached()
{
    yield return Session.StartSession(ActivityClassification.Production, ReadyToWorkType.Push);
}
  1. In StartActivity für PackagingActivity:
public override void StartActivity(ActivityStart activityStart)
{
    _currentSession = activityStart;
    switch (activityStart.Activity)
    {
        case PackagingActivity:
            _currentInstruction = VisualInstructor.Execute(Name, activityStart, InstructionCompleted);
            break;
    }
}
  1. InstructionCompleted
private void InstructionCompleted(int instructionResult, ActivityStart activity)
    {
        _currentInstruction = 0;
        var result = activity.CreateResult(instructionResult);
        _currentSession = result;
        PublishActivityCompleted(result);
    }
  1. SequenceCompleted
    public override void SequenceCompleted(SequenceCompleted completed)
    {
        _currentSession = completed;

        var rtw = Session.StartSession(ActivityClassification.Production, ReadyToWorkType.Push);
        PublishReadyToWork(rtw);
        _currentSession = rtw;
    }

Driver ist für diesen Lernschritt nicht nötig (Werker klickt SUCCESS).

  1. App starten

Resource in der UI anlegen

  1. PackagingCell anlegen, Name z. B. PackagingCell.
  2. Zelle öffnen, Extension VisualInstructor: derselbe Instructor wie bei Weighing und Filling.
  3. Speichern.

Screenshot

Eigenen Workplan für Retail Pack

  1. Arbeitspläne, Plus-Schaltfläche
  2. Name: Retail Pack Workplan
  3. Palette: Packaging Task
  4. Verbinden: Start, Packaging Task, End
  5. Speichern

Kein Weighing/Filling/Sealing in diesem Plan.

Screenshot

Recipe am Retail Pack

  1. Produkte, dein Retail Pack (z. B. Sencha 20er Pack)
  2. Reiter Rezepte, bearbeiten, Recipe hinzufügen
  3. Typ: ProductionRecipe
  4. Name z. B. Retail Pack Production
  5. Workplan: Retail Pack Workplan
  6. Classification: Default
  7. Speichern

Ohne Default-Recipe startet der Auftrag nicht.

Screenshot

In der UI testen

  1. Worker Support / Display = VisualInstructor
  2. Aufträge: Produkt Retail Pack, Menge 1, CREATE, BEGIN
  3. Werkerassistenz Instruction muss Quantity, Beutelname und Karton aus den PartLinks zeigen
  4. SUCCESS, Auftrag fertig

Optional davor: Auftrag TeaBag Menge 20 (Beutel-Linie). Für Packaging technisch nicht nötig, die Anweisung simuliert das Einlegen in die Schachtel.

Screenshot

Screenshot

Checkliste

  • PackagingParameters.Populate liest PartLinks und baut die Instruction
  • PackagingActivity mit PackagingCapabilities() ohne Value
  • PackagingCell mit VisualInstructor, Production-Session, StartActivity / SequenceCompleted
  • PackagingCell in der UI angelegt und Instructor verknüpft
  • Retail Pack Workplan + Default-Recipe am Retail Pack
  • Auftrag Retail Pack Menge 1: Instruction zeigt Quantity / Beutel / Karton