Adding an Import User

Starting in R11.2 we started using an import user for several processes in MarketingPilot including Email Marketing and many of the import processes.  The import user is a SQL Server user, the user needs to be mapped to the MarketingPilot database and have the mp_user and mp_import database roles. Once the user is setup in SQL, it needs to be added to your MarketingPilot application on the Site page, the field is towards the bottom of the page. Once you add the import user and the password (don’t forget to enter it twice), hit save, if you don’t get an error, you are good to go, if you get an error, keep reading for some tips to fix the issue.

If you receive an error stating the import user is not setup correctly there are a few items to check:
1.  Be sure the import user is mapped to your MarketingPilot database
2.  Be sure the user has the mp_user and mp_import roles
3.  Check the exceptionlog in the Web Server folder, if you receive an error similar to ” Cannot execute as the database principal because the principal “dbo” does not exist, this type of principal cannot be impersonated, or you do not have permission.”  You may have an issue with your database owner.  This error normally appears when you have upgraded your SQL server from 2005 to 2008.  To correct this issue you can make the SA user the database owner by running this sql on your MarketingPilot database:  EXEC sp_changedbowner ‘sa’
This will change the database owner and the error should go away.

Advertisements

Setting up relays in Exchange Server

When you are a self hosted client and need to setup your email in MarketingPilot you may find that you are creating emails, but they don’t seem to be delivered.  This may mean you need to setup an open relay in exchange server.  Below are links to Technet for Exchange 2007 and 2010 that give you information that will help you setup your relay so it works for both internal an external email.

Exchange 2007: http://technet.microsoft.com/en-us/library/ee428173(v=exchg.80)

Exchange 2010: http://technet.microsoft.com/en-us/library/bb738161.aspx

Reporting Services – Custom report error (Error while loading code module: MarketingPilot.Framework.dll)

When uploading a custom report (mainly financial reports such as invoices and PO’s) that uses currency, you may find yourself facing an issue trying to deploy your reports. You may see the following error message:
The resolution to this issue is explained below, but please note, you will need to get a copy of the correct MarketingPilot.Framework.dll file from MarketingPilot Support because it must be a version that doesn’t use .NET 4.0.

Procedure to Deploy Report Dependencies to Reporting Service

Fixing Visual Studio Compilation errors
Locate the a version of the MarketingPilot.Framework.dll that IS NOT using .NET 4.0 (example: MarketingPilot\Web Server\bin)

To fix Visual Studio 2005, copy this DLL to C:\Program Files\Microsoft Visual Studio 8.0\Common7\IDE\PrivateAssemblies **(C:\Program Files (x86) if you are using a 64 bit machine)

To fix Visual Studio 2008, copy this DLL to C:\Program Files\Microsoft Visual Studio 9.0\Common7\IDE\PrivateAssemblies **(C:\Program Files (x86) if you are using a 64 bit machine)

Fixing Reporting Services dependency errors
Copy that the same MarketingPilot.Framework.dll in step one to your Reporting Services’ ReportServer bin folder (example: C:\Program Files\Microsoft SQL Server\MSSQL.3\Reporting Services\ReportServer\bin)
Note: The MSSQL.3 part may be different depending on your Reporting Services installation. **(For SQL Express: MSRS10.SQLEXPRESS, for SQL 2008 R2: MSRS10_50.MSSQLSERVER)

**NOTE: Be sure to use the same version of the MarketingPilot.Framework.dll in both locations.

IE “Unable To Load Client Print Control”

