Feature Fields (#116)

* Update PutDocumentFieldUpdate

Author: StanBarrows

README.md

@@ -171,7 +171,7 @@ $thumbnail = $connector->send(new GetDocumentDownloadThumbnailRequest($fileCabin
 /**
  * Update value of a indexed field.
  */
-$value = $connector->send(new PutDocumentFieldsRequest($fileCabinetId, $documentId, [$fieldName => $newValue]))->dto()[$fieldName];
+$value = $connector->send(new PutDocumentFieldsRequest($fileCabinetId, $documentId, [$fieldName => $newValue]))->dto();
 
 /**
  * Update multiple values of indexed fields.
@@ -401,35 +401,35 @@ Please see [Tests](tests/Feature/DocuWare.php) for more details.
 ```php
 CodebarAg\DocuWare\DTO\DocumentIndex\IndexTextDTO {
   +name: "FIELD_TEXT"                               // string
-  +value: "Value"                                   // string
+  +value: "Value"                                   // null|string
 }
 ```
 
 ```php
 CodebarAg\DocuWare\DTO\DocumentIndex\IndexNumericDTO {
   +name: "FIELD_NUMERIC"                                 // string
-  +value: 1                                             // int
+  +value: 1                                             // null|int
 }
 ```
 
 ```php
 CodebarAg\DocuWare\DTO\DocumentIndex\IndexDecimalDTO {
   +name: "FIELD_DECIMAL"                                  // string
-  +value: 1.00                                           // int|float
+  +value: 1.00                                           // null|int|float
 }
 ```
 
 ```php
 use CodebarAg\DocuWare\DTO\DocumentIndex\IndexDateDTO {
   +name: "FIELD_DATE"                                      // string
-  +value: now(),                                           // Carbon
+  +value: now(),                                           // null|Carbon
 }
 ```
 
 ```php
 use CodebarAg\DocuWare\DTO\DocumentIndex\IndexDateTimeDTO {
   +name: "FIELD_DATETIME"                                     // string
-  +value: now(),                                             // Carbon
+  +value: now(),                                             // null|Carbon
 }
 ```
 
@@ -451,7 +451,7 @@ use CodebarAg\DocuWare\DTO\DocumentIndex\IndexTableDTO {
             'VALUE' => 1.00,
          ],
       ]
-])                                                         // Collection|array
+])                                                         // null|Collection|array
 }
 ```
 

src/DTO/Dialog.php

@@ -35,11 +35,11 @@ public function isSearch(): bool
     }
 
     public static function fake(
-        string $id = null,
-        string $type = null,
-        string $label = null,
-        bool $isDefault = null,
-        string $fileCabinetId = null,
+        ?string $id = null,
+        ?string $type = null,
+        ?string $label = null,
+        ?bool $isDefault = null,
+        ?string $fileCabinetId = null,
     ): self {
         return new self(
             id: $id ?? (string) Str::uuid(),

src/DTO/Document.php

@@ -105,18 +105,18 @@ public function fileName(): string
     }
 
     public static function fake(
-        int $id = null,
-        int $file_size = null,
-        int $total_pages = null,
-        string $title = null,
-        string $extension = null,
-        string $content_type = null,
-        string $file_cabinet_id = null,
-        string $intellixTrust = null,
-        Carbon $created_at = null,
-        Carbon $updated_at = null,
-        Collection $fields = null,
-        Collection $suggestions = null,
+        ?int $id = null,
+        ?int $file_size = null,
+        ?int $total_pages = null,
+        ?string $title = null,
+        ?string $extension = null,
+        ?string $content_type = null,
+        ?string $file_cabinet_id = null,
+        ?string $intellixTrust = null,
+        ?Carbon $created_at = null,
+        ?Carbon $updated_at = null,
+        ?Collection $fields = null,
+        ?Collection $suggestions = null,
     ): self {
         return new self(
             id: $id ?? random_int(1, 999999),

src/DTO/DocumentField.php

@@ -33,11 +33,11 @@ public function __construct(
 
     public static function fake(
         ?bool $systemField = false,
-        string $name = null,
-        string $label = null,
+        ?string $name = null,
+        ?string $label = null,
         ?bool $isNull = true,
-        int|float|Carbon|string $value = null,
-        string $type = null,
+        int|float|Carbon|string|null $value = null,
+        ?string $type = null,
     ): self {
         $fakeType = Arr::random(['Int', 'Decimal', 'Text', 'DateTime']);
 

src/DTO/DocumentIndex/IndexDateDTO.php

@@ -8,12 +8,12 @@ class IndexDateDTO
 {
     public function __construct(
         public string $name,
-        public Carbon $value,
+        public null|Carbon|\Carbon\Carbon $value,
     ) {
 
     }
 
-    public static function make(string $name, Carbon $value): self
+    public static function make(string $name, null|Carbon|\Carbon\Carbon $value): self
     {
         return new self($name, $value);
     }

src/DTO/DocumentIndex/IndexDateTimeDTO.php

@@ -8,12 +8,12 @@ class IndexDateTimeDTO
 {
     public function __construct(
         public string $name,
-        public Carbon $value,
+        public null|Carbon|\Carbon\Carbon $value,
     ) {
 
     }
 
-    public static function make(string $name, Carbon $value): self
+    public static function make(string $name, null|Carbon|\Carbon\Carbon $value): self
     {
         return new self($name, $value);
     }

src/DTO/DocumentIndex/IndexDecimalDTO.php

@@ -6,12 +6,12 @@ class IndexDecimalDTO
 {
     public function __construct(
         public string $name,
-        public int|float $value,
+        public null|int|float $value,
     ) {
 
     }
 
-    public static function make(string $name, int|float $value): self
+    public static function make(string $name, null|int|float $value): self
     {
         return new self($name, $value);
     }

src/DTO/DocumentIndex/IndexNumericDTO.php

@@ -8,12 +8,12 @@ class IndexNumericDTO
 
     public function __construct(
         public string $name,
-        public int $value,
+        public ?int $value,
     ) {
 
     }
 
-    public static function make(string $name, int $value): self
+    public static function make(string $name, ?int $value): self
     {
         return new self($name, $value);
     }

src/DTO/DocumentIndex/IndexTableDTO.php

@@ -9,12 +9,12 @@ class IndexTableDTO
 {
     public function __construct(
         public string $name,
-        public Collection|array $rows,
+        public null|Collection|array $rows,
     ) {
 
     }
 
-    public static function make(string $name, Collection|array $rows): self
+    public static function make(string $name, null|Collection|array $rows): self
     {
         return new self($name, $rows);
     }
@@ -33,7 +33,7 @@ public function values(): array
 
     protected function rowsCollection(): array
     {
-        return collect($this->rows)->map(function ($row) {
+        return collect($this->rows ?? [])->map(function ($row) {
 
             $indexes = collect($row)->map(function ($column) {
 

src/DTO/DocumentIndex/IndexTextDTO.php

@@ -6,12 +6,12 @@ class IndexTextDTO
 {
     public function __construct(
         public string $name,
-        public string $value,
+        public ?string $value,
     ) {
 
     }
 
-    public static function make(string $name, string $value): self
+    public static function make(string $name, ?string $value): self
     {
         return new self($name, $value);
     }