Product Documentation

Select a Product:

Find Text:

Submit a question:

Not seeing an answer to a question you might have? You can ask it here and we'll try to update the documentation to address it. If you're making a feature request or reporting a problem, please create a support item for it, instead!

User Feedback Capture

Purpose

The User Feedback Capture visual lets you build interactive Power BI dashboards / reports that let users provide feedback, which is aggregated so that you can build reporting based on the feedback. Feedback can be as simple as "voting" (including up/down voting), numeric, or textual. It can be for a "single topic" or within a topic, it can include data from the report dataset, as well. For example, you could build a list of "states" and have voting by state. You can add "constraints" such as the report user, and/or date, which in turn lets you do things like limit voting to "one vote per user" or "one vote per user, per day" - and much more.

Data Bucket

The data requirements for the User Feedback Capture visual include 2 bucket fields, listed here:

Field	Type	Description
Group By	Text	Zero, one or many fields from the semantic model, which are included with the feedback, to make it more specific. For example, voting for a specific person can be done if the person name is included in the group by well. For tabular presentation styles, each row of data produced in the group by can be displayed, whereas for single-value capture, only the first row of data produced by the group by fields will be included with the feedback. Also known as the "data payload".
Constrain By	Text	Zero, one or many fields from the semantic model, which are included with the feedback but are also used to potentially limit (constrain) voting. For example, adding the user's identity (using the DAX function USERNAME(), in a measure) to this well and then setting the "Maximum Counter: Constrain By" setting to "1" implies that a given user should only be allowed to vote one time.

Settings

Data and Interaction

Field	Default	Description
Capture Method	Simple Button	Controls what capture method will be used. Depending on the capture method, other settings can apply. (For example, 'text entry' relies on maximum length and data type, where 'simple button' does not.)
Capture Scope	Single Value	Controls if capture is done for a single value or multiple values. Within that, different modalities of capture are possible (hence different table styles can be offered).
Text Entry: Data Format	Any Text	When the capture method is 'text entry', is the expected data format for the input text.
Text Entry: Casing	Keep Case	Allows one to keep text, as entered, or force it to be upper or lower case.
Text Entry: Max Length	50	When the capture method is 'text entry', the maximum length allowed for the input text.
Text Entry: Min Length	1	When the capture method is 'text entry', the minimum length allowed for the input text. ('0' implies that an entry value is not required.)
Text Entry: Numeric Min Value		When the capture method is 'text entry' and the data format is for a number, the minimum numeric value allowed for the input text.
Text Entry: Numeric Max Value		When the capture method is 'text entry' and the data format is for a number, the maximum numeric value allowed for the input text.
Text Entry: Allowed Values		Optional comma-separated values that must match entered text, to allow for submission (case sensitive). Eg. 'A,B,C' implies that only the letters A, B or C can be submitted.
Group By: Display Only		Optional comma-separated list of field names that can be shown in tabular display style, but are not sent to the data store for responses.
Counter Scope	Group By Level	Controls what number is shown for the counter, among the possible levels of data collection. Group By level uses any Group By values to count. (If no Group By values are available, then Group By is the same as the Constrained By value.) Constrained By level uses both Group By and Constrain By values to count.
Maximum Counter: All	1000000	Sets an upper limit on the number of feedback events that can be applied for the topic, over all group by and constrained by values. For example, if there is a group by which exposes 20 values which can be voted on and this setting is '1', then one vote can be applied over EACH of the 20 values, per user (or whatever else is used as a constraint). For up/down voting, votes are treated as an absolute value when comparing to this setting.
Maximum Counter: Constrain By	1000000	Sets an upper limit on the number of feedback events that can be applied for the topic, over all constrain by values. For example, if there is a group by which exposes 20 values which can be voted on and this setting is '3', then up to 3 votes can be applied over ALL of the 20 values, per user (or whatever else is used as a constraint).
Maximum Counter: Group By	1000000	Sets an upper limit on the number of feedback events that can be applied for the topic, within each group by set of values. For example, if there is a group by which exposes 20 values which can be voted on and this setting is '3', then there is a maximum of 3 votes for each of the 20 group by values.
Group By Maximum Rows	50	This is the maximum number of rows which can be used for group by values. Prevents accidental 'run-away' rendering. If you have a use case that requires a larger value, contact our support.
Warn Below Use Credits	0	When your use credits fall below this level, a warning is provided. (Use 0 to suppress any warning.)
Allow Tooltips	On	When enabled, tool-tips may be shown when hovering over the text area.
Use Default Context Menus	Off	When enabled, context menus will be the browser default as opposed to the Power BI context menu.

