Skip to content

Procedures ​

A procedure is a set of step-by-step instructions for one task on a product: assembling it, operating it, maintaining it or checking it. Each step has a text and can move the parts of the product's 3D model, so that the person who follows it sees what to do. You create procedures in the Procedures section of a product, edit them in the procedure editor, and publish them. People follow a published procedure in the procedure viewer, which opens from the link of the procedure. This page calls these people the readers of the procedure.

Where procedures are ​

Open a product from the Products page (see Products) and select Procedures in the sidebar of the product. The page lists every procedure of the product with its type, its status and the date of its last edit.

Procedures section of a product: the New procedure button, filters by type, a search field and a table of four procedures with their type, status and last edit date.
New procedure (1) creates a procedure, the filters (2) and the search field (3) narrow the list, and the three dots at the end of a row (4) open the menu of that procedure.

A member with the Viewer role does not get this list: they see only the published procedures, under Contents, and selecting one opens it for reading.

Procedure types ​

Every procedure has one of five types: Assembly, Disassembly, Maintenance, Usage or Quality Control. You choose the type when you create the procedure and can change it in the editor.

The type is a filter in the list. In the editor it also sets how a part is first shown when you add it to a step: see In the row of the step, under the table.

Find and open a procedure ​

  • Filter. Select a type above the table to keep only the procedures of that type, or Drafts to keep the ones with the status Draft. All shows everything again. A type, and Drafts, appear as filters once the product has a procedure of that kind.
  • Search. Enter a part of a name or of a type in Search.
  • Sort. Select a column name, Name, Type, Status or Edited, to sort by it; select it again to reverse the order. The list starts with the most recently edited procedure. In a narrow window a button such as Sort: Edited replaces the column names.
  • Open. Select a row. The procedure opens in the procedure editor.

When nothing matches, the table shows "No results" with Clear search or Clear filter.

Create a procedure ​

A new procedure starts empty, or with steps that TwinWorks writes from the files of the product or from a video.

Step by step

Create one procedure

Start with an empty procedure, or have the steps written from the product's files.

ProductProceduresNew procedure
Steps
  1. Open the product and select Procedures.
  2. Select New procedure.
  3. Enter a Name.
  4. Choose a Type and the Language the procedure is written in.
  5. Select Create to start with an empty procedure, or Generate to have the steps written from the product's files.
Example

For a new maintenance task on a product that already has its operating manual among its files, enter Replace the link, choose Maintenance and English, and select Generate.

Result

After Create, the editor opens on the empty procedure. After Generate, the editor opens on the new procedure and the Assistant starts at once: it reads the product's files, writes the steps, selects each step's parts in the 3D model and sets their states. Each change waits for you to approve it. Keep the editor open until the Assistant has finished.

New procedure dialog with the Name field, the Type and Language lists, the Add video switch and the buttons Cancel, Generate and Create.
Name (1), Type (2) and Language (3) are required. Add video (4) generates the procedure from a video. Generate (5) writes the steps for you, Create (6) starts with no steps.
  • Generate is shown when the product has at least one file, or when Add video is on. Files are added in the Sources section of the product: see Products.
  • The languages are English, French, Spanish and German.
  • A lock on Generate means that your plan does not include generated procedures.
  • On a device that cannot show the 3D model, Generate writes the steps without it: the dialog closes and the procedure is in the list with the status Generating… while its steps are written. They have no parts.
Step by step

Create a procedure from a video

Have the steps written from a video of the task that you already have.

ProductProceduresNew procedureAdd video
Steps
  1. Open the product, select Procedures, then New procedure.
  2. Enter a Name and choose a Type and a Language.
  3. Turn on Add video. A zone for the video opens and Create disappears.
  4. Drop one video on the zone, or select the zone to choose the file: .mp4, .webm, .mov or .m4v. The Generate button reads Preparing… while the video is prepared.
  5. Select Generate.
Result

The dialog closes and the procedure is in the list with the status Generating… while its steps are written.

New procedure dialog with the Add video switch turned on. Under it, a zone reads Drop a video or click to browse, with the accepted formats. The buttons are Cancel and Generate; there is no Create button.
With Add video on (1), drop the video on the zone (2). Generate (3) can be selected once a video is chosen.

