feat(attachments): add "match by mapping file" support

specifyweb/backend/attachment_gw/dataset_views.py

@@ -12,6 +12,17 @@ class AttachmentDataSetPT(PermissionTarget):
     upload = PermissionTargetAction()
     rollback = PermissionTargetAction()
 
+VALID_MATCHING_MODES = {'mappingFile'}
+
+def _get_validated_matchingmode(data, existing=None):
+    """Return a validated matchingmode value or raise ValueError."""
+    if 'matchingmode' not in data:
+        return existing
+    value = data['matchingmode']
+    if value is not None and value not in VALID_MATCHING_MODES:
+        raise ValueError(f"Invalid matchingmode: {value!r}")
+    return value
+
 def datasets_view(request):
     if request.method == 'GET':
         return http.JsonResponse(Spattachmentdataset.get_meta_fields(request), safe=False)
@@ -28,6 +39,7 @@ def datasets_view(request):
             createdbyagent=request.specify_user_agent,
             modifiedbyagent=request.specify_user_agent,
             uploaderstatus="main",
+            matchingmode=_get_validated_matchingmode(data),
             # A bit more flexible than workbench. Handles creating datasets with an uploadplan from the start.
             uploadplan=json.dumps(data['uploadplan']) if 'uploadplan' in data else None
         )
@@ -49,6 +61,7 @@ def dataset_view(request, ds: Spattachmentdataset):
         ds.name = attrs.get('name', ds.name)
         ds.remarks = attrs.get('remarks', ds.remarks)
         ds.data = attrs.get('rows', ds.data)
+        ds.matchingmode = _get_validated_matchingmode(attrs, ds.matchingmode)
         ds.uploadplan = json.dumps(attrs['uploadplan'] if 'uploadplan' in attrs else ds.uploadplan)
         # Never preserve uploaderstatus. Making it required for all requests.
         old_status = ds.uploaderstatus

specifyweb/backend/attachment_gw/migrations/0002_add_matchingmode.py

@@ -0,0 +1,18 @@
+# Generated manually
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('attachment_gw', '0001_initial'),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name='spattachmentdataset',
+            name='matchingmode',
+            field=models.CharField(max_length=32, null=True, default=None),
+        ),
+    ]

specifyweb/backend/attachment_gw/models.py

@@ -8,6 +8,15 @@ class Spattachmentdataset(Dataset):
 
     id = models.AutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')
 
+    matchingmode = models.CharField(
+        max_length=32, null=True, default=None
+    )
+
+    object_response_fields = [
+        *Dataset.object_response_fields,
+        'matchingmode',
+    ]
+
     class Meta:
         db_table = 'attachmentdataset'
 

specifyweb/frontend/js_src/lib/components/AttachmentsBulkImport/Datasets.tsx

@@ -208,6 +208,11 @@ export function AttachmentsImportOverlay(): JSX.Element | null {
                     />
                     {attachmentDataSet.name}
                   </Link.Default>
+                  {attachmentDataSet.matchingmode === 'mappingFile' && (
+                    <div className="text-xs text-gray-500">
+                      {attachmentsText.matchByMappingFile()}
+                    </div>
+                  )}
                 </td>
                 <td>
                   <DateElement date={attachmentDataSet.timestampcreated} />