When running system reports in MarketingPilot and using IE7 or IE8 and you click on the print icon we were receiving an error saying “Unable to Load Client Print Control”.  If this happens to you, here’s how to solve the issue.  The issue is happening because of the  Microsoft Report Viewer 2008 that is installed on the Web Server.  To resolve the issue you will need to install the Microsoft Report Viewer 2008 SP1 Redistributable on the Web Server (http://www.microsoft.com/downloads/en/details.aspx?FamilyID=bb196d5d-76c2-4a0e-9458-267d22b6aac6).

Once the redistributable is loaded on the server, the user will need to reinstall the SQL Server driver.  To do this they will need to:

  • Go into MarketingPilot
  • Click Reports on the left navigation bar
  • Open a system report
  • Click the print icon
  • Install the ‘Microsoft SQL Server’ add-on (this will be in a yellow bar at the top of your browser window just below the address bar)  See Image 1 below
  • Go back into reports and open a system report
  • Click the print icon
  • Install the ‘Microsoft SQL Server’

Now you should be able to print custom reports.

Image 1

Image 2

 

In depth view of Job Requests

Job Requests
Job Requests enable users to fill out a form online that when submitted will create a job. Job Requests can be made public so the person filling out the form does not have to be a MarketingPilot user.

Job Request Templates
In order to use job requests users must setup a job request template. Job Request templates consist of three different sections: header, requirements, and the confirmation email.

Header: The header consists of several fields:

  • Active – Shows if the Job Request template is active or not
  • Request Type – Is the name of the template and is what will be displayed to the user to choose.
  • Job Status – Defines what the status is on the resulting job
  • Company – Defines the company of the resulting job. This field can be left blank; if the user is logged into MarketingPilot the job will be created using the company of the user. If the request is being created via the public link, the user will be asked upon submitting the request for the company that should be used if the contact doesn’t already exist in the MarketingPilot.
  • Est. Duration (Days) – Will determine the due date of the resulting job (Today is the start date, if est. duration is 3 days, the due date will be 3 business day from the start date)
  • Report Template – Specify a report that will be generated and attached to the confirmation email when a job is created. (This is a custom report and must be mapped to this page in the database to be used)
  • Report Folder – Where the report is stored once it is generated. (The default is the job folder, but you can also specify the file folder or subfolder if they are defined)
  • Category – Determines which category the Job Request template appears under on the Job Request Menu. (You create the categories under Site – Categories – Job Request Categories)
  • Job Template – Allows you to specify a Job Template to use when creating the new job.
  • File Folder/Subfolder – Allows you to create a folder and subfolder on the files tab of the resulting job. In the requirements section you can allow users to upload a file, you can also specify one of these folders as the destination for the file.
  • File Access – This allows you to set the security of the newly created folder or subfolder for users and/or web portal users. Note: this only changes security for the folder and subfolder only; it will not change the security on the default job folder.
  • Created by – Defines the creator of the job if the request was created using the public link.
  • Description – The information in the description will appear on the Job Request Menu to the right of the template name.

NOTE: The preview icon in the upper right hand corner of the Job Request Template page will allow you to see what your Job Request form will look like without making the user leave the Job Request Template page.

Requirements:
In this section you can define what the user sees when filling out a job request. By default you will see the Contact information section and User Defined Fields section (only if you have Job UDFs that have been activated) in this section. You can arrange these fields to appear in any order by dragging and dropping them. If there are fields in the Contact Information or User Defined Field that you would like to exclude, you can select those fields and delete them, or remove the check from the active checkbox on the right. If you choose to remove fields from the Contact Information or User Defined Fields sections, you can use the show all icon to show the fields you have deactivated. NOTE: The Contact Information fields will only appear on a job request that is being submitted publicly, if a job request is being created within the application the current users contact information is used.

The information collected from the User Defined Fields will populate the User Defined Fields in the resulting job. The information from the Contact Information section will be used to create a new client contact if the email address entered doesn’t match a current contact record. If the email address already exists in the database, the information will not update the existing contact record.

NOTE: All data gathered on a job request will appear in the specifications of the newly created job.

Changing Groups
You can create a new group by defining it in the group field in the New Requirement window, if you don’t enter a group name, it will be added to the (No Group) section. By default the requirements without a group are at the top of the job request. If you want to move a field from the contact information or user defined fields sections, you can click on that field name and change the group name in that window.

  • Making a Field Required – By default the Contact Information fields are required. If you wish to change a field’s required status, you can click on the field you’d like to change and check or uncheck the required checkbox. NOTE: If a field is marked as required and the user does not enter data, the request will not be submitted and a list of the fields that are missing will be listed at the top of the form.
  • Adding Additional Fields – There are 14 types of fields that can be added to a job request template. In order to add a field to the requirements section you click on the new icon. In the window you can control the group in which the field will appear, if the field is required, the name of the field, what type of field it is, and a description of the field. By default the Required and Active fields are checked. TIP: For easier navigation in the requirements section you can collapse the groups and double click on a specific group to expand it by using the expand and collapse icons in the requirements header.
  • Checkbox – This is a true/false field, if marked Required, the box needs to be checked to be valid.
  • Contact – This field allows the requestor to choose a contact for a specific team role. When adding this field you will be required to select the team role that will be used for that contact on the team tab of the new job. NOTE: Job requestors will be able to select any contact in the system.
  • Currency – Holds numeric values in a currency format. If the site is multi-currency, it allows the user to define which currency it is.
  • Date – Holds date information
  • Download File – Allows the user to download a file such as instructions or information that you want the user to have.
  • Job Title – Allows the user to determine what the resulting job name is. If this field isn’t used, the job is given the Job Request Templates name.
  • Multi-Line Text – Allows users to enter multiple lines of text into the Job Request.
  • Need by Date – This allows the user to enter a date in which they need their request processed by. If you have a value in the Est. Duration field, you will see the estimated completion date to the right of this field. If the user enters a date prior to the estimated completion date, they will receive a warning and can continue with the request, or cancel and go back to the request to change date.
  • Number – Holds numeric values.
  • Product – This field allows requestors to choose a product to attach to the job. When setting this field up you are able to select a default product. You can also lock that product so no other products can be added and the selected product cannot be removed. NOTE: Job requestors may be able to select any product in the system.
  • Text – Allows requestors to enter one line of text.
  • Type – Allows requestors to specify the type of request, this field is either single select or multi-select. During setup you can define if the field is single select or multi-select. When setting this field up you also determine the items that will appear in the list.
  • Upload File – Allows requestors to upload files. When setting this field up, you can choose which folder to store the file under if you had defined a File folder/subfolder in the header.
  • Use Job as Template – Allows requestors to use an existing job to fill in information on the job request. Information is pulled in from the user defined fields, as well as the contact field (if they exist on the job), the job title, and products (if they exist on the job). NOTE: When this field is added to a Job Request an additional option appears on active UDFs: ‘Use Job as Template’. This box is checked by default, but can be removed. When removed that field will not be populated from the Job you are using as a Template.

Confirmation Email
A confirmation email is sent to the requestors email address upon the request being submitted, it is sent from the site’s default email address.

Subject

  • Standard – The format of the standard confirmation email subject is: ‘Job Request Confirmed – <Request Name> – Job Code: <Job Code>’
  • Text – This option enables the users to specify a text-only email subject line. (The email subject line cannot be longer than 250 characters).
  • Custom Type 1 – This is a custom subject line that is in the following format: ‘Custom Type 1: <User 8 (Text)> – <Job Title> – Review # <User 2 (Numeric)>’. If you have an enterprise license you can label “Custom Type 1”, “Review”, and “#”.

Body
The information placed in the body field will be displayed at the top of the confirmation email. Following the body is a table that lists all the information specified on the job request giving the requestor a snapshot of the information they entered on the job request.

Attaching a file to a Job Request
Using the Report Template option from the header section you can attach a report to a Job Request confirmation email. When this option is used the report is converted to PDF and attached to the job that was created. By default, the report is attached to the job in the job’s default folder. You can specify the folder you would like the report to be placed in if you have created a file folder or subfolder. This is controlled by the selection in the Report Folder in the header of the Job Request. NOTE: There is not a “standard” MarketingPilot report for job request confirmation. The drop down menu will not contain any options if a custom Job Request Confirmation report hasn’t been created.

Rules
**In order to see this section the site must have an Enterprise license and all of the following UDFs active: 10, 23, 38,40, or 41.  This section allows the user to define multiple Job Templates to be used based on specific criteria. There are two options when using this section: #1 Use the Default Job Template for all Requests and #2 Use the Default Job Template for all Requests that don’t match Criteria. NOTE: If both boxes are checked, the Default Job Template will be used for all requests.

Creating Rules
Rules are processed from top to bottom, if a Job Request meets all the criteria in the rule, then the Job Template specified will be used, if not, it will proceed to the next rule set. If it isn’t specified to use the default Job Template if the Job Request doesn’t match the criteria and the Request doesn’t meet one of the rules, the Requestor will receive the following error ‘The Job Request form cannot be used for these Requirements. Select a different Job Request form and try again, or contact the Administrator.’

Job Request Menu
The Job Request Menu is the page in which all the Job Request Templates are listed. You will see Job Request Templates that do not have a category listed first, and then you will see the different categories. NOTE: When creating the Job Request Categories, you can upload a picture that will be shown on the Job Request Menu as well.

Public Access
In order to allow public access to the job request menu, you must enable that option. To enable public job requests, click on Site, then in the Job Requests Section, check the Public Requests check box. The URL for access the public Job Request Menu is: http://<Your site URL>/JobRequests/ViewJobRequestMenu.aspx, for example: http://marketingpilot.com/JobRequests/ViewJobRequestMenu.aspx

Additional Setup Options
Job Requests also have additional functions that can be setup outside of the Job Request Template.

Site – Jobs & Components

  • Job Request Header – Allows the user to place text on the header of the Job Request Menu.
  • Job Request Footer – Allows the user to place text on the footer of the Job Request Menu.

Custom Request Processing – When enabled, the Requestor will not be able to create a job using the Job Request unless certain criteria are met. The custom rule is: Do not create Jobs from Job Requests that have the same values for User 2 (Numeric), User 8 (Text), and User 9 (Category) as those that already exist except for Jobs that are cancelled, have User 38 (CheckBox) checked, or User 9 (Category) set to: <Option>.

Custom Use Job As Template Processing – When the option to ‘Restrict users from using Jobs without a User 16 (Date)’ is checked, a Requestors will only see jobs in the Use Job as Template field that have a value in User 16 (Date). If that date isn’t populated, the job will not appear in the list.

Reporting Services – Troubleshooting NT Authority\Network Service access denied

Description: If the following message is received in MarketingPilot when running the report:

The permissions granted to user ‘NT AUTHORITY\NETWORK SERVICE’ are insufficient for performing this operation. (rsAccessDenied)

Or in Reporting Services:

screenshot

Check the following:

On the report server open the report manager:  http://localhost/reports

Once you open the report manager you need to add browser rights to the Users group:

  • Click on the Properties tab
  • Click New Role Assignment
  • Type in “Users” to the Group or user name field
  • Select Browser under Roles
  • Click OK

RS Role Assignment

You should end up with at least the following two Security Roles and you should be able to run the report successfully.

RS Role View