A generated procedure is a first draft. Open it, read every step and preview it before you publish it.

Procedure statuses ​

The Status column of the list says where each procedure stands.

Table of procedures with, from top to bottom, one procedure with the status Generating, one with the status Failed and a Retry link, two with the status Published and two with the status Draft.
StatusWhat it meansWhat you can do
Generating…The steps are being written from the product's files or from a video. The row is dimmed.Wait. If you select the row, the message "Procedure still generating" appears and the editor does not open. When the steps are written the message "Procedure ready" appears and the row becomes a draft.
FailedThe steps could not be written. If the list is open at that moment, the message "Generation failed" appears.Select Retry beside the status to generate again.
PublishedThe procedure is published to the Public audience, to the Team audience, or to both.Open it, share it, or get its link from the menu of the row.
DraftThe procedure is not published.Open it, edit it and publish it.

Rename, duplicate or delete a procedure ​

Each row ends with a button with three dots, named Actions for followed by the name of the procedure. It opens the menu of the row.

Menu entryWhat it does
Get linkCopies the link that opens the published procedure in the procedure viewer: the Public link when the procedure is published to the Public audience, otherwise the Team link. The message "Link copied" appears. For a procedure that is not published, the message "Not published yet" appears, with a Publish button when your plan includes publishing; the button opens the Publish procedure dialog.
DuplicateAdds a copy of the procedure to the list; the message "Procedure duplicated" appears.
RenameTurns the name in the row into a field. Enter the new name and press Enter, or select the tick (Save name). Escape, or the cross (Cancel rename), keeps the old name.
DeleteOpens a confirmation that first says which documents embed the procedure.

Deleting a procedure cannot be undone. Before you confirm, the dialog says which documents embed the procedure: one sentence for each, with the place of the section and its owner, for example "Operating manual embeds it (Section 3 · Sam)." When nothing embeds it, the dialog reads "Nothing else uses this procedure." A document that embeds the procedure keeps its text, but the procedure is gone: decide what to do with that section before you delete. The execution reports of a deleted procedure are kept in the Archive of Insights, which the dialog names "Insights → Archive": see Insights.

Confirmation for deleting the procedure Move the mechanism. Under the title, the sentence Operating manual embeds it (Section 3 · Sam). Then the note that this cannot be undone and that the execution reports stay in Insights → Archive, above the buttons Cancel and Delete procedure.
The sentence (1) says which document embeds the procedure, in which section, and who owns that section. Cancel (2) keeps the procedure, Delete procedure (3) deletes it.

If the check of where the procedure is used fails, the dialog says so and offers Try again; the delete button then reads Delete without checking.

Edit a procedure ​

Select a procedure in the list to open it in the procedure editor. The editor shows the product in 3D and, around it, everything that makes up the procedure.

Procedure editor with the 3D model in the centre, the card of the current step with its instruction at the bottom, the Steps list under the Publish changes button on the right, and, on the left, a narrow bar of icons beside the Assistant panel, under the name of the product and the switch between Product twin and Procedure.
The step card (1) under the 3D view shows the current step as its reader will see it. The Steps list (2) is on the right, under the name of the procedure and its actions (3). The narrow bar on the left (4) leaves the editor and folds away the panel beside it, which holds the Assistant.
  • The 3D view shows the product as it is in the current step and plays the movement of the parts of that step.
  • The step card holds the title, the instruction, the safety notes, the photos, the video, the tools and the protective gear of the current step. Its arrows go to the previous and the next step, and Play step again replays the movement. Before the first step, the card shows the Start screen with the name of the procedure.
  • The Steps list holds the steps in their order. Selecting a step shows it in the 3D view and opens its settings.
  • The header, above the Steps list, holds the name, the type and the actions of the procedure.
  • The panel on the left holds the name of the product, the switch between Product twin (the cube), the editor of the 3D model and its parts, and Procedure (the list), which is where you are, and below them the Assistant.
  • The narrow bar on the left holds, from top to bottom: Back to product (the arrow), Collapse panel, which folds the panel away, Report a problem (the bug), Help (the question mark) and All products (the house). Help > Shortcuts lists the keyboard shortcuts of the editor. When the panel is folded, Expand panel brings it back, and Product twin and Procedure are two icons in the bar. In a narrow window the panel is folded until you expand it. Your choice applies to both editors until you close the browser tab.
