集成使用

Last update: Fri Jul 12 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

演练

以下视频演练介绍了如何使用连接器：

https://video.tv.adobe.com/v/332137/?quality=12&learn=on

设置

本指南将指导您完成连接器的启动和运行。

IMPORTANT

对于每个系统，这些步骤需要由每个系统的 管理员 执行。

本文档中的步骤将指导您创建涉及分配权限和/或管理员访问权限的集成/注册。在执行之前，您有责任确保这些步骤符合贵公司的政策，并仔细执行这些政策。

安装集成包

您将获得对集成AEM包的访问权限。可使用以下两个选项安装集成：

软件包安装 — 直截了当，较少涉及。
POM安装 — 更高级，但在使用AEM Cloud Manager和升级集成时可能很有用。

包安装

要安装包，请通过载入电子邮件中提供的链接下载包。单击此处可找到有关安装AEM包的详细说明。

POM安装

要将连接器包括在POM中，请执行以下步骤。将您的用户名和密码替换为载入电子邮件中收到的用户名和密码。

将以下内容添加到项目中的.cloudmanager/maven/settings.xml文件或计算机上的~/.m2/settings.xml中。将YOUR_USERNAME替换为用户名，将YOUR_PASSWORD替换为登录电子邮件中提供的密码。

note important
IMPORTANT
如果使用Cloud Manager，则安全方法是按照此处为受密码保护的Maven存储库找到的步骤进行操作。

code language-none

code language-none
`<settings> ... <servers> ... <server> <id>repo.ea.adobe.net</id> <username>YOUR_USERNAME</username> <password>YOUR_PASSWORD</password> <filePermissions>BucketOwnerFullControl</filePermissions> <configuration> <wagonProvider>s3</wagonProvider> </configuration> </server> ... </servers> ... </settings>`

<settings>
    ...
    <servers>
        ...
        <server>
            <id>repo.ea.adobe.net</id>
            <username>YOUR_USERNAME</username>
            <password>YOUR_PASSWORD</password>
            <filePermissions>BucketOwnerFullControl</filePermissions>
            <configuration>
              <wagonProvider>s3</wagonProvider>
            </configuration>
        </server>
        ...
    </servers>
    ...
</settings>

将以下内容添加到项目的pom.xml文件：

code language-none

code language-none
`<project> ... <build> ... <extensions> ... <extension> <groupId>com.allogy.maven.wagon</groupId> <artifactId>maven-s3-wagon</artifactId> <version>1.2.0</version> </extension> ... </extensions> ... </build> ... <repositories> ... <repository> <id>repo.ea.adobe.net</id> <url>s3://repo.ea.adobe.net/release</url> <releases> <enabled>true</enabled> </releases> </repository> ... </repositories> ... </project>`

<project>
    ...
    <build>
        ...
        <extensions>
            ...
            <extension>
                <groupId>com.allogy.maven.wagon</groupId>
                <artifactId>maven-s3-wagon</artifactId>
                <version>1.2.0</version>
            </extension>
            ...
        </extensions>
        ...
    </build>
    ...
    <repositories>
        ...
        <repository>
            <id>repo.ea.adobe.net</id>
            <url>s3://repo.ea.adobe.net/release</url>
            <releases>
                <enabled>true</enabled>
            </releases>
        </repository>
        ...
    </repositories>
    ...
</project>

将以下内容添加到项目的all/pom.xml文件。将project.dependencies.dependency.version替换为相应的版本，将project.build.plugins.plugin.configuration.embeddeds.embedded.target替换为正确的路径。

code language-none

code language-none
<project> ... <build> ... <plugins> ... <plugin> <groupId>org.apache.jackrabbit</groupId> <artifactId>filevault-package-maven-plugin</artifactId> ... <configuration> ... <embeddeds> ... <embedded> <groupId>com.adobe.acs.aemveeva</groupId> <artifactId>aem-veeva-connector.all</artifactId> <type>zip</type> <target>/apps/APP_NAME-packages/application/install</target> </embedded> ... </embeddeds> </configuration> </plugin> ... </plugins> ... </build> ... <dependencies> ... <dependency> <groupId>com.adobe.acs.aemveeva</groupId> <artifactId>aem-veeva-connector.all</artifactId> <version>1.0.5</version> <type>zip</type> </dependency> ... </dependencies> ... </project>

<project>
    ...
    <build>
        ...
        <plugins>
            ...
            <plugin>
                <groupId>org.apache.jackrabbit</groupId>
                <artifactId>filevault-package-maven-plugin</artifactId>
                ...
                <configuration>
                    ...
                    <embeddeds>
                        ...
                        <embedded>
                            <groupId>com.adobe.acs.aemveeva</groupId>
                            <artifactId>aem-veeva-connector.all</artifactId>
                            <type>zip</type>
                            <target>/apps/APP_NAME-packages/application/install</target>
                        </embedded>
                        ...
                    </embeddeds>
                </configuration>
            </plugin>
            ...
        </plugins>
        ...
    </build>
    ...
    <dependencies>
        ...
        <dependency>
            <groupId>com.adobe.acs.aemveeva</groupId>
            <artifactId>aem-veeva-connector.all</artifactId>
            <version>1.0.5</version>
            <type>zip</type>
        </dependency>
        ...
    </dependencies>
    ...
</project>

云配置

通过在连接器将操作的文件夹上创建云配置来配置此集成。请按照以下步骤创建云配置：

导航到Veeva云配置。
在相应的文件夹中创建新的Veeva云配置，并按照以下部分中所述填充。

