Wiki

Scale Your Enterprise

User Tools

Site Tools


mcm:marketing_campaign_management

Table of Contents

TWBS Marketing Campaign Management (MCM) User Guide

MCM Overview

Marketing is critical to your overall business if you want to grow and thrive in today’s economy. Shouldn’t your business management solution provide tools that allow you to accomplish your marketing goals?

Easily track and manage leads and activities:

  • Manage your complete marketing-to-customer service revenue cycle all in SAP® Business One.
  • Use SAP® Business One queries to build and manage marketing campaign lists.
  • Integrate Business One with Constant Contact to streamline email marketing efforts.
  • Promote prospects to Business Partners in one click.
  • Capture custom data with SAP® Business One user-defined fields functionality.

Third Wave’s Marketing Campaign Management (MCM) enables your team to create, execute and track marketing efforts all in one place. Now you can enter, import and manage marketing prospect lists before you’re ready to add them to your list of active Business Partners.

MCM allows you to import and store your prospect lists and associated activities in a separate, yet related, set of tables. So, you are able to use the simple and elegant SAP® Business One interface to manage your marketing activities without slowing Business Partner reports and queries.

Once you import your prospect list and set up a campaign, you can even establish a bidirectional connection with Constant Contact or use the built-in email blast feature. When you use the power of SAP® Business One queries to select your audience, you’ll easily keep all activities in one place. Finally, when a marketing prospect becomes qualified to enter the sales process, a single click allows you to promote them into your Business Partners tables, pulling all your complete activity history with it.

Expand the functionality and usability of your SAP® Business One feature-set with MCM. Manage a larger volume of prospects, campaigns and programs while developing and tracking distinct marketing campaigns - all in one place.

Finally, a tool that enables you to measure the effectiveness and return on your marketing investment integrated within SAP® Business One.

System Requirements

  • MS .NET Framework Version 4.0 or higher.
  • An SMTP Application Server is required to send Marketing Campaign e-mails if you are not using Constant Contact. Configuration of this application is outside the scope of the TWBS Marketing Campaign Management Add-On.

    An internal SMTP server (Microsoft Exchange or other local mail server) is required.

SAP Business One requirements

  • If you are using SAP® Business One version 9.0 or 9.1 , any released version is acceptable.
  • SAP® Business One DI API must be installed.

Other Software Requirements

  • Microsoft Office 2003 or higher (Excel, Word, Outlook) - Microsoft Office is required in order to use features in the Marketing Campaign Management application including data importing, message editor, and email delivery.
  • Adobe Acrobat Reader version 10 or higher

Folder permission requirements

  • The user should have Read/Write/Delete Permissions for the following folders
  • My Documents
  • Add-ons folder to which the APP add-on files are installed during the installation

Social Media Integration

The ability to post messages to LinkedIn, Twitter, or Facebook.

Marketing Campaign Manager Search Queries

A robust utility screen for searching Marketing Campaign Manager data and saving the search data as a MCM Search-based query for later use in message editing.

Constant Contact

Constant Contact is a web-based application that helps you manage your e-mail marketing activities. It provides you with tools to create e-mail formats to help you present an effective business image, tools to manage your e-mail lists and tools to view and analyze the results of your e-mail efforts. At the same time you have the ability to upload contact lists from your SAP® Business One database and view the results of each e-mail cycle from within the TWBS Marketing Campaign Management application.

Third Wave Business Systems has elected to integrate with Constant Contact as it is a cost-effective and easy to use tool for this purpose. Go to www.constantcontact.com for more information on their e-mail marketing plans.

Installation

The install process for TWBS Marketing Campaign Management consists of the following components:

MCM Server Configuration

The TWBS MCM Server Properties may be configured by a super-user on the SAP® Business One Server machine.

  • Launch the MCM Server Properties screen by selecting the MCM Server Configuration menu option under the Administration > Setup > MCM menu groups.
    mcmimage15.jpeg
  • The Product Code, Server Name, Database, and SQL/Hana Provider values will be determined automatically based on the SAP® Business One company database the super-user is logged into.
  • Enter the SAP admin-level user credentials and Database user credentials in the fields provided.
  • Enter the SMTP Server information in the fields provided.
  • Click the Test Connection button to test the data interface connection.
  • If the credentials entered allow a successful connection, the user will receive a confirmation messagebox.
  • Click the Update button.

Applying MCM Licenses

Third Wave Business System SAP® Business One add-ons have been updated with an automatic licensing procedure. In order to obtain a permanent license key, the production environment SAP® Business One installation number must first be provided to TWBS Support so that the information can be entered into our systems. The SAP® Business One installation number is a critical component to the new TWBS application license keys. Without this information you will only be able to obtain a 30-day application trial license.

On start up, the application client will verify that a valid license exists for the application having been purchased based on your SAP® Business One installation number. If the license is verified, the application will start. If the application has not been purchased, a 30-day trial license will be issued to allow for limited use of the application. If your trial license has expired and you would like to purchase the application to obtain a full license key, please contact Third Wave Business Systems @ (201) 703-2100.

Creation of MCM Database Objects

The TWBS MCM database objects may be created by a super-user on the SAP® Business One Server machine.

  • Launch the MCM Server Properties screen by selecting the MCM Server Configuration menu option under the Administration > Setup > MCM menu groups.
    mcmimage15.jpeg
  • Click the Create DB Objects button to initiate the database object creation.
  • The user will see a progress bar and update messages on the SAP status bar as the process continues.
  • The user will be notified once the process is complete.

Deleting Document Library Files

The removal of TWBS MCM document library files may be performed by a super-user on the SAP® Business One Server machine.

  • Launch the MCM Server Properties screen by selecting the MCM Server Configuration menu option under the AdministrationSetupMCM menu groups.
    mcmimage15.jpeg
  • Click the Delete Document Library Files button to initiate the document file library removal.
    mcmimage17.jpeg
  • The user will be prompted for confirmation that they wish to remove the entire Document Library.
  • Click the Yes button to confirm and continue with file removal.
    mcmimage18.jpeg
  • Once the process is complete, the user will receive a message box letting them know the files have been successfully removed.

Applying MCM Updates

Updates for the MCM application will occasionally be released through our TWBS Support Portal either to introduce new features, fix existing issues in the application, or both. Third Wave does not send out automatic notices with updates are available, so we recommend that you periodically check for new releases.

Steps for applying patches to the Chargeback application are…

  • If your previous version of TWBS MCM is a version that still utilizes the Database Server.
    • Open the Database Service Manager Screen select the Uninstall Service option
      mcmimage19.jpeg
    • Open the operating system option for administering programs through the Control Panel.
    • Uninstall the option for Third Wave MCM Database Server.
  • Uninstall Third Wave MCM using the SAP Business One System Landscape Directory
  • Once that process is complete, you can begin installing the new updates. Install the Third Wave MCM SAP® Business One client as described in the **Installation Process** section of this User Guide.

MCM Uninstall Process

Steps for uninstalling the MCM application are…

If your previous version of TWBS MCM is a version that still utilizes the Database Server.

  • Open the Database Service Manager Screen select the Uninstall Service option
    mcmimage21.jpeg
  • Open the operating system option for administering programs through the Control
  • Uninstall the option for Third Wave MCM Database Server.
  • Uninstall Third Wave MCM using the SAP Business One System Landscape Directory

Configuration

The Marketing Campaign Management application needs to be set up through the SAP® Business One based configurations screen. This can be launched through the following steps…

  • Click the SAP menu option for Configuration under the AdministrationSetupTWBS MCM menus.
    mcmimage22.jpeg
  • The configuration user credentials screen will load.

General Tab

mcmimage23.jpeg

Account screen mode after conversion to BP…

This option determines how the configuration will be saved.

  • Enable - Once the Account is converted to a Business Partner, the Account can be updated further.
  • Disable - Once the Account is converted to a Business Partner, the Account can no longer be updated.

Display Closed Activities on MCM Account Form Load checkbox…

This configuration allows for the display of closed activities on the MCM account screen when an account is loaded. If this display is not selected, only open activities will be displayed.

Constant Contact Login Tab

mcmimage24.jpeg

Constant Contact Login Information…

This is where the credentials for the Constant Contact account should be stored.

  • User Name - The user name for the Constant Contact account.
  • Obtain Constant Contact Login Token button - Once the user name for your Constant Contact account has been entered, click this button to transmit the information to Constant Contact and obtain a login credential token.

This information is required only if you wish to utilize Constant Contact for e-mail marketing management from SAP® Business One via the Marketing Campaign Management application.

Click the Update button to save configuration options.

Delete List Tab

  • If the user has provided login information for Constant Contact and clicked the submit button, a third tab will appear on the user credentials screen for Delete List.
  • Selecting this tab will present the user with a list of Contact Lists from their Constant Contact Account.

Technical Information

The technical information for TWBS Marketing Campaign Management consists of the following components:

  • Database Objects - The database objects that are added to the SAP® Business One database from the link in the application DB Server. These object may consist of User Defined Tables, User Defined Fields on either User Tables or existing SAP Tables, or User Defined Objects.
  • Installed Queries - Queries that are automatically installed with the TWBS Marketing Campaign Management application.
  • Additional Queries - Queries that can be used for reporting on the TWBS Marketing Campaign Management data.