Header of the procedure editor: the name Move the mechanism with the status Published, the type Usage with a link icon and the number 2 beside it, a row of buttons ending with an eye icon and Publish changes, and the word Saved under them.
The name (1), the status Draft or Published (2) and the type (3), with the link icon and the count of what uses the procedure beside it. Below them, after the two arrows that undo and redo: Share (4), Export (5), the save status (6), Preview (7) and Publish changes (8).
ControlWhat it does
Procedure nameSelect the name and enter a new one.
Draft or PublishedShows whether the procedure is published.
Procedure typeSelect the type under the name to choose another one.
Used byThe link icon with a number. It appears when something uses the procedure: see See where a procedure is used.
Undo, RedoTake back or restore your own last changes.
ShareGives the link, the QR code and the embed code of a published procedure. On a draft the button is named Publish to share and starts publishing.
ExportDownloads the procedure as a PDF or a Word file.
SavedThe save status: see How your changes are saved.
PreviewShows the procedure as its readers see it.
Publish, Publish changesPublish publishes a procedure that is not published yet. On a published procedure the button reads Publish changes and gives your changes to the operators. See Publish or unpublish a procedure.

How your changes are saved ​

There is no Save button. Each change is saved a moment after you make it, and everyone who has the procedure open sees it at once. The save status, beside Preview, says where you stand:

StatusMeaning
Saving…A change of yours is on its way.
SavedEverything you changed is stored.
Reconnecting…The connection was lost. You can keep working: your changes are sent when it comes back.
Offline — keep this tab openThe connection has been lost for some time. Your changes are only in this tab until it comes back: do not close it.
Not saved yet — trying againA change could not be stored yet. TwinWorks tries again.
Video not savedA step video could not be stored. Add it to its step again.

Operators do not get your changes yet: they keep the version that was last published until someone selects Publish changes. See Publish or unpublish a procedure.

Saving does not build AR tracking. AR tracking is what View in AR in the procedure viewer needs to follow the real product with the camera of the reader's device. It is built one step at a time: open AR anchor on a step and select Build AR tracking.

Work on a procedure with other people ​

Several people can edit the same procedure at the same time.

  • Who is where. The avatars of the others stand in the header. In the step card and the step settings, the field a colleague is in has an outline in their colour, with their avatar on it; their first name shows for two seconds when they arrive. A step in the Steps list shows the avatars of the people on it. The avatar of someone who has not done anything for a while fades. Select an avatar in the header to go to the step that person is on.
  • One person types in a text at a time. While a colleague types the title or the instruction of a step, you can read it but not change it: it says, for example, "Sam is typing…" until three seconds after their last key.
  • Changes made at the same time. If a colleague changed a text while your change of it was on its way, for example while you were offline, the message "Sam changed this too." shows their text and offers Keep mine and Use theirs.
  • Undo takes back only your own changes. When a colleague has changed the same thing since, the message "Sam changed this since — it can't be undone." appears instead.

Leave the editor ​

Back to product returns to the procedures of the product. Your changes are already saved. Only a step video that is still being saved makes the editor ask first: wait for it, or leave without it.

Work with steps ​

The Steps list is where you add, order and remove steps. The button with three dots on a step, Step actions, appears when you point at the step or select it; a right-click on the step opens the same menu.

Steps list with the Step actions menu open on the second step: Duplicate, Insert step above, Insert step below, Insert group below, Move up, Move down and Delete step.
Step actions (1) opens the menu of a step: Duplicate (2), Insert step below (3), Insert group below (4), Move up (5) and Delete step (6).
  • Add a step. Select Add step under the list. A step named "New step" is added at the end and opens.
  • Insert a step. Point between two steps and select Insert step here, or use Step actions > Insert step above or Insert step below.
  • Reorder. Drag a step to its new place, or use Step actions > Move up or Move down.
  • Duplicate. Step actions > Duplicate adds a copy under the step, with "(Copy)" after its title.
  • Delete. Step actions > Delete step removes the step at once. A message with an Undo button appears for a few seconds; Undo in the header also brings the step back.

