DataJoe 4 - How-to Guide
   
    TABLE OF CONTENTS
  IDENTITY MODULE
1.1   DataJoe 4 Orientation
    Defining the Screen Areas
    Defining the Modules
    Understanding the Operating Buttons and Menus
1.2   Managing Users and Privileges
    How to Create, Delete, and Edit Users
    How to View and Assign User Privileges
    How to Add a Mug Shot to a User Profile
1.3   Managing Publication Settings
    How to Edit General Publication Info and Logos
  RESEARCHER MODULE
2.1   Searching the Database
    How to Conduct a Basic Search
    How to Conduct an Advanced (Project-specific) Search
    How to Determine Searchable Fields in Advanced Search
2.2   Maintaining Records
    How to Create a New Record
    How to Delete a Record
    How to Edit Existing Records
2.3   Project Setup Overview
    How to Create a Custom Flag
    How to Create a Group Flag
    How to Create a Normal Condition
    How to Create a Project Condition
    How to Create a Group Condition
2.4   Setting up Ranked Lists and Directories
    How to Create a New Project
    How to Edit an Existing Project
2.5   Managing Database Fields
    Understanding Field Types
    How to Create an Association Holder
    How to Create a Custom Field
    How to Edit a Custom Field
    How to Delete a Custom Field
2.6   Setting up Surveys
    How to Determine and Organize Survey Fields
    How to Format a Survey
    How to Add an Image and/or HTML to the Right Side of a Survey Display
    How to Create Validation Rules for Survey Submissions
2.7   Managing Cover Letters
    How to Create a Cover Letter
    How to Edit a Cover Letter
2.8   Sending out Survey Blasts
    Steps to Take Before Sending a Survey Blast
    How to Send a Survey Blast
    How to Generate a Blank Survey Link
    How to Search withing and Sort the Survey Logs
2.9   Processing Survey Submissions
    Navigating the Submissions Inbox
    How to Review and Edit Survey Submissions
    How to Manage Associations in Survey Submissions
    How to Final and Save Survey Submissions to the Database
    How to Archive Survey Submissions
2.10   Editing the Layout of Ranked Lists and Directories
    How to Edit a Project's Layout
    How to Determine and Organize Layout Fields
    How to Format Cells, Field Labels, and Field Data in Layout
    How to Determine Downloadable Fields
    How to Download Data
2.11   Reviewing Data in BlueLines
    How to Manage Data Views in BlueLines
    How to Edit Data in BlueLines
  DESIGNER MODULE
4.1   Editing Layout in PrePress
    How to View a Project in PrePress
    How to Edit the Published Project's Dimensions
    How to Set Column Width
    How to Create Replacement (Style) Rules
    How to Make Temporary Cosmetic Edits to Data
    How to Make Permanent Cosmetic Edits to Data
4.2   Publishing Ranked Lists and Directories
    How to Download (Export) the Published Project
4.3   Managing Images
    How to Conduct a Basic Image Search
    How to Create a New Image Record
    How to Delete an Image Record
    How to Edit Existing Image Records
  MARKETER MODULE
5.1   Managing E-commerce Settings
    How to Manage General E-commerce Settings
    How to Manage E-commerce Checkout Settings
    How to Manage Customized Access Settings
    How to Manage the End User License Agreement (EULA)
5.2   Customizing the E-commerce Interface
    How to Manage E-commerce Navigation
    How to Manage Remote Authentication Settings
    How to Edit Custom Page Intros
5.3   Managing Prospects
    How to Conduct a Prospect Search
    How to Create a New Prospect Record
    How to Delete a Prospect Record
    How to Edit Existing Prospect Records
    How to Create Super Users
5.4   Creating and Managing Subscriptions
    How to Create a New Subscription
    How to Edit or Delete an Existing Subscription
5.5   Creating and Managing Products
    How to Create a New Dynamic Product
    How to Edit Existing Dynamic Products
    How to Create a New Static Product
    How to Edit Existing Static Products
    How to Associate Products
    How to Create a Product Cross-Promotion
    How to Offer Discount Codes
5.6   Creating and Managing Project Upgrades
    How to Create a Project Upgrade
    How to Edit Existing Project Upgrades
    How to Upload an Image and Add it to a Company Record
    How to Check the Size of an Image
5.7   Tracking Transactions
    How to Search Track Transactions
    How to Search Transactions in the Submissions Box
    Understanding Order Details and Issuing Refunds
    How to View and Download Sales Data
    Appendix A: Sub-projects
    Appendix B: Inner-Projects
    Appendix C: Project Packages
    Appendix D: Import Tool Guide
    Appendix E: Combination Tool Guide

 

  IDENTITY MODULE
1.1   DataJoe 4 Orientation
   

DataJoe is a complete data management system. Our clients use DataJoe to manage data, send digital surveys, publish in print-ready formats, publish data seamlessly to their Web sites, and sell data through a turnkey e-commerce system.

DataJoe is especially used for managing and producing regional Books of Lists, industry ranked lists, and editorial directories.

DataJoe is compatible only with the Mozilla Firefox web browser. Firefox can be downloaded online at no charge. Only one browser window of DataJoe can be open at a time on the same computer.

    Defining the Screen Areas
   

Header Area: The header area at the top of the screen contains links to the different modules of the system and the blue Object and green Action buttons. This section stays the same no matter where you go in DataJoe.
Manager Area: Located on the left-hand side of the screen, the manager gives you access to projects, flags, fields, conditions, and records in the system that you'll use in building projects and e-commerce products.
Content Area: The content area displays the content you are managing, such as records, projects, or survey blasts. This is where you will see your results based on the actions you perform with the buttons in the header and manager areas.

   
    Defining the Modules
 

Manage user profiles, create new users, and manage user privileges in the Identity Module. Record Type: User.

 

Manage records, projects, and surveys within the Researcher Module, and prepare ranked lists and directories for publication. Record Types: Company, Person, Thing, Prospect.

  Manage articles, lists of prospects, and nominations in the Reporter Module. Record Types: Article, Filing, Prospect.
  Manage images and layout, and publish projects in several formats in the Designer Module. Record Type: Image.
  Manage products and e-commerce settings in the Marketer Module, and then track your data and product sales. Record Type: Prospect.
    Understanding the Operating Buttons and Menus
    Object Buttons
 

Projects/Products: Click this button to access a list of all current projects in the Researcher Module or all products in the Marketer Module.

  Submissions/Purchases: Click this button to review and process your electronic survey submissions in the Researcher Module. Within the Marketer Module, this button will take you to a list of purchases made on your e-commerce site.
  Records: This button allows you to select record types to work with in the system. There are multiple record types depending on the module in which you are working.
 

Record Selector: The selector allows you to indicate which record type you wish to manage. Records available to manage differ depending on the module in which you are working.

    Project Selector
    Project Selector: This menu works together with the blue Records button and the green action buttons to commit searches and actions against the database. The Project Selector is the lens through which you might view an object. Search for records within a specific project (list or directory), or search across the entire database by choosing “No project selected.”
    Action Buttons
 

Search: Coordinate this button with the Object buttons and Project Selector to commit a specific records search of the database.

 

Create: Use this button in coordination with the Object buttons to create new records, projects, and products within the database.

 

Delete: Use this button to delete selected objects.  You can select more than one object and batch-delete.

 

Survey: Use this button to send out automated blasts of surveys to a selected group of recipients via e-mail and/or fax.

 

Download (Export): Use this button to export data and projects in a variety of formats, including Excel, CSV, PDF, HTML, Word, Text, and Quark XPress Tags.

  Publish: This button will take you to the publishing stages (BlueLines and PrePress), where projects can be formatted for publication.
    Admin Buttons
 

Advanced Tools: The Advanced Tools available to you will depend on which module you have selected. Within the Researcher Module, you will find many tools for data management. Within the Marketer Module, you will find many options for managing your e-commerce.

  Help Guide: Click this button to make the Help Guide pop up on your screen. As you scroll over buttons, the Help Guide will tell you what they do. 
    Manager Buttons
  Project/Product Manager: Use the Project/Product Manager to select projects or products, depending on the module in which you’re working, and load them into your content area or go directly to their setup.
  Flag Manager: Use the Flag Manager to create, edit, and delete flags, and load them into project criteria, conduct a search, or attach them to records.
  Field Manager: Use the Field Manager to create, edit, and delete fields, and to load them into your projects.
  Condition Manager: Use the Condition Manager to create, edit, and delete conditions, and to load them into record searches or project criteria.
  Record Manager: Use the Record Manager to search, create, and edit records within your database and associate them with other records. Types of records available to manage vary depending on the module in which you are working (see “Defining the Modules”).
  Create: Click this to create a new flag, field, or condition, depending on which is selected (and of what type) in the Manager Area.
  Edit: Click this button to edit the settings of the selected flag, field, or condition. Standard fields cannot be edited.
  Delete: Click this to delete the selected flag, field or condition. Standard fields, and flags and fields being used in a project cannot be deleted.
  Info: Click this to see which projects and how many records are using the selected flag, field, or condition.
    Last Result and Logout
 

Last Result: On the left-hand side of the bar, you’ll see an arrow with text that tells you what your last result was in the system—either a result set of records or a view of a project in BlueLines. Clicking this link will take you back to that result.

 

Logout: Click Logout to log out of the system when you are finished working in DataJoe.

  Back to top
1.2   Managing Users and Privileges
    The DataJoe Identity Module  allows administrators to manage user profiles. Administrators can assign login names and passwords to users, upload user “mug shots,” and manage user privileges
   
    How to Create, Delete, and Edit Users
   

Create User: To create a user, administrators can click the green Create button , and enter the new user’s name, e-mail address and password (must be 6 characters). Click Submit .

   

Delete User: To delete a user, administrators can pull up a list of users by clicking the green Search button , highlighting the user you wish to delete, and clicking the green Delete button . Click Submit . Note: DataJoe does not recommend deleting users, so that their histories stay present in record logs. Instead, change their passwords and/or eliminate all but one privilege.

   

Edit User: To edit a user’s profile, administrators can pull up a list of users and click on the green Edit button . Here, you can change the user’s user name, password, and privileges. When you are finished, click Submit .

    How to View and Assign User Privileges
    Users who are not administrators can only view their privileges, not edit them. Only administrators can change privileges.
  1. Go to the Identity Module .
  2. Search  for the user and click the Edit button  next to the user’s name.
  3. Locate the Privileges area.
  4. Click the gray triangle next to the module for which you want to view privileges (Researcher, Reporter, etc.).
   
  5. Assign the appropriate privileges for this user in each module, or specify which projects this user has access to by loading them from the Project Manager .
   
  6. Click Submit .
    How to Add a Mug Shot to a User Profile
    A mug shot is a personal photo associated with a user account.
  1. Begin by saving the image to your desktop or documents. The recommended pixel size is 190px by 190px.
  2. Select the Identity Module .
  3. In the Manager Area, click the Record Manager  and select Image Manager.
   
  4. Click on the purple Create button . Name, browse for, and upload the image.
  5. Be sure the appropriate user profile is selected in the Content Area, and load the image into the mug shot window.
  6. Click Submit .
    Back to top
1.3   Managing Publication Settings
    To set and manage general publication settings, such as your publication’s logo and contact information, which will appear in your surveys and cover letters, you will need to go to Advanced Tools  within the Identity Module .
    How to Edit General Publication Information and Logos
  1. In the Identity Module , go to Advanced Tools  and “General Settings."
  2. Enter or edit the publication’s name and contact information.
  3. To include a logo on your cover letters and surveys, upload one into the Image Manager (follow the same steps for “How to add a mug shot to a user profile”) and load it into the Standard logo box. Recommended logo size is 250 pixels wide.
  4. Click Save .
   
    Back to top

 

  RESEARCHER MODULE
2.1   Searching the Database
   

Four types of records exist within the Researcher Module: company, person, thing, and prospect. Things are records that are often associated with company records, such as shopping malls (associated with management companies) and construction projects (associated with contractors). Prospects are contacts who surveys should be sent to for specific projects (lists and directories).
You can search for the Basic Details of a record, which will pull up all of the data associated with that record in your database, or you can search for the Advanced Details of a record, or only the data associated with that record within a specific project (list or directory). Several different criteria can be used to generate search results. See section 4.3 for how to manage image records.

    How to Conduct a Basic Search
  1. Click on the Record button . Use the Record Selector  to select which type of record to search for.
  2. Be sure the Project Selector is clear  so your search crosses the whole database.
  3. Be sure the Search button  is selected.
  4. In the Search screen, type in or load the search criteria and click Search .
  5. To search using a flag, click on the Flag Manager button . Highlight the appropriate flag in the manager, and click the Load button in the Flags search box. Click Search
   
  6. To search using a condition, click on the Condition Manager button . Highlight the appropriate condition in the manager, and click the Load button  in the Conditions search box. Click Search .
   
  7. Once you have generated a Result set of records, you can view and edit the Basic Details of any record by clicking on the Edit icon  next to the record name.
   
  8. You can navigate through a result set of records by using the arrows at the top of the content area (click on the purple number to insert your own starting record number).
    How to Conduct an Advanced (Project-Specific) Search
  1. Click on the Record button . Use the Record Selector  to select which type of record to search for.
  2. Be sure the project you are working within is selected in the Project Selector  so your search results in only records that meet criteria for the specific project.
  3. Be sure the Search button  is selected.
  4. In the Search screen, type in search criteria and click Search .
  5. Once you have generated a Result set of records, you can view and edit the Advanced Details of any record by clicking on the Edit button  next to the record name.
    How to Determine Searchable Fields in Advanced Search
    Your Advanced Search page for any given project will at first contain only one searchable field (ex: Company name, for company projects). You may set any project’s Advanced Search page to contain more searchable fields. Any of the fields in the project’s survey can be made searchable.
  1. In the Researcher Module , click on the Projects button .
  2. Click on the Edit pencil  next to the name of the project.
  3. Go to the Optional Settings step of the project’s setup.
  4. Click on the Searchable Fields toggle.
  5. You will see a box containing all of the fields that are contained in the project’s survey. Unless you change it, the only field selected as searchable (meaning it appears on your Advanced Search page for that project) will be Company name (if it is a company project). For person projects, First name and Last name will be checked; for thing projects, Thing name will be checked.
  6. You can check any other fields that you would like to make searchable on that project’s Advanced Search page.
    Note: Any selections you make under Searchable Fields also dictate which fields will be available for subscribers to search on your E-commerce site, if you allow the search function.
   
  7. You may select or unselect all fields by clicking “Select all/Unselect all” underneath the window.
    Note: Survey contact fields should never be made searchable online.
  8. You may change the label of a field by clicking on it. A purple box will appear where you can type the new label.
   
  9. Click Save .
    Back to top
2.2   Maintaining Records
   

DataJoe is a complete data management system, which means that you can create and delete records as well as edit and update existing records in many fashions. The records available to maintain depend on the module within which you are working (see “Defining the Modules”).
Records can be created in Basic Details, meaning the record will not yet be associated with any project, or Advanced Details, which means the record will automatically be flagged for (meet criteria for) whichever project is selected in the Project Selector. Records can also be created in the Record Manager.

    How to Create a New Record
    In Basic Details:
  1. Click on the Record button . Use the Record Selector  to select which type of record to create. Be sure that the Project Selector is clear .
  2. Click the Create button . You will be directed to a blank form.
  3. Enter any Standard data you currently have about this record. Standard data fields are those that are standard to the type of record with which you are working (e.g., standard data fields for company records include company name, address, corporate contact, and status).  
    Note: The record name field is red, which means that field is required in order to save the record.
  4. Associate people and/or survey contacts to the record by creating or locating them in the Record Manager  and loading  them into the appropriate association box in your new record. People associations are loaded using the Person Manager. Survey contact associations are loaded using the Prospect Manager.
   
   

Within person associations, you can specify the start year and end year that person worked at a company. Records of people who no longer work at a company will be retained in the database and remain associated with the company record, but those people will no longer be included in your published lists and directories, or online.
You can specify that a survey contact be used when surveys are sent for a specific project or projects by loading the project from the Project Manager  into the Preferred Contact box. Otherwise, survey contacts will be sent surveys any time this record is surveyed for a project.

   
   

