![]() |
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. |
||
![]() |
||
| 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 |
||
![]() |
||
| How to Create, Delete, and Edit Users | ||
Create User: To create a user, administrators can click the green
Create button |
||
Delete User: To delete a user, administrators can pull up a list of
users by clicking the green Search button |
||
Edit User: To edit a user’s profile, administrators can pull up a
list of users and click on the green Edit button |
||
| 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 |
|
| 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 |
|
![]() ![]() |
||
| 4. | Click on the purple Create button |
|
| 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 |
||
| How to Edit General Publication Information and Logos | ||
| 1. | In the Identity Module |
|
| 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). |
||
| How to Conduct a Basic Search | ||
| 1. | Click on the Record button |
|
| 2. | Be sure the Project Selector is clear |
|
| 3. | Be sure the Search button |
|
| 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 |
|
![]() |
||
| 6. | To search using a condition, click on the Condition Manager button |
|
![]() |
||
| 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 |
|
![]() |
||
| 8. | You can navigate through a result set of records by using the arrows at the top of the content area |
|
| How to Conduct an Advanced (Project-Specific) Search | ||
| 1. | Click on the Record button |
|
| 2. | Be sure the project you are working within is selected in the Project Selector |
|
| 3. | Be sure the Search button |
|
| 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 |
|
| 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 |
|
| 2. | Click on the Edit pencil |
|
| 3. | Go to the Optional Settings |
|
| 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”). |
||
| How to Create a New Record | ||
| In Basic Details: | ||
| 1. | Click on the Record button |
|
| 2. | Click the Create button |
|
| 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
|
|
![]() |
||
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. |
||
![]() |
||
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 |
|
![]() |
||
| 6. | You can add a footnote to any data field within this record by clicking on the Footnote button |
|
| 7. | Save |
|
| In Advanced Details: | ||
| 1. | Click on the Record button |
|
| 2. | Click the Create button |
|
| 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 |
|
| 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 |
|
| 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 |
|
![]() |
||
You may also click the Edit icon next to the record’s name. Then, click the purple Delete button
|
||
| 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 |
|
| 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 |
|
| 5. | To view a history of all edits made to the record, click the Logs button |
|
| 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 |
|
| 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 |
|
| 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 |
|
| 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 |
|
| 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 |
|
| 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. |
||
| How to Create a New Project | ||
| 1. | Click on the Projects button |
|
| 2. | Click on the Create button |
|
| 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 |
|
![]() |
||
Associating a flag with a project tells DataJoe that only companies |
||
| 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 |
|
| Note: You can also create a new project by opening the Project Setup of an existing project
and clicking the Save As button |
||
| How to Edit an Existing Project | ||
| 1. | Click on the Projects button |
|
| 2. | Click the Edit button |
|
| 3. | Be sure to click Save |
|
| 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. |
||
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: |
||
|
||
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. |
||
| 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 |
|
| 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 |
|
| 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 |
|
| 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 |
|
| 2. | Click on the Edit button |
|
| 3. | Go to the Survey stage of project setup |
|
| 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 |
|
| 7. | Switch the field Type in the Field Manager |
|
| 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 |
||
![]() |
||
| 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 |
|
| 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 |
|
| 3. | Go to the Optional Settings step |
|
| 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 |
|
![]() |
||
| 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. |
||
| 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 |
|
![]() |
||
| 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 |
|
![]() |
||
![]() |
||
| 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 |
|
| 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 |
|
![]() |
||
| 4. | Double check your Cover Letter to ensure it is ready to be sent by clicking on Advanced Tools |
|
![]() |
||
| 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
|
|
![]() |
||
| 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 |
|
![]() |
||
| 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
|
|
| 2. | Click the Survey button |
|
| 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 |
|
| 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 |
|
| 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. |
||
![]() |
||
| 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 |
|
![]() |
||
| 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 |
|
| 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 |
|
| 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 |
|
![]() |
||
| 2. | To search the Survey Logs by blasts related to a particular project, load the project from the Project
Manager |
|
![]() |
||
| 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. • 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 |
|
| 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 |
||
| 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 |
||
| Navigating the Submissions Inbox | ||
| 1. | Click on the Submissions button |
|
| 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. |
||
| 3. | Clicking the Edit pencil |
|
![]() |
||
| 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 |
|
| How to Review and Edit Survey Submissions | ||
| 1. | Click the Edit pencil |
|
![]() |
||
| 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 |
|
![]() |
||
| 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 |
||
| 3. | You will now be directed back to the Submissions inbox |
|
| 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 |
|
| Back to top | ||
| 2.10 | Editing the Layout of Ranked Lists and Directories | |
The Layout portion of Project setup |
||
| 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 |
|
| 2. | Click on the Edit button |
|
| 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 |
||
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 |
||
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 |
||
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 |
||
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 |
||
![]() |
||
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 |
|
![]() |
||
| 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 |
||
| 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 |
|
| 5. | Be sure always click Save |
|
| 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. | ||
| 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 |
|
| Note: Style adjustments for a project’s layout can also be made under Optional
Settings |
||
| 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 |
|
| 3. | Go to the Optional Settings step of Project setup |
|
| 4. | Click on the Summary Data toggle |
|
| 5. | Select the field(s) to which you would like to add summary data. | |
![]() |
||
| 6. | Click Save |
|
| 7. | Generate the project to BlueLines |
|
![]() |
||
| 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 |
|
| 2. | Click on “Contact info.” | |
| 3. | All of the company standard fields appear on the left. Using the arrow |
|
| 4. | You can rearrange the order of the fields as they will appear in Excel downloads using the up |
|
| 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 |
|
| 3. | Go to the Optional Settings step |
|
| 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 |
|
| 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 |
|
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 |
|
| 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 |
|
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 |
|
| 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 |
|
| 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. |
||
![]() |
||
| 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 |
|
| 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 |
|
| 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 |
||
| 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 |
|
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 |
|
| 2. | Click the Publish button |
|
| 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 |
|
| 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 |
|
| 6. | Click Save |
|
| 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 |
|
| 8. | Click Save |
|
| 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 |
|
| 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 |
|
| 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 |
|
| 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 |
||
| How to Conduct a Basic Image Search | ||
| 1. | Be sure you are in the Designer Module |
|
| 2. | Click on the Records button |
|
| 3. | Be sure the Project Selector is clear |
|
| 4. | Be sure the Search button |
|
| 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 |
|
![]() |
||
| 7. | You can navigate through a result set of records by using the arrows at the top of the content area |
|
| How to Create a New Image Record | ||
| Create an Image Record in Basic Details: | ||
| 1. | Click on the Records button |
|
| 2. | Click the Create button |
|
| 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 |
|
| 7. | Save |
|
| 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 |
|
| 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 |
|
![]() |
||
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 |
|
| 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 |
|
| 5. | To view a history of all edits made to the record, click the Logs button |
|
| 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. |
||
| How to Conduct a Prospect Search | ||
| 1. | Click on the Records button |
|
| 2. | Be sure the Search button |
|
| 3. | In the Search screen, click Source or Subscriber (depending on which type of prospect you are looking for)
and click Search |
|
![]() |
||
| 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 |
||
| 5. | Once you have generated a result set of records, you can download them into an Excel spreadsheet by clicking
the Download button |
|
| 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 |
|
| 2. | Click the Create button |
|
| 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 |
|
| 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 |
|
![]() |
||
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 |
|
| 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 |
|
| 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. |
||
| 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 |
|
| 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. |
||
![]() |
||
| 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 |
|
![]() |
||
| 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 |
|
| 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 |
|
| 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. |
||
| 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 |
|
| 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 |
||
![]() |
||
| 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 |
|
| 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 |
|
| 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 |
|
| 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 |
|
| 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 |
|
| 4. | Scroll down to the bottom of the product setup page and locate the “Associate Product(s)” area. | |
| 5. | In the Product Manager |
|
| 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: | ||
|
||
| 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. |
||
| How to Create a Project Upgrade | ||
To create a project upgrade (including Company logo), you begin by working in |
||
| 1. | Click on the Projects button |
|
| 2. | Click on the Edit pencil |
|
| 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 |
|
![]() |
||
| 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 |
|
| 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 |
||
![]() |
||
| 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 |
|
| 4. | Search for the name of the Company record. | |
| 5. | Click the Edit pencil |
|
| 6. | In the Manager Area, click on the Record 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 |
|
| 4. | Search for the name of the Image. | |
| 5. | Click the Edit pencil |
|
| 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. |
||
| 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 |
|
| 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 |
|
| 2. | In Submissions, click on the Edit pencil |
|
| 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. |
||
| 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 |
|
| 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 |
|
| 8. | In the Project Manager |
|
| 9. | Locate the Sub-projects toggle on the Project setup window in the main Content Area. | |
| 10. | Load |
|
![]() |
||
| 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 |
|
| 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 |
|
| 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 |
|
| 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. |
||
| 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 |
|
| 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 |
|
| 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 |
|
| 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 |
|
| 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. |
||
| 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. |
||
![]() |
||
| 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. |
||
| 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 |
|
| 4. | In the Setup step of Project setup |
|
| 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 |
|
| 2. | Click the green Create button |
|
| 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 |
|
| 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 |
||
Save/Cache |
||
![]() |
||
| 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 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 |
|
| 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 |
|
| 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 |
|
| 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. |
||
![]() |
||
| 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 |
|
| 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 |
|
Note: You may also locate possible duplicates that you are already aware of by opening
the appropriate Record Manager |
||
![]() |
||
| 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” |
|
| 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 |
|
| 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 |
|
| Back to top |