Task 1.1 - Use a List and a Resource

Task Overview

In this first tutorial task, you'll learn how to build a process flow using shared assets. Process flows have three types of shared assets that have different purposes, as explained in the following table:

Consider reading Key Concepts About Shared Assets for a more details explanation of the three shared assets in a process flow and how they differ from other types of process flow activities.

In this tutorial task, you'll learn how to use resources and lists to build a transportation task sequence in a process flow for two operators. You'll also learn how to link resources and lists to 3D objects in the model. In this model, the list will track the flow items that need to be transported and the resources will represent the operators that are assigned to complete a transportation task.

When you're finished, your process flow will look similar to the following image:

And it will control the two operators as they load flow items from a queue and unload them at one of two processors in the 3D model:

Using Labels to Connect to the 3D Model

In this model, you'll use labels extensively to link tokens in a process flow to objects in the 3D model. Process flows can control the logic of the 3D model using labels that contain a reference to a 3D object in the model. As the token moves through the activities in the process flow, the activity's logic can be applied to the object in the 3D model using this reference. Consider reading Key Concepts About Labels for a deeper understanding of how to work with labels in a process flow.

In this model, you'll use labels to:

• Link tokens to flow items in the 3D model - You'll create a label named pulledItem to link tokens in a process flow to the flow items that need to be transported in the 3D model. You'll also copy the value of this item to a label called FlowItem to tokens in the section of the process flow that handles the transportation task sequence.
• Assign task sequences to an operator - When you acquire a resource in this process flow, you'll create a label on the token called operator that will link the resource to one of the two operators in the 3D model. After the operator has been assigned to a transportation task, this label will be used to dynamically assign this operator to complete all the tasks in the transportation task sequence.
• Dynamically set flow item destinations - A label named destination on the flow item will track which processor the flow item should be transported to. The process flow will copy the value of this label to a matching label on a token called itemDestination and use this in the transportation task sequence.

Step 1 Build the 3D Model

In this step, you'll build a basic 3D model. When you're finished, your 3D model should look similar to the following image:

To build this model:

1. Drag the following objects from the Library and place them in the model in this order from left to right:
   • 1 Source
   • 1 Queue
   • 2 Processors
   • 1 Operator
   • 1 Sink
   • 1 Shape (under the Visual group)
2. Move the objects so that they are roughly in the same layout as shown in the image at the beginning of this step.
3. For clarity, rename the objects as follows:

Object	New Name
Source1	Source
Queue1	Queue
Operator1	Operator
Sink1	Sink
Shape1	Fountain

4. Create port connections (A-connects) from:
   • Source to Queue
   • Queue to Processor1 and Processor2
   • Processor1 and Processor2 to Sink

Check to make sure that your model looks similar to the image shown in the beginning of this section.

Step 2 Create an Item List

In this step, you'll create a global list that will track the items that are ready for transport from the queue to the processors. Since this list will contain items, you'll create an item list. Then, you'll change the queue's settings so that it will push all entering items to this new list.

To create the list and update the queue:

1. In the left pane, click the Toolbox tab.
2. In the Toolbox, click the Add button to open a menu. Point to Global List, then select Item List. The list properties window will open automatically.
3. In the name box at the top of the properties window, change the name of the item list to ItemsToTransport.



4. You'll use the default settings for this item list, so click the OK button to save the changes and close the window.
5. Confirm that the ItemsToTransport list shows up in the Toolbox under the Global Lists group.



6. In the 3D model, click the Queue to bring up its properties on the right.
7. Under the Output tab, check the Use Transport checkbox.
8. Click the arrow next to the box beneath the Use Transport checkbox to open a menu. Point to Use List, then select Push to Item List (No Task Sequence) to open some picklist options.
9. Confirm that the List box displays the ItemsToTransport list is the currently selected list. Notice also that when the queue pushes the flow items to the list, it will create three labels on the item, as listed in the Store Data on Item box.

Consider saving your simulation model.

Step 3 Create a Group and Add a Parameter

In this step, you will create a Group and add a Parameter to the model. These tools will help us make our model more robust and scalable when working with our Operators.

Let's start by creating a Group for our Operators:

1. In the Toolbox on the right, click the Add button and select the Group option. You should see a Group Properties window now.
2. Change the name of the Group to Operators.
3. Under the Members section, click the Sampler button to enter sampling mode. Select the original Operator we made in the 3D model.

Your Group Properties window should now look like this:

Next, let's create a Parameter that will control how many Operators are in the group:

