Configuration Manager: Services

Aprimo services execute batch operations. Some are platform services, which perform work such as basic file operations or the scheduling of work for other services. Others are feature-specific and provide functionality such as processing subjects through interactions or sending email messages to recipients identified by a segmentation.

The Services module lists the configurable subservices of the Aprimo service hosts. Although you start and stop all service hosts, except for the Aprimo Utility Service, in the Current Status module, you configure their subservices in the Services module. Each service host's started or stopped status and the configuration of its subservices apply to all domains.

Notes:
  • To process work, a service host must be started in the Current Status module and its subservices must be made active for a data source in the Services module.
  • You can also access the Current Status and Services modules from System Tools in the Configuration Manager.

Key Fields

Field Description

Login

Type the login ID for a service user account.

Password

Type the password for the service user account you specified in the Login field.

Active

Select the check box to activate the subservice for the datasource.

Note:
To process work, the service host must be started in the Current Status module and the subservice must be active for a data source.

Service

The Service column lists the individual, configurable subservices.

Threads

Type the maximum number of work items, or threads, you want to allow the subservice to process concurrently. A work item is a unit of work for a particular job.

Note:
For more information, see the Aprimo Services Reference.

Debug

If you are experiencing problems with a service, select the check box to write more detailed information to the Aprimo Services event log. For more information, see the Aprimo Services Reference.

Caution:
Turn off the debug function as soon as you have the data you need. Leaving the debug function enabled can negatively affect system performance.

Aprimo Service Hosts and Subservices

The service hosts appear in the Current Status module. Their configurable subservices appear in the Services module.

Note:
Some Aprimo services, as noted in the table, do not follow the host-subservice architecture. Their subservices are not configurable and do not appear in the Services module, but their subservices do have log files in the Aprimo/Logs directory on the server running the service host.
Service Host Subservices

Aprimo AMP Service

  • AMP

Aprimo Assets and Attachments Service

  • AssetUpdate
  • AssetCleanup

Aprimo Central XML Sync Service

Note:
This service does not manage work items and does not have individually configurable subservices. It is not represented in the Services module.
  • CentralXml

Aprimo DataMart Service

  • DataMart

Aprimo Deliverability Service

  • DeliverabilityAdminProcessor
  • DeliverabilityErrorProcessor
  • DeliverabilityEventProcessor
  • SecondaryOptOutProcessor

Aprimo Digital Asset Expiration Service

  • DAExpirationService

Aprimo Email Processing Service

  • Email Processing

Aprimo Financials Service

  • Financials

Aprimo Global Calendar Service

Note:
This service does not manage work items and does not have individually configurable subservices. It is not represented in the Services module.
  • GlobalCalendarSync

Aprimo Interaction Service

  • AIM
  • FileOutput
  • InteractionManager

Aprimo Measure Service

  • Measures

Aprimo Microsite Service

Note:
This service does not manage work items and does not have individually configurable subservices. It is not represented in the Services module.
  • Microsite

Aprimo Monitor Service

Note:
This service does not manage work items and does not have individually configurable subservices. It is not represented in the Services module.
  • Monitor

Aprimo Notification Service

  • Notification

Aprimo Reminder Service

  • Reminder

Aprimo Report Distribution Service

  • ReportDistribution

Aprimo Report Mart Service

  • ReportMartService

Aprimo Scheduling Service

Note:
This service does not manage work items and does not have individually configurable subservices. It is not represented in the Services module.
  • Scheduling

Aprimo Segmentation Service

  • ContactOptimization
  • Segmentation
  • SegmentationCleanup
  • SegmentationEmail
  • Universe

Aprimo Utility Service

Note:

This service does not manage work items and does not have individually configurable subservices. It is not represented in the Services module.

  • Cache Service
  • MachineOperation

Aprimo Utility Service (32)

Note:
This service does not manage work items and does not have individually configurable subservices. It is not represented in the Services module.
  • Utility32

Aprimo Workflow Service

  • Workflow

Aprimo XML Publishing Service

Note:
This service does not manage work items and does not have individually configurable subservices. It is not represented in the Services module.
  • XmlPublisher

Service Descriptions

For more information including configuration information, see the Aprimo Services Reference.

Service Host Description

Aprimo AMP Service

During profile runs, the Aprimo AMP Service:

  • Processes audience member records to find those that meet the specified criteria
  • Adds the appropriate audience member to the group configured in the profile
  • When a profile is configured to add audience members to an interaction, checks for new audience members in the group, and adds them to the interaction

Aprimo Assets and Attachments Service