If you find the need to add User Defined Fields to the Marketing Accounts table (@twbs_mk_ocrd), you may find it helpful to create a special Category for your custom fields. This will help you exclude User Defined Fields from the add-on that are also displayed in the UDF window.

You may encounter an issue when trying to add new values to the “List” user field on the Demographics tab of the Account. An error message indicating that the value cannot be updated is displayed. If this occurs contact Third Wave Business Systems support for assistance. This is a known SAP® Business One issue.

Database Objects

The TWBS Marketing Campaign Management application, as part of the installation process, will create the following objects in the SAP database. The following objects are required in order for the application to function.

User Defined Tables

Table NameTable Description
TWBS_MK_OCRDMarketing Account Header and General Tab Information.
TWBS_MK_OCPRMarketing Account Contact Person Tab Information.
TWBS_MK_CRD1Marketing Account Address Tab Information.
TWBS_MK_INTERESTMarketing Account Interest Tab Information.
TWBS_MK_DEMOGRAFMarketing Account Demographics Tab Information.
TWBS_MK_LEADTYPESMarketing Account Type Definitions.
TWBS_MK_INDUSTRYMarketing Account Industry Types.
TWBS_MK_SOURCECODEMarketing Source Codes.
TWBS_MK_CAMPAIGNSMarketing Campaign Header and General Tab Information.
TWBS_MK_CCONTACTMarketing Constant Contact List Selection Information.
TWBS_MK_CCMAPPINGMarketing Constant Contact Mapping Information.
TWBS_MK_ATTACHMENTSMarketing Campaign Attachments Information.
TWBS_MK_CAMPSTATUSMarketing Campaign Status Definitions.
TWBS_MK_CAMPTYPESMarketing Campaign Types Definitions.
TWBS_MK_DOCTEMPMarketing Communication Template Form Header Information.
TWBS_MK_ATTACHMarketing Communication Template Attachment Information.
TWBS_MK_CONFIGMarketing Configuration Information/Constant Contact Login Information.
TWBS_MK_OCRD_INTRSTMarketing Interest Information from Business Partner screen custom tab.

Tables in TWBS_SBO-Common Database

Table NameTable Description
TWBS_COM_DOCLIBDocument Library Information.
TWBS_COM_DOCGROUPDocument Group Master Information.
TWBS_COM_DOCGROUPASSOCDocument Group Association Master Information.

User Defined Fields on SAP Objects

Field NameSAP ObjectTypeField Description
TWBS_LEADCODEActivityAlphanumeric (15)Account Code for the generated Activity.
TWBS_LEADNAMEActivityAlphanumeric (100)Account Name for the Account Code for the generated Activity.
TWBS_CNTCTPRSNActivityAlphanumeric (100)Contact Person for the Account Code for the generated Activity.
TWBS_MK_CAMPCODESales OpportunityAlphanumeric (100)Campaign Code for the generated marketing document.
TWBS_MK_CAMPCODESales QuotesAlphanumeric (100)Campaign Code for the generated marketing document.
TWBS_MK_CAMPCODESales OrdersAlphanumeric (100)Campaign Code for the generated marketing document.
TWBS_MK_CAMPCODEDelivery NotesAlphanumeric (100)Campaign Code for the generated marketing document.
TWBS_MK_CAMPCODEA/R InvoiceAlphanumeric (100)Campaign Code for the generated marketing document.
TWBS_PREFIXBusiness PartnerAlphanumeric (15)Prefix for the Business Partner
TWBS_FIRSTNAMEBusiness Partner ContactAlphanumeric (25)First Name for the Business Partner Contact
TWBS_MIDDLENAMEBusiness Partner ContactAlphanumeric (25)Middle Name for the Business Partner Contact
TWBS_LASTNAMEBusiness Partner ContactAlphanumeric (25)Last Name for the Business Partner Contact
TWBS_ADDUserAlphanumeric (30)This UDF will determine that after an addition operation in Account form. What should be the mode of
Three Valid Values:
1. OK - Keep last added Lead Info on screen
2. ADD - Clear screen - Add Mode
3. FIND - Clear Acreen - Find Mode
Default Value: Add
TWBS_MODEUserAlphanumeric (15)This UDF will determine the form mode when the form is initially loaded from menu click.
Two Three Valid Values
1. A - Add
2. F - Find
Default Value: F
TWBS_ACTUserAlphanumeric (15)This UDF will determine whether to display all activities or only open activities in Account form under Activities tab
2 valid values
1. 1-Only Open Activities
2. 2-Display All
TWBS_MK_SMUserUserAlphanumeric (15)This UDF will determine whether the user has access to the MCM Social Media screen.
1. Y-Yes
2. N-No

User Defined Objects

Unique IDNameTypeTable Name
TWBS_MARKETINGMarketing CustomersMaster DataTWBS_MK_OCRD
TWBS_CAMPAIGNMarketing CampaignMaster DataTWBS_MK_CAMPAIGNS
TWBS_DOCTEMPLATEDocument TemplateMaster DataTWBS_MK_DOCTEMP

Installed Queries

These queries are automatically installed with the TWBS Marketing Campaign Management application. They can be accessed through the following menu…

mcmimage30.jpeg

Queries include:

Leads from A Campaign

This query generates Leads from a Campaign.

SELECT u_cardname, u_intrdate
FROM [@twbs_mk_interest] t0, [@twbs_mk_ocrd]t1 WHERE t0.code = t1.code
AND t0.u_campcode = $[$txt_Cde.1]

Quotes from A Campaign

This query generates Quotes from a Campaign.

SELECT t2.cardcode, u_cardname, u_intrdate, docdate, doctotal
FROM [@twbs_mk_interest]t0, [@twbs_mk_ocrd]t1, oqut t2
WHERE t0.code = t1.code
AND t0.u_campcode = $[$txt_Cde.1] AND t1.u_cardcode = t2.cardcode

Sales Orders from A Campaign

This query generates Sales Orders from a Campaign.

SELECT t2.cardcode, u_cardname, u_intrdate, docdate, doctotal
FROM [@twbs_mk_interest]t0, [@twbs_mk_ocrd]t1, oinv t2
WHERE t0.code = t1.code
AND t0.u_campcode = $[$txt_Cde.1] AND t1.u_cardcode = t2.cardcode

Sales from A Campaign

This query generates Sales from a Campaign.

SELECT t2.cardcode, u_cardname, u_intrdate, docdate, doctotal
FROM [@twbs_mk_interest]t0, [@twbs_mk_ocrd]t1, ordr t2
WHERE t0.code = t1.code
AND t0.u_campcode = $[$txt_Cde.1] AND t1.u_cardcode = t2.cardcode

Additional Queries

These additional queries can be used for reporting on the TWBS Marketing Campaign Management data. They will also help identify fields that you might want to use in a Crystal Report as well.

Linking Account Tables

Child Marketing Account tables; [@twbs_mk_ocpr] [@twbs_mk_crd1], [@twbs_mk_demograf] and [@twbs_mk_interest], are linked to the Marketing Account Master table on the Code column. Following is an example linking Marketing Account Contacts to the Marketing Account Master.

SELECT t0.u_FirstNam, t0.u_LastName, t0.u_E_mailL, t1.CardName
FROM [@twbs_mk_ocpr] t0 (NOLOCK)
INNER JOIN[@twbs_mk_ocrd] ON t0.Code = t1.Code

Basic List of All Marketing Accounts

This query generates a list of all Marketing Accounts

SELECT t0.u_CardCode, t0.u_CardName, t2.u_name, t1.SlpName FROM [dbo].[@twbs_mk_ocrd] t0 (NOLOCK)
INNER JOIN [dbo].[OSLP] t1 (NOLOCK) ON t0.u_SlpCode = t1.SlpCode
LEFT JOIN [dbo].[@twbs_mk_LeadTypes] t2 (NOLOCJK) ON t0.u_CardType = t2.u_Code

Basic List of All Marketing Contacts

This query generates a list of all Marketing Account Contacts.

SELECT t0.u_LastNam, t0.u_FirstNam, t0.u_Position, t0.u_E_MailL, t0.u_Tel1, t1.u_CardName
FROM [dbo].[@twbs_mk_ocpr] t0 (NOLOCK)
INNER JOIN [dbo].[@twbs_mk_ocrd] t1 (NOLOCK) ON t0.code = t1.code

Basic E-Mail List of Marketing Contacts

This query generates a list of Marketing Account Contacts that have an e-mail address

SELECT t0.u_FirstNam, t0.u_LastName, t0.u_E_mailL, t1.u_CardName FROM [dbo].[@twbs_mk_ocpr] t0 (NOLOCK)
INNER JOIN [dbo].[@twbs_mk_ocrd] (NOLOCK) ON t0.Code = t1.Code WHERE t0.u_E_mailL IS NOT NULL

Filtered E-Mail List of Marketing Contacts

This query generates a list of Marketing Account Contacts that have an e-mail address and are flagged as “Solicit” = Yes (example 1). The same query can be used to filter based on “Mail” = Yes (example 2)

SELECT t0.u_FirstNam, t0.u_LastName, t0.u_E_mailL, t1.u_CardName
FROM [dbo].[@twbs_mk_ocpr] t0 (NOLOCK)
INNER JOIN [dbo].[@twbs_mk_ocrd] (NOLOCK) ON t0.Code = t1.Code
WHERE t0.u_E_mailL IS NOT NULL
AND t0.u_solicit = ‘Y’
 