Only one step is open at a time. Collapse all above the list closes it.

A step can carry small marks on its row in the Steps list; point at a mark to read what it means. A safety sign means that the step has at least one safety note. A broken chain link means that the step uses a part the 3D model no longer has: the mark names the part. Open Parts in the step, where the part reads "Missing", and remove it. An eye in a frame means that the AR tracking of the step is out of date: build it again under AR anchor.

What a step holds ​

A step is edited in two places. The step card under the 3D view holds what the reader reads. The row of the step in the Steps list, once open, holds what the 3D view does.

On the step card ​

Step card of the step Push the slider with a caution note, the instruction, a photo, a tool named Hex key, protective gear named Gloves, and buttons to add a safety note, a photo, a video, a tool and PPE.
From top to bottom, what the reader reads: the title, a safety note, the instruction, a photo, a tool and a protective gear. The arrow (1) hides or shows these details. Safety note (2), Photo (3), Video (4) and, beside Tool, PPE (5) add to the step. At the bottom, Play step again is on the left, and the two arrows go to the previous and the next step.
A step holdsHow you set it
TitleSelect the title, enter the new one and press Enter.
Safety notesSelect Safety note (2), choose Danger, Warning, Caution or Notice, enter the note and press Enter.
InstructionSelect the text, or "Add an instruction" when there is none, and write. The formatting buttons make the text bold, italic or underlined, or turn it into a list. Select anywhere else to keep the text; Escape restores it.
PhotosSelect Photo (3) and choose one or more JPEG, PNG or WebP files.
VideoSelect Video (4) and choose one .mp4, .webm, .mov or .m4v file. A step has one video. Trim shortens it and Snapshot turns moments of it into photos.
ToolsSelect Tool, to the left of PPE, enter a Name and, if you wish, a detail, a quantity and a unit, then select Add.
Protective gearSelect PPE (5), select the gear to wear or enter another one, then select Add.

The cross on a safety note, a photo, the video, a tool or a protective gear removes it.

In the row of the step ​

Open step in the Steps list with the rows Instruction, Step view, Parts, Mechanism, Labels and arrows, and AR anchor. Under Parts, the part Slider is open: it goes from the position Default to the position Extended, whose settings are shown with a position list, an eye, a duration in seconds and a turn in degrees, above four highlight colours.
Edit (1) goes to the instruction on the step card. Update (2) stores the step view. Parts (3) lists the parts of the step; Choose from list (4) and Select (5) add parts. An open part shows where it starts (6) and where it ends (7), with the settings of the position that is selected, the button that adds a position (8), the eye that hides the part (9) and the highlight colours (10). Add label (11), Add arrow (12) and AR anchor (13).
A step holdsHow you set it
Step view (2)The view of the 3D model the reader gets on this step. Turn and zoom the model until it shows what the reader should see, then select Set, or Update when the step already has a view. Step view options (the three dots beside Update) > Remove view removes it.
Parts (3)The parts the step moves or highlights. While the row of the step is open, select a part in the 3D view to add it; select it again to remove it. Select (5) does the same with a bar above the 3D view, where Done confirms and Cancel restores the parts the step had. Choose from list (4) opens the list of the parts and of the groups of parts of the product. The cross at the end of a part removes it from the step.
Positions of a part (6 to 9)Select Parts, then a part. The part starts from the first position shown (6) and ends in the last one (7). Select the last position to open its settings: the position, the duration of the move in seconds and a turn in degrees. The eye (9) hides the part in that position. Add position (8) makes the part pass through more positions. The first position has a lock: the part starts where the earlier steps left it. To choose another start, select the first position, then Unlock the starting position.
Highlight colour (10)Choose No highlight, Red: remove, Green: insert or Blue: inspect.
Labels & arrows (11, 12)Add label: choose Part or Scene, select Place label, then select the place on the model and enter the text. Add arrow: select the place on the model, then choose the direction, the colour and the size. A label on a part follows the part when it moves.
AR anchor (13)The parts that View in AR tracks at this step. Open the row and select Build AR tracking.

