Updates version, improves relation handling, adds example

Bumps server version references across modules for consistency.
Enhances relation value processing to better distinguish between
associative and indexed arrays, supporting more robust data mapping.
Adds a sample script for reading address data to demonstrate usage.

Author: Vitexus

Examples/ReadAddress.php

@@ -0,0 +1,24 @@
+#!/usr/bin/php -f
+<?php
+
+declare(strict_types=1);
+
+/**
+ * This file is part of the SpojeNet\AbraFlexi package.
+ *
+ * (c) 2019-2024 SpojeNet s.r.o. <http://spoje.net/>
+ * (c) 2025 SpojeNetIT s.r.o. <http://spojenet.cz/>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Example\AbraFlexi;
+
+include_once './config.php';
+
+include_once '../vendor/autoload.php';
+
+$adr = new \AbraFlexi\Adresar(666);
+
+print_r($adr->getData());

Examples/config.php

@@ -12,4 +12,4 @@
  * file that was distributed with this source code.
  */
 
-require_once '../test/bootstrap.php';
+require_once '../tests/bootstrap.php';

src/AbraFlexi/Actions.php

@@ -24,7 +24,7 @@ class Actions
     /**
      * Source AbraFlexi server version.
      */
-    public static string $version = '2025.8.2';
+    public static string $version = '2025.8.4';
 
     /**
      * Evidence adresar (Adresy firem) Actions.

src/AbraFlexi/EvidenceList.php

@@ -38,7 +38,7 @@ class EvidenceList extends RO
     /**
      * Source FlexiBee server version.
      */
-    public static string $version = '2025.8.2';
+    public static string $version = '2025.8.4';
 
     /**
      * Evidences Path/Name listing.
@@ -790,7 +790,7 @@ class EvidenceList extends RO
         'prikaz-k-inkasu-polozka' => [
             'evidenceName' => 'Položka inkasa',
             'evidencePath' => 'prikaz-k-inkasu-polozka',
-            'importStatus' => 'DISALLOWED',
+            'importStatus' => 'NOT_DIRECT',
             'formCode' => 'elInkasoPol',
             'evidenceType' => 'PRIKAZ_K_INKASU_POLOZKA',
             'beanKey' => 'cz.winstrom.vo.eban.PolozkaPrikazu$$BAN',
@@ -801,7 +801,7 @@ class EvidenceList extends RO
         'prikaz-k-uhrade-polozka' => [
             'evidenceName' => 'Položka příkazu k úhradě',
             'evidencePath' => 'prikaz-k-uhrade-polozka',
-            'importStatus' => 'DISALLOWED',
+            'importStatus' => 'NOT_DIRECT',
             'formCode' => 'elPrikazPol',
             'evidenceType' => 'PRIKAZ_K_UHRADE_POLOZKA',
             'beanKey' => 'cz.winstrom.vo.eban.PolozkaPrikazu$$BAN',

src/AbraFlexi/Formats.php

@@ -24,7 +24,7 @@ class Formats
     /**
      * Source FlexiBee server version.
      */
-    public static string $version = '2025.8.2';
+    public static string $version = '2025.8.4';
 
     /**
      * Availble Formats.

src/AbraFlexi/RO.php

@@ -1084,28 +1084,36 @@ public function fixRecordTypes(array $record, $evidence = null)
                             break;
                         case 'relation':
                             if (\is_array($record[$column])) {
-                                $value = $record[$column][0];
-
-                                if (\is_array($value)) {
-                                    $valueFields = array_keys($value);
-                                    $subject = next($valueFields);
-                                    $record[$column] = new Relation(
-                                        \is_array($value) ? (\array_key_exists('kod', $value) ? $value['kod'] : $value['id']) : $value,
-                                        \array_key_exists('fkEvidencePath', $columnInfo) && null !== $columnInfo['fkEvidencePath'] ? $columnInfo['fkEvidencePath'] : $column,
-                                        \array_key_exists($subject.'@ref', $value) ? $record[$subject.'@ref'] : $value['id'],
-                                        \array_key_exists($subject.'@showAs', $value) ? $value[$subject.'@showAs'] : null,
-                                    );
-
-                                    foreach ($value as $a => $b) {
-                                        $record[$column][$a] = $b;
+                                if (\Ease\Functions::isAssoc($record[$column])) {
+                                    $value = $record[$column][0];
+
+                                    if (\is_array($value)) {
+                                        $valueFields = array_keys($value);
+                                        $subject = next($valueFields);
+                                        $record[$column] = new Relation(
+                                            \is_array($value) ? (\array_key_exists('kod', $value) ? $value['kod'] : $value['id']) : $value,
+                                            \array_key_exists('fkEvidencePath', $columnInfo) && null !== $columnInfo['fkEvidencePath'] ? $columnInfo['fkEvidencePath'] : $column,
+                                            \array_key_exists($subject.'@ref', $value) ? $record[$subject.'@ref'] : $value['id'],
+                                            \array_key_exists($subject.'@showAs', $value) ? $value[$subject.'@showAs'] : null,
+                                        );
+
+                                        foreach ($value as $a => $b) {
+                                            $record[$column][$a] = $b;
+                                        }
+                                    } else {
+                                        $record[$column] = new Relation(
+                                            $value,
+                                            $column,
+                                            str_replace('ext:', '', $value),
+                                            $value,
+                                        );
                                     }
                                 } else {
-                                    $record[$column] = new Relation(
-                                        $value,
-                                        $column,
-                                        str_replace('ext:', '', $value),
-                                        $value,
-                                    );
+                                    foreach ($record[$column] as $relPos => $rawRelation) {
+                                        [,$ext,$extId] = explode(':', $rawRelation);
+                                        $record[$column][$ext] = new Relation($extId, $column, $ext, $rawRelation);
+                                        unset($record[$column][$relPos]);
+                                    }
                                 }
                             } else {
                                 $record[$column] = new Relation(

src/AbraFlexi/Relations.php

@@ -24,7 +24,7 @@ class Relations
     /**
      * Source FlexiBee server version.
      */
-    public static string $version = '2025.8.2';
+    public static string $version = '2025.8.4';
 
     /**
      * Evidence adresar (Adresy firem) Relations.