When a record has more than one survey contact, each contact will receive a survey every time this record is surveyed unless you specify otherwise.

    Note: Person and Prospect records are distinct and must be created separately.
  5. Associate a flag to the record by loading it from the Flag Manager . Flags are a way to identify and categorize records and are discussed more in section 2.3.
   
  6. You can add a footnote to any data field within this record by clicking on the Footnote button  adjacent to that field. This footnote will appear on your printed projects.
  7. Save  the new record.    
    In Advanced Details:
  1. Click on the Record button . Use the Record Selector  to select which type of record to create. Be sure to select the appropriate project in the Project Selector .
  2. Click the Create button . You will be directed to a blank form.
  3. Enter any standard data you have for this record as well as any of the custom fields associated with this project.
   
  4. You can also associate other records (person, prospect, etc.) to this record in Advanced Details using the Record Manager  (see Create a record in Basic Details).
  5. You can now Final this record before saving it, which tells the database that this record’s data is complete for this project for this year, and that this record should not be surveyed for this project this year. Finaling a record also tells the database that this record’s data for this project is ready to appear in your published list or directory and on your e-commerce site (see the Marketer Module How-to Guide).
   
  6. Save  the record. Saving a record in Advanced Details automatically assigns the record any flags that are associated with this project (see section 2.3).
    In the Record Manager:
  1. Click on the Record Manager button .
  2. Select the appropriate manager for the type of record you would like to create (company, person, thing, prospect, or image).
  3. First search to make sure the record does not already exist in your database.
  4. Enter the name and any other applicable information (city and state for company records) and click Create .
   
    How to Delete a Record
  1. To delete a record in your database, conduct either a Basic Search or an Advanced Search for that record.
  2. Highlight the record by clicking on or near the record name (it will appear in green). Click the Delete button  in the Header Area.
   
   

You may also click the Edit icon next to the record’s name. Then, click the purple Delete button  at the bottom of the record.

    Note: In many cases, DataJoe does not recommend that you delete records. If you learn that a company is out of business, you may go into that company's Basic Details and select "No" under Status/Currently Operating. Assuming you have the In Business condition on all of your company projects, this will prohibit the company record from being surveyed or published while preserving the company's historic data within your database.
    How to Edit Existing Records
  1. To edit a record in your database, conduct either a Basic Search or an Advanced Search for that record.
  2. Click the Edit icon next to the record’s name once it appears in the result set.
  3. Add data, associations, flags, and/or footnotes to the record, and final if appropriate.
  4. Add internal Notes to the record by clicking the Notes button at the top of the record details.
  5. To view a history of all edits made to the record, click the Logs button  at the top of the record details.
  6. Print the record’s details by clicking the Printer-Friendly button .
  7. To navigate through and edit several records within a result set, use the navigation arrows at the top of the content area. The purple arrows will take you to the previous or next record, while the green arrows will allow you to save any changes made to the record before moving to the previous or next record.
    Back to top
2.3   Project Setup Overview
    Project Setup is the process through which you create and edit ranked lists and directories, or Projects. Database flags and conditions are used as the criteria that determine which records are included in each project. You are also able to determine which fields are included in each project and format how the data will be displayed in the survey and the published layout. Each project is customizable and can be published in a variety of formats. Projects can also be made into Products sold through the Marketer Module .
    Project Setup includes four steps: Setup, Survey, Layout, and Optional Settings.               
    Note: Project Setup guidelines for sub-projects, inner-projects, and packaged projects can be found in the Appendices to this manual.
    How to Create a Custom Flag
  1. Click on the Flag Manager button .
  2. Be sure "Custom" is selected in the Type menu.
  3. Click the purple Create button  in the Manager.
  4. Name the flag. You may also give it a description or designate it Hide from Public, making it see internally only. (Otherwise, custom flags can be displayed as search criteria on your E-commerce site).
  5. Click Save .
    How to Create a Group Flag
    A group flag can contain several of the custom flags in your database. When using a group flag as a search or project criteria, you are telling DataJoe that a record containing ANY of the flags in the group should be included.
  1. Click on the Flag Manager button .
  2. Choose “Group” in the Type menu.
  3. Click the purple Create button  in the Manager.
  4. Name the flag. Scan the list of available flags (custom flags) and load the desired flags into the Selected flag(s) box.
  5. You may give the flag group a different display label in the Label field.
  6. Click Save .
    Note: You can build a value list off of a flag group (see section 2.5) to put on your surveys. When a survey recipient selects one or more of the values in the value list, their record will be assigned that flag(s) in your database.
    How to Create a Normal Condition
  1. Click on the Condition Manager button .
  2. Be sure the correct Record Type is selected (company, person, etc.).
  3. Be sure "Normal" is selected in the Type menu.
  4. Click the purple Create button  in the Manager.
  5. Name the condition.
  6. Choose which Field Type off of which to build the condition.
  7. Choose the field you will use to build the condition.
   
    (The use of this condition would pull up a result set of all companies who are located in the city of Denver.)
  8. Tell DataJoe whether the value in that field should be equal to, not equal to, like, or not like the value you provide, or if the field is blank or not blank.
  9. Click Save .
    How to Create a Project Condition
   

Create a project condition to pull up a result set of records from another project to use in a new project.

  1. Click on the Condition Manager button .
  2. Be sure the correct Record Type is selected (company, person, etc.).
  3. Choose "Project" in the Type menu.
  4. Click the purple Create button  in the Manager.
  5. Name the condition.
  6. Choose the project from which you want to generate the result set.
  7. Choose the project year from which you want finaled records.
  8. Save .
    How to Create a Group Condition
    Create a group condition to pull up a result set of records that meet the criteria for ANY condition included in the group.
  1. Click on the Condition Manager button .
  2. Be sure the correct Record Type is selected (company, person, etc.).
  3. Choose Group in the Type menu.
  4. Click the purple Create button  in the Manager.
  5. Name the condition.
  6. Choose the available conditions from which you want to generate the result set and load them into the “Included Conditions” box.
  7. Save .
    Back to top
2.4   Setting up Ranked Lists and Directories
   

The two main types of projects in DataJoe are Ranked Lists and Directories. Ranked lists are comprised of data displayed in a chart-like format and ranked by selected field(s). Lists can be exported out of DataJoe for print and/or for sale online in HTML, PDF, and spreadsheet formats.
Directories are comprised of data displayed in a vertical layout and sectioned into categories of your determination. Directories can be exported out of DataJoe into Microsoft Word and spreadsheet documents and can be sold online in HTML, Word, and spreadsheet downloads. Ask DataJoe about the potential for Quark- and InDeisgn-tagged text exports.

    How to Create a New Project
  1. Click on the Projects button  in the Header Area.  Your current list of projects will appear.
  2. Click on the Create button  in the Header Area.
  3. Select the Project Type (ranked list or directory).
  4. Enter the project’s name (this name will be used internally only), specify the Record Type that should be included (company, person, or thing), select the Project Year (generally the current year), and establish the project’s criteria by loading flags and/or conditions from the Flag Manager  and Condition Manager  (see section 2.3 for how to create flags and conditions).
   
   

Associating a flag with a project tells DataJoe that only companies   
with that flag are allowed to be included in this project. Associating a
condition with a project further narrows the criteria for records that will
be included in that project. For example, loading the Architectural Firms
flag into the Architectural Firms list limits the list to companies with that
flag. Loading the condition “In Business” to that same project further  
limits the criteria to allow only architectural firms that are still operating
to be included in the project.

  5. Under E-commerce Access, you can control this project’s E-commerce settings, including the Latest Year Published (the latest data that should be available to E-commerce customers) and which records to Include (all records meeting project criteria or finaled records only).
    Note: Until you have published a project for the current year, you may want to set Latest Year Published at the previous year.
  6. You can now Save  the project or click Next  to save and move on to the next step in Project Setup, Survey.
    Note: You can also create a new project by opening the Project Setup of an existing project and clicking the Save As button in the Setup step of Project setup. This will duplicate all of the project’s criteria, survey setup, and layout, and then you can add to and edit any of the project’s settings.
    How to Edit an Existing Project
  1. Click on the Projects button .  Your current list of projects will appear.
  2. Click the Edit button  next to the name of the project you wish to edit. See sections 2.5 and 2.6 for instructions on managing fields and setting up the survey.
  3. Be sure to click Save  when you are finished editing.
    Back to top
2.5   Managing Database Fields
    A field is a category for data in the database. By managing fields, you are able to customize and manage your database. You are able to create, edit, and delete fields for each of your projects. Examples of database fields include “Company name” and “Number of Employees.” A field can be used in multiple projects, and should be whenever possible. Fields are created, edited and deleted in the Field Manager .
    There are six Field Record Types in the database: Company, Person, Thing, Prospect, Image, and Article (available to clients using Reporter Module ).
   
   

Fields are categorized by Record Type, then by Type (Standard, Association, and Custom). Each Record Type has record-specific fields. For example, company fields are those related to company records—Company name, address, etc. Person fields are those related to person records—First Name, Last Name, Birth Date, etc.

   
    Understanding Field Types
   

Standard Fields: Standard fields are used for general information common to all records within each record type. For example, company standard fields include company name, street address, phone, and website. Standard fields can’t be created, edited, or deleted by users. Use standard fields in your projects whenever possible; avoid creating custom fields that would serve the same purpose.

   

Association “Zones”: Association zones are holders that allow you to associate records of different types to one another (i.e., people in charge with companies, companies with parent companies, or things with management companies) within survyes. The ability to associate records with one another is a very powerful tool and helps to ensure a clean database. For instance, when a company receives a survey and updates data for a person associated with that company, that person’s record is also updated with the database.
Common association holders such as Person in Charge, Key Contact, Parent Company, and Survey Contact are already included in the DataJoe database, but you can create other association holders that are unique to your projects.

   

Custom Fields: If a field doesn’t already exist as a standard field or association field, you can create it as a custom field. The ability to create a custom field is one of the most powerful functions a DataJoe user possesses. You can create a variety of custom field types, including:

   
  • Text Field: Small field for text. You may place a character limit on a text field.
  • Text Block: Larger field for text. You may place a character limit on a text block.
  • Numeric Field: For numbers, commas, and decimal places only.
  • Percent Field: For numbers and decimal points only. Appears with a % sign in layout.
  • Currency Field: For numbers, commas, and decimals points only. Appears with a $ in layout.
  • Yes/No Field: Limits a survey recipient’s response to Yes or No.
  • Value List: A set of pre-determined responses you set up to limit a survey recipient’s responses to a question. Appears as a series of             
    radial buttons or checkboxes. You can choose to allow multiple             
    selections or limit to one.
    Value lists can also be built off of flag groups. When survey
    recipients select values in a Value List Flag Field, the companies
    they represent are automatically assigned those flags within your
    database. See more about group flags in section 2.3.
  • Calculation Field: Can calculate the result of two or more custom numeric, percentage, or currency fields. For example, you could  
    create a calculation to find the percent revenue growth from 2010
    to 2011 for companies in a project. This field is automatically
    calculated and cannot be edited by a survey recipient.
  • Date/Time Field: Limits your recipients to entering only one date in a specified format.
   

Custom Fields can be Fixed Across Years, meaning the data will stay the same from year to year unless a survey recipient edits it (for example, Industry Specialties), or not Fixed Across Years, meaning you assume that the data will change each year and you want to keep a record of historical data in your database (for example, Number of Employees).

    Note: Changing a field from fixed across years to not fixed across years, or vice versa, once it has data populating it can result in a loss of data. If you want to do this, please contact DataJoe.
   
   

Designating a field as Hide from Public means this field will never be downloaded by a public user on the e-commerce side or seen through an e-commerce search page.
Marking a field for Internal Use Only means the field will be viewable by any administrator working in DataJoe but not by any user on the public side, including survey recipients. This way, you would be able to see a field on the survey, but the survey recipient would not. All Internal Use Only fields are always designated as Hide from Public.

    How to Create and Association Holder
   

Common association zone holders such as Person in Charge, Key Contact, Parent Company, and Management Company are already included in the DataJoe database, but you are able to create additional association holders.

  1. Click on the Field Manager button .
  2. Select the appropriate record type (company, person, or thing). The record type you select should match the type of project you are working in. If you are working in a list of companies, you will select “Company,” and the new association will be attached to company records.
  3. Select “Association” for the field type.
   
  4. Click on the purple Create button  to create a new association.
  5. Select whether this will be a company, person, thing, prospect, or image holder. For example, if you are creating a new association holder called “Golf pro,” you will select “Person Holder.”
  6. Type in the name of the new association holder and hit Save .
    Note: You can create detailed association holders within your surveys. Information contained within an association holder will automatically update the associated record contained within the association holder. For example, a survey recipient would be able to load several parent companies into the Parent Company association holder and survey for detailed information about those parent companies when surveying for the primary company record. See section 2.6 for how to set up an association holder in a survey.
    How to Create a Custom Field
    Before creating a new custom field, always search your existing custom fields to ensure that the field does not already exist in your database. You can right click in the Fields box and begin typing the name of the field and see if anything similar pops up. You can also use the Filter Fields link in the Field Manager to narrow down your search by field type or fields used within a certain project.
  1. Click on the Field Manager button .
  2. Select the appropriate record type (company, person, or thing). The record type you select should match the type of project you are working in. If you are working in a list of companies, you will select “Company.”
  3. Select “Custom” for the field type.
   
  4. Click on the purple Create button  to create a new custom field.
  5. Select the type of custom field you would like to use (Numeric, Text, Yes/No, etc.). This is a very important determination. Note that DataJoe can only rank numerically off of data that is in a Numeric, Currency, or Percentage field.
  6. Designate whether the field should be Fixed across years.
    Note: This determination is very important. It is difficult to change this later and could result in loss of data. Call DataJoe if you decide to do this.
  7. Type in the name of the new custom field and hit Save .
    Note: When naming new custom fields, DataJoe recommends that you use a pre-determined organizational system to make searching for and sorting through fields easier in the future. For instance, you can begin the name of all numeric fields with “No.” + the name of the field, and you can begin the names of all Yes/No fields with “Y/N” + the name of the field. This will also help other DataJoe users more easily locate existing fields and avoid creating duplicate fields.
    How to Edit a Custom Field
   

Note: Use caution when editing custom fields. Switching field types (for example, from text to numeric) could corrupt your data because you cannot store text in a numeric field. Contact DataJoe if you would like to do this or switch a field’s designation as Fixed Across Years.

  1. Click on the Field Manager button .
  2. Select the appropriate record type (company, person, or thing).
  3. Select “Custom” for the field type.
  4. Locate the name of the custom field, highlight it, and click the purple Edit button  within the Manager.
  5. Make the change and click Save .
    How to Delete a Custom Field
    Note: Use caution when deleting fields. Once deleted, you cannot recover them or the data that populated them. DataJoe will not allow you to delete fields that are being used in any of your projects. 
  1. Click on the Field Manager button .
  2. Select the appropriate record type (company, person, or thing).
  3. Select “Custom” for the field type.
  4. Locate the name of the custom field and click the purple Delete button .
  5. If the field is being used in any of your surveys, you will get a message telling you DataJoe is unable to delete the field. Otherwise, DataJoe will ask you if you are sure you want to delete the field. Click "Yes."
    Back to top
