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.
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
TeaBagTypestattTeaRetailPackTypecastest, knallt es zur Laufzeit, der Packaging-Auftrag muss das Retail Pack sein.
Datei: src/TeaFactory/Activities/PackagingStep/PackagingActivity.cs
public override ICapabilities RequiredCapabilities => new PackagingCapabilities();(Value nicht setzen.)
Datei: src/TeaFactory.Resources.Packaging/PackagingCell.cs
Die CLI-Zelle hat oft schon IVisualInstructor und StartActivity. Stelle sicher:
[ResourceReference(ResourceRelationType.Extension)] public IVisualInstructor VisualInstructor { get; set; }- In
OnInitializeAsync:Capabilities = new PackagingCapabilities(); ProcessEngineAttached: Production + Push (wie Weighing)
protected override IEnumerable<Session> ProcessEngineAttached()
{
yield return Session.StartSession(ActivityClassification.Production, ReadyToWorkType.Push);
}- In
StartActivityfürPackagingActivity:
public override void StartActivity(ActivityStart activityStart)
{
_currentSession = activityStart;
switch (activityStart.Activity)
{
case PackagingActivity:
_currentInstruction = VisualInstructor.Execute(Name, activityStart, InstructionCompleted);
break;
}
}InstructionCompleted
private void InstructionCompleted(int instructionResult, ActivityStart activity)
{
_currentInstruction = 0;
var result = activity.CreateResult(instructionResult);
_currentSession = result;
PublishActivityCompleted(result);
}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).
- App starten
- PackagingCell anlegen, Name z. B.
PackagingCell. - Zelle öffnen, Extension VisualInstructor: derselbe Instructor wie bei Weighing und Filling.
- Speichern.
- Arbeitspläne, Plus-Schaltfläche
- Name:
Retail Pack Workplan - Palette: Packaging Task
- Verbinden: Start, Packaging Task, End
- Speichern
Kein Weighing/Filling/Sealing in diesem Plan.
- Produkte, dein Retail Pack (z. B.
Sencha 20er Pack) - Reiter Rezepte, bearbeiten, Recipe hinzufügen
- Typ: ProductionRecipe
- Name z. B.
Retail Pack Production - Workplan:
Retail Pack Workplan - Classification: Default
- Speichern
Ohne Default-Recipe startet der Auftrag nicht.
- Worker Support / Display = VisualInstructor
- Aufträge: Produkt Retail Pack, Menge 1, CREATE, BEGIN
- Werkerassistenz Instruction muss Quantity, Beutelname und Karton aus den PartLinks zeigen
- 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.
-
PackagingParameters.Populateliest PartLinks und baut die Instruction -
PackagingActivitymitPackagingCapabilities()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