4. Back in the Toolbox, you should see Model Parameter Tables. Under that, you should see an option titled Parameters - double-click that to open it.
5. There should already be a default parameter. In the name column, change the cell to say NumOperators.
6. Select the cell in the Value column. You'll see a drop down arrow - click it. A popup with several sections will open. We'll be updating these settings.
7. In the Type section, select the dropdown and change it to Integer.
8. In the Reference section, click the Sampler button to enter sampling mode. Find the Operators group in the Toolbox and sample it. A path to the Group should appear in the edit field.
9. In the On Set section, click the Add button and select Delete and Copy Group Members.

After these changes, the popup should look like this:


10. Click off the popup to close it. The last two columns in the Parameter table are there to document the parameter so you can remember what it does - they have no effect on how the model runs.
11. Change the Parameter's Value to be 2.

When you're done with all these steps, it should look like this:

Now we have a Group of Operators that will fluctuate in size depending on what value we give our NumOperators Parameter. Since it has a value of 2, we should have 2 Operators when we Reset the model.

Consider saving your simulation model.

Step 4 Add Activities to a Transport Task Sequence

In this step, you'll add activities to a general process flow to build a simple loading and unloading task sequence. This process flow will have three sections:

• The Shared Assets section will contain a List shared asset and a Resource shared asset.
• The Task Creation section will create transportation tasks for the operators.
• The Transport Tasks section will contain the basic loading and unloading task sequence.

When you're finished, your process flow should look similar to the following image:

For now, you'll merely add and connect these activities to the process flow. You'll edit the properties to add the functionality in a later step.

To add and connect these activities:

1. On the main toolbar, click the Process Flow button to open a menu. Select Add a General Process Flow.
2. In Properties in the Process Flow Name box, delete the current text and rename the process flow OperatorTasks.
3. In the Library under the Display group, add 3 Container shapes to the new process flow.
4. For clarity, rename the three Process shapes as follows:
   • Shared Assets
   • Task Creation
   • Transport Tasks
5. From the Library, add the following shared assets to the Shared Assets shape:
   • A List (under Shared Assets)
   • A Resource (under Shared Assets)
6. For clarity, rename these shared assets as:

Shared Asset	New Name
List	List: ItemsToTransport
Resource	Resources: Operators



7. From the Library, add the following activities to the Task Creation shape:
   • A Schedule Source (under Token Creation)
   • A Pull from List (under Shared Assets)
   • A Create Tokens (under Basic)
8. Create a connector from the Schedule Source to the Pull from List. (Point your mouse over the bottom middle of the activity until your mouse changes to a connector icon. Click and drag the connector until it snaps to the other activity.)
9. Join the Pull from List and Create Tokens activities into a stacked block.
10. Create a connector that loops from the end of the Create Tokens activity back to the Pull from List activity.
11. For clarity, rename these activities as:

Activity	New Name
Source	Source: Start Simulation
Pull from List	Pull from ItemsToTransport List
Create Tokens	Create Token in Transport Tasks



12. In the Transport Tasks shape, add the following activities to create a stacked block:
    • An Assign Labels (under Basic)
    • An Acquire Resource (under Shared Assets)
    • A Create Task Sequence (under Task Sequences)
    • A Load (under Task Sequences)
    • An Unload (under Task Sequences)
    • A Travel > Travel To Object (under Task Sequences)
    • A Finish Task Sequence (under Task Sequences)
    • A Release Resource (under Shared Assets)
    • A Sink (under Basic)
13. For clarity, rename these activities as:

    Activity	New Name
    Assign Labels	Assign Labels: Destination
    Acquire	Acquire Operator
    Create TS	Create Task Sequence
    Load	Load Item at Queue
    Unload	Unload Item at Destination
    Travel	Travel Back to Queue
    Finish TS	Finish Task Sequence
    Release	Release Operator
    Sink	Sink: Finish Task

    

Consider saving your simulation model.

Step 5 Link the Shared Assets to the 3D Model

In this relatively short step, you'll learn how to link shared assets in the process flow to objects in the 3D model. You'll link the ItemsToTransport list in the process flow to the global list by the same name that you created in step 2.

After that, you'll link the resource shared asset to the group you made in step 3. You could change the number of resources available using the Parameter Table to experiment with how many operators you might need to complete common tasks.

To make these changes:

1. In the process flow, click the List: ItemsToTransport shared asset to select it. In Properties, click the arrow next to the List box to open a menu. Point to Global List, then select ItemsToTransport.



2. Click the Resources: Operators shared asset to select it. In Properties next to the Reference box, click the Sampler button to enter sampling mode.
3. Click the Operators Group in the Toolbox to sample it. The Count section should automatically change to say Number of Group Members.