2.6   Setting up Surveys
    Once you have completed the Project Setup (see section 2.4) stage of a new project and determined which Database Fields (see section 2.5) you will use and/or created new custom fields, you can move on to the Survey stage of project setup. The survey includes all of the fields you will include in the project’s layout as well as any others that you want to use internally. A project’s survey also determines the fields and formatting that will appear for a record’s Advanced Details page.
    How to Determine and Organize Survey Fields
  1. To get to Project setup, click on the Projects button .  Your current list of projects will appear.
  2. Click on the Edit button  next to the project’s name.
  3. Go to the Survey stage of project setup . In a new project, you will see a blank box.
  4. In the Manager Area, select the Field Manager .
  5. Highlight a field in the manager that you want to include in your survey. Using the white arrows to the left of the Survey box, begin inserting fields into your survey. In a list or directory of companies, the standard field “Company name” is required in your survey. The same goes for the “First name” and “Last name” fields in a person project and “Thing name” in a thing project.
   
  6. Insert all of the Standard fields you would like to include in your survey by highlighting the field in the manager and using the Insert Above or Insert Below arrows.
  7. Switch the field Type in the Field Manager  to Custom, and insert any custom fields you would like to include in your survey.
    For example, to include the Person in Charge association holder in your survey, you will first insert the Person in Charge association zone (the zone will be shaded pink). Then, you will switch your Record Type to Person to establish which fields related to Person in Charge you would like to include (First Name, Last Name, Title, etc.). When you are finished populating the association zone, switch your Record Type back to Company.
    Note: The Survey Contact association holder, including prospect first name, last name, and email, must be included in a survey before you are able to send out a survey blast.
   
    How to Format a Survey
  1. Once you have inserted all of the desired fields into your survey, you have many options for formatting the survey, and you can preview what the survey will look like from a recipient’s point of view.
   
    Once you have added all of your fields to your survey and formatted them, view the survey Preview  to get a rough HTML view of what the survey will look like. You can make organizational and cosmetic edits in the Preview. Click Preview  again to return to survey setup.
   
    How to Add an Image and/or HTML to the Right Side of the Survey Display
    You can customize the way a survey displays by adding images and/or HTML to the right-hand side of the survey itself. Here, you can place ads and/or links to your website.
   

Note: Recommended max image width is 185 px.

  1. Be sure you are in the Marketer Module .
  2. Click on Advanced Tools .
  3. Click on “E-commerce Settings.”
  4. Click on the Checkout Settings toggle.
  5. If you are entering HTML, do so in the “Checkout/Survey HTML - right:” field.
  6. If you are uploading an image, have the image saved and ready to upload (see section 4.3 on Managing Images), upload and/or locate it in the Image Manager.
   
  7. Click on the image name so that it is highlighted in gray.
  8. Load  the image into the “E-commerce banner – right:” box.
  9. Save.
    How to Create Validation Rules for Survey Submissions
    A Validation Rule dictates how a survey recipient must fill in certain fields on a survey in order to be able to submit it. For example, if a survey has four percentage fields in it, you can create a Validation Rule stating that the numbers in each of those four fields must add up to 100 before a respondent can submit a survey.
  1. Click on the Projects button .
  2. Locate the project, and click on the Edit pencil  adjacent to its name.
  3. Go to the Optional Settings step of Project setup.
  4. Click on the Validation Rules toggle .
  5. Click “Add.”
  6. In the “Build Validation Rule” box, use the field drop-down menu to insert the desired fields in the box below using the arrow . Use the mathematical symbol and logic buttons to create the rule. In this example, % Industrial + % Office + % Residential + % Retail square footage must equal 100.
   
  7. In this example, if the home builder indicates that any percentage of their work greater than zero is new builds, they must enter figures into the % custom and % spec fields that add up to 100.
   
  8. Click "Apply." If your rule has been properly formatted, you will get a message to that effect.
  9. Click "Done."
  10. Name the Validation Rule and type the Alert message a survey recipient should receive if he or she tries to submit a survey without following this Validation Rule.
  11. Click Save .
   
    Back to top
2.7   Managing Cover Letters
   

A Cover Letter is a letter sent out with the survey blast via fax or email. In a fax blast, the cover letter is the first page of the fax received. In an email, the cover letter appears in the body of the email when it is opened by the recipient.
You can create a cover letter template to be used with one or multiple surveys. Cover letters can include images and logos, use a Rich Text HTML Editor, and utilize merge fields to minimize adjustments on a survey-to-survey basis.

    Note: Do not copy text from Microsoft Word into the Cover Letter Builder. Copying from Word to a web-based platform often results in formatting errors.
    How to Create a Cover Letter
  1. Before creating a new cover letter, be sure to fill in the Merge Fields under the Optional Settings step of project setup. This must be compelted on a project-by-project basis.
   
  1. Click on the Advanced Tools button .
  2. Click on the words Cover Letter Builder.
  3. Name your cover letter. Remember, cover letters can be generic enough to use for several different surveys, or they can be specific to one survey. Survey recipients will not see the name of your cover letter.
  4. Use the Image Manager  to load any images or logos to your cover letter. See section 1.2 for instructions on how to upload an image into DataJoe.
   
  5. Compose the body of your cover letter. Integrate the Merge Fields listed at the bottom of the screen to cut down on future edits. Data in merge fields pulls from Optional Settings in Project setup and from General Settings (under Advanced Tools  in the Identity Module ).
   
   
  6. Use the formatting tools to customize the appearance of your cover letter. Formatting options are similar to Microsoft Word.
  7. Use the Spam analyzer to check for language in your cover letter that might be mislabeled as “spam-related” and blocked by recipients’ spam filters.
  8. Save .
    How to Edit a Cover Letter
  1. Go to Advanced Tools  in the Researcher Module  and click on the name of the cover letter you would like to edit under Cover Letter Builder.
  2. Make any applicable edits (see “How to Create a Cover Letter”). These edits will be permanent.
  3. Click Save .
    Back to top
2.8   Sending out Survey Blasts
   

Sending successful blasts depends on several factors. Before sending the blast, verify accuracy in your Project setup, prepare an appropriate cover letter, and ensure that each record that will be included in the blast contains survey contact information.

    Steps to Take before Sending a Survey Blast
  1. Verify that you have selected the correct Project year in Project setup. Project year should be set to the year in which the list will initially publish in the publication.
   
  2. Be sure the Merge Fields under the Optional Settings step of Project setup are populated and updated.
   
  3. Determine whether you want to allow “Save-as-you-go” survey submissions, which allows the survey recipient to enter data into the survey and save it, and then come back later and complete and submit the survey. This determination is made under the project’s Optional Settings , “Survey settings.”
   
  4. Double check your Cover Letter to ensure it is ready to be sent by clicking on Advanced Tools  and clicking on the name of the cover letter you plan to use. (Clicking on “Cover Letter Builder” will take you to a blank template to create a new cover letter.)
   
  5. Double check your Survey to ensure that it is set up to your satisfaction, including the Survey contact association holder and related prospect fields.
  6. Gather the correct result set of records to survey by selecting the correct project in your Project Selector , selecting the Records button , and conducting a Search . To pull up all records included in the project, do not fill in any search criteria, and click Search .
   
  7. Once you have generated your result set of records, scan the records to ensure each one has a survey contact email address or fax number, but preferably also has a survey contact name.
  8. Survey contacts (called Prospects) can be created and loaded to records from the Prospect Manager. Always search to see if a prospect already exists in your database before creating a new prospect.
   
  9. Load  the prospect into the Survey contact box in the record details. Be sure the email and/or fax field is populated or a survey WILL NOT BE SENT for this record. If a record has more than one survey contact, the survey will be sent to each contact, unless one contact is designated a preferred contact for this project.
   
  10. Click Save .
    How to Send a Survey Blast
  1. Gather the correct result set of records to survey by selecting the correct project in your Project Selector , selecting the Records button , and conducting a Search . To pull up all records included in the project, do not fill in any search criteria, and click Search .
  2. Click the Survey button . This will pull up your result set’s survey contact information. In the image below of a survey result set for a Person project, the first two records have no survey contact information, meaning a survey will not be sent for those records. The third record has a survey contact email address; the checkmark denotes that a survey will be sent to that email address. If the box had appeared unchecked, that would mean that the record is already finaled for this survey this year and will not be sent another survey.
  3. Choose the correct Cover letter in the “Which cover letter?” menu.
  4. Double check the year appearing in the “For what year?” menu.  If the year is incorrect, you will need to return to Project setup and select the correct project year.
  5. To add survey contact data to one of the records that currently has none, click on the Edit pencil next to the record’s name to edit the survey contact data in the record’s Advanced Details (project-specific fields). Save the record and hit the Survey button again.
  6. You can manually deselect prospects from receiving a survey in this blast by un-checking the box next to their names. You can also “Select all” records to survey by clicking that button.
   
  7. When you are satisfied with your result set, click “Edit” on the top menu or click Next  at the bottom.
  8. Here, you can make several selections for your survey blast:
   

Subject: The text appearing here is pulling from the project name you listed in Merge Fields under Optional Settings in Project setup. This text will appear in the subject line of the emails you send out. You can edit this here.
Survey Format: Your selection here tells DataJoe which type(s) of surveys to send. Selecting “Emails & Faxes” tells DataJoe to first send the survey to a record’s survey contact email address, and then to the fax number if no email address is available. It will not send both to one record.
Selecting “Emails” tells DataJoe to send surveys only to contacts with email addresses. Selecting “Faxes” tells DataJoe to send surveys only to fax numbers.
From Name: This field is pulling data from Merge Fields in Optional Settings. This name will appear in the survey recipients’ inbox. You can edit this here.
From Address: This field is pulling data from Merge Fields in Optional Settings. This email address will appear in the survey recipients’ inbox. You can edit this here.
Test Recipient: Edit this email address to tell DataJoe where to send a test survey.
Send Simple text e-mails: Selecting this option will send your surveys with no Rich Text formatting in the cover letter (no images, colors, or special text formatting). Sending a survey blast with simple text only may result in a higher rate of delivery.
"Opened" log triggered only when submit link clicked: Selecting this option will give you an “opened” status in the survey logs only when the recipient clicks the “Submit Data Now” button to fill out the survey. Otherwise, the “opened” status will be given when the recipient simply views the email message.

   
  9. You can make cosmetic edit to the cover letter for this blast only. To make permanent edits or create a new cover letter, you will need to leave the survey process and go back into the Cover Letter Builder under Advanced Tools .
  10. DataJoe recommends that you send yourself a Test Survey before sending the blast to be able to preview the cover letter and survey from the survey recipient’s perspective. Type your email address into the “Test Recipient” field and click Send Test  to do this. DO NOT type the batch blast key yet. Below is an example of what a cover letter will look like in a recipient’s email inbox. The “Click Here!” link is where the recipient clicks to go to the survey.
   
  11. When you are ready to send the Survey Blast, type the batch blast key and click Send Blast .
  12. You will then be directed to the Survey Results page. Here you will see a green Delivery progress bar showing you how much of the blast has gone out. DO NOT navigate away from this page until the blast is complete to prevent disrupting the blast. This page also shows you how many total, email, and fax surveys were sent out, and how many were successful and failed once all of the surveys have been sent.
   
  13. Click on the Survey logs button to see a list of individual records and find out which ones were sent successfully. You can return to the survey logs any time in the future by clicking on Advanced Tools  and then “Survey Logs.”
    How to Generate a Blank Survey Link
    Instead of (or in addition to) sending surveys to identified contacts, you can generate a link for any survey in your database that will create a blank survey form. You can distribute this link in a e-newsletter or any other type of electronic communication with subscribers or other contacts. This will allow you to gather data on new prospects and companies.
   
   

Note: If you distribute blank survey links, be aware of the fact that anyone might submit a survey this way, even companies that already exist in your database. This means that you must search the Company Manager when processing these surveys to see if you should create a new record or update an existing record when processing the submission. See instructions below.

  1. Be sure you are in the Researcher Module .
  2. Click on Advanced Tools .
  3. Click on the correct cover letter name under Cover Letter Builder.
    Note: You may want to have a unique cover letter for blank survey links, as the cover letter verbiage will appear atop the survey.
  4. Once you have reviewed the cover letter and are satisfied with it, scroll down until you see “Project submission page links.”
  5. In the Manager Area, click on the Project Manager button  and choose Ranked List or Directory under Type (depending on which type of survey you are generating).
  6. Click on the name of the project so that it is highlighted in gray.
  7. Under “Project submission page links,” click Load .
  8. You will see a link generate under “Link to submission form.”
  9. Copy this link and paste it into any applicable communications to prospects. If you would like a preview of what the blank survey form looks like, paste it into your browser and hit Enter.
  10. You will be able to tell when a survey submission has come from a blank survey form because the Company name will be in red text, and it will say “No data” under Currently for the Company name field.
  11. When you are processing a survey has come in from a blank survey form, search for the company within the Company Manager.
   
  12. If you see a prospective match, highlight it in the Manager to it appears in gray.
  13. Scroll down to the bottom part of the submission where you see the section entitled “Update alternate record.”
   
  14. Click Load .
  15. Scroll back up on the submission to see a comparison of the data from the incoming submission and the existing record.
  16. If you determine that the incoming data should update the existing record’s data (i.e., the records are the same), scroll back down, check the new data and process the associations correctly, and Final and Save the submission.
  17. If you determine that the incoming record is unique, Unload the existing record name from the “Update alternate record” box, and Final and Save the record. This will create a new record in your database.
    How to Search within and Sort the Survey Logs
    In the Survey Logs, you perform searches of all survey blasts sent based on a number of criteria. You can also view the status of each survey that was sent, download reports, and select a printer-friendly option. The Survey Logs default to a list of results for survey blasts.
  1. To access the Survey Logs, go to Advanced Tools in the Researcher Module and click on "Survey Logs."
   
  2. To search the Survey Logs by blasts related to a particular project, load the project from the Project Manager  into the Project(s) box.
   
  3. To search for surveys that went to contacts at a specific company, person, or thing record, enter the record name into the correlating search field. You can search by blast, by fax, or by email.
  4. To search surveys that were sent on a specific date, enter it into the Start date and End date fields.
  5. Once you have conducted a search, you may sort the Survey Logs by specific criteria, including the status of individual surveys within a blast. Use the Sort Survey Logs option and choose your sort criteria.
   
  6. To view status of individual surveys within each blast, click on the Edit pencil  next to the name of that blast.
   
   

The following statuses will be assigned to your email surveys:

   

Queued - The email is in the queue and waiting to be sent out by our email provider.

• Sent - The email was successfully sent out of our email provider's system, or the fax survey successfully reached its recipient.

• Opened - The survey recipient has opened the email to view to the cover letter (if images are enabled).

• Clicked - The survey recipient has clicked on the "Update Data" link inside the email cover letter to open the survey.

• Saved - The Save-as-you-go survey has beed saved by the survey recipient but not yet submitted.

• Submitted, In Process - The email survey recipient has submitted the survey and it now appears in your submissions queue.

• Submitted, Finaled - The researcher has saved the survey submitted by the survey recipient.

• Combined - Multiple surveys were sent to the same email address and combined into one email.

• Bounced - The e-mail survey was sent, but the survey recipient does not exist or the e-mail address was malformed. There are two types of bounces, Hard and Soft. A soft bounce can mean that their inbox is full. Hard bounce can be spam-related.

• Deferred - The e-mail is being held temporarily until our email provider is ready to send it.

• Unsubscribed - The survey recipient clicked on the email message's "Unsubscribe" link, and the email address has been added to you No Email List.. All future attempts to send an email survey to this email address will be suppressed.

• Spam report - The email survey recipient has reported the email as spam, and the email address has been added to your No Email List. All future attempts to send an email survey to this email address will be suppressed.

• Suppressed - One of the following has occurred: The email address was invalid, or this email address has previously been added to your No Email List.

• Processed - The email has been received by our email provider and is ready to be delivered.

• Not Sent - The email or fax survey was not sent because it is present on the No Email List or No Fax List, or the fax survey transmission failed.

  7. To view the actual survey that was sent to a recipient, click the Edit pencil  next to that record’s name/status.
    Note: There is a control under Advanced Tools in the Researcher Module called “No Fax List” where you can list fax numbers that should never be sent a fax again, and one called "No Email List" where email addresses are automatically added when a survey contact elects to Unsubscribe or report your survey as Spam.
    Back to top
2.9   Processing Survey Submissions
    After you have successfully sent a survey blast and your Survey Logs indicate that electronic surveys have been submitted and are ready to be processed, click on the Submissions button  to review and process email submissions (save the new data to your database).
    Note: If you would like to be notified by email each time a survey submission comes in, you can add your email address to the "Submission confirmation email adress field" by going to Researcher Module , Advanced Tools , Research Settings, "Survey Settings," and typing in your email address.
    Navigating the Submissions Inbox
  1. Click on the Submissions button . You will see a list of all unprocessed email submissions as well as submissions that have been processed but not yet moved to the Survey Archives.
  2. Listed with each submission is the following data:
   