The Aprimo Assets and Attachments service has two subservices, which process data that flows between the ADAM application and Aprimo:

  • AssetUpdate
    To integrate Aprimo with ADAM, you must configure four fields in ADAM. For more information on how to configure these fields, see the ADAM Integration Configuration Guide. When you change the data in one of these fields in ADAM, the AssetUpdate subservice ensures that the new data appears in Aprimo.
  • AssetCleanup
    The AssetCleanup subservice clears the filestore of local copies of digital assets that it has temporarily stored to be used in the Annotation Viewer or Reference Document Viewer.

Aprimo Central XML Sync Service

The central.xml file on each server contains the connection information for your Central Database . The Aprimo Central XML Sync Service updates the central.xml file with the latest Central Database connection information, because it might have been changed on any server.

Aprimo DataMart Service

Administrators use the Datasource Management modules to import data from external databases or from files into the System Database . The data source configuration defines how imported data should be added to or merged with existing data. The Aprimo Data Mart Service retrieves and processes the data.

Aprimo Deliverability Service

The Aprimo Deliverability Service process events for emails sent by interactions and segmentations.

Aprimo Digital Asset Expiration Service

You configure digital assets and customizations to expire to prevent users from viewing or using them after a specified date. At one-minute intervals, the Aprimo Digital Asset Expiration Service checks for digital assets and customizations that will expire soon and processes items that expired.

Aprimo Email Processing Service

The Web Response modules retrieve and process emails sent to POP (Post Office Protocol) accounts. For each email, the EmailProcessing service searches for and processes this information:

  • Data submitted through a non-Aprimo web form
    Note:
    The EmailProcessing service does not process inbound form replies.
  • For emails not sent by the Email Deliverability service, the reason why an undeliverable message bounced

Aprimo Financials Service

The Financials service runs once daily and processes these items:

  • Transfers between funding accounts that meet these criteria:
    • The account has the Pending status.
    • The destination funding account is not closed
    • The transfer date has passed.
  • Exchange rate information for records that do not have the rates locked:
    • Updates the base currency value using the current exchange rate
    • Updates objects
    • Synchronizes the currency code's record with information from the exchange rate's record
    • Logs on to the System Database and updates the financial_service_log table with the date and time stamp for the last run

Aprimo Global Calendar Service

The Operations Calendar uses Aprimo data. The Aprimo Global Calendar Service synchronizes the data shown on the Operations Calendar with the data in the System Database .

Aprimo Interaction Service

The Aprimo Interaction Service performs batch processing for interactions.

Aprimo Measure Service

Measures enable users to evaluate numeric data in activities and activity proposals at a point in time. For example, in an activity for a trade show, a measure can count the number of audience members who attend the show. Measures run on a recurring schedule. During each run, the Aprimo Measure Service:

  • Executes the SQL statement configured for the measure definition on which the measure is based
  • Applies the SQL statement to the specified activities

Aprimo Microsite Service

A microsite typically contains one or more web pages that supplement a larger website for a limited time with detailed information about a product, service, or promotion. The Aprimo Microsite Service performs these operations

  • When a user publishes a microsite or microsite pages, publishes the necessary files to the microsite server
  • When people view a microsite:
    • Records microsite metrics
    • Resolves field tags to personalize the microsite content with data from the System Database
    • Resolves criteria configured for the content blocks that make up microsite pages
  • For inbound forms and outbound messages that link to or display a digital asset or attachment, resolves the link to the file

Aprimo Monitor Service

The Aprimo Monitor Service performs these operations:

  • Caches complex, high-use application pages, such as My Aprimo, to reduce initial load times. For more information, see the Configuring a Pre Cache User section in the Aprimo Installation Guide.
  • Provides diagnostic support via external code. For example, when a particular type of error occurs, you could use external code to send an email message to an administrator or to restart the process.
    Note:
    Typically, Aprimo provides custom code for use with the Monitor service. For more information, contact Aprimo Customer Services.

Aprimo Notification Service

Aprimo sends notification emails to inform people when certain events or errors occur. The Aprimo Reminder Service generates many of these messages. The Aprimo Notification Service sends emails generated by the Aprimo Reminder Service and other notifications generated by the system, even if you use the Aprimo Deliverability Service to deliver emails from interactions and segmentations. The Aprimo Notification Service does not send these emails:

  • Emails from segmentations.
  • Emails from interactions that are configured to use the Aprimo Deliverability Service or an SMTP server to send emails.
  • Test emails for the outbound messages and forward-to-a-friend features. These emails are sent by the Aprimo Utility Service.