“配置”选项卡

在配置选项卡中填写以下内容：

配置选项卡

必需。 Veeva保险库连接器配置的标题。此值可以是任意值。（例如Veeva Vault Configuration）
必需。 Veeva实例的域URL（例如https://my-instance.veevavault.com/）
必需。调用Veeva Vault API所需的ClientID。该值可以是任意值，主要用于调试。（例如adobe-aem-vvtechpartner）
必需。 Veeva保险库用户名。请参阅Veeva用户创建。
必需。 Veeva保险库密码。请参阅Veeva用户创建。

“AdobeIO”选项卡

如果项目需要为页面生成PDF或图像，则需要此选项卡。在adobe io选项卡中填写以下内容：

AdobeIO选项卡

必需。用于创建载入电子邮件中提供的PDF图像的AdobeIO端点。（例如https://my-namespace.adobeioruntime.net/api/v1/web/aem-veeva-serverless-0.0.2/trigger-action.json）
必需。用于生成页面图像的操作名称。此值必须为aem-veeva-integration/get-image-async。
必需。用于生成html图像的操作名称。此值必须为aem-veeva-integration/get-pdf-async-new。
必需。 AdobeIO端点，用于获取载入电子邮件中提供的生成状态。（例如https://my-namespace.adobeioruntime.net/api/v1/web/aem-veeva-serverless-0.0.2/get-state-value）
必需。 AdobeIO使用的AEM用户名。请参阅AEM用户创建。
必需。 AdobeIO使用的AEM密码。请参阅AEM用户创建。
可选。默认超时是允许页面在指定的时间之前响应，在此时间之后，AIO服务将停止尝试获取响应。默认值为30000。
可选。延迟是指页面以200响应延迟，以便所有图像在拍摄屏幕快照之前呈现。默认值为2000。
可选。屏幕快照/PDF生成的URL将在配置值（以秒为单位）后过期。
可选。 AdobeIO屏幕快照/PDF生成服务是异步的。 AEM服务调用AIO状态端点以获取屏幕快照/PDF。此属性将决定每个状态调用之间的暂停时间（以毫秒为单位）。默认值为10000。
可选。对AdobeIO进行状态调用以获取屏幕快照/PDF的最大重试计数。默认值为10。

“高级”选项卡

在高级选项卡中填写以下内容：

高级选项卡

生成PDF/图像时需要使用。创建PDF/图像时使用的文件名模式。可以对{name}进行模板。（例如{name}-screenshot）
可选。除桌面设备外，需要页面屏幕截图的设备类型。有效类型包括Tab (iPad)和Mobile (iPhone X)。
可选。 Veeva中表示上述演绎版的演绎版类型值。（例如web_ready__c）
生成PDF/图像时需要使用。要创建的屏幕快照类型。 PDF或Image。
生成PDF/图像时需要使用。要生成的PDF类型。 Print CSS Based PDF或Pixel Perfect Screenshot PDF。
生成PDF/图像时需要使用。要生成的图像类型。 PNG或JPEG。
必需。一旦Veeva Vault批准触发器触发运行，即会运行工作流。
必需。表示“已批准”的状态属性值。（例如Approved for Distribution）
必需。 Veeva保险库拒绝触发器触发后要运行的工作流。
必需。表示已拒绝/未批准的状态属性值。（例如Rejected）
可选。 Veeva Vault中文档ID的属性名称。默认值为id。
可选。 Veeva Vault中Status的属性名称。默认值为status__v。
可选。文档修改日期的属性名称。默认值为version_modified_date__v。
可选。文档资源URL的属性名称。默认值为external_id__v。如果此字段已被使用，请在Veeva中创建其他字段并在此处填充该字段名称。此字段将在Veeva中用于保存AEM资源路径。自动化元数据同步需要此项。
可选。 Veeva Vault中主版本号的属性名称。默认值为major_version_number__v。
可选。 Veeva Vault中次版本号的属性名称。默认值为minor_version_number__v。
可选。 Veeva保险库关系类型值。添加到页面的所有资产都将根据该值表示为相关。默认值为supporting_document__c。

“页面”选项卡

如果正在同步页面，请在页面选项卡中填写以下内容：

页选项卡

必需。将资产从AEM映射到Veeva。
a. AEM属性名称。可以从AEM属性中进行选择。（例如jcr:title） {name}可以模板。
b.完全在输入的Veeva属性名称在Veeva中存在。（例如name__v）
c.属性类型。 Text或Multiline Text。
必需。将资产从Veeva映射到AEM。
a.完全在输入的Veeva属性名称在Veeva中存在。（例如name__v）
b. AEM属性名称。可以从AEM属性中进行选择。（例如jcr:title）
c.属性类型。 Text或Multiline Text。

“资源”选项卡

如果正在同步资源，请在资源选项卡中填写以下内容：

资产选项卡

必需。将资产从AEM映射到Veeva。
a. AEM属性名称。可以从AEM属性中进行选择。（例如/jcr:content/metadata/jcr:title） {name}可以模板。
b.完全在输入的Veeva属性名称在Veeva中存在。（例如name__v）
c.属性类型。 Text或Multiline Text。
必需。将资产从Veeva映射到AEM。
a.完全在输入的Veeva属性名称在Veeva中存在。（例如name__v）
b. AEM属性名称。可以从AEM属性中进行选择。（例如/jcr:content/metadata/jcr:title）
c.属性类型。 Text或Multiline Text。