Live publish

Author: buck1ey

powerapps-docs/developer/common-data-service/build-web-applications-server-server-s2s-authentication.md

@@ -32,7 +32,7 @@ S2S authentication means you don’t need to use a paid Power Apps user license
 |   Scenario    |   Description  |
 |---------------|---------------|
 | Multi-Tenant  | This is the most common scenario and the one which is used for apps distributed using Microsoft AppSource.<br /><br /> Each Common Data Service tenant is associated with an Azure AD tenant. Your web application or service is registered with your Azure AD tenant.<br /><br /> In this scenario any Common Data Service tenant can potentially use your multi-tenant application after they grant consent for the application to access data in their tenant.                                                           |
-| Single-Tenant | This scenario typically applies to Common Data Service environments that want to develop apps for their own tenant and don’t intend to distribute them to other [Common Data Service environments.<br /><br /> An enterprise can create a web application or service to connect to all the Common Data Service environments for their tenant.<br /><br /> In this scenario, your web application or service will only be able to connect to Common Data Service environments using the same Azure AD tenant. |
+| Single-Tenant | This scenario typically applies to Common Data Service environments that want to develop apps for their own tenant and don’t intend to distribute them to other Common Data Service environments.<br /><br /> An enterprise can create a web application or service to connect to all the Common Data Service environments for their tenant.<br /><br /> In this scenario, your web application or service will only be able to connect to Common Data Service environments using the same Azure AD tenant. |
 
  Both scenarios have common elements but there are some differences. Since multi-tenant is the most common scenario, the [Use Multi-Tenant Server-to-server authentication](use-multi-tenant-server-server-authentication.md) content describes how you can use S2S in this scenario and include notes where the options for single-tenant configuration is different. 
 

powerapps-docs/developer/component-framework/manifest-schema-reference/type.md

@@ -33,19 +33,17 @@ This element contains a `string` with one of the following values:
 
 [!INCLUDE [type-table](includes/type-table.md)]
 
-### Example
+### Example for Enum type
 
 ```XML
-<type-group name="numbers">
-      <type>Whole.None</type>
-      <type>Currency</type>
-      <type>FP</type>
-      <type>Decimal</type>
-    </type-group>
+<property name="YesNo" display-name-key="YesNo_Display_Key" description-key="YesNo_Desc_Key" of-type="Enum" usage="input" required="false">
+      <value name="Yes" display-name-key="Yes">0</value>
+      <value name="No" display-name-key="No">1</value>
+</property>
 ```
 
 ### Related topics
 
 [Power Apps component framework manifest schema reference](index.md)<br/>
 [Power Apps component framework API reference](../reference/index.md)<br/>
-[Power Apps component framework overview](../overview.md)
+[Power Apps component framework overview](../overview.md)

powerapps-docs/developer/model-driven-apps/clientapi/reference/formContext-data/includes/refresh-description.md

@@ -1 +1 @@
-Asynchronously refreshes and optionally saves all the data of the form without reloading the page.
+Asynchronously refreshes and optionally saves all the data of the form without reloading the page. The [form data onload event](../../events/form-data-onload.md) occurs after the data is refreshed.

powerapps-docs/includes/record-scope.md

@@ -1,2 +1 @@
-Fields of the record currently being processed are available within the formula.  You simply reference them by name as you would any other value.  You can also reference control properties and other values from throughout your app.  For more details, see the examples below and [working with record scope](../maker/canvas-apps/working-with-tables.md#record-scope). 
-
+Fields of the record currently being processed are available within the formula.  Use the [**ThisRecord** operator](../maker/canvas-apps/functions/operators.md#thisitem-thisrecord-and-as-operators) or simply reference fields by name as you would any other value. The [**As** operator](../maker/canvas-apps/functions/operators.md#thisitem-thisrecord-and-as-operators) can also be used to name the record being processed which can help make your formula easier to understand and make nested records accessible. For more information, see the examples below and [working with record scope](../maker/canvas-apps/working-with-tables.md#record-scope).

powerapps-docs/maker/TOC.yml

@@ -485,6 +485,8 @@
             href: ./canvas-apps/functions/function-logicals.md
           - name: App
             href: ./canvas-apps/functions/object-app.md
+          - name: As
+            href: ./canvas-apps/functions/operators.md#thisitem-thisrecord-and-as-operators            
           - name: Asin
             href: ./canvas-apps/functions/function-trig.md
           - name: Assert
@@ -577,12 +579,14 @@
             href: ./canvas-apps/functions/function-form.md
           - name: Enable
             href: ./canvas-apps/functions/function-enable-disable.md
+          - name: EncodeUrl
+            href: ./canvas-apps/functions/function-encode-decode.md            
           - name: EndsWith
             href: ./canvas-apps/functions/function-startswith.md
           - name: Errors
             href: ./canvas-apps/functions/function-errors.md
-          - name: EncodeUrl
-            href: ./canvas-apps/functions/function-encode-decode.md
+          - name: exactin
+            href: ./canvas-apps/functions/operators.md#in-and-exactin-operators            
           - name: Exit
             href: ./canvas-apps/functions/function-exit.md
           - name: Exp
@@ -611,6 +615,8 @@
             href: ./canvas-apps/functions/function-if.md
           - name: IfError
             href: ./canvas-apps/functions/function-iferror.md
+          - name: in
+            href: ./canvas-apps/functions/operators.md#in-and-exactin-operators
           - name: IsBlank
             href: ./canvas-apps/functions/function-isblank-isempty.md
           - name: IsEmpty
@@ -681,6 +687,8 @@
             href: ./canvas-apps/functions/function-logicals.md
           - name: Param
             href: ./canvas-apps/functions/function-param.md
+          - name: Parent
+            href: ./canvas-apps/functions/operators.md#self-and-parent-operators              
           - name: Patch
             href: ./canvas-apps/functions/function-patch.md
           - name: Pi
@@ -731,12 +739,16 @@
             href: ./canvas-apps/functions/function-datetime-parts.md
           - name: Select
             href: ./canvas-apps/functions/function-select.md
+          - name: Self
+            href: ./canvas-apps/functions/operators.md#self-and-parent-operators         
           - name: Set
             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: Sequence
+            href: ./canvas-apps/functions/function-sequence.md            
           - name: ShowColumns
             href: ./canvas-apps/functions/function-table-shaping.md
           - name: Shuffle
@@ -769,6 +781,10 @@
             href: ./canvas-apps/functions/function-trig.md
           - name: Text
             href: ./canvas-apps/functions/function-text.md
+          - name: ThisItem
+            href: ./canvas-apps/functions/operators.md#thisitem-thisrecord-and-as-operators
+          - name: ThisRecord
+            href: ./canvas-apps/functions/operators.md#thisitem-thisrecord-and-as-operators         
           - name: Time
             href: ./canvas-apps/functions/function-date-time.md
           - name: TimeValue

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: 05/20/2020
+ms.date: 07/17/2020
 ms.author: gregli
 search.audienceType: 
   - maker
@@ -20,7 +20,7 @@ Formulas combine many elements.  Listed below are:
 * **Functions** take parameters, perform an operation, and return a value. For example, **Sqrt(25)** returns **5**. Functions are modeled after Microsoft Excel functions.  Some functions have side effects, such as **SubmitForm**, which are appropriate only in a [behavior formula](working-with-formulas-in-depth.md) such as **Button.OnSelect**.
 * **Signals** return information about the environment. For example, **[Location](functions/signals.md)** returns the device's current GPS coordinates. Signals don't take parameters or have side effects.
 * **Enumerations** return a pre-defined constant value. For example, **[Color](functions/function-colors.md)** is an enumeration that has pre-defined values for **Color.Red**, **Color.Blue**, and so forth.  Common enumerations are included here; function-specific enumerations are described with the function.
-* **Named operators**, such as **[ThisItem](functions/operators.md#thisitem-operator)** and **[Self](functions/operators.md#self-and-parent-operators)**, provide access to information from within a container.
+* **Named operators**, such as **[ThisItem](functions/operators.md#thisitem-thisrecord-and-as-operators)** and **[Self](functions/operators.md#self-and-parent-operators)**, provide access to information from within a container.
 
 Other elements include:
 
@@ -47,6 +47,8 @@ Other elements include:
 
 **[Assert](functions/function-assert.md)** – Evaluates to true or false in a test.
 
+**[As](functions/operators.md#thisitem-thisrecord-and-as-operators)** – Names the current record in gallery, form, and record scope functions such as **ForAll**, **With**, and **Sum**.
+
 **[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.
@@ -137,11 +139,13 @@ Other elements include:
 
 **[Enable](functions/function-enable-disable.md)** – Enables a signal, such as **[Location](functions/signals.md)** for reading the GPS.
 
+**[EncodeUrl](functions/function-encode-decode.md)** – Encodes special characters using URL encoding.
+
 **[EndsWith](functions/function-startswith.md)** – Checks whether a text string ends with another text string.
 
 **[Errors](functions/function-errors.md)** – Provides error information for previous changes to a data source.
 
-**[EncodeUrl](functions/function-encode-decode.md)** – Encodes special characters using URL encoding.
+**[exactin](functions/operators.md#in-and-exactin-operators)** – Checks if a text string is contained within another text string or table, case dependent.  Also used to check if a record is in a table.  
 
 **[Exit](functions/function-exit.md)** – Exits the currently running app and optionally signs out the current user.
 
@@ -173,6 +177,8 @@ Other elements include:
 
 **[IfError](functions/function-iferror.md)** - Detects errors and provides an alternative value or takes action. 
 
+**[in](functions/operators.md#in-and-exactin-operators)** – Checks if a text string is contained within another text string or table, case independent.  Also used to check if a record is in a table.
+
 **[IsBlank](functions/function-isblank-isempty.md)** – Checks for a [blank](functions/function-isblank-isempty.md) value.
 
 **[IsEmpty](functions/function-isblank-isempty.md)** – Checks for an empty table.
@@ -303,6 +309,8 @@ Other elements include:
 
 **[Self](functions/operators.md#self-and-parent-operators)** – Provides access to the properties of the current control.
 
+**[Sequence](functions/function-sequence.md)** – Generate a table of sequential numbers, useful when iterating with **ForAll**.
+
 **[Set](functions/function-set.md)** – Sets the value of a global variable.
 
 **[SetFocus](functions/function-setfocus.md)** – Moves input focus to a specific control.
@@ -342,7 +350,9 @@ Other elements include:
 
 **[Text](functions/function-text.md)** – Converts any value and formats a number or date/time value to a string of text.
 
-**[ThisItem](functions/operators.md#thisitem-operator)** – When in a gallery or form, returns the data for the current item from the container.
+**[ThisItem](functions/operators.md#thisitem-thisrecord-and-as-operators)** – Returns the record for the current item in a gallery or form control.
+
+**[ThisRecord](functions/operators.md#thisitem-thisrecord-and-as-operators)** – Returns the record for the current item in a record scope function, such as **ForAll**, **With**, and **Sum**.
 
 **[Time](functions/function-date-time.md)** – Returns a date/time value, based on **Hour**, **Minute**, and **Second** values.  
 

powerapps-docs/maker/canvas-apps/functions/function-astype-istype.md

@@ -7,7 +7,7 @@ ms.service: powerapps
 ms.topic: reference
 ms.custom: canvas
 ms.reviewer: tapanm
-ms.date: 05/17/2019
+ms.date: 07/19/2020
 ms.author: gregli
 search.audienceType: 
   - maker
@@ -33,13 +33,11 @@ Common Data Service also supports polymorphic lookup fields, which can refer to
 | **Customer** | **Accounts** or **Contacts** |
 | **Regarding** | **Accounts**, **Contacts**, **Knowledge Articles**, etc. |
 
-<!--note from editor: Change "Knowledge Articles" to "Knowledge Base articles" if that is what is being referenced.   -->
-
-In canvas-app formulas, you can use record references to work with polymorphic lookups. Because a record reference can refer to different entities, you don't know which fields will be available when you write a formula. The *.Field* notation isn't available. Those formulas must adapt to the records that the app encounters when it runs.
+In canvas-app formulas, use record references to work with polymorphic lookups. Because a record reference can refer to different entities, you don't know which fields will be available when you write a formula. The *Record.Field* notation isn't available. Those formulas must adapt to the records that the app encounters when it runs.
 
 The **IsType** function tests whether a record reference refers to a specific entity type. The function returns a Boolean TRUE or FALSE.
 
-The **AsType** function treats a record reference as a specific entity type, sometimes referred to as *casting*. You can use the result as if it were a record of the entity and, again, use the *.Field* notation to access all of the fields of that record. An error occurs if the reference isn't of the specific type.
+The **AsType** function treats a record reference as a specific entity type, sometimes referred to as *casting*. You can use the result as if it were a record of the entity and again use the *Record.Field* notation to access all of the fields of that record. An error occurs if the reference isn't of the specific type.
 
 Use these functions together to first test the entity type of a record and then treat it as a record of that type so that the fields are available:
 
@@ -65,9 +63,9 @@ Patch( Accounts, First( Accounts ), { Owner: First( Teams ) } )
 If used in a record context, such as within a [**Gallery**](../controls/control-gallery.md) or [**Edit form**](../controls/control-form-detail.md) control, you might need to use the [global disambiguation operator](operators.md#disambiguation-operator) to reference the entity type. For example, this formula would be effective for a gallery that's displaying a list of contacts where **Company Name** is a **Customer** lookup:
 
 ```powerapps-dot
-If( IsType( ThisItem.'Company Name', [@Accounts] ),
-    AsType( ThisItem.'Company Name', [@Accounts] ).'Account Name',
-    AsType( ThisItem.'Company Name', [@Contacts] ).'Full Name'
+If( IsType( ThisItem.'Company Name', Accounts ),
+    AsType( ThisItem.'Company Name', Accounts ).'Account Name',
+    AsType( ThisItem.'Company Name', Contacts ).'Full Name'
 )
 ```
 
@@ -129,9 +127,9 @@ If the record reference is *blank*, **IsType** returns FALSE, and **AsType** ret
 
     ```powerapps-dot
     If( IsBlank( ThisItem.'Company Name' ), "--",
-        IsType( ThisItem.'Company Name', [@Accounts] ),
-            "Account: " & AsType( ThisItem.'Company Name', [@Accounts] ).'Account Name',
-        "Contact: " & AsType( ThisItem.'Company Name', [@Contacts] ).'Full Name'
+        IsType( ThisItem.'Company Name', Accounts ),
+            "Account: " & AsType( ThisItem.'Company Name', Accounts ).'Account Name',
+        "Contact: " & AsType( ThisItem.'Company Name', Contacts ).'Full Name'
     )
     ```