Aprimo Reminder Service

The Aprimo Reminder Service generates messages that are sent by the Aprimo Notification Service. The service runs on a recurring schedule. During each run, if the appropriate criteria are met, the service:

  • Generates reminders for proposals
  • Generates reminders and escalations for review tasks
  • Generates reminders and escalations for creative reviews
  • Expires creative reviews
  • Generates reminders and escalations for activity requests
  • Expires offers
  • For annotations configured with alerts, generates daily summary alerts at the time specified by the Time of Day to Send Daily Summary Annotations Alert system parameter

Aprimo Report Distribution Service

A distribution sends a report via email to a group of people at a specified time or on a recurring basis. Each time a report is distributed, the Aprimo Report Distribution Service generates the report with the most recent data.

Note:
This service generates reports in the background on the server where the service is running. The service never generates more than two reports simultaneously.

Aprimo Report Mart Service

A report mart optimizes data for reporting purposes. A report mart contains one or more object outputs. Each object output retrieves data from a source database, optimizes the data, and writes the optimized data to an output table in a target database. Report marts can run at a specified time or on a recurring basis. During each report mart run, the ReportMartService:

  • For a report mart's first run, creates an output table in the target database for each object output. Or, if a user creates a new object output after the first run, creates a corresponding output table in the target database
  • Retrieves data from the source database for each object output
  • Optimizes the source data by transforming its structure to match the structure configured for each output table
  • Writes the transformed data to each output table
  • For report marts that run on a recurring basis, the service:
    • Keeps each output table's data current according to the update method (append or replace) configured in the corresponding object output
    • For report marts configured to maintain objects based on output tables, creates a custom object each time a user creates a new object output. If a user selects new attributes for an object output, the service adds those attributes to the custom object.

Aprimo Scheduling Service

The Aprimo Scheduling Service monitors the scheduled_jobs table in the System Database for jobs that are ready to run. When the Aprimo Scheduling Service finds a job to run, it creates a work item and adds the work item to the WorkItemQueue table in the System Database .

Aprimo Segmentation Service

The Aprimo Segmentation Service provides batch processing for segmentations:

  • It processes optimizations, which are sets of contact rules, constraints, or priorities for contacting people via segmentations.
  • During a segmentation run, it generates and runs the SQL that segments the population, calculates counts, and creates the segmentation's outputs.
  • It drops temp tables created by the send email tool.
  • It sends emails created by the send email tool.
  • It creates static universes for segmentations.

Aprimo Utility Service

The Aprimo Utility Service handles these 64-bit tasks:

  • Handles file operations for features such as digital assets and the configuration mover
  • Logs page usage information for the application usage tracker
  • Sends test emails for the outbound messages and forward-to-a-friend features
  • Processes closeouts for the financials modules
  • Governs the message queues for web reviews and email tracking
  • Synchronizes activity data for the Aprimo /CIM integration
  • Hosts the Machine Operation subservice, which handles the starting and stopping of services and the retrieval of information for the Current Status module in the Configuration Module and System Tools.

Aprimo Utility Service (32)

The Aprimo Utility Service (32) handles queues for these 32-bit processes:

  • AprimoFileProcessing32 Processes Encapsulated PostScript (EPS) graphics and creates thumbnails for them.
  • AprimoVideoTranscoding Sends audio and video files encoded in formats that are not supported by Microsoft Silverlight or Adobe Flash to the Microsoft Expression Encoder, which converts them into supported formats. Generates thumbnails for video files.

Aprimo Workflow Service

The Aprimo Workflow service processes tasks in projects that have been started. The service is configured with a default recurring schedule of one minute between runs. During each run, if the appropriate criteria are met, the service:

  • Auto assigns pending tasks that meet these criteria
  • Auto closes tasks that are configured with a duration
  • Processes closed tasks that did not fire an output port and meet these criteria
  • Closes start tasks that are configured with the As Soon As Possible or As Late As Possible start type and meet these criteria
  • Assigns tasks with fixed dates that meet these criteria

Aprimo XML Publishing Service

The Integration Workbench enables Aprimo to exchange data with other applications via XML. These applications are called clients in the Integration Workbench. For more information, see these documents:

  • Configuring the Integration Workbench
  • Aprimo Integration Workbench Reference Guide

The XML Publishing service:

  • Processes events that occur in Aprimo and invokes a web service call to each subscribed client's URI
  • Builds the XML required to pass data to the client
    Note:
    Aprimo uses a web service called the XML Listener to receive communications from clients.