The type of the procedure sets how a part is first shown when you add it. In an Assembly procedure, a part appears in the first step that uses it and is highlighted in green. In a Disassembly procedure, a part is hidden at the end of the step and is highlighted in red. In the other types the part stays visible and is highlighted in green. You can change the positions and the colour on each part.

The positions of a part, such as Default and Extended in the picture, are defined in the product twin: see Products.

Step groups ​

A group is a named run of steps that follow each other in the Steps list. A group can show only the parts its steps work on, or cut the product open, for as long as the reader is on one of its steps. Use a group for the steps that work on one sub-assembly.

Step by step

Create a group and put steps into it

Group the steps that belong together, for example the steps on one sub-assembly.

Procedure editorStepsMore ways to add stepsAdd group
Steps
  1. Under the Steps list, select the arrow beside Add step, named More ways to add steps.
  2. Select Add group. A group named New group appears at the end of the list and reads "No steps yet".
  3. In the group, select Move steps here…. The Move steps here dialog lists the steps of the procedure.
  4. Select the box of each step to move, then select Move. The button shows how many steps are selected, for example Move (2).
  5. To name the group, select Group actions (three dots) on its line, then Group settings, and enter a Group name.
Result

The steps are listed under the group, indented. Selecting the line of the group folds or unfolds them.

Move steps here dialog with a search field and the two steps of the procedure, each with a box. The box of the step Turn the link is selected and the Move button counts one selected step.
Select the box of each step to move (1), then the Move button (2), which shows how many steps are selected.

Other ways to fill and to empty a group:

  • Drag. Drag a step onto the group, or out of it.
  • From the menu of a step. Step actions > Move into a group, then choose the group. Step actions > Move out of the group takes the step out.
  • A new step in the group. Select Add step in the empty group, or Group actions > Add step.
  • A new group under a step. Step actions > Insert group below.
Step by step

Show only the parts a group works on

Hide the rest of the product while the reader is on the steps of the group. The product needs a 3D model.

Procedure editorStepsGroup actionsGroup settings
Steps
  1. On the line of the group, select Group actions (three dots), then Group settings.
  2. Turn on Show only these parts.
  3. To keep a part visible that no step of the group uses, select Add part (the plus) beside Parts to show and choose the part. You can also select parts in the 3D view while the settings are open.
  4. Select Close group settings (the arrow at the end of the line).
  5. Select a step of the group to see the result.
Example

The group Link adjustment holds the step Turn the link, which moves the Link. With the Slider added under Parts to show, the 3D view shows the Link and the Slider on that step, and hides the Frame.

Result

An eye on the line of the group marks it. On each step of the group the 3D view shows the parts the steps of the group use and the parts under Parts to show. On the first step after the group, every part is back.

Group Link adjustment with its settings open: the Group name field, the Cut the product open switch turned off, the Show only these parts switch turned on, and Slider listed under Parts to show. The step Turn the link is listed under the group.
The line of the group (1) with the eye that marks a group showing only its parts (2). Group name (3), Cut the product open (4), Show only these parts (5), the button that adds a part to show (6), the button that removes one (7), and Close group settings (8).
Procedure editor on the step Turn the link, which belongs to the group Link adjustment. The 3D view shows only the Link and the Slider; the Frame is hidden.
On a step of the group (1), here Turn the link (2), the 3D view shows only the parts of the group.
  • Cut the product open. In Group settings, turn on Cut the product open: on the steps of the group, the 3D model is cut along a plane, to show what is inside. While the settings are open, the plane and a handle are shown in the 3D view: drag the handle to move and turn the cut. A pair of scissors on the line of the group marks it.
  • While the settings of a group are open, the 3D view shows every part, so that you can select parts. The group takes effect again when you close them.
  • What the reader sees. The reader does not see the groups or their names in the procedure viewer, only their effect on the 3D view. Preview shows the same. In a PDF or Word export, the name of a group is printed as a heading above its first step.
  • Delete a group. Select Group actions > Delete group. In "Delete step group?", Ungroup steps removes the group and keeps its steps; Delete group and steps removes both.