SELECT t0.u_FirstNam, t0.u_LastName, t0.u_E_mailL, t1.u_CardName
FROM [dbo].[@twbs_mk_ocpr] t0 (NOLOCK)
INNER JOIN [dbo].[@twbs_mk_ocrd] (NOLOCK) ON t0.Code = t1.Code
WHERE t0.u_E_mailL IS NOT NULL
AND t0.u_mailOK = ‘Y’

Marketing Campaign Manager Screens

The following section outlines all TWBS Marketing Campaign Management screens and SAP® Business One screens which were modified with custom tabs, user defined fields, or other customized objects.

  • Accounts Screen The Account screen is the enter and maintain prospective Business Partner accounts of varying types (ex. Customers, Vendors, etc.) in an environment separate from the SAP® Business Partners Master Data. This provides the flexibility to remove potential customers as needed which is not possible once the Business Partner record has been created in SAP. These accounts allow for the tracking of the potential Business Partners for the purposes of marketing without needlessly adding records to the SAP system that may never be used.
  • Campaign Screen The Campaign screen is used to define and manage marketing campaigns.
  • Social Media Screen The Social Media screen is used to pre-populate fields for posting messages to social media outlets.
  • MCM Search Screen The MCM Search screen is a robust utility screen for searching Marketing Campaign Manager data and saving the search data as a MCM-based query for later use.
  • Communication Templates ScreenThe Communication Template screen allows the addition of new communication templates or editing of existing templates.
  • Document Library Screen The Document Library screen allows the user to add documents to the TWBS Marketing Campaign Management Document Library.

Accounts Screen

To access the TWBS Marketing Campaign Management Account screen…

  • Click the SAP menu option for Account under the MCM menu.

The function of the Account screen is the enter and maintain prospective Business Partner accounts of varying types (ex. Customers, Vendors, etc.) in an environment separate from the SAP® Business Partners Master Data. This provides the flexibility to remove potential customers as needed which is not possible once the Business Partner record has been created in SAP. These accounts allow for the tracking of the potential Business Partners for the purposes of marketing without needlessly adding records to the SAP system that may never be used.

Once a Business Partner record has been created in the SAP® Business One system, it cannot be removed. It can only be deactivated.

mcmimage33.jpeg

Account Screen Fields

Field NameField DescriptionData Size
Code*An Account's unique identification code. This value cannot be changed once the Account record has been added.15 characters
Prospect TypeAccount prospect type. The value can be selected from the dropdown list or select Define New to add a new value.
NameAccount company name.100 characters
Foreign NameAccount foreign or additional company name.100 characters
GroupAccount customer group value can be selected from the dropdown list. This is the standard SAP Business One set of customer groups.
CurrencyAccount currency value can be selected from the dropdown list. This is the standard set of currencies active in SAP Business One.
Federal Tax IDAccount federal tax ID.32 characters
StatusAccount status value can be selected from the dropdown list. Available values are Active, Inactive and Converted as Lead. The status will be changed to “Converted” automatically when the “Convert to BP” function is used.
BP CodeThis field displays the Business Partner code assigned to this Account record when converted. It is a display-only field
Consolidating BPEither select or enter an active SAP Business Partner code that will act as the consolidation Business Partner for this Account. This value is used for reporting purposes only in the TWBS Marketing function It is not transferred as the “Consolidating BP” for accounting purposes to the Business Partner record.

*= Required Field

Account Screen Buttons

Button CaptionButton Function
OK/Find/Add/UpdateStandard SAP® Business One button to find, add, and update records.
CancelStandard SAP® Business One button to close the form with no further user interaction.
Convert to BPClick this button to convert a TWBS Marketing Account to a standard SAP® Business One Business Partner (Customer).
ActivityClick this button to add a standard SAP® Business One Activity associated with this TWBS Marketing Account.

General Tab Fields

Field NameField DescriptionData Size
Tel1Account main company telephone number.20 characters
Mobile PhoneAccount mobile phone number.20 characters
FaxAccount main company fax number.20 characters
E-EmailEmailAccount e-mail address.20 characters
Web SiteAccount company website address.100 characters
PasswordAccount password (if it is part of your existing Business Partner definition process).32 characters
ProjectSelect an Account project from the dropdown list. This is the standard set of projects active in SAP Business One.
Contact PersonThis field displays the name of the default Contact defined for this lead (on the Contact Person tab).
ID No. 2A field to contain any information that is appropriate for your business process.18 characters
RemarksA field to contain any notes or comments about this Account.100 characters
Sales EmployeeSelect a sales employee from the dropdown list. This is the standard set of sales employees active in SAP Business One.
BP Channel CodeEither select or enter an active Business Partner code for a Business Partner that may service this lead.
TechnicianEither select or enter an employee that may deal with this lead for service issues. The values shown in this list are employees (identified in the Human Resources module) that are identified as a “technician.”
TerritoryEither select or enter a territory for this lead. This is the standard set of territories active in SAP Business One.

mcmimage35.jpeg

Contact Person Tab Fields

Field NameField DescriptionData Size
NameThe contact person’s full name.100 characters
PrefixThe contact person’s title (Mr., Mrs., Ms., Dr., etc.).30 characters
First NameThe contact person’s first name.50 characters
Middle NameThe contact person’s middle name or initial.50 characters
Last NameThe contact person’s last name.50 characters
Solicit OKSelect a value from the dropdown list. Valid values are Yes or No. This value can be used to develop queries to extract marketing communication lists.
Mail OKSelect a value from the dropdown list. Valid values are Yes or No. This value can be used to develop queries to extract marketing communication lists.
TitleThe contact person’s title. In standard SAP Business One this value is used to hold the same value as “Prefix” noted above.20 characters
PositionThe contact person’s business function or position.20 characters
AddressThe contact person’s address. Like standard SAP Business One this value is simply a long text string. Your business process will determine how this value is used.200 characters
TelephoneThe contact person’s telephone number.40 characters
Mobile PhoneThe contact person’s mobile telephone number.100 characters
FaxThe contact person’s fax number.40 characters
E_mailThe contact person’s e-mail address.200 characters
PagerThe contact person’s pager number.60 characters
Remarks1A field to contain any notes or comments about this contact.200 characters
Remarks2A field to contain any notes or comments about this contact.200 characters

Contact Person Tab Buttons

Button CaptionButton Function
Set DefaultWill designate a Contact Person as the default for the Account.

mcmimage36.jpeg

Address Tab Fields

Field NameField DescriptionData Size
Address NameThe address's name.100 characters
StreetThe address's street address.100 characters
BlockThe address's block/second line of address.100 characters
CityThe address's city name.200 characters
Zip CodeThe address's zip/postal code.40 characters
StateSelect the state/province code from the dropdown list. Note that the Country code must be selected before the state code can be selected. This is the standard set of states/provinces active in SAP Business One.
CountrySelect the country code from the dropdown list. This is the standard set of countries active in SAP Business One.

Address Tab Buttons

Button CaptionButton Function
Set as DefaultWill designate an Address as the default for the Account.

Field NameField Description
Display Only Open ActivitiesControls the display of SAP Activity information related to the Account. If the checkbox is selected, only open status Activity data will be displayed.

mcmimage39.jpeg

Interest Tab Fields

Field NameField Description
Item CodeEither select or enter a specific item of interest for this lead. This is the standard set of items active in SAP® Business One.
DescriptionIf a specific item has been selected its description is displayed.
Item GroupSelect a value from the dropdown list. This is the standard set of item groups active in SAP® Business One. In a specific item has been selected its corresponding item group is displayed
Interest DateEnter an approximate date when a sale might occur. Your business process will determine how you assign this date.
Source CodeSelect a value from the dropdown list. This is a user defined list of values. Click “Define New” to add a new value. Your business process will determine how this value is used.
Campaign CodeEither select or enter a campaign code that generated interest in this product. The list of codes is based on TWBS Marketing Campaigns

mcmimage40.jpeg

Demographics Tab Fields

Field NameField DescriptionData Size/Constraints
IndustryCode Select a value from the dropdown list. This is a user defined list of values. Click “Define New” to add a new value.
SIC CodeEnter a value for the SIC (Standard Industrial Classification) code for this company.100 characters
Text1Enter a text value. Use the standard SAP® Business One <Ctrl> + double-click on the field label to change the name displayed on the form.100 characters
Text2Enter a text value. Use the standard SAP® Business One <Ctrl> + double-click on the field label to change the name displayed on the form.100 characters
Text3Enter a text value. Use the standard SAP® Business One <Ctrl> + double-click on the field label to change the name displayed on the form.100 characters
Text4Enter a text value. Use the standard SAP® Business One <Ctrl> + double-click on the field label to change the name displayed on the form.100 characters
ListSelect a value from the dropdown list. This is a user defined list of values. Use the standard SAP® Business One <Ctrl> + double-click on the field label to change the name displayed on the form.100 characters
Number1Enter a numeric value (whole number). Use the standard SAP® Business One <Ctrl> + double- click on the field label to change the name displayed on the form.Range -32,768 to 32,767
No of EmployeesEnter the number of employees for this company. Annual Revenue Enter the annual revenue for this company.
Number2Enter a numeric value (whole number). Use the standard SAP® Business One <Ctrl> + double-click on the field label to change the name displayed on the form.Range -32,768 to 32,767
Amount1Enter a numeric value (whole number). Use the standard SAP® Business One <Ctrl> + double-click on the field label to change the name displayed on the form.Range -32,768 to 32,767
Amount2Enter a numeric value (whole number). Use the standard SAP® Business One <Ctrl> + double-click on the field label to change the name displayed on the form.Range -32,768 to 32,767
Quantity1Enter a numeric value (whole number). Use the standard SAP® Business One <Ctrl> + double-click on the field label to change the name displayed on the form.Range -32,768 to 32,767
Date1Enter a date. Use the standard SAP® Business One <Ctrl> + double-click on the field label to change the name displayed on the form.
Date2Enter a date. Use the standard SAP® Business One <Ctrl> + double-click on the field label to change the name displayed on the form.

