Merge pull request #2242 from MicrosoftDocs/test-studio-canvas-app

Test studio canvas app

Author: tapanm-MSFT

powerapps-docs/maker/TOC.yml

@@ -418,6 +418,8 @@
             href: ./canvas-apps/functions/object-app.md
           - name: Asin
             href: ./canvas-apps/functions/function-trig.md
+          - name: Assert
+            href: ./canvas-apps/functions/function-assert.md
           - name: AsType
             href: ./canvas-apps/functions/function-astype-istype.md
           - name: Atan
@@ -660,6 +662,8 @@
             href: ./canvas-apps/functions/function-set.md
           - name: SetFocus
             href: ./canvas-apps/functions/function-setfocus.md
+          - name: SetProperty
+            href: ./canvas-apps/functions/function-setproperty.md
           - name: ShowColumns
             href: ./canvas-apps/functions/function-table-shaping.md
           - name: Shuffle
@@ -700,6 +704,8 @@
             href: ./canvas-apps/functions/function-dateadd-datediff.md
           - name: Today
             href: ./canvas-apps/functions/function-now-today-istoday.md
+          - name: Trace
+            href: ./canvas-apps/functions/function-trace.md
           - name: Trim
             href: ./canvas-apps/functions/function-trim.md
           - name: TrimEnds
@@ -792,6 +798,12 @@
           href: ./canvas-apps/set-aspect-ratio-portrait-landscape.md
         - name: Create responsive layout
           href: ./canvas-apps/create-responsive-layout.md
+  - name: Test an app with Test Studio
+    items:
+    - name: Test Studio Overview
+      href: ./canvas-apps/test-studio.md
+    - name: Working with Test Studio
+      href: ./canvas-apps/working-with-test-studio.md
   - name: Customize a SharePoint list form
     items:
       - name: Make basic changes

powerapps-docs/maker/canvas-apps/formula-reference.md

@@ -7,7 +7,7 @@ ms.service: powerapps
 ms.topic: reference
 ms.custom: canvas
 ms.reviewer: tapanm
-ms.date: 08/15/2019
+ms.date: 12/19/2019
 ms.author: gregli
 search.audienceType: 
   - maker
@@ -45,6 +45,8 @@ Other elements include:
 
 **[Asin](functions/function-trig.md)** – Returns the arcsine of a number, in radians.
 
+**[Assert](functions/function-assert.md)** – Evaluates to true or false in a test.
+
 **[AsType](functions/function-astype-istype.md)** – Treats a record reference as a specific entity type.
 
 **[Atan](functions/function-trig.md)** – Returns the arctangent of a number, in radians.
@@ -301,6 +303,8 @@ Other elements include:
 
 **[SetFocus](functions/function-setfocus.md)** – Moves input focus to a specific control.
 
+**[SetPropertry](functions/function-setproperty.md)** – Simulates interactions with input controls.
+
 **[ShowColumns](functions/function-table-shaping.md)** – Returns a table with only selected columns.
 
 **[Shuffle](functions/function-shuffle.md)** – Randomly reorders the records of a table.
@@ -344,6 +348,8 @@ Other elements include:
 
 **[Today](functions/function-now-today-istoday.md)** – Returns the current date/time value.
 
+**[Trace](functions/function-trace.md)** - Provide additional information in your test results.
+
 **[Trim](functions/function-trim.md)** – Removes extra spaces from the ends and interior of a string of text.
 
 **[TrimEnds](functions/function-trim.md)** – Removes extra spaces from the ends of a string of text only.

powerapps-docs/maker/canvas-apps/functions/function-assert.md