Respondent: The name of the record that was surveyed as well as the name of the survey (project) it filled out.
Date submitted: The date and time the survey was submitted online and arrived in your Submissions inbox.
Contact: The name and contact information of the person who submitted the survey.
Proc’d: This tells you whether the survey response has been processed already (Yes) or not (No). If a survey has been processed, it has been saved by the researcher into the database.

  3. Clicking the Edit pencil  next to a record name will take you to the survey that the respondent filled out.
   
  4. You also have the ability to search and sort the submissions similar to the way you can in the Survey logs (see section 2.8).
   
  5. You can also archived processed submissions to move them out of your inbox. More on archiving submissions in “How to Final and Save Survey Submission to the Database.”
  6. You can also click on the Printer-friendly button  to generate a report of all of the submissions in your inbox at any given time.
    How to Review and Edit Survey Submissions
  1. Click the Edit pencil  next to a survey submission to go to the survey’s details in the Submissions queue . This page will look similar to the Advanced Details of a record, but you will be able to see which data is new and compare it to the data currently stored in your database.
   
  2. Data that has been unchanged on the survey will appear in black (see Year Established in above example). New data will appear in red; below that, “Currently” lists the data that was in that field previously (in the examples above, the Type of Business and No. Employees fields had no data when the survey was sent out).
    Note: If data has been changed in a questionable manner (for instance, No. Locations previously read 6 and was changed to 45), DataJoe advises you to make a follow-up phone call and verify the new data.
  3. You have the ability to edit data in any field before saving the submission. Of course, DataJoe encourages you to do this with caution and verify the accuracy of the data with the survey respondent.
    How to Manage Associations in Survey Submissions
  1. DataJoe alerts you when an association has been proposed, deleted, or updated. If an existing association’s details have changed, the change appears in red. If a new association has been proposed, the name appears in all-capitol green letters in the Load/Unload box. If an association has been deleted, it will appear in red with a line through it in the Load/Unload box.
   
  2. Before accepting any new (“proposed”) associations, be sure to verify that the record does not already exist in your database using the Record Manager . Be sure to review the “Info” related to the existing record before deciding if it is a match. THIS IS ONE OF THE BEST WAYS TO AVOID DUPLICATE RECORDS IN YOUR DATABASE. If you discover that the record already exists in your database, Load  it into the association box over the proposed new record (be sure the proposed record is highlighted in the box before clicking Load).
   
  3.

Accepting changes made by the survey respondent in association zones is complex. Simply saving the submission will create NEW records in the database for any associations added by the survey respondent. Always use the appropriate manager (person, prospect, company or thing) to check and see if the person or prospect already has a record in the database. If so, highlight the name in both the manager and on the survey submission and hit the green LOAD button to tell the database know that it is the same record, and avoid creating a duplicate.

Simply saving the survey submission WILL NOT remove associations that the survey respondent deleted from the record. You must highlight and UNLOAD associations that have been deleted by the survey respondent (and appear red with a line through them) in order for the name(s) to be dis-associated with the record (these associated records are not deleted from your database; they are simply removed from the record).

    Note: Person, company, and thing associations that are deleted on a survey are not deleted from the database and stay related to the primary record in Basic Details, but show an End Year of the year in which the association was deleted. They will no longer show up on Advanced Details for that record or associated to that record in the published version of any projects going forward.
   
    How to Final and Save a Survey Submission to the Database
  1. Once you have reviewed the submission thoroughly and updated any associations, you can Final the record. Finaling the record tells DataJoe that you have all the data you need for this record, in this project, this year. The finaled record will not be sent any follow up surveys for this project this year.
   
  2. Click Save .   
   

Note: Rather than updating data for an existing record, you can also choose to create a new record in your database
with the data in this survey by clicking Create New.

  3. You will now be directed back to the Submissions inbox . Instead of an Edit pencil next to the record’s name, you will see a Printer-friendly icon . Click on this to open a printer friendly-version of the submission in a new browser tab, and print it.
    How to Archive Survey Submissions
  1. Once you have processed a survey submission, you may now Archive the Submission, removing it from your inbox and placing it in the Survey Archives (found by going into Advanced Tools ). You can archive one or several submissions at a time by clicking on the Archive Submissions button .
   
  2. Choosing “ALL processed submissions” will move every submission in your inbox that has been processed into your archives.
  3. Choosing “Selected processed submissions” will move only the submissions you have clicked on (highlighted in green) into your archives. You can select one or several submissions at a time.
  4. Choosing “Processed submissions” allows you to designate criteria for which submissions should be moved to the archives based on when they were processed or for which project.
  5. Once you have made your selection, click the Archive Submissions button .
  6. To locate your archived submissions, click on Advanced Tools  in the Researcher Module , and then click on “Archived Submissions.” Here, you can search for and sort archived submissions in the same manner you can search for and sort survey submissions in your Submission inbox  (see “Navigating the Submission Inbox”).
    Back to top
2.10   Editing the Layout of Ranked Lists and Directories
   

The Layout portion of Project setup is where you create and edit the layout of a ranked list or directory in preparation for the publishing steps.
You will need to have completed the Setup (see section 2.4) and Survey (see section 2.6) steps of Project setup before formatting the project’s layout.

    Note: Any field you want to include in the layout of a project must be present in the project’s Survey (even if it is hidden in the survey).
    How to Edit a Project's Layout
  1. Click on the Projects button in the Researcher Module .  Your current list of projects will appear.
  2. Click on the Edit button  next to the project’s name.
  3. Go to the Layout stage of Project setup .
  4. If the project is new and a layout has not yet been created, all of the fields from the survey will automatically appear in the layout window in the same order, but with no column or section breaks. Label formatting such as bold and hidden labels will carry over.
    How to Determine and Organize Layout Fields
  1. You can determine which fields will appear in your layout by using the white Layout Fields buttons and the Palette. The Palette contains all of the fields that are included in your survey and is the place where you determine the ranking criteria for the project.
   
   

Unload Field from Layout: To unload a field from your layout, click on it in the layout window so that it is highlighted in green. Then, click the white Unload button to the left of the layout window. The unloaded field remains in the Palette and can be loaded back into your layout at any time.

   

Note: Always remove the survey contact fields from your layout.

   

Move Fields Up or Down in Layout: Fields can be reordered by clicking on the field you desire to move so that it is highlighted in green and then clicking on the white Up and Down arrows to the left of the layout window.

   

Load Fields in Layout: Fields can be loaded into the layout from the Palette by selecting the field in the Palette, highlighting a field in the layout and telling DataJoe that the new field should be loaded above or below  it using the appropriate arrow button.

   

Identify Source Field: To identify a source field in the Palette, click on the field in the layout so that it is highlight in green, and then click on the Identify button .

   

Insert a Column Break: Highlight a field in green in your layout and click on the Column Break button  to begin a new column in your layout before the highlighted field.

   

Note: Column breaks are available only in ranked lists.

   

Insert a Section Break: A Section Break creates a new section in a directory or a customized column layout in a ranked list.

   

Insert a Field Join: In the layout, fields in the same column default to being stacked on top of one another. If you would like to join to two or more data fields on the same line (such as a person’s first and last name), you can do so using a Field Join. Highlight the second field you want to join in your layout, then click the Field Join button  to insert it above/before that field. A field join window will pop up in the Edit panel on the right side of the screen. Field joins default to slashes, but can be edited to contain any characters. Make the appropriate edit in the panel (for example, type one space to join first and last name, or a comma and a space to join city and state), and click Save  at the bottom of the layout.

   
   

Insert Custom Text: You can insert custom text into your layout using the Custom Text button .

  2. Before you are able to save your layout, you must select at least one Ranking Criteria. Do so by selecting the appropriate field in the Palette and using the greatest to smallest button or smallest to greatest button to tell DataJoe how to rank the data in the field. You may select as many ranking criteria as you like.
   
    In this example, the first ranking criteria is number of employees from greatest to smallest; the second ranking criteria (in the event of a tie) is the year established from earliest to most recent; the third ranking criteria (in the event of another tie) is company name, alphabetically.
    You can reorganize the hierarchy of your ranking criteria using the Up  and Down  arrows or remove them using the Unload button .
  3. You must also select the project’s Style before saving your layout. Locate the Style toggle underneath the layout window, and select one of your pre-built styles for the project. Here, you can also tell DataJoe whether the published project should display a Rank column and/or Previous Rank column.
   
  4. Click the Preview  button to get a rough visual representation of how the layout looks at this point. Click Preview again to return to layout setup.
  5. Be sure always click Save  before navigating away from the page.
    Note: Once a layout has been saved, new fields added to the survey will also needed to be added to the layout (they will be available in the Palette). Conversely, to remove a field from a survey, it must first be unloaded from the project’s layout. Be sure to also remove it as a ranking criterion, if applicable.
   

How to Format Cells, Field Labels, and Field Data in Layout

  1. DataJoe offers many options for formatting Cells, Field Labels, and Field Data in the layout step of Project setup. These options are controlled within the Edit window to the right of the layout box. Select the field you want to format so that it is highlighted in green.
    You have the following options under Format Cells:
   

Custom Format: Within the cell, you are able to apply left, center, or right horizontal alignment to your data and/or header. You are also able to apply vertical alignment of top, middle, or bottom to your data and/or header. You can also apply Borders on a cell-by-cell basis. Input the border width, padding, and color.

   
   

Custom Label: Replace field labels with custom labels or make a vertical label on the page. You can apply formatting such as bold and italic, and you can create a footnote for the label. Be sure to select “None” under “Label” to replace the regular label with the custom label.

   
   

Spanning Label: Create a label that spans horizontally across a specified number of columns and their headers. Apply formatting such as bold and italics.

   
   

You have the following options under Format Label:

   

Field Label: Edit the labels of your fields by using formatting options such as bold, italic, and all caps, or choose “None” to hide the label in your layout. Be sure to first select the field whose label you want to edit by clicking on it in the layout so that it is highlighted in green. You may also write a footnote for the field label. DataJoe encourages you to always use year merge fields for labels containing the field’s year to cut down on edits in future years (ex: [YEAR] for 2014 and [YEAR-1] for 2013).

   

Note: Changing a field’s label on a project’s layout does not change the field's name in the database. 

   
   

You have the following options under Format Field Data:

   

Data: Format field data by applying bold, italics, etc., to all data within a field you have selected (highlighted in green). You can also add text before or after the data in a field or suppress the not available mark. You can also change the symbol shown for Yes/No fields and certain value lists, and you can select notation formats for data in numeric fields and dictate the number of decimal places that should display. Leaving “Default” checked will enable to data to display in the defaulted format dictated by the project’s style.

   
  2. You can also make format selections across the entire project’s layout, rather than to individual fields under the “Numbers” toggle underneath the layout box. Here, you can dictate formatting for all numeric, percentage, and/or currency fields in the project’s layout.
   
  3. Always remember to hit Save  after making any formatting change or navigating away from the layout step of Project setup, or any changes you have made to the layout will be lost.
    Note: Style adjustments for a project’s layout can also be made under Optional Settings , “Style adjustments” in the project’s setup.
    How to Integrate Summary Data Fields into Layout
    DataJoe offers an option to include Summary Data for numeric fields in a project’s layout, totaling all of the data points in a particular field across an entire list. For example, in a list of Denver-area banks that is ranked by total assets, you can display a summary total of all the banks’ assets at the bottom of the column.
  1. Click on the Projects button .
  2. Click on the Edit pencil  adjacent to the project’s name.
  3. Go to the Optional Settings step of Project setup .
  4. Click on the Summary Data toggle . All of the numeric fields in your project will display as options.
  5. Select the field(s) to which you would like to add summary data.
   
  6. Click Save .
  7. Generate the project to BlueLines  to see the result.
   
    How to Determine Downloadable Fields
    DataJoe offers the ability to customize the fields that can be downloaded on a project-by-project basis, both from within the DataJoe administrative tool and from your e-commerce site. Downloadable standard fields (for companies only) are determined under Contact Info (in Advanced Tools). Custom Downloadable Fields for each project are determined under the Optional Settings step of Project setup.
   

To Determine Standard Downloadable Fields for All Projects:

  1. In the Researcher Module , click on Advanced Tools .
  2. Click on “Contact info.”
  3. All of the company standard fields appear on the left. Using the arrow , select fields that should appear on downloads from the left-hand box and move them into the right-hand Contact info box.
  4. You can rearrange the order of the fields as they will appear in Excel downloads using the up  and down  arrows.
  5. You can remove a field from the Contact info box by clicking on it and clicking on the remove button .
  6. Click Save .
   
   

To Determine Downloadable Fields within a Project:

  1. Click on the Projects button .
  2. Click on the Edit pencil  adjacent to the project’s name.
  3. Go to the Optional Settings step of Project setup.
  4. Click on the Downloadable Fields toggle .
  5. DataJoe defaults to having no fields selected here, which means that all of the fields from your survey will appear on an Excel download on the administrative side (internally) and the public side (from your e-commerce site). The Excel download will contain more than one file: the DATA file, which includes all of the standard and custom data from your survey; the Survey contact file, which includes all of the fields from the survey contact association holder (internal downloads only); and an additional file for each association in your project, containing all of the fields included in the association holder.
    Note: The above is true for internal downloads only. Survey contact data will never appear in a download accessed from the public side (your e-commerce site).
   
  6. To customize which fields should appear in a download and on the public side (your e-commerce site) for this project, check all of the applicable boxes. When an association holder is checked, the primary association data will also appear in the DATA file.
    Note: As soon as you check any of the boxes, you are telling DataJoe that only the checked boxes should appear in download. This means that you must select ALL of the fields that should appear in a download, including standard fields.
  7. You may also use the “Select all/Unselect All” button to select or unselect all of the fields
   
  8. You may re-label any field for the download by clicking on the field’s name. A purple box will appear where you can type the new label.
   
  9. Check “Include Super Contacts file” to include an additional Excel file in your download for this project that includes a row for every person (not including survey  contacts, which are considered prospects) attached to each company (across all association zones included in Survey Setup and regardless of which fields are selected as downloadable fields) plus all project-specific data for each company.
  10. You may also elect to “Include email addresses in ‘Super Contacts’ file” or create a “Download consist[ing] of ‘Super Contacts’ file ONLY.”
   
  11. Add a footer to the downloaded file, if applicable.
  12. Click Save .
    How to Download Data
    There are several ways from which to download data from your database, depending on how you plan to use the data. You may download standard data for any result set of records; the fields included in this Excel download are determined under Contact Info in Advanced Tools (see “How to Determine Downloadable Fields”). You may also download project-specific data for a determined result set of records or all records within a project.
   

To Download Standard Data for a Result Set of Records:

  1. Make sure there is no project selected in the Project Selector .
  2. Make sure the Records button  is selected and that the appropriate record type is selected  in the Record Selector.
  3. Click the Search button .
  4. Enter the appropriate search criteria, and click Search .
  5. Once the result set of records appears, click the Download button . You will be able to download the data in Excel.
   

Note: If no data appears in the Excel file, that means you have not set your downloadable standard fields under “Contact info” in Advanced Tools .

   

To Download Project-Specific Data for a Result Set of Records:

  1. Make sure the correct project is selected in the Project Selector .
  2. Make sure the Records button  is selected and that the appropriate record type is selected  in the Record Selector.
  3. Click the Search button .
  4. Enter the appropriate search criteria, and click Search .
  5. Once the result set of records appears, click the Download button . You will be able to download the data in Excel. Your selections in Downloadable Fields dictate the data that appears (see “Hot to Determine Downloadable Fields”).
   

To Download Project-Specific Data for All Records in a Project:

  1. Make sure the correct project is selected in the Project Selector .
  2. Generate the project to BlueLines .
  3. Click the Download button . You will be able to download the data in multiple formats, including Excel, CSV, HTML, PDF, and Word. Your selections in Downloadable Fields dictate the data that appears (see “Hot to Determine Downloadable Fields”).
    Note: You will want to go to the PrePress step (from BlueLines) before downloading a final published version of a project, where you can make cosmetic edits to the layout and data. See the Designer Module How-to Guide for instructions on PrePress.
   

