README

Akeneo 3.1 的 TESSA 连接器

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

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

需求

重要！请确保您的 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-1-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. （可选）创建一个 cronjob 在后台与 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