Campaign Screen

To access the TWBS Marketing Campaign Management Campaign screen…

  • Click the SAP menu option for Campaign under the MCM menu.
  • The Campaign function is the mechanism that is used to define and manage marketing campaigns. The most efficient management of e-mail campaigns is done using Constant Contact (www.constantcontact.com). However, it is possible to execute e-mail campaigns using the TWBS Marketing tool only. In this case e-mail is sent via an SMTP server.

TWBS Marketing Campaign Management email delivery requires the use of an internal SMTP server. An external SMTP server cannot be used.

mcmimage42.jpeg

Marketing Campaign Screen Fields

Field NameField DescriptionData Size
Campaign Code*Enter a unique identification code for this campaign. This value is required. This value cannot be changed once the record has been50 characters
Campaign NameEnter a name for this campaign.100 characters
Campaign TypeSelect a value from the dropdown list. Two standard values of “E-mail” and “Print” are provided, and additional values can be added. Click “Define New” to add a new value.
ObjectivesEnter a short description of the objectives of this campaign.100 characters
Campaign IDThis numeric value is assigned by the system and cannot be changed.
Call to ActionEnter a short description of the “call to action” (e.g. what you want the prospect to do) for this campaign.100 characters
Campaign DescriptionEnter a description of the campaign.254 characters
Constant ContactSelect this checkbox if e-mail communications for this campaign will be managed through Constant Contact. Note that you must have previously defined your Constant Contact login information to enable this option. Selecting the option will enable the Campaign Lists field and the Constant Contact Lists field in the List Selection tab of the Lists tab.
Campaign ListsA Campaign List refers to a list of e-mail formats that is defined in your Constant Contact account. Select the desired format from the dropdown list. This field is available only when the Constant Contact option is enabled.

Marketing Campaign Screen Buttons

Button CaptionButton Function
OK/Find/Add/UpdateStandard SAP® Business One button to find, add, and update records.
CancelStandard SAP® Business One button to close the form with no further user interaction.
Post to SocialLaunches the **Social Media** screen and populates the Message Name with the Campaign Name value.

General Tab Fields

Field NameField Description
StatusSelect a value from the dropdown list. Four standard values of “Draft”, “Approved”, “Canceled”, and “Closed” are provided, and additional values can be added. Click “Define New” to add a new value.
Potential ResponsesEnter the number of potential responses for this campaign.
Forecast BudgetEnter the planned budget for this campaign.
Expected ResultsEnter the expected results for this campaign. This value can be used to measure any value that is appropriate for your company. An example might be that your “call to action” is for people to request a catalog. Your expected results would then be the number of catalog requests you expect to receive. This can then be measured against the Actual Responses value.
Task BudgetThis value is for future use.
Actual LaunchEnter the date the campaign is actually launched.
Units CreatedEnter the number of units created for this campaign. This could represent the number of mailers produced or the number of e-mails sent out.
Actual ResponsesEnter the number of actual responses for this campaign.
Actual CostEnter the actual cost for this campaign. At this time this value must be updated manually. You may consider using the SAP Business One Projects function to track the costs incurred for this campaign.
Task Actual AmtThis value is for future use.
Actual ResultsEnter the actual results for this campaign. See the Expected Results field for more explanation.

mcmimage46.jpeg

List Tab - List Selection Sub tab Fields

Field NameField DescriptionData Size
Phase NameEnter the name of the campaign phase.254 characters
DateEnter the scheduled date of this campaign phase.
StatusSelect a value from the dropdown list. Three values of “Draft”, “Scheduled”, and “Sent” are available.
Query ListSelect a value from the dropdown list. This value identifies the SAP® Business One query to be used to provide the contact list for this phase of the campaign. The query must be created prior to use in this function.
Constant Contact ListSelect a value from the dropdown list. This field is available only when the Constant Contact option is enabled.The options in this list correspond to e-mail lists defined in your Constant Contact account. Click “Define New” to create a new list.

Due to the way the dropdown list is created a query that will be used here must exist before the Marketing Campaign form is opened. If you create a query after the form is opened you will need to close and reopen the form to see the query in the list.

List Tab - CC Mapping Sub tab Fields

This tab is used to map the fields in your query (Query List) to corresponding field in Constant Contact. This tab is only available when the “Constant Contact” option in the header has been selected. To map fields, please follow these steps…

  1. Select (highlight) the desired row on the List Select tab. An error will be raised if you do not select a row before continuing.
  2. Select a Constant Contact field from the dropdown list in the Constant Contact Fields column.
  3. Select the corresponding field in your query from the dropdown list in the Query Fields column.
  4. Continue this process until all Constant Contact fields are mapped.
Field NameField Description
Constant Contact FieldsThe field as defined on Constant Contacts.
Query FieldsThe field as defined in the utilized Query.

CC Mapping Buttons

Button CaptionButton Function
Update Constant Contact ListUpdate your contact list in Constant Contact with the results of your query.

List Tab - List Data Sub tab Fields

This tab displays the results of the query associated with a row selected on the List Selection tab.

  • Select (highlight) the desired row on the List Select tab. An error will be raised if you do not select a row before continuing.
  • Click the List Data tab to view the results of the query.

mcmimage48.jpeg

Email Message Tab Fields

This tab is used to create your e-mail when you are not using Constant Contact. The tab is available only when the Constant Contact option is not selected.

Field NameField DescriptionData Size
Phase NameSelect a value from the dropdown list. A list of the phases associated with this campaign is displayed.
Create ActivitySelect this checkbox to have the system create an SAP Business One Activity when the e-mail is sent.
From EmailEnter the e-mail address that will be used as the “sender” for the e-mail.100 characters
To Email AddressSelect a value from the dropdown list.
Message Customization Tags
Email MsgEnter the text of your e-mail message in this area. If you enter text directly in this area the e-mail will be treated as a text message. You can also enter create and edit HTML text in this window if you wish, but using the Edit HTML Msg option will make the process much easier.

Only one e-mail message can be stored for a specific campaign at a time. If you want to use one format for Phase A and a different format for Phase B you will need to manually redo the format for each phase.

Button CaptionButton Function
Edit HTML MsgClick to open the editor used to create and edit the HTML code for your message. When this option is selected you will also have the ability to personalize your message using fields from the query associated with the Phase. You will see the HTML text that was created when you save and return to the main form.
Send MailClick this button to send the e-mails created for this phase of the campaign.
Insert
Copy

Statistics Tab

These tabs display information from Constant Contact about the Campaign identified in the “Campaign Lists” dropdown in the campaign header. This information is retrieved directly from Constant Contact. It is not stored in your local database. This tab is only available when the Constant Contact option is enabled.

Statistics – Campaign Statistics Tab

This tab displays general information about the Constant Contact campaign.

Statistics – Contact Statistics Tab

This tab displays information contacts included in the Constant Contact campaign. Enter a number of contact records to retrieve and click Get Data .

Results Tab

These tabs display information from SAP® Business One that result from the Campaign. There are sub-tabs displaying information for…

  • Accounts
  • BP
  • Sales Opportunities
  • Sales Quotes
  • Sales Orders
  • Sales Invoices

Social Media Screen

To access the TWBS Marketing Campaign Management Social Media screen…

  • Click the SAP menu option for Social Media under the MCM menu.
  • The Social Media screen is used to pre-populate fields for posting messages to the following social media outlets:
    • Linked In
    • Twitter
    • Facebook

Access to the Social Media screen is controlled through the Social Media User user defined field on the Users screen in SAP® Business One.

Use of the screen will generate an Activity in SAP® Business One with an Activity Type of Social Media to allow for later tracking and analysis.

mcmimage52.jpeg

Social Media Screen Fields

Field NameField DescriptionData Size
Message NameTitle associated with the message being posted.60 characters
MessagesThe content of the message being posted.500 Charcaters
URLThe website URL associated with the message being posted.100 characters
Via URLThe via website URL associated with the message being posted.100 characters

Social Media Screen Buttons

Button CaptionButton Function
Posting the message information through LinkedIn.
Posting the message information through Twitter.
Posting the message information through Facebook.

Clicking one of the social media outlet buttons will launch a browser window for the appropriate site and pre-populate the fields with the information from the Social Media screen.

MCM Search Screen

To access the TWBS Marketing Campaign Management Search screen…

  • Click the SAP menu option for MCM Search under the MCM menu.

The MCM Search screen is a robust utility screen for searching Marketing Campaign Manager data and saving the search data as a MCM Search-based query for later use.

  • Search ID - An internal unique identification code for the search.
  • Name - Description given by the user for the search.
  • Screen Type - Associates the search with a specific screen type.
    • Account
    • Business Partner
  • All Users checkbox - Allows for the selection of all SAP® user id's.
  • User Selection list - Allows for the individual selection of one or multiple SAP® user id's.
  • Add button - Saves the search and adds it to the MCM Search Results menu.
  • Cancel button - Closes the screen.
  • Refresh Menu button - Refreshes the MCM Search Results menu.
  • Show Results button - Opens a screen to show the search results.

