---
title: "Location Sample List - Perspective"
id: "location-sample-list-perspective"
project: "MES User Manual"
url: "https://docs.sepasoft.com/articles/user-manual/location-sample-list-perspective"
updated: 2026-10-01T15:52:39Z
---

# Location Sample List \- Perspective

**Sepasoft MES Module Suite**

###  SPC Location Sample List in Perspective

**Location Sample List** displays samples for a location and optionally by sample ownership. Through configuration properties, it can show samples that are scheduled to be coming due, due, overdue, or waiting approval or approved.

When an allowable location is added to a sample definition, a tag value can be set. This component can limit the samples that appear by entering in matching tag values. It is typically used for defining who has ownership for collecting sample data. For example, the lab takes samples at packaging line 1 every 2 hours. The operator also takes samples at packaging line 1 every 1 hour. The lab does not want to see samples that the operator has ownership for and vice versa. To accomplish this, set the tag value to "Lab" for sample definitions that the lab has ownership for and to "Operator" for sample definitions that the operator has ownership for.

| ![Warning](/resources/Storage/user-manual/Warning.png) | MES 3.81.9 and later<br> <br>Installed with the **SPC Module** |
| --- | --- |

 ![](/resources/Storage/user-manual/location-sample-list-perspective/SPC%20Location%20Sample%20List.PNG)
 
* * *

###  Sample List UI

![](/resources/Storage/user-manual/location-sample-list-perspective/SPCLocationSample.png)

####  Sample Dataset

| ![Note](/resources/Storage/user-manual/Note.png) | Available in **3.81.10 RC3** and later<br><br>The second column returned in Perspective/Vision Location Sample List components and getSampleList script call is named "Definition" and contains the name of the Sample Definition attached to a sample entry. |
| --- | --- |

![](/resources/Storage/user-manual/location-sample-list-perspective/location-sample-list-perspective-2024-05-24.png)

![](/resources/Storage/user-manual/location-sample-list-perspective/location-sample-list-perspective-2024-05-24-1.png)

![](/resources/Storage/user-manual/location-sample-list-perspective/location-sample-list-perspective-2024-05-24-2.png)

####  Component Properties

Properties are provided that can be set to affect the operation and look of the component. They can be set through the **Property Editor in the Designer** or through scripting.


```python
self.getSibling("spcLocationList").showLocationSampleListHeader = True
```


| **Name** | **Property Value Descriptions** |
| --- | --- |
| **showLocationSampleListHeader** | Boolean - When True displays the header with the edit and approval tools display. |
| **toolbarTitle** | String - defaults to SPC Location Sample List |
| **selectedUUID** | | ![Note](/resources/Storage/user-manual/Note.png) | Available in MES 3.81.10 SP1 and later |<br>| --- | --- |<br><br><br>Boolean - Tracks the SampleUUID of the selected Sample in the list. Changing the property does not affect the component, it just relays information that can be used for linking. |
| **showEditNoteIcon** | Boolean - When True allows adding and editing of sample notes. |
| **showApproveSampleIcon** | Boolean - When True allows approving samples. |
| **showUnapproveSampleIcon** | Boolean - When True allows unapproving samples. |
| **showSearchIcon** | Boolean - When True displays search bar and allows searching on sample names. |
| **showIncludeSampleIcon** | Boolean - When True displays Include Sample icon |
| **showexcludeSampleIcon** | Boolean - When True displays Exclude Sample icon |
| **tableColumns** | **Formatting of table columns:**<br> <br>align<br> <br>alignVertical<br> <br>columnName<br> <br>dataFormat<br> <br>dataType<br> <br>fixed<br> <br>hidden<br> <br>include<br> <br>name<br> <br>order<br> <br>searchEnabled<br> <br>sortingEnabled<br> <br>title<br> <br>orginalTitle<br> <br>width<br> <br>wordWrapEnabled |
| **selectedRow** | Index of the first selected row, or -1 if none. |
| **data** | Raw sample data |
| **executionTimes** | in milliseconds |
| **readOnly** | Boolean - When True, sets the list as read-only no allowing any editing. |
| **showWaitingApproval** | Boolean - When True, samples that are waiting to be approved or unapproved show up in the table. |
| **showApprovedSamples** | Boolean - When True, table displays samples that have been approved. |
| **showDueSamples** | Boolean - When True, table displays samples that meet the Due threshold for sampling. |
| **showComingDueSamples** | Boolean - When True, table displays samples that meet the Coming Due threshold for sampling. |
| **showOverdueSamples** | Boolean - When True, table displays samples that meet the Over Due threshold for sampling. |
| **showExcludedSamples** | Boolean - Use this to show all excluded or all included samples. |
| **startDate** | Required start date/time for samples to display in the table. |
| **endDate** | Required end date/time for samples to display in the table. |
| **locationPath** | String - Show samples by Locations in the equipment path. E.g. 'Enterprise\Site\Area\K-A Location'<br><br>In **MES 3.81.12 SP5**, **MES 4.83.1 SP5**, and later, an empty `sampleUUID` clears the sample form, including when the Location Sample List selection is cleared because its location path is `<None>`. |
| **produceCode** | String - Show samples by product code. |
| **referenceNo** | String - Show samples by reference number. |
| **sortType** | Set which column to sort on. Filter allowed on that data. |
| **tag** | String - Show samples by tag. |
| **toolbarColumnChooserEnabled** |  |
| **resizingAllowed** | Boolean - When true, columns can be resized during runtime. |
| **Note** | String - Entered when the sample is taken<br><br><br>| ![Note](/resources/Storage/user-manual/Note.png) | As of 3.81.10 SP7 - Added Entered By and Last Updated fields as read-only fields. |<br>| --- | --- |<br><br><br>![](/resources/Storage/user-manual/location-sample-list-perspective/location-sample-list-perspective-2025-01-07.png) |
| **NoteEnteredBy** | based on login credentials |

**Sepasoft MES Module Suite**