To Download all of the Data from your Database:

  1. Go to the Identity Module .
  2. Under Advanced Tools , click on “Data Dump.” Here, you can generate an XML file.
    Back to top
2.11   Reviewing Data in BlueLines
   

BlueLines is the first stage in the publishing process. It reflects an up-to-the-second report of how data in a project is stacking up. Researchers use BlueLines to view and edit project content. This is your last opportunity to edit data before making final determinations about the appearance of your printed project in PrePress. BlueLines is an HMTL preview of the project and does not reflect particular fonts and other elements of the project’s style.
You can view a project’s current data in BlueLines anytime that project is selected in the Project Selector  by clicking the Publish button .

   
    How to Manage Data Views in BlueLines
  1. Once in a project’s BlueLines, you can use the Settings panel to determine which data you want to view and/or publish within that project. For instance, you can choose to view “All records meeting criteria” for the project, or “Final records only” or “Unfinaled records only.” You can also set how many records you would like to view at one time, which you will want to specify before completing the publishing process. For example, if you plan to publish the top 25 companies in a list, choose “Publish Records 1 to 25” before moving on to PrePress.
   
  2. Hit the Apply button to change the current data you are viewing in BlueLines. Hit the Save button  to change these selections to your default selections when you return to BlueLines for this project.
  3. When you are ready to publish the project, click on “PrePress” at the top of the screen. Your current Settings dictate which data appears in PrePress.
    How to Edit Data in BlueLines
    You can make permanent edits to the records’ data from BlueLines.
  1. Click on a record’s data row in BlueLines to be taken to Advanced Details for that record.
   
  2. Make any applicable edits to the record’s data.
  3. Hit Save , and you will be directed back to that project in BlueLines.
    Note: You can return to the project’s setup from BlueLines any time by clicking on the Project setup button on the top of the screen . This will direct you to the project’s layout.
  4. When you are ready to publish the project, click on “PrePress” at the top of the screen. Your current Settings dictate which data appears in PrePress.
  5. You will now be directed to the Designer Module  of DataJoe.
   

Note: See the Designer Module How-to Guide for instructions on using PrePress and exporting published projects.

    Back to top

 

  DESIGNER MODULE
     
4.1   Editing Layout in PrePress
    PrePress is the second stage of the publishing process. It’s where the researcher/designer can make cosmetic changes to the look and feel of each particular project. PrePress is an advanced HTML preview of the layout of a project, and is a close (although not exact) match to what you will see in the printed (exported) file.
    How to View a Project in PrePress
  1. From the Researcher Module , either click on the Projects button and click on the name of the project you want to view so that it is highlighted in green (or click the Edit button  adjacent to the project’s name), or you may select the project in the Project Selector .
  2. Click the Publish button  to go to BlueLines for that project.
  3.

Once in BlueLines, click on the PrePress button at the top of the Content Area. Notice that you are automatically directed to the Designer Module .

  4. Alternatively, from the Designer Module , make sure the correct record type is selected in the Record Selector , select the project in the Project Selector , and click the Publish button to be directed to PrePress.
    How to Edit the Published Project's Dimensions
  1. In PrePress, locate the Settings Panel.
   
  2. To set the published project’s width and height (in inches), enter the values into the corresponding boxes.
  3. Manipulate the project’s font size and leading (vertical space between lines of text) in the same manner.
  4. If the number of records you indicated should be published are not fitting within the designated page dimensions, use the Vertical spacer to (in purple) to fit more or fewer records into the defined space. Click and drag the purple Vertical spacer upwards for a tighter squeeze or downwards for widening. You may also input figures into the Vertical field (full or half numbers).
    Note: Some lists are already too tight to allow squeezing, or have other formatting/style settings that can interfere with squeezing. DataJoe’s PrePress tool is powerful, but it is not a miracle worker!
  5. Click Apply  to apply the settings immediately and for an exported file in this PrePress view.
  6. Click Save  to save the settings permanently, so that they will still be in place when you return to PrePress for this project at a later time.
    How to Set Column Width
    You can set column width for each column in your ranked lists in PrePress. You can set each column to have a unique width, or set several consecutive columns to have the exact same width. Remember that column width settings may be restricted by the amount and/or width of data present.
  1. To manage a column’s style, hover your cursor over the column border you want to adjust until your cursor turns into a double arrow.
  2. Click and hold. A vertical green line will appear.
  3. Still holding down the mouse, drag the column border to the right or left.
  4. To distribute two or more columns evenly (so they are the same width), click on the purple tabs above each column. Selected columns will appear highlighted in green.
  5. Double click anywhere within the green highlighted area (not the purple tabs) to distribute the columns evenly.
    Note: If data in one of the two columns in two wide, DataJoe may not be able to distribute the columns to your desired specifications.
   
  6. You can lock a column if you want its width to remain frozen and unaffected by future column adjustments by double clicking on the purple tab at the top of the column. A lock icon will appear.
  7. Click Apply  to apply the settings immediately and for an exported file in this PrePress view.
  8. Click Save  to save the settings permanently, so that they will still be in place when you return to PrePress for this project at a later time.
    How to Create Replacement (Style) Rules
    To set display rules that should always be in place for all of your published projects (e.g. the word Corporation in company names should always display as “Corp.”), use the Replacement Rules tool.
  1. Go to the Researcher Module .
  2. Click on Advanced Tools .
  3. Click on “Replacement Rules.”
  4. In the “Start text” field, enter the word, phrase, or character you want to replace consistently in projects appearing in BlueLines and PrePress.
  5. In the “End text” field, enter the replacement you want to appear.
   
  6. Click Load  next to the “Rules” box.
  7. Click Save .
    How to Make Temporary Cosmetic Edits to Data
    Temporary cosmetic edits to data will stay in place only during the current PrePress visit and on any project downloads/exports of this project during the current visit.
  1. Right click on the data point you want to edit. A purple box will open.
  2. Type in the edit.
   
  3. Click “Commit.”
    How to Make Permanent Cosmetic Edits to Data
    Permanent cosmetic edits to data will stay in place in BlueLines and PrePress after the current PrePress visit and for current and future downloads/exports of this project. Permanent edits cannot be made to association fields; however, temporary edits can be made to association data.
  1. Left click on the data point you want to edit. A white box will appear.
  2. Type in the permanent edit you want to make.
   
  3. Click “Commit.”
    Back to top
4.2   Publishing Ranked Lists and Directories
    Once you have finished formatting your project and making any permanent or cosmetic edits, you are ready to download (or export) your published project.
    How to Download (Export) the Published Project
  1. In PrePress in the Designer Module  click the Download button .
  2. Depending on the type of project you are exporting, you will be given several options of file types. Click on the appropriate type. The file will generate and be ready to save or open on your computer.
   
    The following are the types of files available for download:
  A download of the .txt file in a delimited Microsoft Excel format. Does not contain any stylized formatting, but each data point resides in an individual cell, along with additional Excel files for each association zone listed in the layout of the project.
  A download of the .csv file in a Microsoft Excel format. Does not have data points separated out by cell, but rather by column.
  A download of the .pdf file, viewable in Adobe Reader. Does not allow you to manipulate data (i.e., sort) but contains stylized formatting for print.
  A download of the .hmtl file, viewable in a web browser. Does not contain all stylized formatting such as correct font settings, but does contain data in a table format.
  A download of the .doc file viewable in Microsoft Word. Does not contain all stylized formatting such as correct font settings, but does contain data in a table format. Most commonly used for exporting directories if not using a tagged-text export.
  A download of the tab-delimited .txt file viewable in Notepad. Does not contain any stylized formatting.
  A download of image files associated with a project. Contains image files only in a .zip file.
  A download of the data in a tagged-text format, suitable for import into InDesign or Quark. Must have custom tags arranged through DataJoe in order to use this type of export. Most commonly used for directories if not using a .doc type of export.
   

Note: Not all export options are available for all types of projects.

  3. Click Finished  when you are down downloading the published project.
    Back to top
4.3   Managing Images
   

Image records are managed in the same manner as other records (companies, people, etc.), but in the Designer Module .  You can search for, create, delete, and update image records here (see sections 2.1 and 2.2 for how to maintain company, person, thing, and prospect/survey contact records).

    How to Conduct a Basic Image Search
  1. Be sure you are in the Designer Module .
  2. Click on the Records button . The Record Selector should be set to Image .
  3. Be sure the Project Selector is clear  so your search crosses the whole database.
  4. Be sure the Search button  is selected.
  5. In the Search screen, type or load in search criteria and click Search .
   
  6. Once you have generated a Result set of image records, you can view and edit the Basic Details of any record by clicking on the Edit icon  next to the record name.
   
  7.

You can navigate through a result set of records by using the arrows at the top of the content area (click on the purple number to insert your own starting record number).

    How to Create a New Image Record
    Create an Image Record in Basic Details:
  1. Click on the Records button . The Record Selector should be set to Image . Be sure that the Project Selector is clear .
  2. Click the Create button . You will be directed to a blank form.
  3. Upload a new image by first clicking “Browse” to locate the file on your computer, and then clicking “Upload.” A preview of the image will appear in the screen.
    Note: Before uploading a new image, be sure that it is saved in the appropriate format and size on your computer. Be consistent with the size of your images so they all display the same way. Recommended image size for images appearing in lists is 120 px by 120 px.
   
  4. Name the image in a way that will help you intuitively search for it later.
  5. Provide a description in the “Description” window under “Details,” if applicable.
  6. If applicable, associate a flag to the image record by loading it from the Flag Manager . Flags are a way to identify and categorize records and are discussed more in section 2.3.
  7. Save  the new record.    
  8. Once the new image record in saved, you will see the image’s dimensions and type under the “Details” toggle within the record.
   
    Create an image record in the Image Record Manager:
  1. Click on the Record Manager button .
  2. Select "Image Manager."
   
  3. Click on the purple Create button .
  4. Name the file. DataJoe suggests using a consistent naming convention when uploading images to make searching for them easier in the future.
  5. Click Upload . A preview of the image will appear.
  6. Click Save .
    Note: Before uploading a new image, be sure that it is saved in the appropriate format and size on your computer. Be consistent with the size of your images so they all display the same way. Recommended image size for images appearing in lists is 120 px by 120 px.
    How to Delete an Image Record
  1. To delete a record in your database, conduct a Basic Search or for that record in the Designer Module.
  2. Highlight the record by clicking on or near the record name (it will appear in green). Click the Delete button  in the Header Area.
   
   

Note: You may also click the Edit icon next to the record’s name. Then, click the purple Delete button  at the bottom of the record.

    How to Edit Existing Image Records
  1. To edit a record in your database, conduct a Basic Search for that record in the Designer Module.
   
  2. Click the Edit icon next to the record’s name.
  3. Add a description, flags, and/or footnotes to the image record.
    Note: You cannot edit the size or file type of an image record once it is in the database.
  4. Add internal-use-only notes to the record by clicking the Notes button at the top of the record details.
  5. To view a history of all edits made to the record, click the Logs button  at the top of the record details.
  6. To navigate through and edit several records within a result set, use the navigation arrows at the top of the content area. The purple arrows will take you to the previous or next record, while the green arrows will allow you to save any changes made to the record before moving to the previous or next record. 
    Back to top

 

  MARKETER MODULE
     
5.1   Managing E-commerce Settings
    Within the Marketer Module are several general settings that govern the way subscribers view and interact with your E-commerce site and purchase data products.
    Note: These directions are indicated for the standard DataJoe E-commerce module. If your publication has integrated any custom features, not all settings and/or options may be applicable to you.
    How to Manage General E-commerce Settings
  1. Be sure you are in the Marketer Module .
  2. Click on the Advanced Tools button .
  3. Click on “E-commerce Settings.”
  4. Enter your publication name as you want it to appear on the DataJoe checkout page.
  5. Enter your publication’s E-commerce “landing” URL. This represents your landing page for E-commerce.
  6. Populate the E-commerce contact, Contact e-mail, and Contact phone fields, if desired. Enter the name and contact information of the person at your publications who public users should contact if they have questions or problems with purchasing. This is often the researcher.
  7. In the About URL field, insert the URL that people should be sent to when they click your publications name on the DataJoe checkout page. (Most clients link to their “About Us” page or equivalent page.)
  8. By clicking on the “Contact” button in the default navigation menu (see “Default Navigation” section), public users can
either be directed to an online comment/question form to fill out and submit back to the e-commerce contact or you can set a “Contact URL” to instead direct them to whatever Web site address you choose to put in here. Some clients opt to send them to their business journal’s “Contact Us” page, for example).
  9. If interested, you can contact DataJoe to help you activate Google Maps through your e-commerce portal. Adding the Google Maps feature through your e-commerce would give you the ability to embed maps to your HTML lists so that visitors to your web site can see where each company is located. You will need to generate an API key through Google in order activate maps on your Web site. More information about generating an API key can be found at http://code.google.com/ apis/maps/signup.html. Please contact DataJoe for more details.
    How to Manage E-commerce Checkout Settings
  1. Be sure you are in the Marketer Module .
  2. Click on the Advanced Tools button .
  3. Click on “E-commerce Settings.”
  4. Click on the arrow adjacent to the words “Checkout Settings.”
  5. Using the Image Manager, upload and load an image that will serve as your E-commerce Banner. This image will reflect your publication’s brand on the DataJoe checkout page. It will appear on the left-hand side of the page. Recommended maximum width for the banner is 185 pixels.
  6. The Checkout/Survey HTML box will allow you to enter in text or HTML code that would appear on the left-hand side of the e-commerce page. This would be below the e-commerce banner (if you had one).
  7. The magic credit card number allows you to “purchase” products through your e-commerce site to test the purchasing process. To use this number, you’d fill out all required fields in the checkout process and at the Credit Card Information area you’d type in this number (any other information like Name on Card and expiration date can be made up). Keep in mind that “purchases” made with the magic credit card will appear on your Order Details page. They will not, however, show up in your Track Transactions.
  8. Here you may also check the box to Enable discount codes. See “How to Offer Discount Codes” in section 5.5 for more information.
    How to Manage Customized Access Settings
  1. Be sure you are in the Marketer Module .
  2. Click on the Advanced Tools button .
  3. Click on “E-commerce Settings.”
  4. Click on the arrow adjacent to the words “Customize Access.”
  5. Here, edit determinations regarding whether and when articles (if applicable), “View Details,” and PDF downloads should be available to subscribers.
    How to Manage the End User License Agreement (EULA)
    The End User License Agreement (EULA) is the contrac to which a subscriber must agree before making a purchase from your E-commerce site and includes guidelines on the allowable use of data.
  1. Be sure you are in the Marketer Module .
  2. Click on the Advanced Tools button .
  3. Click on “End User License Agreement.”
  4. Make necessary edits to the text.
  5. Click Save .
    Back to top
5.2   Customizing the E-commerce Interface
    Within the Marketer Module are several general settings that govern the way subscribers view and interact with your E-commerce site and purchase data products.
    Note: These directions are indicated for the standard DataJoe E-commerce module. If your publication has integrated any custom features, not all settings and/or options may be applicable to you.
    How to Manage E-commerce Navigation
    This controls whether the internal navigation buttons will appear at the top of your online store. You can choose to use any combination of these buttons. The navigation buttons look like this:
   
   

Products: The Products button will take your e-commerce customers to the main products page listing the different products you have available for sale.

Search: The Search button will allow your e-commerce customers to search for records within your database and download a custom result set of company or person records. The Search page’s functions will be built off whatever you have set as your “Standard Project (company)” or “Standard Project (person)” in the Researcher Module’s Advanced Tools under Research Settings. Please see the Researcher How-To Guide for details on setting this up.

Profile: The Profile page will allow users to log in and access their information through the system. In their profile, they will be able to download previously purchased products (up to 30 days from the original date of purchase), and be able to view a record of products and subscriptions they may have purchased. They can also update their address and billing information through their Profile page.

Add Data: The Add Data page is a feature that allows visitors to your Web site to submit information to be sent to your DataJoe database and processed just as a submission coming in from a survey would look. The initial survey available on the Add Data page is the same survey that is used on the “Search” page. See “How to Determine Downloadable Fields” in section 2.10 for more information.