Formatting

Field	Default	Description
General Style	Base Default	Offers some different general styles for the visual (formatting for all contained controls).
Disabled Vote Status	Disable	Controls how 'already voted' is handled - will the vote button be hidden? disabled?
Single Button Text	{check}	Text to show in the button, in single button style. See help reference for icons.
Up/Down: Up Button Text	{uptriangle}	Text to show in the 'up' button, in the up/down style. See help reference for icons.
Up/Down: Down Button Text	{downtriangle}	Text to show in the 'down' button, in the up/down style. See help reference for icons.
Submit Button Text	Submit	Text to show in the submit button, in text entry style. See help reference for icons.
Counter Placement	Right	Controls placement of the counter, when shown.
Counter Text (Zero)	{0}	Text to show for counter, when the count is exactly zero. Can use '{0}' to substitute in the actual count value (internationalized).
Counter Text (Singular)	{0}	Text to show for counter, when the count is exactly one. Can use '{0}' to substitute in the actual count value (internationalized).
Counter Text (Singular, Negative)	{0}	Text to show for counter, when the count is exactly -1. Can use '{0}' to substitute in the actual count value, or '{1}' for the absolute value (internationalized).
Counter Text (Plural)	{0}	Text to show for counter, when the count is not one. Can use '{0}' to substitute in the actual count value (internationalized).
Counter Text (Plural, Negative)	{0}	Text to show for counter, when the count is less than zero and not -1. Can use '{0}' to substitute in the actual count value, or '{1}' for the absolute value (internationalized).
Repeater Style: Heading Format		When using table repeater-based capture scope, controls formatting when there is one or more group by values. Format strings can include 'bold', 'italic', 'left', 'right', 'center', or specific named colors, or hex color codes. Multiple values for a field can be separated with a comma. Each field format string should be separated with a semi-colon.
Tool-tip: Topic Label	Topic	Text to show in tool-tips for the Topic level count.
Tool-tip: Group Label	Group	Text to show in tool-tips for the Group level count.
Tool-tip: Filtered Label	Filtered	Text to show in tool-tips for the Filtered level count. (This would generally correspond to user-filtered, or whatever else has been set for group by and constrain by values.)
Counter Extra Padding	0	Optionally add extra padding between the counter text and button(s).
Button Text Font		The font for buttons.
Counter Text Font		The font for the counter text.
Group By Text Font		The font for group by text.
Text Entry Font		The font for text boxes.
Additional Inner Padding	0	Allows additional padding to be included between elements within the visual.
Table Style: Extra Padding	0	Optionally add extra padding between cells of the table generated with a tabular display style..
Table Style: Border	None	Controls if/how borders are shown when using a tabular display style.
Message: Low Credits	Usage credits are nearing zero. (available: {0})	Text to show when credits are low. (Allows {0})

Colors

Field	Default	Description
Text Color		The color override for general text within the visual.
Counter Color, Positive		The color override for the counter, when the value is positive. (Note: applies to the constrained/user count, not the display count.)
Counter Color, Negative		The color override for the counter, when the value is negative. (Note: applies to the constrained/user count, not the display count.)
Text Area Background Color		The background color override for the generated text area.
Button Background Color		The background color for buttons within the visual.
Background Color		The background color for the visual's whitespace areas.
Background Opacity	100	The opacity (percentage) for the background color. (Zero is fully transparent.)
Tabular Style: Alternating Row Color 1		The color override to use on odd-numbered rows when using a tabular display style.
Tabular Style: Alternating Row Color 2		The color override to use on even-numbered rows when using a tabular display style.

License and Keys

Field	Default	Description
Licensed By		Provide the name that is shown on your bizintelligencechampions.com Account page, for the license key you intend to use.
License Key		Provide the 22 character license key, as found when you sign up for a bizintelligencechampions.com account (trial key), or purchase a license key.
Topic ID		Topics are created on your Account page, on bizintelligencechampions.com. Each user capture visual needs to be associated with exactly one topic. Copy the applicable topic key from bizintelligencechampions.com and paste it here.