Fix #215 - [Legacy] Add Extra Attribute Mapper

public/legacy/include/portability/ApiBeanMapper/ExtraAttributeMappers/ExtraAttributeMapperInterface.php

@@ -0,0 +1,53 @@
+<?php
+/**
+ * SuiteCRM is a customer relationship management program developed by SalesAgility Ltd.
+ * Copyright (C) 2023 SalesAgility Ltd.
+ *
+ * This program is free software; you can redistribute it and/or modify it under
+ * the terms of the GNU Affero General Public License version 3 as published by the
+ * Free Software Foundation with the addition of the following permission added
+ * to Section 15 as permitted in Section 7(a): FOR ANY PART OF THE COVERED WORK
+ * IN WHICH THE COPYRIGHT IS OWNED BY SALESAGILITY, SALESAGILITY DISCLAIMS THE
+ * WARRANTY OF NON INFRINGEMENT OF THIRD PARTY RIGHTS.
+ *
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+ * FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more
+ * details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see http://www.gnu.org/licenses.
+ *
+ * In accordance with Section 7(b) of the GNU Affero General Public License
+ * version 3, these Appropriate Legal Notices must retain the display of the
+ * "Supercharged by SuiteCRM" logo. If the display of the logos is not reasonably
+ * feasible for technical reasons, the Appropriate Legal Notices must display
+ * the words "Supercharged by SuiteCRM".
+ */
+
+interface ExtraAttributeMapperInterface
+{
+    /**
+     * The field to map
+     * @return string
+     */
+    public static function getField(): string;
+
+    /**
+     * Map the field and add it to the container
+     * @param SugarBean $bean
+     * @param array $container
+     * @param string $alternativeName
+     * @return mixed
+     */
+    public function toApi(SugarBean $bean, array &$container, string $alternativeName = ''): void;
+
+    /**
+     * Map the field to bean format and add it to the container
+     * @param SugarBean $bean
+     * @param array $container
+     * @param string $alternativeName
+     * @return mixed
+     */
+    public function toBean(SugarBean $bean, array &$container, string $alternativeName = ''): void;
+}