Merge pull request #8183 from MicrosoftDocs/matp-3256723

Matp 3256723

Author: Mattp123

powerapps-docs/maker/TOC.yml

@@ -2057,6 +2057,14 @@
           href: ./data-platform/monitor-manage-processes.md
         - name: Best practices for real-time workflow processes
           href: ./data-platform/best-practices-workflow-processes.md
+      - name: Use Dataverse low-code plug-ins (experiemental)
+        items:
+        - name: Create low-code plug-ins
+          href: ./data-platform/low-code-plug-ins.md
+        - name: Example low-code plug-ins
+          href: ./data-platform/lowcode-plug-ins-examples.md
+        - name: Low-code plug-ins Power Fx 
+          href: ./data-platform/low-code-plug-ins-powerfx.md  
       - name: Work with actions
         items:
         - name: Use actions

powerapps-docs/maker/data-platform/low-code-plug-ins-powerfx.md

@@ -0,0 +1,188 @@
+---
+title: Low-code plug-ins Power Fx
+description: Supported Power Fx expressions for use with Microsoft Dataverse low-code plug-ins  
+author: Mattp123
+ms.author: matp
+ms.service: powerapps
+ms.topic: how-to
+ms.date: 05/18/2023
+ms.custom: template-how-to
+---
+# Low-code plug-ins Power Fx (experimental)
+
+[!INCLUDE [cc-beta-prerelease-disclaimer](../../includes/cc-beta-prerelease-disclaimer.md)]
+
+Low-code plug-ins can add business logic to your apps using the Power Fx expression language and directly integrate with Dataverse business data and external data through Power Platform connectors. With low-code plug-ins, you can quickly build rich workflows without any code.
+
+> [!IMPORTANT]
+> - This is an experimental feature. Use this if you're an early adopter, see something useful to you, and would like to help test the feature.
+> - Experimental features aren’t meant for production use and may have restricted functionality. These features are available before an official release so that customers can get early access and provide feedback.
+> - Experimental features can radically change or completely disappear at any time. For this reason the feature is not enabled by default and you must explicitly opt in to use it.
+
+Low-code plug-ins support many of the Power Fx operators, variables, and formulas. For more information about Power Fx, go to these articles:
+
+- [Expression grammar](/power-platform/power-fx/expression-grammar)
+- [Operators](/power-platform/power-fx/operators)
+- [Variables](/power-platform/power-fx/variables)
+- [Formula reference](/power-platform/power-fx/formula-reference)
+
+The following table lists the Power Fx formulas that work but have limitations or don’t work but have an alternative for use with low-code plug-ins.
+
+|Power Fx formula  |Supported in plug-ins?  | Limitation or work around   |
+|---------|---------|---------|
+|Set     |  Yes      | Requires the variable to exist (as bound table row property) and the variable type to match what you’re trying to set it to. <br /> For an automated action, update the associated row’s values by passing `ThisRecord` as the first argument (referring to the row that triggered the data event), then the desired column updates in the second object parameter, such as `Set( ThisRecord, { Description: “Updated description text” } );`  |
+|Collect     | Yes        | Requires the variable to exist and the variable type to match what you’re trying to set it to.    |
+|Defaults     |  No       | Use Collect instead. For example, instead of *Patch(account, Defaults(account), {“Account Name”: “Example Account”})* use `Collect(account, {“Account Name”: “Example Account”})`.    |
+|User()     | No        | Instead use Viewer, which has a subset of information about the user who invoked the action (both instant and automated).    |
+
+## Formulas not currently supported with low-code plug-ins
+
+:::row:::
+   :::column span="":::
+      Clear
+   :::column-end:::
+   :::column span="":::
+      ClearCollect
+   :::column-end:::
+   :::column span="":::
+      Update
+   :::column-end:::
+:::row-end:::
+:::row:::
+   :::column span="":::
+      UpdateIf
+   :::column-end:::
+   :::column span="":::
+      SortByColumns
+   :::column-end:::
+   :::column span="":::
+      Concurrent
+   :::column-end:::
+:::row-end:::
+:::row:::
+   :::column span="":::
+      DropColumns
+   :::column-end:::
+   :::column span="":::
+      AddColumns
+   :::column-end:::
+   :::column span="":::
+      IsEmpty
+   :::column-end:::
+:::row-end:::
+:::row:::
+   :::column span="":::
+      SetFocus
+   :::column-end:::
+   :::column span="":::
+      IsType
+   :::column-end:::
+   :::column span="":::
+      JSON
+   :::column-end:::
+:::row-end:::
+:::row:::
+   :::column span="":::
+      Download
+   :::column-end:::
+   :::column span="":::
+      PlainText
+   :::column-end:::
+   :::column span="":::
+     RemoveIf
+   :::column-end:::
+:::row-end:::
+:::row:::
+:::row-end:::
+:::row:::
+   :::column span="":::
+      GroupBy
+   :::column-end:::
+   :::column span="":::
+      SetProperty
+   :::column-end:::
+   :::column span="":::
+      RenameColumns
+   :::column-end:::
+:::row-end:::
+:::row:::
+   :::column span="":::
+      Search
+   :::column-end:::
+   :::column span="":::
+      ShowColumns
+   :::column-end:::
+   :::column span="":::
+      UTCNow
+   :::column-end:::
+:::row-end:::
+:::row:::
+   :::column span="":::
+      UTCToday
+   :::column-end:::
+   :::column span="":::
+      Validate
+   :::column-end:::
+   :::column span="":::
+      Weekday
+   :::column-end:::
+:::row-end:::
+:::row:::
+   :::column span="":::
+      As
+   :::column-end:::
+   :::column span="":::
+      Calendar
+   :::column-end:::
+   :::column span="":::
+      Choices
+   :::column-end:::
+:::row-end:::
+:::row:::
+   :::column span="":::
+      Clock
+   :::column-end:::
+   :::column span="":::
+      Select
+   :::column-end:::
+   :::column span="":::
+      Notify
+   :::column-end:::
+:::row-end:::
+:::row:::
+   :::column span="":::
+      Errors
+   :::column-end:::
+   :::column span="":::
+      HashTags
+   :::column-end:::
+   :::column span="":::
+      ISOWeekNum 
+   :::column-end:::
+:::row-end:::
+:::row:::
+   :::column span="":::
+      WeekNum
+   :::column-end:::
+   :::column span="":::
+      Refresh
+   :::column-end:::
+   :::column span="":::
+      SaveData, LoadData, and ClearData
+   :::column-end:::
+:::row-end:::
+:::row:::
+   :::column span="":::
+      Form-related formulas (EditForm, NewForm, SubmitForm, ResetForm, and ViewForm)
+   :::column-end:::
+   :::column span="":::
+      Device sensor formulas (Acceleration, App, Compass, Connection, and Location)
+   :::column-end:::
+   :::column span="":::
+      <!--empty-->
+   :::column-end:::
+:::row-end:::
+
+## See also
+
+[Use Dataverse low-code plug-ins (experimental)](low-code-plug-ins.md)