Recipes, orders and scheduled jobs

Recipe Panel <smart-recipe-panel>

RecipePanel lists the recipes a line can be set to and loads one into the plant in a single action.

<smart-recipe-panel> · 7 properties, 0 methods, 2 events · source/modules/smart.recipepanel.js

Usage in Blazor

The Razor component is <RecipePanel> in Smart.Blazor.Industrial: every property is a parameter in PascalCase, every event an EventCallback<Event> named On<Event> whose ev["Detail"] is the typed detail class, and the methods are called on the @ref. String choices are enums. In a Blazor Web App (.NET 8 and later) the page needs an interactive render mode, for example @rendermode InteractiveServer; a statically rendered component stays empty.

@using Smart.Blazor.Industrial
@* .NET 8 and later: an interactive render mode, on the page or for the whole app *@
@rendermode InteractiveServer

<RecipePanel @ref="recipePanel" Selected="product-a"
    OnRecipeApply="OnRecipeApply" />

@code {
    RecipePanel recipePanel;

    void OnRecipeApply(Event ev)
    {
        RecipePanelRecipeApplyEventDetail detail = ev["Detail"];
    }
}

Properties

Parameter	Type, default	Description
Recipes recipes	IEnumerable<object>	Sets or retrieves the recipes as [{ id, name, note, entries: [{ tag, label, value, unit }] }]. label is what an operator calls the value; without one the tag is shown, which is what an engineer calls it. Assign a new array to update the component.
Selected selected	string	Sets or retrieves the id of the recipe whose values are shown. An empty value shows the first recipe.
Label label	string	Sets or retrieves the heading of the panel. It is also the accessible name of the group.
ReadOnly readOnly	bool false	Sets or retrieves whether the panel only shows the recipes. The Load button is removed rather than disabled, because a control that cannot be used should not invite a press; the values are still readable.
Confirm confirm	bool true	Sets or retrieves whether loading asks first. When true, the confirmation names every value that is about to be written. A recipe moves several setpoints at once, so this is on by default. The confirmation is modal - the panel behind it does not respond and Tab stays on its two buttons - and it freezes what it names: Load it sends the recipe as it was shown. If that recipe changes underneath while the question is open (the list is refreshed, another recipe is selected), the question is withdrawn and the panel says so. The second click of the double-click that opened it, a press within 300 ms of opening and a held key do not answer it.
Busy busy	bool false	Sets or retrieves whether a load is in flight. The application sets it while it writes, so the button cannot be pressed twice and the panel says what it is doing. The panel also sets it itself as it raises recipeApply, so a double press is one load even when the application sets busy only after an await. It is released when the application sets busy to false or sets result, or after ten seconds.
Result result	object	Sets or retrieves what the last load did, as { name, applied, of, failed: [{ tag, error }], at }. The application sets it when the writes come back. The entries named in failed are marked refused in the values table, so a load that half-succeeded is visible rather than only logged. A load refused as a whole - the role may not load, the session ran out - wrote nothing, and is given as { name, error }, which the panel says in those words rather than as "0 of 5 written".

Events

Every event is an EventCallback<Event>; Event is a dictionary and ev["Detail"] converts to the detail class named under the event.

Event	Description and detail
OnRecipeApply recipeApply RecipePanelRecipeApplyEventDetail	This event is triggered when the operator loads a recipe, after the confirmation when one is asked for. The component does not write: the application performs the writes and then sets the result property. It cannot know who is pressing the button or how the writes should be audited, so it does not pretend to. With confirm on, the id and the values are the ones the confirmation showed. Id string The id of the recipe. Name string The name of the recipe, as the operator saw it. Entries dynamic The values to write, as <em>[{ tag, value }]</em>.
OnRecipeSelect recipeSelect RecipePanelRecipeSelectEventDetail	This event is triggered when a recipe is chosen, by pointer or by keyboard. It is also raised when the recipe already shown is chosen again. Nothing is written; only what the panel shows changes. Id string The id of the recipe now shown. Name string Its name.

CSS variables

The component declares 4 CSS variables; the CSS page shows how to set them.

--smart-recipe-panel-refused-color --smart-recipe-panel-done-color --smart-recipe-panel-value-font --smart-recipe-panel-list-width