@@ -0,0 +1,40 @@
+---
+title: Assert function | Microsoft Docs
+description: Reference information, including syntax, for the Assert function in Power Apps Test Studio
+author: tapanm-msft
+manager: kvivek
+ms.service: powerapps
+ms.topic: reference
+ms.custom: canvas
+ms.reviewer: tapanm
+ms.date: 12/19/2018
+ms.author: aheneay
+search.audienceType: 
+  - maker
+search.app: 
+  - PowerApps
+---
+# Assert function in Power Apps Test Studio
+
+An assertion is a condition or an expression that evaluates to true or false in a test. If the expression returns false, the test case will fail. Assertions are used to validate the expected result of a test or test step, against the actual result and to fail the test if the condition is false. Assertions can be used to validate the state of controls in your app such as label values, list box selections and other control properties.  
+
+Assertion messages, for both passed and failed assertions, are also contained in a Traces table in the TestCaseResult record. 
+
+## Syntax
+
+*Assert(expression, message)*
+
+- *Expression* – Required. An expression that evaluates to true or false.
+- *Message* – Not Required. A message that describes the assertion failure. 
+
+
+## Examples
+
+```Assert(lblResult.Text = "Success", "lblResult value Expected : Success , Actual : " & lblResult.Text)```<br>
+```Assert(ListBox1.Selected.Value = "Success", "ListBox1 selection Expected : Success,  Actual : " & ListBox1.Selected.Value)```<br>
+```Assert(kudosAfterTest = kudosBeforeTest + 1, "Kudos count. Expected : " & kudosBeforeTest + 1  & " Actual :" & kudosAfterTest)```
+
+### See Also
+
+[Test Studio Overview](../test-studio.md) <br>
+[Working with Test Studio](../working-with-test-studio.md)

powerapps-docs/maker/canvas-apps/functions/function-select.md

@@ -7,7 +7,7 @@ ms.service: powerapps
 ms.topic: reference
 ms.custom: canvas
 ms.reviewer: tapanm
-ms.date: 06/11/2018
+ms.date: 01/08/2020
 ms.author: gregli
 search.audienceType: 
   - maker
@@ -26,21 +26,45 @@ If you want one or more controls in the gallery to perform different actions fro
 
 **Select** queues the target **OnSelect** for later processing, which may happen after the current formula has finished being evaluated. **Select** doesn't cause the target **OnSelect** to evaluate immediately, nor does **Select** wait for **OnSelect** to finish being evaluated.
 
-**Select** can't cross the boundaries of container controls, such as a gallery or a form. Controls within a container control can only be the subject of a **Select** function in formulas that are inside the same container control. You can't use **Select** across screens.
+You can't use **Select** across screens.
 
 You can use **Select** only with controls that have an **OnSelect** property.
 
 You can use **Select** only in [behavior formulas](../working-with-formulas-in-depth.md).
 
 A control can't **Select** itself directly or indirectly through other controls.
 
+The select function can also be used with a gallery. For example, it can be used to specify the row or column to select in a gallery and the control to select within that row or column of the gallery. When you select a row or column, the gallery selection changes and the **OnSelect** formula on the gallery control is evaluated. If a control within the row or column is provided, the **OnSelect** formula for the child control will be evaluated. 
+
 ## Syntax
 **Select**( *Control* )
 
 * *Control* – Required.  The control to select on behalf of the user.
 
+**Select**( *Control, Row or column, Child Control* )
+
+- *Control* – Required. The control to select on behalf of the user.
+- *Row or column* – Not required. The number of row or column (starting with 1) in a gallery control to select on behalf of the user.
+- *Child Control* - Not required. The child control of the control identified in the 'control' parameter to select. 
+
 ## Examples
 
+- *Button*
+
+    ```Select(button1)```
+
+- *Gallery*	
+
+    ```Select(Gallery1, 1)```
+
+    Simulates a user selecting row 1 or column 1 in Gallery1. 
+
+- *Gallery*	
+
+    ```Select(Gallery1, 1, ChildControl1)```
+
+    Simulates a user selecting ChildConttrol1 in row 1 or column 1 of Gallery1.
+
 #### Basic usage
 
 1. Add a **[Button](../controls/control-button.md)** control, and rename it **Button1** if it has a different name.
@@ -86,3 +110,12 @@ A control can't **Select** itself directly or indirectly through other controls.
 	Use individual controls in the gallery to take actions that differ from the gallery's default action.
 
 	![An animation that shows the default value of the OnSelect property for a gallery control, as well as a control that takes a different action](media/function-select/gallery-select.gif)
+
+7. On the same screen, add a **Button** control, and set its **OnSelect** property to this formula:
+
+	**Select( Gallery1,2,Image1 )**
+
+8. While holding down the Alt key, select the button.
+   
+     A **Image Selected** notification appears across the top of your app. The button click simulated selecting the image in row 2 of the gallery.  
+

powerapps-docs/maker/canvas-apps/functions/function-setproperty.md