Record a procedure ​

Instead of writing the steps, you can record the task and have the steps written from the recording. The two recorders are in the menu of the arrow beside Add step; in a procedure with no steps they are the buttons 3D and voice and Video under Record a procedure.

Bottom of the Steps list with the Add step button and, opened by the arrow beside it, a menu with Add group, Record with 3D and voice, Record a video and How recording works.
The arrow beside Add step (1) opens a menu: Add group (2), the two recorders, Record with 3D and voice (3) and Record a video (4), and How recording works (5).
RecorderWhat it recordsWhat you get
Record with 3D and voiceYour voice, and the parts you select on the 3D model while you speakSteps written from what you said, with the parts you selected
Record a videoThe camera and the microphone, in one takeSteps written from the video, each with its part of the video

How recording works opens a help dialog for one recorder: 3D and voice at first, video once you have started a video recording.

Step by step

Record with 3D and voice

Describe the task aloud while you select the parts you talk about on the 3D model.

Procedure editorStepsMore ways to add stepsRecord with 3D and voice
Steps
  1. Under the Steps list, select the arrow beside Add step, then Record with 3D and voice.
  2. Allow the microphone if the browser asks.
  3. Describe the task. While you speak, select the parts you talk about, in the 3D view or in the list of parts that replaces the Steps list.
  4. Say when a new step starts, in your own words, for example "in the next step": it helps to separate the steps.
  5. Under the list of parts, select Stop recording (the round button with a square), or Cancel to discard the recording.
Example

Say "Push the slider to the end of the rods" while you select the Slider, then "In the next step, turn the link on its pin" while you select the Link.

Result

The message "Processing recording…" stays on screen while the steps are written. When the message "Recording processed" appears, the new steps are in the Steps list. If the steps could not be written, the message "Steps not created" appears instead: record again.

Step by step

Record a video

Film the task in one take with the camera of your device.

Procedure editorStepsMore ways to add stepsRecord a video
Steps
  1. Under the Steps list, select the arrow beside Add step, then Record a video.
  2. Allow the camera and the microphone if the browser asks.
  3. Film the task in one take. The picture of the camera is shown at the end of the Steps list.
  4. Under the Steps list, where Add step was, select Stop recording, or Cancel to discard the recording.
Result

The message "Processing recording…" stays on screen while the steps are written. When the message "Recording processed" appears, the new steps are in the Steps list, each with its part of the video. If the steps could not be written, the message "Steps not created" appears instead: record again.

  • While a recording runs you cannot open Preview. From the start of a recording until its steps are written, you cannot edit steps or groups, add photos or a video, or trim a video, and the Assistant cannot change the procedure: its panel reads "Editing paused while recording". Cancel gives the editor back at once.
  • If the recording does not start, check that the browser may use the microphone, and for a video the camera: see Technical requirements.
  • If the browser cannot record video, Record a video shows "This browser cannot record video" and records nothing: use another browser, or Record with 3D and voice. If the browser stops recording the video during a take, the message "Recording stopped" appears and nothing is sent.
  • If "Processing recording…" is still on screen after 15 minutes, the message "Recording still processing" appears: reload the page to check for the new steps.
  • When the steps of a recording are written while the procedure is also open in another editor, that editor refreshes its steps and shows "Steps refreshed". If it has changes that are not saved, it shows "Steps changed by a recording" instead: select Reload to see the new steps, which discards those changes.
  • To use a video you already have, create the procedure with Add video: see Create a procedure.

Recorded steps are a first draft, written in the language of the procedure: read them and correct them like generated ones.

Use the Assistant ​

The Assistant is a conversation panel on the left of the editor, open when the editor opens. It reads the procedure and the product's files, answers questions about them, and proposes changes to the steps that you approve one by one.