General Tab

mcmimage56.jpeg

Data Columns on General Tab

  • Select - Selection to include the field in the marketing search.
  • Field - The database field name for General information.
  • Description - The database field description followed by the data type in parenthesis.
  • Condition - Conditions to be evaluated in the search.
    • Equal - The selected Field equal to the Value 1 value.
    • Not Equal - The selected Field not equal to the Value 1 value.
    • Smaller Than - The selected Field smaller than the Value 1 value.
    • Greater Than - The selected Field greater than the Value 1 value.
    • Greater or Equal - The selected Field greater than or equal to the Value 1 value.
    • Smaller or Equal - The selected Field smaller than or equal to the Value 1 value.
    • Between - The selected Field between the Value 1 and Value 2 values.
  • Value 1 - An entered value to be used in the condition evaluation.
  • Value 2 - A second entered value to be used in the condition evaluation (if needed).
  • Relationship - The authorization code for the existing authorization, if any.
    • And - Indicates combination of multiple field condition evaluations must be satisfied.
    • Or - Indicates separate condition evaluations of multiple fields.

Contact Person Tab

mcmimage58.jpeg

Data Columns on Contact Person Tab

  • Select - Selection to include the field in the marketing search.
  • Field - The database field name for Contact Person information.
  • Description - The database field description followed by the data type in parenthesis.
  • Condition - Conditions to be evaluated in the search.
    • Equal - The selected Field equal to the Value 1 value.
    • Not Equal - The selected Field not equal to the Value 1 value.
    • Smaller Than - The selected Field smaller than the Value 1 value.
    • Greater Than - The selected Field greater than the Value 1 value.
    • Greater or Equal - The selected Field greater than or equal to the Value 1 value.
    • Smaller or Equal - The selected Field smaller than or equal to the Value 1 value.
    • Between - The selected Field between the Value 1 and Value 2 values.
  • Value 1 - An entered value to be used in the condition evaluation.
  • Value 2 - A second entered value to be used in the condition evaluation (if needed).
  • Relationship - The authorization code for the existing authorization, if any.
    • And - Indicates combination of multiple field condition evaluations must be satisfied.
    • Or - Indicates separate condition evaluations of multiple fields.

Address Tab

mcmimage59.jpeg

Data Columns on Address Tab

  • Select - Selection to include the field in the marketing search.
  • Field - The database field name for Address information.
  • Description - The database field description followed by the data type in parenthesis.
  • Condition - Conditions to be evaluated in the search.
    • Equal - The selected Field equal to the Value 1 value.
    • Not Equal - The selected Field not equal to the Value 1 value.
    • Smaller Than - The selected Field smaller than the Value 1 value.
    • Greater Than - The selected Field greater than the Value 1 value.
    • Greater or Equal - The selected Field greater than or equal to the Value 1 value.
    • Smaller or Equal - The selected Field smaller than or equal to the Value 1 value.
    • Between - The selected Field between the Value 1 and Value 2 values.
  • Value 1 - An entered value to be used in the condition evaluation.
  • Value 2 - A second entered value to be used in the condition evaluation (if needed).
  • Relationship - The authorization code for the existing authorization, if any.
    • And - Indicates combination of multiple field condition evaluations must be satisfied.
    • Or - Indicates separate condition evaluations of multiple fields.

mcmimage60.jpeg

  • Select - Selection to include the field in the marketing search.
  • Field - The database field name for Related Activities information.
  • Description - The database field description followed by the data type in parenthesis.
  • Condition - Conditions to be evaluated in the search.
    • Equal - The selected Field equal to the Value 1 value.
    • Not Equal - The selected Field not equal to the Value 1 value.
    • Smaller Than - The selected Field smaller than the Value 1 value.
    • Greater Than - The selected Field greater than the Value 1 value.
    • Greater or Equal - The selected Field greater than or equal to the Value 1 value.
    • Smaller or Equal - The selected Field smaller than or equal to the Value 1 value.
    • Between - The selected Field between the Value 1 and Value 2 values.
  • Value 1 - An entered value to be used in the condition evaluation.
  • Value 2 - A second entered value to be used in the condition evaluation (if needed).
  • Relationship - The authorization code for the existing authorization, if any.
    • And - Indicates combination of multiple field condition evaluations must be satisfied.
    • Or - Indicates separate condition evaluations of multiple fields.

Interest Tab

mcmimage61.jpeg

Data Columns on Interest Tab

  • Select - Selection to include the field in the marketing search.
  • Field - The database field name for Interest information.
  • Description - The database field description followed by the data type in parenthesis.
  • Condition - Conditions to be evaluated in the search.
    • Equal - The selected Field equal to the Value 1 value.
    • Not Equal - The selected Field not equal to the Value 1 value.
    • Smaller Than - The selected Field smaller than the Value 1 value.
    • Greater Than - The selected Field greater than the Value 1 value.
    • Greater or Equal - The selected Field greater than or equal to the Value 1 value.
    • Smaller or Equal - The selected Field smaller than or equal to the Value 1 value.
    • Between - The selected Field between the Value 1 and Value 2 values.
  • Value 1 - An entered value to be used in the condition evaluation.
  • Value 2 - A second entered value to be used in the condition evaluation (if needed).
  • Relationship - The authorization code for the existing authorization, if any.
    • And - Indicates combination of multiple field condition evaluations must be satisfied.
    • Or - Indicates separate condition evaluations of multiple fields.

Demographics Tab

mcmimage62.jpeg

Data Columns on Demographics Tab

  • Select - Selection to include the field in the marketing search.
  • Field - The database field name for Demographics information.
  • Description - The database field description followed by the data type in parenthesis.
  • Condition - Conditions to be evaluated in the search.
    • Equal - The selected Field equal to the Value 1 value.
    • Not Equal - The selected Field not equal to the Value 1 value.
    • Smaller Than - The selected Field smaller than the Value 1 value.
    • Greater Than - The selected Field greater than the Value 1 value.
    • Greater or Equal - The selected Field greater than or equal to the Value 1 value.
    • Smaller or Equal - The selected Field smaller than or equal to the Value 1 value.
    • Between - The selected Field between the Value 1 and Value 2 values.
  • Value 1 - An entered value to be used in the condition evaluation.
  • Value 2 - A second entered value to be used in the condition evaluation (if needed).
  • Relationship - The authorization code for the existing authorization, if any.
    • And - Indicates combination of multiple field condition evaluations must be satisfied.
    • Or - Indicates separate condition evaluations of multiple fields.

Display Order Tab

mcmimage63.jpeg

Data Columns on Display Order Tab

  • Field - The database field name of a field selected from one of the other tabs on the search screen.
  • Description - The database field description followed by the data type in parenthesis.
  • Order - The order in which the field data will be displayed in the search results.

Communication Templates Screen

To access the TWBS Marketing Campaign Management Communication Templates screen…

  • Click the SAP menu option for Account under the MCM menu.
  • The Communication Template Setup screen will load. This screen will allow the user to add new templates or update existing templates, adding documents to the template from the Document Library. These templates can be attached to SAP® Business One screens and can be accessed through these screens to be used for either email or print purposes.

Message Editor Screen

To access the TWBS Marketing Campaign Management Message Editor screen…

  • Click the Message Editor button on the Communications Template screen.
  • Query Type - Selection of the Query type to be used in the message editor.
  • B1 Based Query - An SAP® Business One query.
  • MCM Search Query - A stored Marketing Campaign Manager Search query.
  • Search Name - The name of the stored Marketing Campaign Manager Search query.
  • Query Category - The category queries in SAP® Business One.
  • B1 Based Query - List of the SAP® Business One queries available in the selected Query Category.
  • Query Fields drop down - Lists the available fields of the selected query.

Document Library Screen

To access the TWBS Marketing Campaign Management Document Library screen…

  • Click the SAP menu option for Document Library under the MCM menu.
  • The Document Library screen will load. This screen will allow the user to add documents to the TWBS Marketing Campaign Management Document Library. Once a document has been added to the library, the document can be added to a Communication Template.

SAP User Screen

To access the SAP® Business One Users Setup screen and set specific Marketing configuration options by user…

  • Click the SAP menu option for Users under the AdministrationSetupGeneral menu.
  • Four user-defined fields have been added to this screen.
    mcmimage68.jpeg

Add Button After Action...

mcmimage69.jpeg

This option determines what happens in the Marketing Accounts form when a new record is added.

  • OK - Automatically re-display the Account record when it is added.
  • ADD - Clear the form data and change the form to Add mode.
  • FIND - Clear the form data and change the form to Find mode.

Config for Marketing Mode...

mcmimage70.jpeg

This option determines if the Marketing Accounts form opens in Add or Find mode.

  • ADD - Open the form in Add mode.
  • FIND - Open the form in Find mode.

mcmimage71.jpeg

This option determines what happens when the Related Activities tab in the Marketing Accounts form is selected. The options available are “Display All” or “Only Open.” The option can then be changed on the tab itself as needed.

  • Only Open Activities - Displays only open status related activities.
  • Display All - Displays all related activities regardless of status.

Document Management Admin Access...

mcmimage72.jpeg