Contact: The Contact page will allow customers to your Web site the ability to contact you with any issues or questions they might have. By default, the contact button will take them to a form where they can fill in their information which will send an e-mail to whomever is set as the “Ecommerce contact.” If you’d rather, you can enter a Web site into the “Contact URL” which  would direct the user to whatever Web page you have chosen (your publication’s Contact Us page for example) instead of the form.

Subscribe: The Subscribe page houses the available subscriptions you are offering your users. See “How to Manage Subscriptions” for more information.

Searchable Icons: You can make any product on your Products page “Searchable.” To do this, see “How to Determine Searchable Fields in Advanced Search” in section 2.1. You can select “Show searchable icons on products page” to indicate this capability to subscribers.

Sort: You can select to “Sort products by year” on your Products page.

    How to Manage Remote Authentication Settings
    If you have chosen a “remote login” style of e-commerce implementation, or Remote Authentication, DataJoe will work with you to set up your login settings. The Remote Key, Login URL and Logout URL will all be discussed with you at your e-commerce implementation and will determine how your users’ logins will be treated.
    How to Edit Custom Page Intros
    Custom Page Intros allow you to customize the explanatory/introductory text on each page of your E-commerce site for your subscribers.
  1. Be sure you are in the Marketer Module .
  2. Click on the Advanced Tools button .
  3. Click on “Custom Page Intros.”
    Back to top
5.3   Managing Prospects
   

In the Marketer Module, one type of record exists: Prospects. In this module, you can search for result sets of both Source prospects and Subscriber prospects. A source prospect is a prospect record from the Researcher Module, or a survey contact. A subscriber prospect is someone who has made a purchase on your E-commerce site.
You might conduct a search for a set of source prospects at whom you want to direct a marketing campaign for your E-commerce site. You might conduct a search for subscriber prospects at whom you want to aim a marketing campaign for next year’s product because they purchased this year’s product.

    How to Conduct a Prospect Search
  1. Click on the Records button . The Record Selector will default to Prospect , the only record type in the Marketer Module .
  2. Be sure the Search button  is selected.
  3. In the Search screen, click Source or Subscriber (depending on which type of prospect you are looking for) and click Search . When searching Subscriber prospects, you can search for one specific  prospect name or email address, or you can choose to search for all prospects that have purchased products (as opposed to subscriptions).
   
    When searching for Source prospects, you can search for prospects that are attached to companies, people, or things with specific flags.
   
  4. The record details for a subscriber prospect will display that person’s purchase history, including which products he or she has purchased, and the date, time, and amount of each purchase.
   
   

Clicking on the product name will take you to the Product setup. Clicking on the green Edit pencil will take you to the Order
Details/receipt for the purchase, where you can issue a refund for a product purchased within the past 30 days, see if the prospect has downloaded the product, or download the product yourself. (See section 5.7, “Tracking Transactions,” for more details on issuing
refunds.)

  5. Once you have generated a result set of records, you can download them into an Excel spreadsheet by clicking the Download button . A download of subscriber prospects can then be sorted by order date or product, to help you fine-tune your marketing campaign.
    How to Create a New Prospect Record
    Prospect records are created automatically when someone purchases a product or subscription on your E-commerce site, but you can create them manually as well.
  1. Click on the Records button . The Record Selector will default to Prospect , the only record type in the Marketer Module .
  2. Click the Create button . You will be directed to a blank form.
  3. Enter any data you currently have about this prospect. For this person to have access to your E-commerce site, the record details must include an e-mail address (to log in with) and a password.
   
  4. Save  the new record.   
    How to Delete a Prospect Record
   

Always use caution when deleting a prospect record because you will permanently lose all data, including transaction history, when deleting. You may want to delete a duplicate prospect record (you may also combine duplicate prospect records using the Combination Tool. See Appendix E.).

  1. To delete a prospect record in your database, conduct a search for that record in the Marketer Module.
  2. Highlight the record by clicking on or near the record name (it will appear in green). Click the Delete button  in the Header Area.
   
   

Note: You may also click the Edit icon next to the record’s name. Then, click the purple Delete button  at the bottom of the record.

    How to Edit Existing Prospect Records
    You may not have much need to edit prospect records in the Marketer Module, but you can, including completing a password reset. A subscriber prospect can also reset his or her own password by using the “Forgot your password?” link on your E-commerce login.
  1. To edit a record in your database, conduct a search for that record in the Marketer Module.
  2. Click the Edit icon next to the record’s name.
  3. Edit any personal or company data, or reset the prospect’s password.
  4. Click Save .
    How to Create Super Users
    You have the ability to create Super Users, or subscribers who can view and download all of your publication’s data and products for free. You may set up publication staff members as super users so they can test how products are displayed and downloaded on your E-commerce site without having to actually purchase anything. These users still must set up an e-commerce login/account.
  1. In the Marketer Module , click on the Advanced Tools button .
  2. Click on “E-commerce Settings.”
  3. Click on the arrow to the left of the “Super Users” toggle.
  4. Enter your publication’s domain in the “Super Domain” field (for DataJoe, the domain is datajoe.com).
  5. In the “Super Users” field, enter each super user’s email address (up until the @), separated by commas (ex: jprew, michelle, jacob).
  6. Click Save .
    Back to top
5.4   Creating and Managing Subscriptions
   

Database subscriptions are one product type offered through DataJoe’s E-commerce. A subscription can be set up with almost any set of parameters imaginable, including searching the database, viewing deep data, and downloading some or all products from your site.
Carefully think through a new subscription’s parameters and the impact it will have on your data sales before creating it. The subscription will be live on your website as soon as you save it in the Marketer Module.

    Note: If you plan to offer subscriptions, be sure that your Subscribe button is turned on. See section 5.2, “Customizing the E-commerce Interface.”
    How to Create a New Subscription
  1. In the Marketer Module , click on the Products button .
  2. Click on the green Create button .
  3. Click on “Subscriptions.”
  4. Enter the name of the subscription into the “Subscription name” field. This name will appear as the subscription name on your website.
  5. In the “Description” field, enter a clear description of what the subscription includes. This description is what the potential subscriber will use to make a decision on purchasing the subscription, so make sure it is clear and enticing.
  6. Check off the privileges that should be included in this subscription (you can include any combination of these):
   

View data: Gives the subscriber access to view any data, but requires the subscriber to pay to download that data.
View articles: Only relevant for clients using the Reporter Module .  Give the subscriber the ability to download unlimited articles.
Download data: Give the subscriber the ability to download unlimited records and products.

   
  7. Within each subscription, you can offer one or multiple duration/price combinations. In the example above, the Premium Subscription Trial can be purchased for seven, five, or three days for various amounts. In the example below, the Premium Database Subscription can be purchased for 12 months at the cost of $500.
   
  8. You can also create product-specific subscriptions, so that the subscriber can view and download data only within the specific products you load from the Product Manager . (Or, you may load products here that should be excluded from the subscription.)
   
  9. Click Save .
  10. The new subscription will automatically become live on your E-commerce site (if the Subscribe button is activated under “E-Commerce Settings” and Navigation).
   
    How to Edit or Delete and Existing Subscription
    Once you have created a subscription, it will appear within your list of products in the Marketer Module. You can edit the subscription’s parameters, details, and description at any time, or you can delete it.
  1. In the Marketer Module, click on the Products button .
  2. Locate the subscription in your list of product, and click on the Edit pencil  adjacent to its name.
   
  3. Make the appropriate edits and click Save .
  4. To delete the subscription, highlight it on the Products page so that it is highlighted in green, and click the green Delete button  in the Header Area.
    Back to top
5.5   Creating and Managing Products
   

Any project (ranked list, directory, or project package) in your database can be converted into a product to be sold online through your publication’s DataJoe E-commerce portal.
In the DataJoe Marketer Module, you can create two types of products: dynamic and static.
Dynamic products draw directly from the DataJoe database and continually update as records are updated during the research process.
Static products are files you upload into DataJoe within the Marketer Module, and then sell through the E-commerce portal. Static files can be uploaded and sold in the following formats: PDF, CSV, XLS, TXT, DOC, or ZIP. These files are not tied to the database in any way. Files should be smaller than 5 MB.

    How to Create a New Dynamic Product
    Although products are managed in the Marketer Module, the first step to creating a dynamic product actually occurs in the Researcher Module.
  1. Be sure you are in the Researcher Module .
  2. Click on the Projects button .
  3. Locate the project you will make into a product. Click on the Edit pencil  adjacent to its name.
  4. Locate the E-commerce Access area of Project setup. The year selected in the Latest Year Published menu dictates which data is available through your E-commerce portal. Select the most recent year with thorough data. In the Include menu, select whether all records meeting criteria for the project should be available online, or finaled records only.
   
  5. Click Save .
    You are now ready to proceed to the Marketer Module, where you will create the dynamic product and make it live on your E-commerce site.
  1. Go to the Marketer Module .
  2. Click the Products button .
  3. Click on the Create button .
  4. Select “Product.” A blank product setup page will open.
   
  5. Populate the “Name” field. This label will appear on your website. As the product name.
  6. The “Category” field is relevant to specific clients. Call DataJoe for details.
  7. Populate the “Date Published Online” field with the date the product will go live.
  8. Check “Hide this product” if you are not yet ready for it to appear online. It will appear online once the box is un-checked.
  9. Click “Associated product only” if this product should not be listed individually on your website but alongside another product(s). (This is more likely to be the case for static products.)
  10. Edit the way the product listing will display on your Products page by adding an image to run alongside it and/or populating the Description field.
  11. To upload an image, open the Image Manager, and search for an existing image or load a new one.
   
   

