Stock location can now be identified via the app

assets/release_notes.md

@@ -7,6 +7,7 @@
 - Refactor home screen display
 - Display unread notifications on home screen
 - Fixes duplicated display of units when showing stock quantity
+- Adds ability to locate / identify stock items or locations (requires server plugin)
 - Improve rendering of home screen when server is not connected
 - Adds ability to load global and user settings from the server
 

lib/l10n/app_en.arb

@@ -416,6 +416,9 @@
   "keywords": "Keywords",
   "@keywords": {},
 
+  "labelTemplate": "Label Template",
+  "@labelTemplate": {},
+
   "lastStocktake": "Last Stocktake",
   "@lastStocktake": {},
 
@@ -428,6 +431,12 @@
   "lineItems": "Line Items",
   "@lineItems": {},
 
+  "locateItem": "Locate stock item",
+  "@locateItem": {},
+
+  "locateLocation": "Locate stock location",
+  "@locateLocation": {},
+
   "locationCreate": "New Location",
   "@locationCreate": {},
 
@@ -575,6 +584,12 @@
   "printLabel": "Print Label",
   "@printLabel": {},
 
+  "plugin": "Plugin",
+  "@plugin": {},
+
+  "pluginPrinter": "Printer",
+  "@pluginPrinter": {},
+
   "printLabelFailure": "Label printing failed",
   "@printLabelFailure": {},
 

lib/widget/location_display.dart

@@ -3,6 +3,7 @@ import "package:flutter/material.dart";
 import "package:font_awesome_flutter/font_awesome_flutter.dart";
 
 import "package:inventree/api.dart";
+import 'package:inventree/api_form.dart';
 import "package:inventree/app_colors.dart";
 import "package:inventree/barcode.dart";
 import "package:inventree/inventree/stock.dart";
@@ -61,19 +62,99 @@ class _LocationDisplayState extends RefreshableState<LocationDisplayWidget> {
     );
      */
 
-    if ((location != null) && (InvenTreeAPI().checkPermission("stock_location", "change"))) {
+    if (location != null) {
-      actions.add(
+
-        IconButton(
+      // Add "locate" button
-          icon: FaIcon(FontAwesomeIcons.edit),
+      if (InvenTreeAPI().supportsMixin("locate")) {
-          tooltip: L10().edit,
+        actions.add(
-          onPressed: () { _editLocationDialog(context); },
+          IconButton(
-        )
+            icon: FaIcon(FontAwesomeIcons.searchLocation),
-      );
+            tooltip: L10().locateLocation,
+            onPressed: () async {
+              _locateStockLocation(context);
+            },
+          )
+        );
+      }
+
+      // Add "edit" button
+      if (InvenTreeAPI().checkPermission("stock_location", "change")) {
+        actions.add(
+            IconButton(
+              icon: FaIcon(FontAwesomeIcons.edit),
+              tooltip: L10().edit,
+              onPressed: () { _editLocationDialog(context); },
+            )
+        );
+      }
     }
 
     return actions;
   }
 
+  Future<void> _locateStockLocation(BuildContext context) async {
+
+    final _loc = location;
+
+    if (_loc != null) {
+
+      final plugins = InvenTreeAPI().getPlugins(mixin: "locate");
+
+      if (plugins.isEmpty) {
+        // TODO: Error message here
+        return;
+      }
+
+      String plugin_name = "";
+
+      if (plugins.length == 1) {
+        plugin_name = plugins.first.key;
+      } else {
+        // User selects which plugin to use
+        List<Map<String, dynamic>> plugin_options = [];
+
+        for (var plugin in plugins) {
+          plugin_options.add({
+            "display_name": plugin.humanName,
+            "value": plugin.key,
+          });
+        }
+
+        Map<String, dynamic> fields = {
+          "plugin": {
+            "label": L10().plugin,
+            "type": "choice",
+            "value": plugins.first.key,
+            "choices": plugin_options,
+            "required": true,
+          }
+        };
+
+        await launchApiForm(
+          context,
+          L10().locateLocation,
+          "",
+          fields,
+          icon: FontAwesomeIcons.searchLocation,
+          onSuccess: (Map<String, dynamic> data) async {
+            plugin_name = (data["plugin"] ?? "") as String;
+          }
+        );
+      }
+
+      print("plugin: ${plugin_name}");
+
+      InvenTreeAPI().post(
+        "/api/locate/",
+        body: {
+          "plugin": plugin_name,
+          "location": "${_loc.pk}",
+        },
+        expectedStatusCode: 200,
+      );
+    }
+  }
+
   void _editLocationDialog(BuildContext context) {
 
     final _loc = location;

lib/widget/stock_detail.dart

@@ -217,14 +217,14 @@ class _StockItemDisplayState extends RefreshableState<StockDetailWidget> {
 
     Map<String, dynamic> fields = {
       "label": {
-        "label": "Label Template",
+        "label": L10().labelTemplate,
         "type": "choice",
         "value": initial_label,
         "choices": label_options,
         "required": true,
       },
       "plugin": {
-        "label": "Printer",
+        "label": L10().pluginPrinter,
         "type": "choice",
         "value": initial_plugin,
         "choices": plugin_options,