Product documentation Docs
    • English
    • Deutsch
    • 日本語
    • 한국어
    • Français
  • More Sites
    • Now Community
    • Developer Site
    • Knowledge Base
    • Product Information
    • ServiceNow.com
    • Training
    • Customer Success Center
    • ServiceNow Support Videos
  • Log in

Product documentation

  • Home
How search works:
  • Punctuation and capital letters are ignored
  • Special characters like underscores (_) are removed
  • Known synonyms are applied
  • The most relevant topics (based on weighting and matching to search terms) are listed first in search results
Topics are ranked in search results by how closely they match your search terms
  • A match on the entire phrase you typed
  • A match on part of the phrase you typed
  • A match on ALL of the terms in the phrase you typed
  • A match on ANY of the terms in the phrase you typed

Note: Matches in titles are always highly ranked.

  • Release version
    Table of Contents
    • Now Platform capabilities
Table of Contents
Choose your release version
    Home Madrid Now Platform Capabilities Now Platform capabilities Service administration Survey Management Survey administration Survey definitions Modify a survey definition

    Modify a survey definition

    • Save as PDF Selected topic Topic & subtopics All topics in contents
    • Unsubscribe Log in to subscribe to topics and get notified when content changes.
    • Share this page

    Modify a survey definition

    You can configure additional options for a survey definition.

    Before you begin

    Role required: admin or survey_admin

    Procedure

    1. Navigate to Survey > View Surveys.
      Each survey definition is stored as a record on the Assessment Metric Type [asmt_metric_type] table with a modified view for survey use.
    2. Open a survey definition. The Response Trend chart with the weekly trend of the survey instance count, and the Survey Summary chart with the overall summary response based on instance states are displayed.
    3. Modify the fields on the Survey Definition form, as appropriate.
      Note: You can only edit a survey that has the same application scope as that of your current session.
      Table 1. Survey Definition form
      Field Description
      Name Name of the survey, which appears on the questionnaire.
      Description Helpful information about the survey.
      Active Check box to activate the survey definition. When the Active check box is cleared, new survey instances cannot be generated and users cannot complete existing survey instances. Use the Active check box to deactivate or activate a published survey.
      Anonymize responses Check box to ensure that all responses for this survey are stored without the submitting user names. When a user submits a survey, the system clears the Assigned to field for the associated survey instance. Also, survey responses for anonymous surveys do not contain Assigned to values.
      Note: The Assigned to field is cleared. However, each response record includes the Created By and Updated By fields that are accessible to users with the survey_admin role.
      Send notifications Check box to send a notification that the survey has been taken.
      State Status of the survey: Draft or Published.
      Allow retake Check box that allows users to modify their answers to a completed survey. Users can resubmit a survey as many times as they want until the due date. After that date, the system removes the survey from the user's My Assessments & Surveys page.
      Scheduled job Scheduled job the system creates for this survey definition when the schedule period is a repeating interval. The system sets the scheduled job to run according to the selected schedule period. If you change the schedule period and save the survey definition:
      • The system deletes the old scheduled job.
      If you selected a recurring schedule period:
      • A new scheduled job is created.
      For example, if you change the schedule period from Daily to Weekly and save the record:
      • The system deletes the daily scheduled job.
      • Creates a weekly one set to run a week from the current date.

      This field is visible to administrators only if the schedule period is Daily, Weekly, Monthly, or Yearly.

      Assessment duration The length of time to complete assigned survey instances, starting from the time the survey instance is generated. The assessment duration sets the Due date for each survey instance. The default duration is 14 days. Configure the form to see this field.
      Note: By default, the system runs the Cancel Expired Assessments script every 30 days to cancel expired survey, assessment, and quiz instances that are in the Work in progress or Ready to take states.
      Send notifications Select the check box to send notifications for the survey when it is published. Configure the form to see the field.
      Other Options
      Sample Metric A metric of the current survey that you can include as an image in the email or invitation sent to a survey user. When the survey user clicks the image in the email or while previewing the HTML body, the entire survey is available to be taken.
      Note: You cannot edit or delete a metric that is selected in this field.
      Signature Acknowledgement by a survey recipient of requirements, admonitions, or policies related to the survey. The signature may require the recipient to select a check box or to type a full signature to verify having read these assertions. You can display assertions without requiring a signature. Select an existing signature from the list or click New to create a new one. The signature form contains these fields:
      • Name: Descriptive name for this signature.
      • Signature type: Type of signature required. The selections are Check box, Full name, or Assertion only. If Assertion only is selected, no signature is required to submit the survey.
      • Assertion: Text you want to display to recipients.

      By default, a property called Require authentication for user signature (com.snc.assessment.signature_authentication) requires users to authenticate when providing a full name signature.

      Schedule period Option that determines how often a user can take the same survey and whether the system generates survey instances on a schedule.
      Note: If you use a trigger condition for a survey, ensure the schedule period is set to No Limit. Trigger conditions use a different method to regulate how often users can receive survey instances.
      Pagination setting for Service Portal view The setting on which the pagination is based for desktop or tablet view in Service Portal.
      • Category: default
      • Question: 1 question per page (automatic for mobile)
      • None: no pagination
      Note: This field is displayed only when Service Portal is installed.
      One Click Survey Enables a One Click survey in Service Portal.
      Note: This option can be selected if the Pagination setting for Service Portal view is set to None.
      Source Table Table whose field is used as a dynamic value for a question in a triggered survey.
      Note: When you select a source table, ensure that its relevant field is selected as Source Field value of a metric.
      Outlook Actionable Message Includes an embedded survey in the survey email notification. After you select this check box and save the survey, a validation is run to ensure all survey questions are supported.
      Allow Sentiment Analysis Enables sentiment analysis for this survey.
      Introduction & End Notes
      Introduction Introductory content to display on survey questionnaires. Consider adding a company logo, a welcome message, background information about the survey, or instructions.
      End note End note that appears when someone submits a survey questionnaire. Consider adding a thank you message, follow-up instructions, or other applicable information.
      Related Links
      Enable Public Access

      Remove Public Access

      Link that enables/disables the survey as a public survey. No login is required to take a public survey (including a survey with a trigger condition) and users or non-users can respond anonymously. For completed public surveys, the Assigned to field value is Guest.
      Note: You can use the View Survey URL related link to share the URL with users.
      View Responses Link that opens the list of responses for this survey. This related link is available only if there are results for the survey.
      View Scorecard Link that opens the scorecard for this survey. This related link is available only if there are results for the survey.
      View Survey URL Link that opens a dialog box that displays a URL for this survey. The URL is useful for sharing a public survey.

      This related link is available only if the Active check box is selected. The URL does not work until the survey definition is published.

      Show Benchmarks Opens the Benchmarks Dashboard that provides visibility into your key performance indicators (KPIs) and trends.
      Note:
      • This related link is available only for survey_admin, assessment_admin and survey_reader with bm_viewer role.
      • You must opt in to Benchmarks to view the dashboard. See Enable Benchmarks
      • This is applicable only for a published survey.
      Create Improvement Initiative Opens the Improvement Initiative window to create an improvement initiative record that helps in improving the performance of the survey.
      Note:
      • This related link is available only for the survey_admin and assessment_admin role. A survey_reader can only view the created improvement initiative records.
      • You should activate the Continual Improvement Management plugin (com.sn_cim).
      Retry Sentiment Analysis Checks all survey instances of this survey that do not have sentiment analysis data and sends them for analysis.
      Related Lists
      Trigger Condition Displays all trigger conditions associated with the survey.
      Survey Responses Displays all responses associated with the survey.
      Metric Categories All survey categories for this survey.
      Survey Users All survey users who are authorized to take this survey. If no users are listed, any user can take this survey.
      Assessment Instances

      All survey instances for this survey. Configure the form to add this related list to see it.

      Note: If you add a related list to the form, use list control to omit the New button. The system generates survey instances to produce functional surveys.
      Improvement Initiatives Displays improvement initiatives associated with the survey.
      Note: This related list is available only when there is at least one improvement initiative record.
      Survey Recipients Lists Recipients lists that are added to the survey.
    4. Save the record.
    Related tasks
    • Publish a survey
    Related concepts
    • Survey trigger conditions
    • Event scheduling

    Tags:

    Feedback
    On this page

    Previous topic

    Next topic

    • Contact Us
    • Careers
    • Terms of Use
    • Privacy Statement
    • Sitemap
    • © ServiceNow. All rights reserved.

    Release version
    Choose your release version

      Modify a survey definition

      • Save as PDF Selected topic Topic & subtopics All topics in contents
      • Unsubscribe Log in to subscribe to topics and get notified when content changes.
      • Share this page

      Modify a survey definition

      You can configure additional options for a survey definition.

      Before you begin

      Role required: admin or survey_admin

      Procedure

      1. Navigate to Survey > View Surveys.
        Each survey definition is stored as a record on the Assessment Metric Type [asmt_metric_type] table with a modified view for survey use.
      2. Open a survey definition. The Response Trend chart with the weekly trend of the survey instance count, and the Survey Summary chart with the overall summary response based on instance states are displayed.
      3. Modify the fields on the Survey Definition form, as appropriate.
        Note: You can only edit a survey that has the same application scope as that of your current session.
        Table 1. Survey Definition form
        Field Description
        Name Name of the survey, which appears on the questionnaire.
        Description Helpful information about the survey.
        Active Check box to activate the survey definition. When the Active check box is cleared, new survey instances cannot be generated and users cannot complete existing survey instances. Use the Active check box to deactivate or activate a published survey.
        Anonymize responses Check box to ensure that all responses for this survey are stored without the submitting user names. When a user submits a survey, the system clears the Assigned to field for the associated survey instance. Also, survey responses for anonymous surveys do not contain Assigned to values.
        Note: The Assigned to field is cleared. However, each response record includes the Created By and Updated By fields that are accessible to users with the survey_admin role.
        Send notifications Check box to send a notification that the survey has been taken.
        State Status of the survey: Draft or Published.
        Allow retake Check box that allows users to modify their answers to a completed survey. Users can resubmit a survey as many times as they want until the due date. After that date, the system removes the survey from the user's My Assessments & Surveys page.
        Scheduled job Scheduled job the system creates for this survey definition when the schedule period is a repeating interval. The system sets the scheduled job to run according to the selected schedule period. If you change the schedule period and save the survey definition:
        • The system deletes the old scheduled job.
        If you selected a recurring schedule period:
        • A new scheduled job is created.
        For example, if you change the schedule period from Daily to Weekly and save the record:
        • The system deletes the daily scheduled job.
        • Creates a weekly one set to run a week from the current date.

        This field is visible to administrators only if the schedule period is Daily, Weekly, Monthly, or Yearly.

        Assessment duration The length of time to complete assigned survey instances, starting from the time the survey instance is generated. The assessment duration sets the Due date for each survey instance. The default duration is 14 days. Configure the form to see this field.
        Note: By default, the system runs the Cancel Expired Assessments script every 30 days to cancel expired survey, assessment, and quiz instances that are in the Work in progress or Ready to take states.
        Send notifications Select the check box to send notifications for the survey when it is published. Configure the form to see the field.
        Other Options
        Sample Metric A metric of the current survey that you can include as an image in the email or invitation sent to a survey user. When the survey user clicks the image in the email or while previewing the HTML body, the entire survey is available to be taken.
        Note: You cannot edit or delete a metric that is selected in this field.
        Signature Acknowledgement by a survey recipient of requirements, admonitions, or policies related to the survey. The signature may require the recipient to select a check box or to type a full signature to verify having read these assertions. You can display assertions without requiring a signature. Select an existing signature from the list or click New to create a new one. The signature form contains these fields:
        • Name: Descriptive name for this signature.
        • Signature type: Type of signature required. The selections are Check box, Full name, or Assertion only. If Assertion only is selected, no signature is required to submit the survey.
        • Assertion: Text you want to display to recipients.

        By default, a property called Require authentication for user signature (com.snc.assessment.signature_authentication) requires users to authenticate when providing a full name signature.

        Schedule period Option that determines how often a user can take the same survey and whether the system generates survey instances on a schedule.
        Note: If you use a trigger condition for a survey, ensure the schedule period is set to No Limit. Trigger conditions use a different method to regulate how often users can receive survey instances.
        Pagination setting for Service Portal view The setting on which the pagination is based for desktop or tablet view in Service Portal.
        • Category: default
        • Question: 1 question per page (automatic for mobile)
        • None: no pagination
        Note: This field is displayed only when Service Portal is installed.
        One Click Survey Enables a One Click survey in Service Portal.
        Note: This option can be selected if the Pagination setting for Service Portal view is set to None.
        Source Table Table whose field is used as a dynamic value for a question in a triggered survey.
        Note: When you select a source table, ensure that its relevant field is selected as Source Field value of a metric.
        Outlook Actionable Message Includes an embedded survey in the survey email notification. After you select this check box and save the survey, a validation is run to ensure all survey questions are supported.
        Allow Sentiment Analysis Enables sentiment analysis for this survey.
        Introduction & End Notes
        Introduction Introductory content to display on survey questionnaires. Consider adding a company logo, a welcome message, background information about the survey, or instructions.
        End note End note that appears when someone submits a survey questionnaire. Consider adding a thank you message, follow-up instructions, or other applicable information.
        Related Links
        Enable Public Access

        Remove Public Access

        Link that enables/disables the survey as a public survey. No login is required to take a public survey (including a survey with a trigger condition) and users or non-users can respond anonymously. For completed public surveys, the Assigned to field value is Guest.
        Note: You can use the View Survey URL related link to share the URL with users.
        View Responses Link that opens the list of responses for this survey. This related link is available only if there are results for the survey.
        View Scorecard Link that opens the scorecard for this survey. This related link is available only if there are results for the survey.
        View Survey URL Link that opens a dialog box that displays a URL for this survey. The URL is useful for sharing a public survey.

        This related link is available only if the Active check box is selected. The URL does not work until the survey definition is published.

        Show Benchmarks Opens the Benchmarks Dashboard that provides visibility into your key performance indicators (KPIs) and trends.
        Note:
        • This related link is available only for survey_admin, assessment_admin and survey_reader with bm_viewer role.
        • You must opt in to Benchmarks to view the dashboard. See Enable Benchmarks
        • This is applicable only for a published survey.
        Create Improvement Initiative Opens the Improvement Initiative window to create an improvement initiative record that helps in improving the performance of the survey.
        Note:
        • This related link is available only for the survey_admin and assessment_admin role. A survey_reader can only view the created improvement initiative records.
        • You should activate the Continual Improvement Management plugin (com.sn_cim).
        Retry Sentiment Analysis Checks all survey instances of this survey that do not have sentiment analysis data and sends them for analysis.
        Related Lists
        Trigger Condition Displays all trigger conditions associated with the survey.
        Survey Responses Displays all responses associated with the survey.
        Metric Categories All survey categories for this survey.
        Survey Users All survey users who are authorized to take this survey. If no users are listed, any user can take this survey.
        Assessment Instances

        All survey instances for this survey. Configure the form to add this related list to see it.

        Note: If you add a related list to the form, use list control to omit the New button. The system generates survey instances to produce functional surveys.
        Improvement Initiatives Displays improvement initiatives associated with the survey.
        Note: This related list is available only when there is at least one improvement initiative record.
        Survey Recipients Lists Recipients lists that are added to the survey.
      4. Save the record.
      Related tasks
      • Publish a survey
      Related concepts
      • Survey trigger conditions
      • Event scheduling

      Tags:

      Feedback

          Share this page

          Got it! Feel free to add a comment
          To share your product suggestions, visit the Idea Portal.
          Please let us know how to improve this content

          Check any that apply

          To share your product suggestions, visit the Idea Portal.
          Confirm

          We were unable to find "Coaching" in Jakarta. Would you like to search instead?

          No Yes
          • Contact Us
          • Careers
          • Terms of Use
          • Privacy Statement
          • Sitemap
          • © ServiceNow. All rights reserved.

          Subscribe Subscribed Unsubscribe Last updated: Tags: January February March April May June July August September October November December No Results Found Versions Search preferences successfully updated My release version successfully updated My release version successfully deleted An error has occurred. Please try again later. You have been unsubscribed from all topics. You are now subscribed to and will receive notifications if any changes are made to this page. You have been unsubscribed from this content Thank you for your feedback. Form temporarily unavailable. Please try again or contact  docfeedback@servicenow.com  to submit your comments. The topic you requested does not exist in the release. You were redirected to a related topic instead. The available release versions for this topic are listed There is no specific version for this documentation. Explore products Click to go to the page. Release notes and upgrades Click to open the dropdown menu. Delete Remove No selected version Reset This field is required You are already subscribed to this topic Attach screenshot The file you uploaded exceeds the allowed file size of 20MB. Please try again with a smaller file. Please complete the reCAPTCHA step to attach a screenshot
          Log in to personalize your search results and subscribe to topics
          No, thanks Login