4. Press the Reset button on the simulation control panel.
5. In the 3D model, you should see a second Operator created next to your first one. If you open the Operators group, you should see an Operator_2 added under the original.

Consider saving your simulation model.

Step 6 Edit the Task Creation Activities

In this step, you'll edit the properties for the activities in the Task Creation section of the process flow. The following is an overview of how each activity in this section will function:

To edit these properties:

1. Click the Scheduled Source activity to select it. You'll use the default properties for this activity, so confirm that the settings match the following image:



2. Click the Pull From ItemsToTransport List activity to select it. Click the Exclamation Point button next to this activity to enter sampling mode.
3. Click the List: ItemsToTransport shared asset in the process flow to sample it. A blue line will appear to show that the list is now linked.



4. In Properties, confirm that the Assign To option is selected. In the box beneath it, change the text to token.pulledItem for clarity.



5. With the Create Token in Transport Tasks activity selected as well, click the Exclamation Point button next to this activity to enter sampling mode.
6. Click the Assign Labels: Destination activity to sample it. A blue line will appear to show that the tokens will be created in this activity.
7. In Properties, click the Create As menu and select Independent Tokens.
8. Under the Assign Labels to Created Tokens, click the Add button to add a label to the child token that will be created.
9. In the Name box, type FlowItem.
10. Click the arrow next to the Value box to open a menu. Point to Token Label, then select pulledItem.

Consider saving your simulation model.

Step 7 Edit the Transport Task Sequence

In this step, you'll edit the properties for the activities in the Transport Tasks section of the process flow to create a simple transportation task sequence. The following is an overview of how each activity in this section will function:

To create this logic:

1. Click the stacked block in the Transport Tasks to select it.
2. There should be a default label labelName with value 0. In the Name box, replace labelName with itemDestination.
3. Click the arrow next to the Value box to open a menu. Point to Token Label, then select FlowItem. The box will now read token.FlowItem. Add .destination to the end of the FlexScript in this box.



4. Next to the Acquire Operator activity, click the Exclamation Point button to enter sampling mode.
5. Click the Resources: Operators in the process flow to sample it. A blue line will appear to show that the resource is now linked.
6. In Properties for the Acquire Operator activity, change the Assign To label to token.operator.



7. Click the Create Task Sequence activity to select it. In Properties, click the arrow next to the Executer / Task Sequence box to open a menu. Point to Token Label and select Operator. This will assign the task sequence we are creating to the operator previously acquired. Leave the other settings as their default values. You'll notice that this activity creates a new label on the token called taskSequence. All of the tasks in this sequence will be assigned to the sequence via this label.



8. In Properties for the Load Item at Queue activity, make sure the default for Executer / Task Sequence reads token.taskSequence.
9. Click the arrow next to the Item box to open a menu. Point to Token Label and select FlowItem.



10. In Properties for the Unload Item at Destination activity, make sure the default for Executer / Task Sequence reads token.taskSequence.
11. Click the arrow next to the Item box to open a menu. Point to Token Label and select FlowItem. Click the arrow next to the Station box to open a menu. Point to Token Label and select itemDestination.



12. In Properties for the Travel Back to Queue activity, make sure the default for Executer / Task Sequence reads token.taskSequence. Then, next to the Destination box, click the Sampler button to enter sampling mode.
13. Select the Queue in the 3D model to open a menu. Select Queue from the menu to sample it.



14. We can leave the Finish Task Sequence as its default settings. Make sure the Task Sequence box reads token.taskSequence. This designates the end of the sequence of tasks to be carried out.



15. In Properties for the Release Operator activity, click the arrow next to the Resource(s) Assigned To box to open a menu. Point to Token Label and select operator.

Consider saving your simulation model.

Step 8 Test the Simulation Model

At this point, you should probably run the simulation model to ensure that the basic travel task sequence is running correctly. Reset and run the model.

In the 3D model, the task executers should alternate between transporting flow items to the processors.

Watch as the tokens first move through the Task Creation section pulling items from the list and sending tokens to the Transport Tasks section. Notice that when a flow item isn't available for transport, it creates a red back order on the list shared asset.

Notice also that when the operators are assigned to the task, they show up as being allocated in the Resources shared asset. While the operators perform the transportation task in the 3D model, the flow items move through the task sequence.

Conclusion

Now you've built a basic transport task sequence using lists and resources. In the next tutorial, you'll learn how to make a resource act a little like the list in order to get some advanced functionality from it. Continue on to Tutorial Task 1.2 - Make a Resource Act Like a List.