Add support for article individualization retrieval/saving

Author: usox

docs/index.md

@@ -81,6 +81,22 @@ ArticleDetail(
     int <articleTypeId>
 )
 ```
+##### ArticleIndividualization
+Represtens the article individualization configuration
+```
+ArticleIndividualization(
+    bool <hasFallback>
+    array <individualizationItems>
+)
+```
+##### ArticleIndividualizationItem
+
+```
+ArticleIndividualizationItem(
+    int <targetgroupId>
+    int <articleId>
+)
+```
 ### Blacklist
 ##### BlackList
 Represents a list of BlackListItems for one specific mandator.<br>

src/Struct/Article/ArticleIndividualization.php

@@ -0,0 +1,61 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Scn\EvalancheSoapStruct\Struct\Article;
+
+/**
+ * Represtens the article individualization configuration
+ */
+class ArticleIndividualization implements ArticleIndividualizationInterface
+{
+    /**
+     * @var bool
+     */
+    private $hasFallback;
+
+    /**
+     * @var array<ArticleIndividualizationItemInterface>
+     */
+    private $individualizationItems;
+
+    public function __construct(
+        bool $hasFallback = false,
+        array $individualizationItems = []
+    ) {
+        $this->hasFallback = $hasFallback;
+        $this->individualizationItems = $individualizationItems;
+    }
+
+    /**
+     * Is `true` if a fallback configuration is set
+     */
+    public function isHasFallback(): bool
+    {
+        return $this->hasFallback;
+    }
+
+    /**
+     * Set the fallback configuration
+     */
+    public function setHasFallback(bool $hasFallback): void
+    {
+        $this->hasFallback = $hasFallback;
+    }
+
+    /**
+     * @return array<ArticleIndividualizationItemInterface>
+     */
+    public function getIndividualizationItems(): array
+    {
+        return $this->individualizationItems;
+    }
+
+    /**
+     * @param array<ArticleIndividualizationItemInterface> $individualizationItems
+     */
+    public function setIndividualizationItems(array $individualizationItems): void
+    {
+        $this->individualizationItems = $individualizationItems;
+    }
+}

src/Struct/Article/ArticleIndividualizationInterface.php

@@ -0,0 +1,28 @@
+<?php
+
+namespace Scn\EvalancheSoapStruct\Struct\Article;
+
+use Scn\EvalancheSoapStruct\Struct\StructInterface;
+
+interface ArticleIndividualizationInterface extends StructInterface
+{
+    /**
+     * Is `true` if a fallback configuration is set
+     */
+    public function isHasFallback(): bool;
+
+    /**
+     * Set the fallback configuration
+     */
+    public function setHasFallback(bool $hasFallback): void;
+
+    /**
+     * @return array<ArticleIndividualizationItemInterface>
+     */
+    public function getIndividualizationItems(): array;
+
+    /**
+     * @param array<ArticleIndividualizationItemInterface> $individualizationItems
+     */
+    public function setIndividualizationItems(array $individualizationItems): void;
+}

src/Struct/Article/ArticleIndividualizationItem.php

@@ -0,0 +1,61 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Scn\EvalancheSoapStruct\Struct\Article;
+
+/**
+ * Represents a article-id/targetgroup tuple in the article individualization config
+ */
+class ArticleIndividualizationItem implements ArticleIndividualizationItemInterface
+{
+    /**
+     * @var int
+     */
+    private $targetgroupId;
+
+    /**
+     * @var int
+     */
+    private $articleId;
+
+    public function __construct(
+        int $targetgroupId = 0,
+        int $articleId = 0
+    ) {
+        $this->targetgroupId = $targetgroupId;
+        $this->articleId = $articleId;
+    }
+
+    /**
+     * @return int
+     */
+    public function getTargetgroupId(): int
+    {
+        return $this->targetgroupId;
+    }
+
+    /**
+     * @param int $targetgroupId
+     */
+    public function setTargetgroupId(int $targetgroupId): void
+    {
+        $this->targetgroupId = $targetgroupId;
+    }
+
+    /**
+     * @return int
+     */
+    public function getArticleId(): int
+    {
+        return $this->articleId;
+    }
+
+    /**
+     * @param int $articleId
+     */
+    public function setArticleId(int $articleId): void
+    {
+        $this->articleId = $articleId;
+    }
+}

src/Struct/Article/ArticleIndividualizationItemInterface.php

@@ -0,0 +1,28 @@
+<?php
+
+namespace Scn\EvalancheSoapStruct\Struct\Article;
+
+use Scn\EvalancheSoapStruct\Struct\StructInterface;
+
+interface ArticleIndividualizationItemInterface extends StructInterface
+{
+    /**
+     * @return int
+     */
+    public function getTargetgroupId(): int;
+
+    /**
+     * @param int $targetgroupId
+     */
+    public function setTargetgroupId(int $targetgroupId): void;
+
+    /**
+     * @return int
+     */
+    public function getArticleId(): int;
+
+    /**
+     * @param int $articleId
+     */
+    public function setArticleId(int $articleId): void;
+}

tests/Struct/Article/ArticleIndividualizationItemTest.php

@@ -0,0 +1,52 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Scn\EvalancheSoapStruct\Struct\Article;
+
+use Scn\EvalancheSoapStruct\StructTestCase;
+
+class ArticleIndividualizationItemTest extends StructTestCase
+{
+    /** @var ArticleIndividualizationItem */
+    private $subject;
+
+    protected function setUp(): void
+    {
+        $this->subject = new ArticleIndividualizationItem();
+    }
+
+    public function testTargetgroupIdSetGet(): void
+    {
+        $value = 666;
+
+        static::assertSame(
+            0,
+            $this->subject->getTargetgroupId()
+        );
+
+        $this->subject->setTargetgroupId($value);
+
+        static::assertSame(
+            $value,
+            $this->subject->getTargetgroupId()
+        );
+    }
+
+    public function testArticleIdSetGet(): void
+    {
+        $value = 666;
+
+        static::assertSame(
+            0,
+            $this->subject->getArticleId()
+        );
+
+        $this->subject->setArticleId($value);
+
+        static::assertSame(
+            $value,
+            $this->subject->getArticleId()
+        );
+    }
+}

tests/Struct/Article/ArticleIndividualizationTest.php

@@ -0,0 +1,48 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Scn\EvalancheSoapStruct\Struct\Article;
+
+use Scn\EvalancheSoapStruct\StructTestCase;
+
+class ArticleIndividualizationTest extends StructTestCase
+{
+    /** @var ArticleIndividualization */
+    private $subject;
+
+    protected function setUp(): void
+    {
+        $this->subject = new ArticleIndividualization();
+    }
+
+    public function testHasFallbachSetGet(): void
+    {
+        static::assertFalse(
+            $this->subject->isHasFallback()
+        );
+
+        $this->subject->setHasFallback(true);
+
+        static::assertTrue(
+            $this->subject->isHasFallback()
+        );
+    }
+
+    public function testGetIndividualizationItemsSetGet(): void
+    {
+        $items = ['some-item'];
+
+        static::assertSame(
+            [],
+            $this->subject->getIndividualizationItems()
+        );
+
+        $this->subject->setIndividualizationItems($items);
+
+        static::assertSame(
+            $items,
+            $this->subject->getIndividualizationItems()
+        );
+    }
+}