This option determines if the Communication Template and Document Library options are available to the user.

  • Yes - Allows access to the Communication Template and Document Library options.
  • No - Does not allow access to the Communication Template and Document Library options.

SAP Business Partner Master Data Screen

To access the SAP® Business One Business Partners Master Data screen…

  • Click the SAP menu option for Business Partner Master Data under the Business Partner menu.
  • A custom Interest tab has been added to this screen.

mcmimage73.jpeg

Interest Tab Fields

Field NameField Description
Item CodeEither select or enter a specific item of interest for this lead. This is the standard set of items active in SAP® Business One.
Item DescriptionIf a specific item has been selected its description is displayed.
Item GroupSelect a value from the dropdown list. This is the standard set of item groups active in SAP® Business One. In a specific item has been selected its corresponding item group is displayed.
Interest DateEnter an approximate date when a sale might occur. Your business process will determine how you assign this date.
Source CodeSelect a value from the dropdown list. This is a user defined list of values. Click “Define New” to add a new value. Your business process will determine how this value is used.
Campaign CodeEither select or enter a campaign code that generated interest in this product. The list of codes is based on TWBS Marketing Campaigns.

SAP Marketing Document Screen

To access the SAP® Business One marketing document screens…

  • Click the SAP menu option for one of the documents under the Sales - A/R menu.
    • Sales Quotation
    • Sales Order
    • Delivery
    • A/R Invoice
  • The Campaign Code UDF has been added to the marketing document forms.

Using Marketing Campaign Manager

The following section outlines different real-world application scenarios utilizing the TWBS Marketing Campaign Management application.

How to Setup your Constant Contact Credentials

  • Click the SAP menu option for Configuration under the Administration > Setup > TWBS MCM menus.
    mcmimage22.jpeg
  • The configuration screen will load.
  • Click on the Constant Contact Login tab.
    mcmimage24.jpeg
  • Enter the User Name for your Constant Contact credentials.
  • Click the Obtain Constant Contact Login Token button.

This information is required only if you wish to utilize Constant Contact for e-mail marketing management from SAP® Business One via the Marketing Campaign Management application.

mcmimage77.jpeg

  • You will be prompted with a reminder to click the Update button after successful Constant Contact authorization.
  • Click the OK button.
  • A log in screen for Constant Contact will load.
  • Enter your Constant Contact account user name and password in the appropriate fields.
  • Click the Log In button.
    mcmimage79.jpeg
  • You will then be prompted if you want to allow the TWBS MCM application to access your Constant Contact account and be able to update infromation. Click the Allow button.
  • If the token has been successfully received, the Constant Contact window will close and you will receive a successful message on the SAP status bar.
  • Click the Update button to save configuration options.
    mcmimage80.jpeg
  • Once the Constant Contact credentials have been obtained and saved, the Delete List tab will appear on the Configuration screen and allow you access to your Constant Contact lists to remove ones you wish to delete.

How to Delete a Constant Contact List

How to Add/Update Accounts

Adding an Account

  • Click the SAP menu option for Account under the Marketing menu.
  • Click the SAP Add button to place the Account form into Add mode.
  • Enter the Account information. For specific information regarding the form fields, please refer to the **Accounts Screen** section of the User Guide.
    mcmimage83.jpeg
  • Click the Add button.

Updating an Account

  • Click the SAP menu option for Account under the Marketing menu.
  • Load an existing Account onto the screen.
  • Update any information that needs to be altered. Changing the existing values will put the form into Update mode.
    mcmimage84.jpeg
  • Click the Update button.

How to Remove Accounts

  • Click the SAP menu option for Account under the Marketing menu.
  • Load the existing Account onto the screen that you wish to remove.
  • Access the Right-Click menu for the Account screen.
    mcmimage85.jpeg
  • Select the option for Remove.
  • You will be prompted for confirmation that you wish to remove the current Account.

    Once an Account is removed from the system, it cannot be recovered.

  • Select the OK button to confirm and remove the Account.

How to Import Accounts

  • Click the SAP menu option for Data Import Wizard under the Administration > Data Import/Export > MCM menu.
  • The TWBS Marketing Data Import Wizard will appear minimized on your task bar.
    mcmimage87.jpeg
  • Click the Next button to proceed.

Identify Your Import Source File

In this step you will define the type and location of your input data file.

  • Select the table corresponding to the data you want to import.
    • TWBS_MK_OCRD: Marketing Account Master
    • TWBS_MK_OCPR: Marketing Account Contacts
    • TWBS_MK_CRD1: Marketing Account Addresses

      Remember that the Marketing Account records must be imported before importing Contacts and Addresses.

    • Click the radio button for “Tab File” or “Excel File” to indicate what type of import source file you will be using.
    • Click on the button to browse for your file.
    • When you select your file the contents are displayed in the grid. This will give you the chance to review the data in the file.

Deduping (Handling Duplicates)

At the bottom of the screen are found the “Deduping” options. “Deduping” describes how you want the import process to handle situations where a duplicate record is found. The way you approach this may be different for each type of import data.

Deduping Criteria

Select the field from the dropdown list that you want to test for an existing record. The fields presented in the list are the fields you have included in your import file.

  • For Master records the most common test field is the Account Code
  • For Contact records the most common test fields might be name, e-mail address or telephone number
  • For Address records the most common test fields might be name, zip code or city.

Update or Skip

Select the desired action to be taken when a duplicate is found. Use “Update existing record with file details” if you are deliberately intending to update existing records. Use “Skip record if duplicate is found” if you are loading a new set of lead information and you don’t want to duplicate a record that already exists.

  • Click the Next button to proceed.

Map Import Fields

In the next step you will tell the application how the fields in your import file relate to the fields in the database.

  • The columns in your import file are listed in the left-hand grid. The database columns are listed in the right-hand grid.
  • Select (click on) a field in the left-hand grid, select (click on) its corresponding field in the right-hand grid, and click Connect. The mapped data pair is moved to the lower section of the screen. This lower section shows all fields that have been mapped for this type of import. Continue this process until all fields in your import file that you wish to import have been mapped. Note that an indicator (a small “x”) is shown next to each field that has been mapped.
  • If you determine that a field pair is mapped incorrectly, select the pair in the lower section of the screen and click Disconnect. This will clear the mapping relationship of the two fields.
  • When you have completed the mapping process click Save Mapping to save the mapping information for the actual processing step.
  • The Finish button is displayed after the mapping file has been saved.

The mapping process must be completed each time the import function is executed. The Save Mapping process simply saves a file that is used for the current import cycle.

Execute the Import

Click Finish to execute the actual import process. A message box is displayed when the import process is complete. Click OK to close the message box.

When the import process is complete you can click Cancel to exit the import function or click Back to move to previous steps.

How to Format Data for Importing Accounts

The TWBS Marketing Campaign Management application provides a tool to import Marketing Accounts from an external text (tab delimited) or Excel file. In version 1 of the tool it is necessary to import this information in three separate cycles. Information that can be imported includes Master information, Contact information and Address information.

This utility can be used to both import new records and update existing records, subject to some limitations. A description of how the update process can be used is found in the “Execute the Import Process” that follows.

Create the Import Files

The import file can be either at tab delimited text file or a standard Excel workbook. If you use an Excel workbook only the first worksheet can be used for import data. The following tables describe the information for each data set (master, contact and address).
The first row of the import file should contain the column name. The information in this row is presented in the import mapping process to allow you to “connect” data in your file to the appropriate field in the Marketing database.
It is not necessary to have data for all columns listed in the tables. Your file can consist of columns for only the data you are going to import. So your file may only have five or six columns.

Master Information

The following table identifies the data that can be imported for a Marketing Account Master record. Any User Defined Fields you may have created will also be displayed in the interface so that you can import custom information as well. A more complete description of how the various fields are used is found in the **Marketing Campaign Manager Screens** sections of this User Guide.

Col #Marketing Column (field)DescriptionMax SizeRequired
1Lead CodeMarketing Lead Code15
2Business Partner CodeSystem generated: do not importXXX
3Consolidating BPStandard Business Partner Code: use CardCode value from OCRD15
4Lead NameCompany Name100
5Contact PersonSystem Generated: do not importXXX
6Lead TypeCode for Lead Type: use u_Code value from @twbs_mk_leadtypes15
7Foreign NameCompany Name, Foreign100
8Group CodeCustomer Group code: use GroupCode value from OCRG where GroupType = ‘C’6
9CurrencyCurrency Code: use CurrCode value from OCRN3
10Federal Tax IDTax ID32
11Phone1Telephone number20
12Phone2Telephone number20
13MobileTelephone number50
14FaxFax number20
15E-mailE-mail address100
16Web SiteWebsite URL100
17Ship TypeNot currently used6
18PasswordPassword32
19Factoring IndicatorNot currently used2
20Project CodeProject Code: use PrjCode value from OPRJ8
21Contact PersonSystem generated: do not import90
22ID NoID 218
23NotesNotes/Remarks100
24Sales EmployeeSales Employee Code: use SlpCode value from OSLP6
25BP Channel CodeStandard Business Partner Code: use CardCode value from OCRD15
26EmployeeService Technician: use EmpID from OHEM where HEM6.RoleID = -215
27TerritoryTerritory Code: Use territryID from OTER15
28StatusLead status: 1 = Active, 2 = Inactive. Do not use 3 (Converted)6
29BillDefDefault Bill-To address: system generated – do not import50
30ShipDefDefault Ship-To address: system generated – do not import50
Contact Information

