README

Akeneo 3.2 的 TESSA 连接器

使用此连接器包，您可以无缝地将 Akeneo 与数字资产管理解决方案 "TESSA" (https://www.tessa-dam.com) 连接起来。这为您提供了 Akeneo 的专业且完全集成的 DAM 解决方案，以在所有渠道中集中存储、管理和使用产品（例如图像、视频、文档等）的所有附加文件。

更多详细信息请访问我们的 网站。

要求

重要!请确保您的 Akeneo API 正在运行。TESSA 需要与您的 Akeneo 的 API 连接。在某些情况下，Apache 配置错误，请参阅 https://api.akeneo.com/documentation/troubleshooting.html#apache-strip-the-authentication-header。

安装

1. 使用 composer 安装包

composer require eikona-media/akeneo3-2-tessa-connector

1. 然后，在您的 app/config/routing.yml 文件的末尾添加以下行

tessa_media:
    resource: "@EikonaTessaConnectorBundle/Resources/config/routing.yml"

1. 在 app/AppKernel.php 文件中的 registerProjectBundles() 方法中启用包

protected function registerProjectBundles()
{
    return [
        // ...
        new Eikona\Tessa\ConnectorBundle\EikonaTessaConnectorBundle(),
    ];
}

1. 在您的项目根目录中运行以下命令

php bin/console cache:clear --env=prod --no-warmup
php bin/console cache:warmup --env=prod
php bin/console pim:installer:dump-require-paths --env=prod
php bin/console pim:installer:assets --env=prod
yarn run webpack

1. 更新您的数据库模式

php bin/console doctrine:schema:update --dump-sql # Show changes
php bin/console doctrine:schema:update --force # Update database schema

1. 在您的 Akeneo 系统设置中配置 Tessa 连接器。

2. (可选) 创建一个 crontab 任务以在后台与 TESSA 同步数据

如果在使用系统设置中的 "在后台同步" 选项，则这是必需的

php bin/console eikona_media:tessa:notification_queue:execute --env=prod

建议每 5 分钟运行一次 (*/5 * * * *)。如果命令同时启动两次，则第二次命令将存在一个通知。

如何与参考实体（企业版 >3.0）一起使用

1. 在 app/AppKernel.php 文件中的 registerProjectBundles() 方法中启用 ReferenceDataAttributeBundle（在 EikonaTessaConnectorBundle 之后）

protected function registerProjectBundles()
{
    return [
        // ...
        new Eikona\Tessa\ConnectorBundle\EikonaTessaConnectorBundle(), // Already registered
        new Eikona\Tessa\ReferenceDataAttributeBundle\EikonaTessaReferenceDataAttributeBundle(), // New
    ];
}

1. 添加新的参考实体属性时，在类型下拉列表中选择 TESSA

如何与 CustomEntityBundle 一起使用

1. 请确保您已安装 CustomEntityBundle

2. 在 app/AppKernel.php 文件中的 registerProjectBundles() 方法中启用 ReferenceDataBundle（在 EikonaTessaConnectorBundle 之后）

protected function registerProjectBundles()
{
    return [
        // ...
        new Eikona\Tessa\ConnectorBundle\EikonaTessaConnectorBundle(), // Already registered
        new Eikona\Tessa\ReferenceDataBundle\EikonaTessaReferenceDataBundle(), // New
    ];
}

1. 在您的编辑表单中使用该模块

    pim-brand-edit-logo:
        module: eikona/tessa/connector/reference-data/form/field # Use this module
        parent: pim-brand-edit-form-properties-common
        targetZone: content
        position: 100
        config:
            fieldName: logo # This field has to be of type "string"
            label: acme_custom.brand.field.label.logo
            customEntityName: brand
            allowedExtensions: ['jpg', 'jpeg', 'png'] # Allowed extensions (default: no restriction)
            maximumCount: 4 # Maximum assets (default: unlimited)

1. (可选) 在数据网格中显示缩略图

datagrid:
    brand:
        # ...
            columns:
                 # ...
                 logo:
                    label: acme_custom.brand.field.label.logo
                    type: twig
                    frontend_type: html
                    template: EikonaTessaReferenceDataBundle:datagrid:thumbnail.html.twig