WIP

Author: RhysLees

README.md

@@ -103,7 +103,7 @@ then optimize the processes that power the core of your business.
 | FileCabinets/CheckInCheckOut        | Undo Check-out                                              | 🕣        |                |
 | FileCabinets/SelectLists            | Get Select Lists & Get Filtered Select Lists                | ✅         |                |
 | FileCabinets/Upload                 | Create Data Record                                          | ✅         |                |
-| FileCabinets/Upload                 | Append File(s) to a Data Record                             | ❌         | -              |
+| FileCabinets/Upload                 | Append File(s) to a Data Record                             | ✅         | -              |
 | FileCabinets/Upload                 | Upload a Single File for a Data Record                      | ❌         | -              |
 | FileCabinets/Upload                 | Create a Data Record & Upload File                          | ❌         | -              |
 | FileCabinets/Upload                 | Create Data Record & Upload File Using Store Dialog         | ❌         | -              |

src/Requests/FileCabinets/Upload/AppendFilesToADataRecord.php

@@ -0,0 +1,43 @@
+<?php
+
+namespace CodebarAg\DocuWare\Requests\FileCabinets\Upload;
+
+use CodebarAg\DocuWare\DTO\Documents\Document;
+use CodebarAg\DocuWare\DTO\Documents\DocumentIndex\PrepareDTO;
+use CodebarAg\DocuWare\Responses\FileCabinets\Upload\CreateDataRecordResponse;
+use Illuminate\Support\Collection;
+use Saloon\Contracts\Body\HasBody;
+use Saloon\Data\MultipartValue;
+use Saloon\Enums\Method;
+use Saloon\Http\Request;
+use Saloon\Http\Response;
+use Saloon\Traits\Body\HasFormBody;
+use Saloon\Traits\Body\HasMultipartBody;
+
+class AppendFilesToADataRecord extends Request implements HasBody
+{
+    use HasMultipartBody;
+
+    protected Method $method = Method::POST;
+
+    public function __construct(
+        protected readonly string $fileCabinetId,
+        protected readonly string $dataRecordId,
+        protected readonly Collection $files,
+    ) {}
+
+    public function resolveEndpoint(): string
+    {
+        return '/FileCabinets/'.$this->fileCabinetId.'/Documents/'.$this->dataRecordId;
+    }
+
+    protected function defaultBody(): array
+    {
+        return $this->files->toArray();
+    }
+
+    public function createDtoFromResponse(Response $response): Document
+    {
+        return CreateDataRecordResponse::fromResponse($response);
+    }
+}

tests/Feature/Requests/FileCabinets/Upload/AppendFilesToADataRecordTest.php

@@ -0,0 +1,84 @@
+<?php
+
+use CodebarAg\DocuWare\DTO\Documents\Document;
+use CodebarAg\DocuWare\Events\DocuWareResponseLog;
+use CodebarAg\DocuWare\Requests\FileCabinets\Upload\AppendFilesToADataRecord;
+use CodebarAg\DocuWare\Requests\FileCabinets\Upload\CreateDataRecord;
+use Illuminate\Support\Facades\Event;
+use Saloon\Data\MultipartValue;
+
+it('can attach a file to a data record', function () {
+    Event::fake();
+
+    $fileCabinetId = env('DOCUWARE_TESTS_FILE_CABINET_ID');
+
+    $document = $this->connector->send(new CreateDataRecord(
+        fileCabinetId: $fileCabinetId,
+        fileContent: file_get_contents(__DIR__.'/../../../../Fixtures/files/test-1.pdf'),
+        fileName: 'test-1.pdf',
+        indexes: null
+    ))->dto();
+
+    $response = $this->connector->send(
+        new AppendFilesToADataRecord(
+            fileCabinetId: $fileCabinetId,
+            dataRecordId: $document->id,
+            files: collect([
+                new MultipartValue(
+                    name: 'File[]',
+                    value: file_get_contents(__DIR__.'/../../../../Fixtures/files/test-2.pdf'),
+                    filename: 'test-2.pdf',
+                ),
+            ])
+        )
+    )->dto();
+
+    expect($response)->toBeInstanceOf(Document::class)
+        ->and($response->sections->count())->toBe(2)
+        ->and($response->sections->first()->originalFileName)->toBe('test-1.pdf')
+        ->and($response->sections->last()->originalFileName)->toBe('test-2.pdf');
+
+    Event::assertDispatched(DocuWareResponseLog::class);
+});
+
+it('can attach files to a data record', function () {
+    Event::fake();
+
+    $fileCabinetId = env('DOCUWARE_TESTS_FILE_CABINET_ID');
+
+    $document = $this->connector->send(new CreateDataRecord(
+        fileCabinetId: $fileCabinetId,
+        fileContent: file_get_contents(__DIR__.'/../../../../Fixtures/files/test-1.pdf'),
+        fileName: 'test-1.pdf',
+        indexes: null
+    ))->dto();
+
+    $response = $this->connector->send(
+        new AppendFilesToADataRecord(
+            fileCabinetId: $fileCabinetId,
+            dataRecordId: $document->id,
+            files: collect([
+                new MultipartValue(
+                    name: 'File[]',
+                    value: file_get_contents(__DIR__.'/../../../../Fixtures/files/test-2.pdf'),
+                    filename: 'test-2.pdf',
+                ),
+                new MultipartValue(
+                    name: 'File[]',
+                    value: file_get_contents(__DIR__.'/../../../../Fixtures/files/test-3.pdf'),
+                    filename: 'test-3.pdf',
+                ),
+            ])
+        )
+    )->dto();
+
+    ray($response->sections);
+
+    expect($response)->toBeInstanceOf(Document::class)
+        ->and($response->sections->count())->toBe(3)
+        ->and($response->sections->first()->originalFileName)->toBe('test-1.pdf')
+        ->and($response->sections->originalFileName)->toBe('test-2.pdf')
+        ->and($response->sections->last()->originalFileName)->toBe('test-2.pdf');
+
+    Event::assertDispatched(DocuWareResponseLog::class);
+})->only();