Configuring the Informz Integration
This describes how to install all the components that are required to setup and configure Informz for Aptify Integration. Refer to the Aptify-Informz Integration User Guide to learn more about using the integration to its full potential.
The Informz setup includes unpacking a configuration migration pack on Aptify 5.5.2 or higher. Also, you will need to install the Aptify Configuration Migration Tool (CM Tool) to be able to unpack the Informz integration pack. In the last step, you can automate the process of updating the campaign prospect list. This last step is not a required step for the setup but is recommended in order to have less manual work involved in using Aptify Informz Integration. CM Tool setup files and Informz Integration pack can be obtained by contacting Aptify support or by contacting your Informz eMarketing Advisor.
Perform the following steps to complete the Informz integration:
- Prerequisites
- Installing the Aptify CM Tool
- Unpacking the Informz Integration CM Pack
- Verifying the Unpacked Items
- Creating a Scheduled Task to Automate Updating the Prospect List
Prerequisites
- All the requirements for Aptify 6.1. See System Requirements for Aptify 6.1 for more information.
Installing the Aptify CM Tool
Install the Aptify Configuration Migration (CM) Tool on the server where the Aptify Desktop client as described in Installing the Aptify CM Tool:
Unpacking the Informz Integration CM Pack
Note
This changes will be applicable only for Aptify 6.1
Before you start
- Download updated AptifyGenericEntity.dll assembly, click here to download.
- Paste the downloaded assembly in Client Installation Folder/Path and in Aptify Object Repository Object.
Please follow these steps to unpack the Informz integration CM Pack:
- Go to Aptify Smart Client, Add the same updated assembly in Object Repository Object and restart the Aptify Smart Client.
- After restart, ensure that the updated assembly is present in Object Repository Object.
- Copy and paste the InformzPack.cmpack file to the computer where you have installed the Aptify CM Tool.
In the Windows Desktop, click the CM Tool icon to launch the Aptify CM Tool.
Ensure that the user running the Aptify CM Tool has the permission to create/update entities. A system administrator level user is required for such a task.
- In the Configuration Migration Utility screen, select the Open Configuration for Unpacking option and click OK.
- In the Pack Path field of the Folder Selection section, enter the path for Informz integration Pack (InformzPack.cmpack) and click the UnPack button.
- If the CM Tool displays notifications about the difference in version and some validation failures, ignore these and continue unpacking.
- When the Completion Message is displayed, the CM Tool has completed unpacking the Informz Integration Pack.
- Click OK to close the completion message. Aptify should now have all of the components required for the Informz integration.
- To verify that all of the components required for Informz Integration are present, see 355339544.
Verifying the Unpacked Items
This verification step is recommended but not required. After the unpack process has completed, open Aptify to verify whether the required components were unpacked:
- Search for the related Service Data Object.
- Open the Service Data Objects service under the Web Services application.
- Search and verify that a Service Data Object record named spPersonlizationFieldValues exists.
- Search for the related Process Flow
- Open the Process Flows service under the Process Pipeline application.
- Search and verify that a Process Flow record named Multiple Campaign List Builder Process Component exists.
- Search for the related Scheduled Task.
- Open the Scheduled Tasks service under the Process Pipeline application.
- Search and verify that a Scheduled Task record named Update Prospect List for Multiple Campaign exists.
- Ensure that the Mailing Activity Entity service is present.
- Open the Campaign Management application.
- Verify that a service named Mailing Activity exists.
- Ensure that the Email Exclusion History sub-tab is present.
- Open any Person's record and navigate to the Contact Log tab.
- Verify that a sub-tab named Email Exclusion History exists.
- Ensure that the AvailableForEmail field is present.
- Open any campaign record
- Verify that AvailableForEmail field exists in the main area.
The Email Exclusion History sub-tab and the AvailableForEmail field might not appear by default if you are using configured form templates for those services.
Creating a Scheduled Task to Automate Updating the Prospect List
By performing this procedure, you can automate the process of updating the prospect list, when using Campaign Segments. Complete the following steps to create and set a schedule task:
- Confirm that you have an Application Server configured and functional on your network.
- You must have one or more Application Servers to use Aptify Scheduled Tasks.
- You must have one or more Application Servers to use Aptify Scheduled Tasks.
- Open the Scheduled Tasks service under the Process Pipeline application.
- Search for and open the Update Prospect List for Multiple Campaign scheduled task'.
- Open the Remote Scheduler service.
- After saving the record, the Application Server will change the service to Windows Scheduler automatically and set up a Windows Task for this item.
- If you are running the Aptify Desktop client on the Application Server directly, you can set the service to Windows Scheduler directly.
- Specify the Application Server that will execute this task.
- Specify the Job Account Name and Password for the account that will execute this task on the Application Server.
- See Creating a Scheduled Task for more information.
- See Creating a Scheduled Task for more information.
- Select the Is Enabled option.
- Modify the Frequency, Dates, and Start Time as needed.
- Save the Scheduled Task.
By following these steps, all the required components for Informz are now in place and it is configured to update the prospect list automatically based on the scheduled task frequency.
Informz uses Aptify Web Services API to access the Aptify system. After the installation, please take care of the following:
1. Domain URL for Aptify Web - This is in the format https://mysite.com. Do not include /AptifyServicesAPI/services/Authentication/Login/DomainWithContainer/ at the end as Informz application automatically appends that. If Aptify Web service API is not running at /AptifyServicesAPI/services/, there will be connection issues.
2. Domain Username and Password - SQL username and password will cause connection issues as Informz assumes /Login/DomainWithContainer/ on the authentication request.
Note
Do not include special characters in the Password such as quotation marks (“), apostrophe (‘), ampersand (&), less-than (<), and greater-than (>), as Informz application does not encode the password causing connection issues.