Associate it with the product by clicking the Load button  next to the “Image” box.

   
  12. Populate the Long description field. This information will appear on the Product details page.
  13. Assign product pricing. You may select and populate the Fixed price field, assign a price Per record, or designate the product as Free of charge.
   
  14. Choose Type of product, “Dynamic.”
  15. Using the Project Manager, load the project that the product will pull data from into the “Project” box.
   
  16. If your E-commerce Access settings are current on the project’s setup, you will not need to adjust any other settings in this area. You may customize which data appears online by changing the project year here to a Custom year or by displaying only Top [#] records on the list.
  17. Set the HTML version and Advanced options settings, if applicable.
   
   

You can choose to provide no HTML view of the project on your website by clicking “None,” or you can provide one by clicking “Dynamic.” If you do display an HTML view, designate under Advanced options how many records should appear—Full version or the Top [#] records, and/or if the Full version should be available to subscribers. Making the product Searchable will allow E-commerce subscribers to search companies within (or that meet the criteria for) that product online.

  18. Click Save .
    How to Edit an Existing Dynamic Product
    To update an existing dynamic product, you may or may not even need to work with the product setup. If you need to update the data available in the product because you have just published a new version of the list, change the E-commerce Access settings in Project setup in the Researcher Module .
   

To edit anything relevant to how the product descriptions or details are displayed online:

  1. Go to the Marketer Module .
  2. Click on the Products button .
  3. Click on the Edit pencil  adjacent to the product name.
  4. Make the necessary updates.
  5. Click Save .
    How to Create a Static Product
    Creating a static product involves use of DataJoe’s file upload tool. This tool requires Firefox version 4 or more recent and an updated version of Flash Player.
  1. Go to the Marketer Module .
  2. Click the Products button .
  3. Click on the Create button .
  4. Select “Product.” A blank product setup page will open.
   
  5. Populate the “Name” field. This label will appear on your website. As the product name. With static products, it is wise to include something in the name that indicates it is a static product, such as “Banks (PDF),” to differentiate the name from the dynamic version of the product, when applicable.
  6. The “Category” field is relevant to specific clients. Call DataJoe for details.
  7. Populate the “Date Published Online” field with the date the product will go live.
  8. Check “Hide this product” if you are not yet ready for it to appear online. It will appear online once the box is un-checked.
  9. Click “Associated product only” if this product should not be listed individually on your website but alongside another product(s). (This is more likely to be the case for static products.)
  10. Edit the way the product listing will display on your Products page by adding an image to run alongside it and/or populating the Description field.
  11. To upload an image, open the Image Manager, and search for an existing image or load a new one.
   
   

Associate it with the product by clicking the Load button  next to the “Image” box.

   
  12. Populate the Long description field. This information will appear on the Product details page.
  13. Assign product pricing. You may select and populate the Fixed price field, assign a price Per record, or designate the product as Free of charge.
  14. Choose Type of Product, “Static.”
  15. You will see the file upload tool. To upload the static product, click “Browse.” Open the file from your computer, and click “Upload.” The upload is complete when the purple bar moves all the way across the upload tool.
   
    Note: The file upload tool has a 5 MB limit. If you have a need for uploading larger files regularly, contact DataJoe about increasing your file size limit for a small monthly fee.
  16. Populate the # of records field and Publish year field to E-commerce subscribers are aware of exactly what they’re purchasing on your website.
  17. Click Save .
    Note: See “How to Associate Products” for instructions on making a static product associated with a dynamic product on your website.
    How to Edit an Existing Static Product
   

To update a static product from year to year, you can simply upload a new file over top of (replace) the file from the previous year without creating a new product.

  1. Be sure you are in the Marketer Module .
  2. Click on the Products button .
  3. Click on the Edit pencil  adjacent to the product name.
  4. Using the file upload tool, Browse for and Upload the new few file. It will replace the existing file. To view the existing file first or the new file after it has been uploaded, click “Click here to view the current PDF.”
  5. Be sure to update any timely information included in the product description or Publish year fields.
  6. Click Save .
    How to Associate Products with One Another
    Often, like products are associated with one another on your E-commerce page, meaning two or more file types of the same product data are grouped together under one product name. If you do not select the option to associate products, they will each be listed individually on your website. The most common associated products are Excel and PDF versions of the same list or directory.
  1. Be sure you are in the Marketer Module .
  2. Click on the Products button .
  3. Locate one of the products (the static product) that will be associated and click on the Edit pencil  adjacent to its name.
  4. Check the box “Associated product only.”
  5. Scroll down to the bottom of the product setup page and locate the “Associate Product(s)” area.
  6. In the Product Manager , locate and highlight the name of the Product that will be associated with the one currently open in the Content Area.
  7. Load that product’s name into the “Product(s)” box.
  8. Select “Alternate Version.”
  9. Click Save .
    How to Create a Product Cross-Promotion
   

A product cross-promotion allows you to suggest and link to similar products, or other products that the customer purchasing this product might be interested in, within product details.

  1. Be sure you are in the Marketer Module .
  2. Click on the Products button .
  3. Locate one of the products that will be cross-promoted and click on the Edit pencil  adjacent to its name.
  4. Scroll down to the bottom of the product setup page and locate the “Associate Product(s)” area.
  5. In the Product Manager , locate and highlight the name of the Product that will be cross-promoted with the one currently open in the Content Area.
  6. Load that product’s name into the “Product(s)” box.
  7. Select “Cross-promotion.”
  8. Click Save .
    How to Offer Discount Codes
    In E-commerce Settings, under “Checkout Settings,” you can choose to enable the discount code feature of DataJoe’s E-commerce. If you would like to offer a discount code, contact DataJoe to have it set up. Be sure to have the following information handy when you contact us:
   
  • Expiration date
  • Amount (percentage or dollar amount)
  • If there must be a minimum purchase
  • Whether the code can be used more than once
    Back to top
5.6   Creating and Managing Project Upgrades
   

Though Upgrades are likely to be offered via a survey sent through the Researcher module and used by Source Prospects, because they are a product for which a price can be charged, they are managed through the Marketer module.
You can create an option for people to upgrade their listing in your products in multiple ways. You can allow them to purchase an upgrade so that a logo appears next to their company’s name in one of your directories. You can allow them the option to upgrade to have more data appear with their listing versus compared to others who didn’t upgrade. Or, you can offer options for their data to appear highlighted or bolded. Additionally, these upgrades can be offered for online, for print, or for both mediums through one interface.

    How to Create a Project Upgrade
   

To create a project upgrade (including Company logo), you begin by working in
the Researcher Module .

  1. Click on the Projects button . Your list of projects will appear in the main Content Area.
  2. Click on the Edit pencil  next to the name of the project you want to apply the upgrade to.
  3. Go to the project’s Survey .
  4. Go to the Field Manager .
  5. To insert the Company logo association zone, choose Company as your record type and Association as the field type.
   
  6. Click on the Company logo field.
  7. Insert the Company logo field into your Survey by using the arrows to the left of your survey.
  8. Change the record type to Image in the Field Manager .
  9. Load the standard fields Image and Image name into the Company logo association zone in your survey using the arrows.
   
  10. Save your Survey.
  11. Click on the Layout button at the top of the Project Setup screen .
  12. Insert the Company logo from the Palette into the first column of your layout using the white arrows.
   
  13. Select “None” under Label in your Edit panel.
  14. Click Save .
   

You will now be working in the Marketer Module .

  1. Click the Create button .
  2. Click on “Upgrade.”
  3. Using the Project Manager button , select the project you are applying the upgrade to and Load  it into the Project box in the main Content Area.
   
  4. Select the year you would like to apply the upgrade to (this should match your Project year in Project Setup).
  5. You would fill in Instructions if you were giving survey recipients the option to upload their own images. When you are controlling images internally, there is no need to fill in instructions.
  6. Select Manage upgrades internally only, if applicable. Checking this box tells DataJoe that any forms accessed by public users/survey recipients will not include upgrade options.
  7. Select Suppress auto-hyperlinking to ensure that company websites appearing on your E-commerce site are hyperlinked ONLY when that company has purchased an upgrade. Otherwise, company websites will be hyperlinked by default.
  8. Under Price by Category, you have the option to price upgrades by category when upgrading a product that is ranked by a Value List.
  9. Under Basic Listing, set the fields that will be included in a non-upgraded listing on your e-commerce site. Fields omitted here will appear under Upgrade Levels in Additional Fields, and will be included in upgraded listings only. The window on the right is a preview of the data that will appear online in an upgraded listing.
   
  10. Under Upgrade Levels, create a new upgrade level by clicking on the white plus sign.
  11. Name the upgrade and set a price for it under Level Details. Also determine where and how the upgrade should appear (online, in a bold listing, etc.).
   
  12. Under Additional Fields, select the fields to which the upgrade should be applied (include Company logo if applicable).
  13. Click Save .
  14. Now you must activate the HTML version within the corresponding product. Still in the Marketer Module , click on the Products button  and then the Edit pencil  next to the corresponding product name.
  15. Under Type of Product, HTML version, select “Dynamic.” Under Advanced Options, select “HTML – full version free.” Click Save.
    How to Edit Existing Project Upgrades
    To manage an existing Project Upgrade in the future, go to the Marketer Module . Click on the Products button , and you will see a highlighted section at the top of your Products lists containing all of your Project Upgrades. Click on the Edit pencil  next to the name of the upgrade you would like to edit.
   
    How to Upload an Image and Add it to a Company Record
    You will be working in the Researcher Module  .
  1. Click on the Records button .
  2. Select the name of the project in which the company record appears in the Project Selector .
  3. Be sure the Search button  is selected.
  4. Search for the name of the Company record.
  5. Click the Edit pencil  next to the name of the record.
  6. In the Manager Area, click on the Record Manager  and select Image Manager.
   
  7. If the image is already in your database, search for it and click “Go.” If you need to upload a new image, click on the purple Create button .
  8. Name the file. DataJoe suggests using a consistent naming convention when uploading images to make searching for them easier in the future.
  9. Browse for the image on your computer.
  10. Click Upload.
  11. Click Save.
  12. Load the image into the Company logo box within the company record.
   
  13. At the bottom of the record, select “Logo upgrade” in the Upgrades box.
   
  14. Save the record.
    How to Check the Size of an Image
    You are unable to adjust image size within DataJoe. We recommend that you check and edit image sizes in a graphics program before uploading them into DataJoe. We also recommend that you ask companies to send you logos that are the correct size so that you do not have to adjust their size. When you enlarge a very small image, you run the risk of it being grainy at the larger size. Ideally, your images should 120 pixels wide and 120 pixels in height.
   

You will be working in the Designer Module  .

  1. Click on the Records button .
  2. Select Image as the record type in the Record Selector .
   
  3. Be sure the Search button  is selected.
  4. Search for the name of the Image.
  5. Click the Edit pencil  next to the name of the record.
  6. Under the Details menu you will find image size details. Ideally, your images should 120 pixels wide and 120 pixels in height.
   
    Back to top
5.7   Tracking Transactions
    Track Transactions allows you to view the details of purchases made through the DataJoe E-commerce portal. In Tracks Transactions, you can view transactions by month and year, view transaction totals and summaries, print monthly transaction invoices, issue refunds, and find information about customers (called subscriber prospects).
    How to Search Track Transactions
  1. Be sure you are in the Marketer Module .
  2. Click on the Advanced Tools button .
  3. Click on “Track Transactions.” You will be directed to a summary of the current month’s transactions. In the grey shaded areas, you will see monthly transactions totals, total by type, and a year-to-date sales figure.
   

Note: "Other" refers to the full price tag of products sold. Other does not include discounts.
"Total Sales" refers to the actual money that was collected, and therefore includes discounts.

  4. View transactions for another month/year by selecting the month and year at the top of the page.
   
  5. Click the “Print” button to print an invoice of the transaction totals currently displaying on the page.
  6. View individual transactions at the bottom of the page. Here you will find order number, name of subscriber, date and time of purchase, and total amount of purchase data for each transaction.
  7. Click on the order number or subscriber name to be taken to the Order Details.
    How to Search Transactions in the Submissions Box
   

You can also search for transactions under the Submissions button.

  1. Be sure you are in the Marketer Module .
  2. Click on the Submissions button .
  3. A list of transaction by date will appear, including purchased product name(s), date ordered, subscriber name, and order complete status.
  4. You may sort the order listing by reverse date.
  5. To view the Order Details, click on the Edit pencil  adjacent to the order name.
    Understanding Order Details and Issuing Refunds
    For every transaction record, DataJoe details subscriber contact and credit card information as well as the name(s) of products purchased. From here, you can also download the product(s) that were purchased and issue refunds.
  1. Open Order Details for a specific order by locating it either in the Submissions box  or under Advanced Tools , “Track Transactions” in the Marketer Module .
  2. In Submissions, click on the Edit pencil  to view Order Details. In “Track Transactions,” click on the order number or subscriber’s name.
  3. Click on “Download Item” to download a product that was purchased.
  4. Click on “Refund” to issue a full or partial refund for the transaction.
   

Note: DataJoe staff will not issue a refund for any of your publication’s E-commerce transactions without consent from a representative of your publication.

    How to View and Download Sales Data
    Using the Dashboard tool (located under Advanced Tools in the Marketer Module), DataJoe E-commerce clients can view and download page view and sales data by type, by product, and within a specified timeframe. This data allows you to gauge the effectiveness of marketing campaigns and pricing strategies.
  1. Be sure you are in the Marketer Module .
  2. Click on Advanced Tools .
  3. Click on “Dashboard.” Here you can view page view data; product views, sales, and downloads information, sales figures by product; and more by adjusting the data range and graph view parameters.
   
  4. Use the Settings panel to a desired date range, and click Export to download an Excel file of E-commerce statistics.
    Back to top

 

  APPENDIX A: SUB-PROJECTS
   

Sub-projects allow you to repurpose data collected from another project. Creating a sub-project will bring in the same project year, flags, conditions, and fields as the “parent” project. The data from the original project can then be repurposed in the sub-project’s layout.
When might you use a sub-project? Sub-projects are often used to produce “thinner” versions of projects (with fewer fields) or to rank lists by different criteria/fields. For example, you might rank your annual Banks list by amount of deposits but want to create a smaller, scaled-down ranking of banks by number of local branches for a special section on local financial institutions. In this case, you would include fewer fields in the sub-project’s layout and change its ranking criteria.

    How to Create a Sub-project
    There are two ways to create a sub-project; one carries over the layout from the parent project. The other gives you a blank layout to design yourself.
   

Create a Sub-project with the original project’s layout:

  1. Be sure you are in the Researcher Module .
  2. Click on the Projects button .
  3. Click the Edit pencil  adjacent to the name of the parent project (the one from which you will create the sub-project).
  4. At the bottom of the Setup screen, click the Save As button .
  5. Name your sub-project in a manner that will help you easily identify it in your project list (e.g., “Sub-project of Banks”).
  6. Go back to your Projects .
  7. Click on the Edit pencil  adjacent to the name of the parent project.
  8. In the Project Manager , locate the sub-project you just created, and highlight it. The sub-project will be listed under its type, Ranked List or Directory.
  9. Locate the Sub-projects toggle on the Project setup window in the main Content Area.
  10. Load  the sub-project into the Sub-projects box.
   
  11. Click Save .
   

Create a Sub-project with a blank layout:

  1. Be sure you are in the Researcher Module .
  2. Click on the Projects button .
  3. Click the Create button .
  4. Locate and highlight the name of the parent project in the “Create from project:” drop-down menu.
  5. Click on “Sub-project.”
   
  6. Fill in an appropriate name for the project in the “Subproject name:” field.
  7. Add any applicable project criteria (flags and conditions), and change the project type (ranked list vs. directory) if applicable.
  8. Click Save .
    How to Edit a Sub-project's Layout
    Because a sub-project will not be surveyed and pulls data directly from the parent project, you will be unable to change the parent project’s year or unload the parent project’s criteria (flags and conditions). You may add additional criteria, however. You may also change the project type from Ranked List to Directory, or vice versa.
   
    You will be unable to edit the project’s survey.
  1. Click on the Projects button .
  2. Click on the Edit pencil  adjacent to the name of the sub-project.
  3. Go to the Layout step .
  4. Depending on how you created the sub-project, you will see either a blank layout window, or a replica of the parent project’s layout (all fields and formatting will remain in place).
  5. All of the fields from the parent project’s survey will be present in the Palette.
  6. You may load and unload fields from the Palette into the layout window as you desire; you may also change the sub-project’s ranking criteria. See section 2.10, “How to Edit the Layout of Ranked Lists and Directories” for step-by-step instructions.
  7. Be sure to click Save  when you finish editing the sub-project’s layout.
  8. Data in the Merge Fields (under the Optional Settings step of Project setup) will not carry over from the parent project. Be sure to populate those fields for the sub-project and Save .
   
  9. You also have the ability to override the parent project’s previous rank, which carries over to the sub-project by default. To do this, go to the subproject’s Optional Settings and check the box “Sub-project prev. rank overrides.” Click Save .
   
    How to Edit a Sub-project's Records
    Because sub-projects do not have their own survey setup, clicking on a record from the sub-project’s BlueLines or an Advanced Search result will take you to that record’s Advanced Details in the parent project (the parent project’s survey).
  1. Select the sub-project in the Project Selector .
   

Note: Sub-projects appear with a tilde in front of their names in the Project Selector.

  2. Click the Publish button  to go to BlueLines.
  3. Click on a record to go to its Advanced Details (the survey) for the parent project.
  4. Make any applicable edits to the record’s data. These edits will apply to this record for the sub-project and parent project.
  5. Click Save .
    Note: You will be directed back to the parent project in BlueLines. To view the subproject in BlueLines again, choose it in the Project Selector.
    Back to top

 

  APPENDIX B: INNER-PROJECTS
   

Inner-projects allow you to cross-survey, or send one group of records a survey to fill out for another type of records. In other words, they are essentially one survey within another survey.
The main survey is the survey you will use to send out your blast. The inner-project survey is the survey you will use to collect data for additional records within the main survey. The survey blast will be sent to the result set that meets the criteria for the main survey, whose contacts will also be able to provide data for the inner-project survey.
One example of this is sending an Office Complexes (inner-project) thing survey to a set of property management companies within the Property Management Companies company (main) survey. Another example is surveying medical practices through a (main) company survey while collecting data on individual doctors for a person directory using an inner-project survey.
Inner-projects allow for several layers of associations between projects and greater flexibility in organizing projects, especially directories.

    How to Create Inner-Project Surveys
    The first step to creating an inner-project is to create the two surveys independently.  
  1. Be sure you are in the Researcher Module .
  2. Go to your list of projects by clicking the Projects button .
  3. Click the green Create button  to create a new project, if necessary.
  4. See sections 2.3 -2.6 for step-by-step instructions on setting up projects and surveys. Be sure each project is assigned the appropriate flags.
    Note: The Project year for both projects should be the same.
  5. In order to relate the two surveys for an inner-project, they must have an association that links them together (for example, the Property Management Companies project would have a “Complexes Managed” association holder, while the Office Complexes survey would have a “Office Complex Manager” association holder). See “How to Create an Association Holder” in section 2.5 for step-by-step instructions.
   
  6. Once both surveys have been set up, including their connecting associations, you must link the two together. Do this by going to the Setup stage of Project setup  for the main survey.
  7. Click the arrow to the left of the "Inner-project" toggle to open it.
  8. Locate the inner-project survey in the Project Manager . Load  it into the Inner-project box.
  9. When you load the inner-project, any association holders present will appear listed to the right. Be sure the radial button is selected for the association that ties the two projects together.
   
  10. Save  the project.
    Providing Clear Instructions for Survey Recipients
   

Inner-project surveys will appear differently, so even seasoned DataJoe survey recipients will need clear instructions on how to go about filling them out. When survey recipients click on the “Update my data” button, instead of being directed straight to a survey, they will go to a manager area where they can update and manage interior listings, or records on the inner survey, as well as the main survey.

   
   

The survey recipient will first need to update and/or add new listings (records) for the inner-project survey. Any existing projects will appear in the bottom box (in the screen shot, there are no current Office Complex listings). To add new Office Complex records, the survey recipient will click on [new] and be directed to the inner-project survey. The survey recipient can submit several records for the inner-project survey. The survey recipient should then click on the record name appearing in green under “Record to update” to access the main survey.
It is important that the survey recipient submit all inner-project surveys (interior listings) before submitting the main survey, so your instructions here are crucial.

  1. Go to the Optional step of Project setup for the main survey .
  2. Click on the arrow to the left of “Survey settings.”
  3. Click on the arrow to the left of “Inner-project.”
  4. In the “Interior record label” box, provide a clear title for the interior listings/inner-project records.
  5. In the “Intro text” box, type clear instructions for the survey recipient on the order in which to fill out and submit the surveys (interior listings before main survey).
  6. Click Save .
    Processing Inner-Project Submissions
    Inner-project submissions will also appear differently than normal survey submissions in your Submissions box. As seen below, interior listing submissions appear indented underneath the main survey.
   

Note: You will not receive inner-project submissions until the main survey has been submitted.
It is important to process them in a specific order (interior listings first, then main survey).

   
    See section 2.9 (“Processing Survey Submissions”) for step-by-step instructions on this process.
    How to Lay Out Inner-Projects
    The layout of inner-projects is set up the same as any other project (see section 2.10).
    Back to top

 

  APPENDIX C: PROJECT PACKAGES
   

The Project Package is a “snapshot” of how data appears at that moment in time in a selection of lists or directories that you choose to combine into a single .zip file. This package will remain in its current state until you update (re-cache) the project. An e-commerce product can be created from this project in the Marketer Module.
You can choose to leave the data in a project package as-is throughout the year, or you can keep it constantly updated with changes to the database by re-caching the Project Package. By re-caching the project package, you are essentially taking a new snapshot of the data in the records of the projects that are included.
The most common example of a project package is a digital Book of Lists.

    Steps to Take before Creating a Project Package
    Before you create a project package, you’ll want to make sure that the projects you’ll be adding to the package have the correct E-commerce Access settings.
  1. Be sure you are in the Researcher Module .
  2. Go to your list of projects by clicking the Projects button .
  3. Click the Edit pencil  to a project’s name to edit its E-commerce Access settings.
  4. In the Setup step of Project setup , locate the “E-commerce Access” toggle toward the bottom of the page. These settings control what records will flow into the e-commerce product that is created from this project in the Marketer Module.
  5. Under Latest year published, select the latest year from which customers should be able to view and purchase data on your e-commerce site. If you are still working on a 2011 list, you’ll want to keep your Latest year published to 2010, so that people can’t purchase something that you’re not ready to sell. Once you’ve published your 2011 project and want to sell your newest data, you’ll want to switch this to 2011 to make the newest information available on your Products page and for inclusion in your Project Package.
  6. Under Include, choose whether you will be creating a product that should have “Finaled records only” or “All records meeting criteria” for the project. The “criteria” refers to that project’s flags and conditions.
   
  7. Click Save .
  8. Repeat for each project to be included in the package.
    How to Create a Project Package
  1. In the Researcher Module , click the Projects button .
  2. Click the green Create button  in the Header Area.
  3. Choose “Project Package Tool.”
   
  4. Enter the Project name. This is for internal use only.
  5. Choose the Package year (the year from which most, or all, of the projects in the package are current).
  6. You can choose to set a default record limit for all of the projects to be included in your package. If you limited you printed lists to 25 records throughout the year and would like this project package to mirror that, set it to 25. If you want to include all records meeting criteria, you can select a higher number.
  7. Select the checkbox “Package year overrides individual project years” if you want to ensure that is the case.
  8. Select the checkbox “Include e-mail addresses in contacts file” if you want the person associations’ personal email addresses to appear in the extra Contacts file included in the project package.
  9. Using the Project Manager  to Load  all of the ranked lists and directories that should be included in the project package into the “Include projects” box. Each project you load will appear as a single Excel file within the .zip project package download.
  10. You may apply custom settings to any of the projects in the package by highlighting it in the “Include projects” box and checking “Customize settings.” Here, you can customize the project year, which records are included (finaled only or all records meeting criteria), and the record limit.
   
  11. You may also build an index file for your print book of lists here (see “How to Build a Print Index” below).
  12. Once all of the projects are added and settings adjusted to your specifications, it is time to save the project package. You have two options:
   

Save/No cache : Choosing Save/No cache means that the settings you have applied within the Project Package Tool will be saved when you leave this project and come back in, but the settings will not be applied to the download result, and your project’s data will still reflect how the data appeared at the time of your last cache.

   

Save/Cache : Each time you do a Save/Cache, the project package will be re-built and will take a new “snapshot” of the data at that time of the records in those projects. When it re-builds it will also take the most recent settings you have applied to each project and will update those settings in the download. When you choose Save/Cache, you’ll see a Progress Bar at the top as the project re-builds to let you know how long it will take before you can move off the page.

   
  13. If you have finished building your project package and cached it, you can click on the “Download file” link to download and view it immediately.
   
    Note: See the Marketer Module  how-to guide for step-by-step instructions on turning a project package into a product to sell through your e-commerce site.
    How to Build a Print Index
    The print index allows you to build an Excel file of records included in lists within your Project Package matched to the page number(s) on which those records appear in your printed product. The download will not only include primary records, but will also include associated records (e.g., person in charge for a company). The Excel download will have three columns – Record Name, Record Type, and Page Number(s).
   

Note: The print index will not work for directories.

  1. To create the index, you will need to select each individual project within the “Include Projects” box. For each project, you’ll click on the “Include in print index” checkbox and enter the corresponding index information in the Printed page(s) area.
  2. The following format will need to be used to assign pages numbers to the records:
PageNumber:RecordRange;SecondPageNumber:SecondRecordRange. For example, if records 1 through 12 of your ranked list appear on page 25 of your printed project and records 13 through 25 of your list appear on page 27, you would enter this into the Printed page(s) area: 25:1-12;27:13-25
   
  3. Your project will need to be re-cached in order for any changes to the Print Index to take effect. Click Save/Cache . Remember, re-caching the project package will also cause it to take a new snapshot of the database and update the records in the project package if any changes have been made to them since the last time you cached.
  4. After the project package has been re-cached, you’ll see the option to “Download Index” at the top of the Project Package page.
   
   

This download will be an Excel file. You will stylize your print index outside of DataJoe.

    Back to top

 

  APPENDIX D: IMPORT TOOL
    Importing allows you to add large quantities of data from sources other than surveying into your database without having to enter it manually. Because of the impact importing has on your database, proper preparation before importing is crucial. This guide will walk you through several steps of the import preparation and executive process. Read this guide carefully before you begin importing.
    Note: Certain types of data cannot be imported, such as custom fields within association holders, and footnotes.
    How to Prepare the Survey before Importing
    In order to import custom and association data, and to flag records as they are imported, you must first ensure that the survey’s set up is correct and that fields are clearly.
  1. Be sure you are in the Researcher Module .
  2. Click on the Projects button .
  3. Click the Edit pencil  adjacent to the name of the project into which you will import data.
  4. Make sure that the Project year is correct (generally the current year).
    Note: Data in fields that are not fixed across years can be imported into any year you specify during the import matching process, but it is good practice to ensure your Project year is current.
  5. Be sure you have at least one custom (normal) flag loaded into the project. The records will automatically receive this flag when they are imported.
  6. Go to the Survey step of Project setup .
  7. Make sure that all of the fields that you need to import data into are present on the survey. Also ensure that the year is correct for all fields that are not fixed across years.
  8. Check your field labels. Make sure that they are clear, as those will be all you see during the matching process when you are importing. This is especially important for fields that are not fixed across years (use the [YEAR] and [YEAR-1] merge tags).
  9. Be sure you are aware of the field type of each field in the survey (yes/no, value list, numeric, etc.). Knowing this is crucial in formatting the spreadsheet correctly for import.
  10. Be aware of all association holders and their related fields. These will have special consideration during the field-matching process.
    How to Prepare the Excel File before Importing
   

Precise specifications must be met when preparing the data file for import, or the import may be unsuccessful.

    Note: Blank data fields in your data file will not overwrite existing data in the database.
  1. Data in the Excel file must be distributed into columns according to the fields in which they will be imported. For example, because a person’s first name and last name are separate fields in your survey in DataJoe, first names and last names must be separated into separate columns in your spreadsheet.
   
  2. All cells in your spreadsheet should be formatted as “General.” To do this, hold down Ctrl+A, right click and select “Format Cells.” Choose “General,” and click “OK.”
  3. Row #1 in your spreadsheet must include the column headers. The column headers must each be unique and should match the field labels in your survey as closely as possible. Include the year for any data column that will be imported into fields that are not fixed across years. You will use these titles to match with fields in your DataJoe survey during the import process.
    Note: If any two column headers are identical, the import will fail. Special characters in the column headers may also cause an import to fail, and empty column headers can wreak havoc on a data import.
  4. Delete any WND or N/A marks from the data file. DataJoe will supply appropriate marks for fields that have no data.
  5. Be sure that your data file meets the precise specifications for importing into each of the following field types:
   

Numeric and Currency Fields: Numbers and currency figures must be formatted as real digits. No commas, dollar signs, or text may be included in these data points. For example, change “8 million” or “$8 mil” to “8000000.”

   

Percentage Fields: Only numeric values may be present in these data points. Leave out the % sign; DataJoe will supply it.

   

Yes/No Fields: All yes or no values must be formatted as “Y” or “N,” rather than “yes,” “no,” a checkmark, an “X,” etc. You may specify alternate formatting within DataJoe.

   

State Fields: State data may be formatted as AP Style, postal code abbreviations, or the full names of states.

   

Value Lists: Values must be spelled and capitalized exactly as they are in the value list in DataJoe and must be separated by tic marks and a space in the data file (ex: accounting` government` education` healthcare).

   
   

Note: Delete any special characters in your data file, including bullets, accent signs, backward slashes and tabs. These are known to trip up the import process.

  6. Finally, highlight several columns to the right of the last column, right click, and choose “Delete.” Do this also with several rows below the last row. This will ensure you remove any extraneous data from the spreadsheet.
    How to Save the Data File before Importing
    Once you have finished formatting the Excel file, you must save it as a Text (Tab delimited) file in order to import the data.
  1. Once you saved the Excel file, with your Excel file open, click Save As.
  2. Choose the file type “Text (Tab delimited).”
  3. Select the appropriate place to save the file (My Documents, Desktop, etc.)
  4. Click Save.
  5. If a pop up appears saying, “The selected file type does not support…,” click “OK.”
  6. If a second pop up appears saying the file “may contain features that are not compatible…,” click “Yes.”
  7. Close the document. If a pop up appers asking if you want to save the Excel file, click "Don't Save."
  8. Locate and open the Text (Tab delimited) file in Notepad.
  9. When converting files from Excel to Notepad, extraneous quotation marks can appear. To remove them, Click “Edit” and “Replace.” Then, type a single quotation mark into the “Find what” field and click in the “Replace with” field but type nothing. Click “Replace All.”
   
  10. Save the file and close it.
    How to Upload the Data File before Importing
    Once the Text (Tab delimited) file has been formatted, you will upload it into the Import Tool to begin the matching process.
  1. In DataJoe, be sure you are in the Researcher Module .
  2. Choose the correct project in the Project Selector .
  3. Go to Advanced Tools .
  4. Click on “Import Tool.”
  5. Click Browse .
  6. Locate and open the Text (Tab delimited) file on your computer.
  7. Click Load it . This is point where you will receive a red error message, most likely, “File improperly structured,” if there is a problem with the data file. If you receive this error, refer back to “How to Prepare the Excel File before Importing” to see if you missed any of the steps and/or tips.
    Note: If the file will not load a second time, contact DataJoe for help. Do not spend hours trying to import.
  8. You will now see a preview of the file in the window. This is only a sample (the first 50 records) so that you may verify that there are no columns missing data or a header, and that there are not any other obvious problems with the data file.
   
  9. If the data looks ok, click “Match fields” at the top of the window to move on to the matching stage of importing.
    How to Match Records for Importing
    Once the Text (Tab delimited) data file has uploaded successfully, you are ready to match the incoming columns from your file to the fields in your survey.
  1. Click “Match fields.” In the box on the left, you will see the column headers from your data file. In the box on the right, you will see all of DataJoe’s standard fields for the record type the project is built off of, as well as all of the custom and association fields present in the survey.
   
  2. To match records, click on the column header on the right, and then on the corresponding field name on the left, and click the green “Match Selected Records” button in the center. You will then see the match appear in the center box. The column label will now appear grayed out in the left-hand box.
   
  3. For custom fields that are not fixed across years, you will have to complete one additional step when matching. After you click “Match Selected Records,” a “Select Year” box will appear asking you to designate the year into which the data should be imported. It will default to the Project year (generally the current year), but you can change it by keying in a different year. Click “OK.”
   
   

Note: If you have a not-fixed-across-years field present in your survey more than once (i.e., for more than one year), it will appear only once in the right-hand box. You can match incoming data to it multiple times, and change the year each time.

  4. To match association data, open the italicized association holder in the right-hand box to bring up all of the association’s standard fields.
   
   

When you are finished matching fields within that association, click the green “Cancel” button at the top of the right-hand box to return to your list of survey fields.

   

Note: You can match multiple records for one association. If you had two survey contact names , for example, you would match the first to the “Survey contact (1) First name,” etc., and the second to the “Survey contact (2) First name,” etc. fields.

  5. When all of the fields have been matched, review the matches in the center box to make sure they appear correct.
  6. When you are confident that you have matched the fields correctly, click “Run import” at the top of the screen.
    How to Check for Matching Records while Running the Import
   

As the import runs, you will see the green Status Indicator bar move from 0% to 100% completion. Do not navigate away from this page until the import is 100% complete.
DataJoe will try to match incoming records to records that already exist in the database during this process. When DataJoe finds a potential match, the import will pause so you can review the potential matches and decide if they should be merged or not.
The record comparison will point out any discrepancies in standard and custom data and provide a side-by-side comparison of each record’s associations. It will also provide a combined list of the flags associated with each record.

   
  1. View the standard and custom data discrepencies (if there are any). Data for the incoming record appears on the left. If standard and/or custom data points do not appear here for comparison, that means that the incoming record’s data matches the existing record’s data excatly, a good sign that the two records are indeed the same.
  2. Select which data point(s) should be used when the two records are merged into one, or insert a new data value into the purple box that pops up when you select the data point on the right.
   
  3. View the association comparison(s). Clicking on the name of an associated record will show you which record it is associated with and in what capacity.
    Note: The DataJoe Import Tool does not offer the ability to merge association data upon import, meaning that duplicate associations may be created in your database. Before running an import, determine if several of the associated records already exist in your database. If so, it may be wiser to leave the associations out of the import and make updates by hand.
  4. View the flags associated with the existing records. In this case, only the Coffee Shops flag appears because it is the only flag associated with the existing record.
   
  5. Once you have made a determination on whether the records should be combined, you have three options:
   

Match records: Merge the incoming record with the existing record.

   

New record: Create a new record in the database.

   

Skip record: Skip this incoming record during this import and make a determination later. No data will be added or updated in the database.

  6. Once the import is 100% complete, you will see a report of how many records were updated (matched) within the database, added to the database, and skipped during the import.
  7. To view the new data, click the Publish button  to go to BlueLines.
    Back to top

 

  APPENDIX E: COMBINATION TOOL
    The Combination Tool allows to you easily combine duplicate records (up to 3 at a time) in the database, merging those records’ data and flags into one record.
    How to Search for Duplicate Records in the Database
  1. Be sure you are in the Researcher Module .
  2. Click on Advanced Tools .
  3. Click on “Combination Tool.”
  4. Select the “Type of Record” you want to work with from the drop-down menu (company, person, thing, or prospect).
   
  5. Click the “Search for duplicates” link underneath the “Type of record” menu. The Manager will automatically open to the corresponding Record Manager  (company, person, thing, or prospect). A list of possible duplicate records will appear (each set of possible duplicates will be highlighted in the same color.
   

Note: You may also locate possible duplicates that you are already aware of by opening the appropriate Record Manager  (company, person, thing, or prospect) and searching for the record name.

   
  6. Load the possible duplicates (up to 3 at a time) into the “Records to Combine” box.
  7. Click “Compare”  to see a side-by-side detail of the records’ standard and custom data discrepancies as well as a comparison of the companies, people, things, and/or prospects related to the records.
    How to Compare Possible Record Matches
  1. Once you have loaded possible record matches, click “Compare”  to see a side-by-side detail of the records’ standard and custom data discrepancies as well as a comparison of the companies, people, things, and/or prospects related to the records.
  2. Select the correct data point for each discrepancy by clicking the radial button to its left. The selected data point will override the other data point(s) when you combine the records.
   
  3. If applicable, click on the arrow next to “Standard Data” or “Custom Data” to view the fields with discrepancies. The data next to #1 is connected to the first record you loaded to combine. The data next to #2 is connected to the second record you loaded to combine, etc.
    Note: If no standard or custom data discrepancies appear, that means all of the data for both or all 3 records is an exact match, a good sign that the records are in fact duplicates and should be combined.
  4. Using the radial buttons, select which data should be preserved for the field(s) experiencing the data discrepancy when the records are combined. You may also click on one of the data points to open up a field for a custom edit to the data.
  5. If applicable, click on the arrow next to associations to compare. For example, if Person Associations appears in the comparison view, click on the arrow to the left of it to see the people association with both or all 3 companies you are comparing.
   
  6. Click on an associated record’s name to see how it is related to each record. In the example above, Paige Coker Heiman is associated to both record #1 and record #2. If you choose to combine these records, she will be attached to the new company record once.
    Note: If Paige Coker Heiman’s name had appeared in the “Employee” box twice, that would mean her person record exists twice in the database (has a duplicate). Combining this company record would NOT combine her person record. You would need to do that separately, so take note.
    Once the records are combined, any records left within the Association area will be attached to the combined master record.
  7. To remove an association record before combing the loaded records, use the Unload button  to remove the association from the combined record. This action will not delete the associated record from the database. To permanently delete this record, make note of it and search for it later to permanently delete it.
    Note: If you’d like to add more associations to the record, you’ll need to wait until you combine the record and then make the edits accordingly in the updated, merged record’s Basic or Advanced Details.
  8. View the Flags associated with both or all 3 records by clicking the arrow to the left of the word “Flags.” This will show you all of the flags associated with both or all 3 records (each flag appears one time, even if it is associated with more than one record).
   

Note: If there are flags you want to eliminate, take note. You’ll have to take care of this in Basic Details after combining the records.

  9. If you are certain you want to combine the records, click “Combine Records” .
  10. If you decide against combining the records, unload  them from the “Records to Combine” box.
    Back to top

 

 

 

 

 

 

 

 

 

How to guide