The following table identifies the data that can be imported for a Marketing Account Contacts record. Any User Defined Fields you may have created will also be displayed in the interface so that you can import custom information as well. A more complete description of how the various fields are used is found in the previous sections of this document.

Col #Marketing Column (field)DescriptionMax SizeRequired
1NameContact full name50
2PrefixContact prefix15
3First NameContact First Name25
4Middle NameContact Middle Name25
5Last NameContact Last Name25
6Solicit OKOK to contact: valid values are ‘Y’ and ‘N’25
7Mail OKOK to contact: valid values are ‘Y’ and ‘N’25
8TitleContact title10
9PositionContact position90
10AddressContact address100
11TelephoneContact telephone number20
12Mobile PhoneContact mobile/cell number50
13FaxContact fax number20
14E_mailContact e-mail address100
15PagerContact pager number30
16Remarks1Contact remarks/notes 1100
17Remarks2Contact remarks/notes 2100
18PasswordPassword8
19Customer CodeMarketing Lead code: this must refer to a Lead Code that already exists in the Marketing database15
20DefaultDefault contact flag: value = 1 if this is the default. Only one contact can be a default per Marketing Lead6
21CrystalWave Contact TypeNot currently used253
22CrystalWave Report DeliveryNot currently used253
Address Information

The following table identifies the data that can be imported for a Marketing Account Address record. Any User Defined Fields you may have created will also be displayed in the interface so that you can import custom information as well. A more complete description of how the various fields are used is found in the previous sections of this document.

Col #Marketing Column (field)DescriptionMax SizeRequired
1Address NameAddress Name50
2StreetStreet address100
3BlockStreet address 2100
4CityCity100
5Zip CodeZip/Postal Code20
6StateState/Province code: use Code value from OCST where Country = Country (item 10) below3
7Tax CodeNot currently used8
8Address TypeType of address: valid values are ‘B’ (Bill-To) or ‘S’ (Ship-To)
9Card CodeMarketing Lead code: this must refer to a Lead Code that already exists in the Marketing database15
10CountryCountry: use Name value from OCRY - MCM import will match the country name and associate the appropriate country code from the table.100

How to Add/Remove Contact People from an Account

Adding a Contact Person
  • Click the SAP menu option for Account under the Marketing menu.
  • Load the existing Account onto the screen that you wish to add a contact person to.
  • Click the Contact Person tab.
  • Click the Define New option in the left list.
  • If there are no Contact Person entries for the Account, the Define New will already be defaulted for the Account.


    mcmimage92.jpeg

  • Enter the information for the Contact Person that you wish to add to the Account.
  • Click the Update button.
    mcmimage93.jpeg
  • The Name of your new Contact Person will now be displayed in the left list. Clicking on the Name will load the data for the Contact Person in the right matrix and allow that data to be edited and updated.
Removing a Contact Person
  • Load the existing Account onto the screen that you wish to remove a contact person from.
  • Click the Contact Person tab.
  • Access the Right-Click menu for the left list of Contact Person names.
    mcmimage94.jpeg
  • Click the Delete Row menu option.
  • The Contact Person will be removed from the Account.
  • There is no confirmation before the Contact Person is removed from the Account.

  • Click the SAP menu option for Account under the Marketing menu.

How to Add/Remove Addresses from an Account

Adding an Address
  • Click the SAP menu option for Account under the Marketing menu.
  • Load the existing Account onto the screen that you wish to add an Address to.
  • Click the Address tab.
  • Click the Define New option in the left list for either a Bill To or Ship To Address.

    If there are no Address entries for the Account, the Define New will already be defaulted for the Bill To Address.


    mcmimage96.jpeg

  • Enter the information for the Address that you wish to add to the Account.
  • Click the Update button.
  • The Address Name of your new Address will now be displayed in the left list. Clicking on the Address Name will load the data for the Address in the right matrix and allow that data to be edited and updated.
Removing an Address
  • Click the SAP menu option for Account under the Marketing menu.
  • Load the existing Account onto the screen that you wish to remove an Address from.
  • Click the Address tab.
  • Access the Right-Click menu for the left list of Address names you want to remove the Address for. \\mcmimage97.jpeg
  • Click the Delete Row menu option.
  • The Address Name will be removed from the Account.

    There is no confirmation before the Address is removed from the Account.

How to Copy a Bill To Address to a Ship To Address

  • Click the SAP menu option for Account under the Marketing menu.
  • Load the existing Account onto the screen that you wish to copy an Address for.
  • Click the Address tab.
  • Click on the Address Name on the left list for the Bill To Address that you wish to copy to a Ship To Address.
  • Check the box marked Copy Bill To - Ship To.
    mcmimage99.jpeg
  • Click the Update button.
    mcmimage100.jpeg
  • The Address Name from the Bill To Address copied will now also show under the Ship To Address list.

How to Add/Remove an Interest from an Account

Adding an Interest to an Account
  • Click the SAP menu option for Account under the Marketing menu.
    mcmimage102.jpeg
  • Load the existing Account onto the screen that you wish to add an Interest to.
  • Click the Interest tab.
  • Enter the information for the new Interest line.
    mcmimage101.jpeg
  • Click the Update button.
  • The Interest will be added to the Account.
Removing an Interest from an Account
  • Click the SAP menu option for Account under the Marketing menu.
    mcmimage102.jpeg
  • Load the existing Account onto the screen that you wish to remove an Interest from.
  • Click the Interest tab.
  • Access the Right-Click menu for the Interest entry you want to remove.
    mcmimage103.jpeg
  • Click the Remove Row menu option.
  • The Interest will be removed from the Account.

How to Convert an Account to an SAP Business Partner

  • Click the SAP menu option for Account under the Marketing menu.
  • Load the existing Account onto the screen that you wish to convert to an SAP® Business One Business Partner.
    mcmimage104.jpeg
  • Click the Convert to BP button.
    mcmimage105.jpeg
  • The user will be prompted to select the Customer Type and Card Code for the Business Partner to be created.

    Previous versions of TWBS Marketing Campaign Management only allowed for the creation of a Customer type BP from an Account. With Version 1.2, there are now more options for card type including Vendor.

  • Click the Convert button.

    The Business Partner code must be a unique value that doesn't already exist in the system.

  • To confirm that the Business Partner was create, click the SAP menu option for Business Partner Master Data under the Business Partner menu.
  • Click the SAP Find button.
  • Search for the Business Partner Code specified during the conversion.

    You will most likely need to provide additional information on the newly created Business Partner after the conversion process. Review the new record to be sure that all necessary information is provided.

  • Click the SAP menu option for Account under the Marketing menu.
  • Load the existing Account onto the screen that you wish to link to an existing SAP® Business One Business Partner.
    mcmimage104.jpeg
  • Click the Convert to BP button.
    mcmimage110.jpeg
  • Select the Link to Existing BP option
  • Designate the SAP Business Partner to link the Account to by entering the BP Code or by selecting the BP from the Choose From List option.

    The Business Partner code must be a unique value that already exists in the system.

  • The BP Code field on the Account screen will be updated for the Account with the SAP Business Partner that you chose to link the Account to.

How to Create an Activity from an Account

  • Click the SAP menu option for Account under the Marketing menu.
  • Load the existing Account onto the screen that you wish to create an Activity for.
    mcmimage113.jpeg
  • Click the Activity button.
    mcmimage114.jpeg
  • An SAP Activity screen will load and the information for the Account will be pre-populated.
  • Complete the Activity and add it to the SAP® Business One system.

    An Activity for a Marketing Account must have the “Personal” checkbox selected. This is done automatically and should not be changed. Otherwise the system will require you to enter a valid Business Partner code, which will typically not yet exist.

How to Add a Document to the Document Library

To access the TWBS Marketing Campaign Management Document Library screen…

  • Click the SAP menu option for Document Library under the Marketing menu.
  • The Document Library screen will load.
  • Click the Browse button.
  • Locate the file to be added to the Document Library and select the file.
  • Enter the Document Name and Doc Description fields.
    mcmimage116.jpeg
  • Click the Add button.

How to Remove a Document from the Document Library

To access the TWBS Marketing Campaign Management Document Library screen…

  • Click the SAP menu option for Document Library under the Marketing menu.
  • The Document Library screen will load.
  • Access the Right-Click menu for the Document you want to remove.
    mcmimage117.jpeg
  • Select the Remove Row menu option.
  • The user will be prompted for confirmation to remove the selected Document.
    mcmimage118.jpeg
  • Click the Yes button.

    To remove all documents from the Document Library at one time, refer to the **Deleting Document Library Files** section of the User Guide.

How to Review Document Usage

To access the TWBS Marketing Campaign Management Document Library screen…

  • Click the SAP menu option for Document Library under the Marketing menu.
  • The Document Library screen will load.
    mcmimage120.jpeg
  • To review which Communication Templates a specific document has been associated with, highlight the row of the document in question on the General tab.
  • Click on the Related Documents tab. A list of Templates and the SAP® Business One screen that the Template is associated with will be displayed.
    mcmimage121.jpeg
  • To review which Communication Templates a specific document has been associated with, highlight the row of the document in question on the General tab.
  • Click on the Document Group View tab. A list of Groups that the document is associated with will be displayed.
    mcmimage122.jpeg

How to Setup a Communication Template