Assistant panel of the procedure editor, beside the bar of icons, under the name of the product and the switch between Product twin and Procedure. The panel asks What should we change, offers four suggestions and, at the bottom, a field with the placeholder Ask about this step, above which a chip names the step Push the slider.
Collapse panel (1), in the bar, folds the panel away; Expand panel brings it back. Assistant options (2) starts a new conversation or copies this one. A suggestion (3) sends a ready-made request. The chip (4) says which step the message is about; its cross leaves the step out. Enter your message in the field (5) and send it (6).
Step by step

Ask the Assistant to change the procedure

Let the Assistant write, reorder or check steps, and decide which of its changes to keep.

Procedure editorAssistant
Steps
  1. If the panel on the left is folded, select Expand panel in the narrow bar on the left. The Assistant is in that panel, under Product twin and Procedure.
  2. Select a suggestion, or enter what you want in the field and press Enter.
  3. If the Assistant asks a question, select one of its options or enter your own answer.
  4. When the Assistant proposes changes, a card in the conversation lists them, each with a selected box. Clear the box of each change you do not want.
  5. Select Approve all to apply all the changes, Run selected to apply the ones still selected, or Reject to apply none.
  6. Check the steps.
Example

With the step Push the slider open, ask: Add a caution about fingers near the slider, and make the instruction shorter.

Result

The applied changes are saved in the procedure. Each one has its own card in the conversation with Undo and Keep.

  • What to ask. Writing or rewriting titles and instructions; adding, deleting, moving, duplicating or reordering steps; the parts of a step and how they move; tools, protective gear and safety notes; the step view; labels and arrows; and questions about the procedure or the product's files. Answers taken from a file carry references to its pages, which open the file.
  • What the message is about. The chips above the field name the open step and the parts selected in the 3D view. Open a step before you ask about it.
  • The card of proposed changes is titled "Review" with the number of changes. Nothing is changed in the procedure until you select one of its three buttons.
  • Undo and Keep. Undo on the card of an applied change takes the change back. Undo from here also takes back the changes applied after it. Keep confirms the change: the card then reads "Kept" and has no buttons. A change you neither undo nor keep stays in the procedure. Selecting the card opens the step it changed.
  • Skipping the review. The box Don't ask again in this session on the card of proposed changes makes every later change apply without asking. Turn off under the field, or a new conversation, brings the review back.
  • Stopping. While the Assistant works, the send button becomes Stop assistant.
  • The conversation of this Assistant is not kept: it is gone when you reload the page or select Assistant options > New conversation. The Assistant of the Documentation section is another one, and keeps its conversation: see Assistant.

Preview a procedure ​

Preview (the eye in the header) shows the procedure as its readers see it in the procedure viewer, with your latest changes. Nothing can be edited in the preview, and nothing is saved or published by it.

Preview of the procedure in a tablet frame: the product in 3D above the card of the step Push the slider with its caution note, instruction, photo, tool and protective gear. Above the frame, three screen size buttons and the Exit preview button.
Screen size (1) switches between Phone, Tablet and Desktop. Exit preview (2) returns to the editor. The arrow at the bottom right of the card goes to the next step.
  1. Select Preview.
  2. Select Start, then the arrow to go from step to step.
  3. Under Screen size, select Phone, Tablet or Desktop to see the procedure on that screen.
  4. Select Exit preview, press Escape, or select Finish on the last step.

Publish or unpublish a procedure ​

Publishing makes a procedure available to its readers. A procedure can be published to either of two audiences, or to both: Public, for anyone with the link, and Team, for signed-in members of your organization only.

Step by step

Publish a procedure from the editor

Choose who can open the procedure.

Procedure editorPublish
Steps
  1. In the header of the editor, select Publish.
  2. In Publish procedure, turn on Public, Team, or both.
  3. Select Publish.
Example

For a procedure that only your own technicians should follow, turn on Team and leave Public off.

Result

The status beside the name changes from Draft to Published, and the Share procedure dialog opens with the link.