@@ -0,0 +1,51 @@
+---
+title: SetProperty function | Microsoft Docs
+description: Reference information, including syntax, for the SetProperty function in Power Apps Test Studio
+author: tapanm-msft
+manager: kvivek
+ms.service: powerapps
+ms.topic: reference
+ms.custom: canvas
+ms.reviewer: tapanm
+ms.date: 12/19/2018
+ms.author: aheneay
+search.audienceType: 
+  - maker
+search.app: 
+  - PowerApps
+---
+# SetProperty function in Power Apps Test Studio
+
+The SetProperty function simulates interactions with input controls as if the user had entered or set a value on the control. This function is only available if you are writing tests in the Power Apps Test Studio. The following properties can be set using the SetProperty function.
+
+## Syntax
+
+*SetProperty(Control Property, value)*
+
+- *Control Property* – Required. The control property to set on behalf of the user.
+- *Value* – Required. The value of the property to set on behalf of the user. 
+
+## Examples
+
+| Control	| Property	| Example expression
+| :- | :- | :-
+| TextInput	| Text	| ```SetProperty(TextInput1.Text, "Sample text")```
+| RichTextEditor	| HtmlText	| ```SetProperty(RichTextEditor1.HtmlText, "<p>Sample text</p>")```
+| Toggle	| Value	| ```SetProperty(Toggle1.Value, false)```
+| Checkbox	| Value	| ```SetProperty(Checkbox1.Value, false)```
+| Slider	| Value	| ```SetProperty(Slider1.Value, 10)```
+| Rating	| Value	| ```SetProperty(Rating1.Value, 5)```
+| DatePicker	| SelectedDate	| ```SetProperty(DatePicker1.SelectedDate, Date(2020,3,10))```
+| Radio	| Selected	| ```SetProperty(Radio1.Selected, "Yes")```
+| Radio | SelectedText | ```SetProperty(Radio1.SelectedText, "Yes")```
+| Dropdown | Selected | ```SetProperty(Dropdown1.Selected, {Value:"Sample value"})```
+| Dropdown | SelectedText | ```SetProperty(Dropdown1.SelectedText, {Value:"Sample value"})```
+| Combobox | Selected | ```SetProperty(Dropdown1.Selected, {Value:"Sample value"})```
+| Combobox | SelectedItems | ```SetProperty(ComboBox1.SelectedItems, Table({Value:"Sample value"},({Value:"Sample value"}))```
+| ListBox | Selected | ```SetProperty(Listbox1.Selected, {'Value':"Sample value"})```
+| ListBox | SelectedItems | ```SetProperty(Listbox1.SelectedItems, Table({Value:"Sample value"},({Value:"Sample value"}))```
+
+### See Also
+
+[Test Studio Overview](../test-studio.md) <br>
+[Working with Test Studio](../working-with-test-studio.md)

powerapps-docs/maker/canvas-apps/functions/function-trace.md

@@ -0,0 +1,35 @@
+---
+title: Trace function | Microsoft Docs
+description: Reference information, including syntax, for the Trace function in Power Apps Test Studio
+author: tapanm-msft
+manager: kvivek
+ms.service: powerapps
+ms.topic: reference
+ms.custom: canvas
+ms.reviewer: tapanm
+ms.date: 12/19/2018
+ms.author: aheneay
+search.audienceType: 
+  - maker
+search.app: 
+  - PowerApps
+---
+# Trace function 
+
+When used with Test Studio, Trace is an optional expression that can be used to provide additional information in your test results from the **OnTestCaseComplete** event. Trace event messages, as well as any messages for both passed and failed assertions, are contained in a Traces table in the TestCaseResult record. The Traces table has two properties, Message and Timestamp. 
+
+If you have allowed your app to send telemetry data to Azure Application Insights, the Trace function can also be used to send custom event or diagnostic information to your Application Insights resource. You can inspect this data in Application Insights to help diagnose problems or understand usage of your apps and features. Trace information used in Tests will also be recorded in Application Insights. All Trace messages can also be viewed in the Power Apps Monitor tool, which will help in debugging or identifying issues for real-time diagnostic sessions for your app.   
+
+## Syntax
+
+*Trace(message, severity, custom_record )*
+
+- *Message* – Required. The information to be traced. In tests, this creates a record in the Traces table in the TestCaseResult record. 
+- *Severity* - Optional. The severity level of the Trace recorded in Application Insights. Options are Information, Warning or Error. 
+- *custom_record* - Optional. A record containing custom data that will be recorded in Application Insights. 
+  
+
+### See Also
+
+[Test Studio Overview](../test-studio.md) <br>
+[Working with Test Studio](../working-with-test-studio.md)