To access the TWBS Marketing Campaign Management Communication Template Setup screen…

  • Click the SAP menu option for Communication Templates under the Marketing menu.
  • The Communication Template Setup screen will load.
  • Click the SAP Add button to place the form into Add mode.
    mcmimage123.jpeg
  • Enter a Template Name
  • Select the SAP® Business One screen that you want to link the Communications Template to.
  • Select the Template Type, either Email or Print.
  • Select the Printer.
  • Select any Documents from the Document Library that you want added to the Communications Template
    mcmimage124.jpeg

How to Edit a Communication Template Message

To access the TWBS Marketing Campaign Management Communication Template Setup screen…

  • Click the SAP menu option for Communication Templates under the Marketing menu.
  • The Communication Template Setup screen will load.
  • Load the Communication Template that you want to edit the message for.
    mcmimage123.jpeg
  • Click the Message Editor button.
    mcmimage125.jpeg
  • Edit the Subject and/or Message Content. You can also specify a query from which you can insert fields into the message body.
  • Click the Save button.

How to Access an Email Communication Template

To access an Email Communication Template…

  • Determine the SAP® Business One screen that the Communication Template you with to use is linked to.
  • Launch the screen the Communication Template is linked to.
  • Access the Right-Click menu for screen.
  • Hover over the Communication Template menu to get a list of the specific Communication Templates linked to the screen.
  • Select the Email type Communication Template you want to access.
    mcmimage124.jpeg
  • The TWBS Email Tool will launch. The information from the Message Editor for the Communication Template will pre-load to the message body. Any documents in the Template will be attached.

    If the Activity checkbox of the Communication Template was selected, the Create Activity checkbox on the Email Tool window will be defaulted.


    mcmimage126.jpeg

  • Complete any message text, Email addressing, receipts, formatting, etc.
  • Click the Send button.

How to Access an Print Communication Template

To access a Print Communication Template…

  • Determine the SAP® Business One screen that the Communication Template you with to use is linked to.
  • Launch the screen the Communication Template is linked to.
  • Access the Right-Click menu for screen.
  • Hover over the Communication Template menu to get a list of the specific Communication Templates linked to the screen.
  • Select the Print type Communication Template you want to access.
    mcmimage124.jpeg
  • The Communication Template Execution screen will launch. The information from the Message Editor for the Communication Template will pre-load to the message body. Any documents in the Template will cause the Print with Supporting Documents option to be selected.
    mcmimage127.jpeg
  • Complete any message text, formatting, etc.
  • Click the Print button.

How to Add/Update a Marketing Campaign

Adding an Marketing Campaign
  • Click the SAP menu option for Campaign under the Marketing menu.
  • Click the SAP Add button to place the Campaign form into Add mode.
  • Enter the Marketing Campaign information. For specific information regarding the form fields, please refer to the Campaign Screen section of the User Guide.
    mcmimage128.jpeg
  • Click the Add button.
Updating an Marketing Campaign
  • Click the SAP menu option for Campaign under the Marketing menu.
  • Load an existing Campaign onto the screen.
  • Update any information that needs to be altered. Changing the existing values will put the form into Update mode.
    mcmimage129.jpeg
  • Click the Update button.

How to Remove a Marketing Campaign

  • Click the SAP menu option for Campaign under the Marketing menu.
  • Load the existing Campaign onto the screen that you wish to remove.
  • Access the Right-Click menu for the Campaign screen.
    mcmimage130.jpeg
  • Select the option for Remove.
    mcmimage131.jpeg
  • You will be prompted for confirmation that you wish to remove the current Account.

    Once a Campaign is removed from the system, it cannot be recovered.

  • Select the OK button to confirm and remove the Campaign.

How to Post a Social Media Message

  • Click the SAP menu option for Social Media under the MCM menu to launch the **Social Media** screen.

    Access to the Social Media screen is controlled through the Social Media User user defined field on the Users screen in SAP® Business One.

    Use of the screen will generate an Activity in SAP® Business One with an Activity Type of Social Media to allow for later tracking and analysis.

    mcmimage52.jpeg

  • Enter a title for the message in the Message Name field and the content of your message into the Messages field.
  • Enter the website URL (if applicable) in the URL field and the via website URL (if applicable) in the Via URL field.
    mcmimage132.jpeg
  • Click the button for the appropriate social media site to post the message to
    • Linked In - mcmimage133.jpeg
    • Twitter - mcmimage134.jpeg
    • Facebook -
  • Clicking one of the social media outlet buttons will launch a browser window for the appropriate site and pre-populate the fields with the information from the Social Media screen.

Posting the message to Linked In

The Linked In website will open and require you to enter your account credentials to continue the message posting process.

The Marketing Campaign Manager application is not involved in the message posting process from this point forward. All functionality is from Linked In.

mcmimage135.jpeg

Posting the message to Twitter

The Twitter website will open and require you to enter your account credentials to continue the message posting process.

The Marketing Campaign Manager application is not involved in the message posting process from this point forward. All functionality is from Twitter.

mcmimage136.jpeg

Posting the message to Facebook

The Facebook website will open and require you to enter your account credentials to continue the message posting process.

The Marketing Campaign Manager application is not involved in the message posting process from this point forward. All functionality is from Facebook.

mcmimage138.jpeg

Viewing the Activity created by the Click of the Social Media button

The Activity will be generated in SAP® Business One on the click of the social media button, regardless of if the message is completed through the social media website.

  • Click the SAP menu option for Activity under the Business Partners menu to launch the Activity screen.
  • Load the last Activity added to the system to the screen.
    mcmimage139.jpeg
  • The Type value is set to social media and the Remarks field is set to the value of the Message Name field from the **Social Media** screen.
    mcmimage140.jpeg
  • The Content value is set to the value of the Messages field from the **Social Media** screen.

How to Post a Social Media Message from the Campaign Manager

  • On the **Campaign** screen, with your Campaign loaded, click the Post to Social Media button.
    mcmimage141.jpeg
  • The Message Name value is set to the value of the Campaign Name field from the **Campaign** screen.
  • The Messages value is set to the value of the Campaign Description field from the **Campaign** screen.

    Access to the Social Media screen is controlled through the Social Media User user defined field on the Users screen in SAP® Business One.

    Use of the screen will generate an Activity in SAP® Business One with an Activity Type of Social Media to allow for later tracking and analysis.

    mcmimage142.jpeg

  • Edit the title for the message in the Message Name field and the content of your message into the Messages field, if needed.
  • Enter the website URL (if applicable) in the URL field and the via website URL (if applicable) in the Via URL field.
  • Click the button for the appropriate social media site to post the message to
    • Linked In - mcmimage133.jpeg
    • Twitter - mcmimage134.jpeg
    • Facebook -
  • Clicking one of the social media outlet buttons will launch a browser window for the appropriate site and pre-populate the fields with the information from the Social Media screen.

Posting the message to Linked In

The Linked In website will open and require you to enter your account credentials to continue the message posting process.

The Marketing Campaign Manager application is not involved in the message posting process from this point forward. All functionality is from Linked In.

mcmimage135.jpeg

Posting the message to Twitter

The Twitter website will open and require you to enter your account credentials to continue the message posting process.

The Marketing Campaign Manager application is not involved in the message posting process from this point forward. All functionality is from Twitter.

mcmimage136.jpeg

Posting the message to Facebook

The Facebook website will open and require you to enter your account credentials to continue the message posting process.

The Marketing Campaign Manager application is not involved in the message posting process from this point forward. All functionality is from Facebook.

mcmimage138.jpeg

Viewing the Activity created by the Click of the Social Media button

The Activity will be generated in SAP® Business One on the click of the social media button, regardless of if the message is completed through the social media website.

  • Click the SAP menu option for Activity under the Business Partners menu to launch the Activity screen.
  • Load the last Activity added to the system to the screen.
    mcmimage139.jpeg
  • The Type value is set to social media and the Remarks field is set to the value of the Message Name field from the **Social Media** screen.
    mcmimage140.jpeg
  • The Content value is set to the value of the Messages field from the **Social Media** screen.

How to Use the MCM Search Screen

  • Click the SAP menu option for MCM Search under the MCM menu to launch the **Marketing Campaign Manager Search** screen.
    mcmimage56.jpeg
  • Enter a description for the search in the Name field.
  • Select a type for the search from the Screen Type drop down.
  • Select the users for the search permissions.
  • Browse the Marketing Campaign data tabs (General, Contact Person, Address, Related Activities, Interest, and Demographics) and select the fields to be included in the search. Conditions and relationships can be set for the fields according to the desired results.
  • To alter the display orders of the fields included in the MCM Search, click on the Display Order tab. Change the values of the Order column next to the field name to reflect the desired order of fields in the search results.

Viewing the Search Results Data

mcmimage143.jpeg

  • Click the Show Results button to open a screen to show the search results.
    mcmimage144.jpeg

Saving the Search as an MCM Search Query

mcmimage145.jpeg

  • Click the Add button to save the MCM Search Query. The internal reference Search ID will be assigned automatically.
    mcmimage146.jpeg
  • Click the Refresh Menu button to reload the MCM menu in SAP® Business One.
    mcmimage147.jpeg
  • The new menu option for the MCM Search Query is listed under the chosen Screen Type menu group under the MCMMCM Search Results menu.
mcm/marketing_campaign_management.txt · Last modified: 2019/02/04 09:41 (external edit)