Publish procedure dialog with the switch Public, Anyone with the link, turned on, the switch Team, Signed-in members only, turned off, and the buttons Customize settings and Publish.
Public (1) and Team (2) set the audiences. Customize settings (3) opens the Publish section of the product. Publish (4) confirms.
  • Publish changes. Once a procedure is published, operators keep the version that was published until someone selects Publish changes in the header. The button is active while they have an older version; its tooltip then says "Changes not yet on the shop floor". The message "Published" confirms that operators now see the changes.
  • Change the audiences or unpublish. Use the switches of the procedure under Content in the Publish section of the product: see Publishing. A procedure that is published to no audience is a Draft again. A reader who then opens its link or scans its QR code gets the message "This procedure is no longer published" in place of the procedure.
  • Customize settings opens the Publish section of the product, where what each audience sees, the languages, the features and the branding are set for the whole product: see Publishing.
  • A lock on Publish means that your plan does not include publishing.

Share a published procedure ​

Step by step

Get the link, the QR code or the embed code

Give a published procedure to its readers.

Procedure editorShare
Steps
  1. In the header of the editor, select Share.
  2. Under the title, select Public or Team to choose which link is shown. An audience the procedure is not published to cannot be selected.
  3. Select Copy (the two sheets) to copy the link, Download QR code to save its QR code as an image, or Embed code (the angle brackets) to get the code that shows the procedure inside a web page.
Example

Print the QR code of the Team link and put it on the machine, so that a technician opens the procedure with a phone.

Share procedure dialog with the Public and Team choice, the link with buttons to copy it, to get the embed code and to open it in a new tab, a QR code and the Download QR code button.
Choose the audience of the link (1). Copy (2) copies the link, Embed code (3) gives the code for a web page, Open in new tab (4) opens the procedure as its reader sees it, and Download QR code (5) saves the QR code.
  • Embed code opens a dialog of the same name with the code in a field and a Copy button. If your plan does not include embedding, the message "Plan upgrade required" appears and the dialog does not open.
  • The Share procedure dialog also opens by itself after you publish.
  • Get link in the menu of a row of the list copies the Public link when the procedure is published to the Public audience, otherwise the Team link.

Export a procedure ​

A procedure can be downloaded as a PDF or as an editable Word file, for printing or for use without a connection. The procedure does not need to be published. The file holds what is in the editor at that moment.

Step by step

Export a procedure as PDF or Word

Download the procedure as a file that follows the export template of your organization.

Procedure editorExport
Steps
  1. In the header of the editor, select Export.
  2. If you wish, choose a 3D view style for this file.
  3. Select Export as PDF or Export as Word.
  4. Wait for the download, or close the dialog and go on working: the download starts when the file is ready.
Result

The message "PDF ready" or "Word file ready" appears and the browser downloads a file named after the procedure.

Export procedure dialog with the 3D view style list set to the default of the template, and the buttons Export as Word and Export as PDF.
3D view style (1) sets how the 3D views are drawn in this file. Export as Word (2) and Export as PDF (3) build the file.
3D view styleHow the 3D views are drawn
Template defaultIn the style set in the template; the name of that style is shown in parentheses
RealisticShaded views
OutlinedShaded views with the edges of the parts drawn
Technical DrawingBlack line drawings without perspective, with the parts of the step in colour, made from the CAD file of the product. Without a CAD file the views are Outlined. The first export of a large model can take several minutes.

The layout, the colours and the logo of the file come from the default procedure template of your organization: see Export templates. While technical drawings are being made, Finish now finishes the file sooner, with the remaining views drawn from the 3D model.

If your plan does not include exports, the dialog still opens, and the two buttons answer with the message "PDF export not available" or "Word export not available".

See where a procedure is used ​

A procedure can be embedded or cited in the documents of the product, and referred to by other procedures. When something uses the procedure, a link icon with a number appears beside the type in the header of the editor. Select it to open the list Used by.

Used by list open under the header of the procedure editor. It says Used by 1 published document and 1 draft, then lists under Where this is used a published document and a draft, both named Operating manual, each with its section Operation and links to open them.
The link icon with a number (1) opens the list. Open document (2) and Open section (3) open the place in a new tab. Why is this listed? (4) gives the reason.

The list has the headings Procedures, Published documents and Drafts. Check this list before you change a procedure that a published document shows to its readers.

The icon is not shown when nothing uses the procedure.