Merge pull request #1956 from MicrosoftDocs/master

publish to live

Author: jimholtz

powerapps-docs/developer/component-framework/add-custom-controls-to-a-field-or-entity.md

@@ -1,6 +1,6 @@
 ---
-title: Add Custom Components to a field or entity | Microsoft Docs
-description: Process to import custom components
+title: Add code components to a field or entity | Microsoft Docs
+description: Process to import code components
 keywords:
 ms.author: nabuthuk
 author: Nkrb
@@ -12,9 +12,13 @@ ms.tgt_pltfrm: ""
 ms.topic: "article"
 ---
 
-# Add custom components to a field or entity
+# Add code components to a field or entity in model-driven apps
 
-Custom components let you transform fields that traditionally contain text into visualizations. Similarly, you can use custom components to transform datasets, such as a view, to display in a more visual rendering rather than a list of records. Custom components can appear as visualizations on forms, dashboards, views, and homepage grids. 
+code components let you transform fields that traditionally contain text into visualizations. Similarly, you can use code components to transform datasets, such as a view, to display in a more visual rendering rather than a list of records. code components can appear as visualizations on forms, dashboards, views, and homepage grids. 
+
+
+   > [!div class="mx-imgBorder"] 
+   > ![Custom slider control](../../maker/model-driven-apps/media/slider-control.PNG "Slider control for a field")
 
 ## Add a custom component to a field
 
@@ -30,15 +34,25 @@ Following the steps in this procedure will change the default label and text box
 
 5. On the Add Control page, select the component that you want, such as the **Linear Slider** component, and then select **Add**.
 
+   > [!div class="mx-imgBorder"] 
+   > ![Add linear slider control](../../maker/model-driven-apps/media/add-slider.PNG "Add linear slider control")
+
 6. Choose the client where you want the component to appear.
 
    - **Web**. To make the custom component available from any web browser, select the Web option next to the component. Notice that setting the Web option includes rendering the component in web browsers on PCs, Macs, and mobile devices.
 
    - **Phone**. To make the custom component available on phones running Dynamics 365 for phones, select the Phone option next to the component.
 
    - **Tablet**. To make the custom component available on tablet devices running Dynamics 365 for tablets, select the Tablet option next to the component.
+
+   > [!div class="mx-imgBorder"] 
+   > ![Choose the client apps to view the custom control](../../maker/model-driven-apps/media/choose-client.png "Choose the client apps to view the custom control") 
+
 7. Select the pencil icon next to **Min**, **Max**, and **Step**, set the property option, and then select **OK**.  
-  
+   
+   > [!div class="mx-imgBorder"] 
+   > ![Add custom control properties](../../maker/model-driven-apps/media/ccf-add-properties.png "Add custom control properties")
+
    - **Min**. Set the minimum accepted value. You can bind a static value that you enter or bind the value to an existing field. In this example **Bind to static value** is **Currency** and the minimum value that can be entered is *zero*.  
 
        - **Bind to a static value**. Select the data type, such as a whole number (Whole.None), currency, floating point (FP), or decimal. Next, enter a number that represents the minimum accepted value for the field.  
@@ -72,6 +86,9 @@ To add a custom component like data-set component or simple table component to a
 
  Open a record that includes the field with the custom component, such as the Opportunity form from the previous example, and view how the field is changed. The field is now rendered as a slider component instead of the text field.  
 
+> [!div class="mx-imgBorder"] 
+> ![Slider control rendered on form](../../maker/model-driven-apps/media/slider-control.PNG "Slider control rendered on form")  
+
 ### See also
 
 [Implementing components in TypeScript](implementing-controls-using-typescript.md)<br/>

powerapps-docs/developer/component-framework/capabilities-and-limitations-for-canvas-apps.md

@@ -0,0 +1,35 @@
+---
+title: PowerApps component framework capabilities and limitations for canvas apps  | Microsoft Docs
+description: Capabilities and limitations for canvas apps
+keywords:
+ms.author: nabuthuk
+author: Nkrb
+manager: kvivek
+ms.date: 08/31/2019
+ms.service: "powerapps"
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5d100dc3-bd82-4b45-964c-d90eaebc0735
+---
+
+# PowerApps component framework capabilities and limitations for canvas apps
+
+The following table describes the capabilities and limitations for building custom components using PowerApps component framework for canvas apps. 
+
+## PowerApps component framework APIs
+
+
+|API Name| Available for| Comments|
+|-------|------|---------|
+|Client|Model-driven apps||
+|Control|Both Model-driven apps and canvas apps (experimental preview)||
+|DataSet|Model-driven apps||
+
+
+## Manifest schema reference 
+
+|Property name|Available for|Comments|
+|------|-------|-------|
+|Code| Both model-driven and canvas apps||
+|control|Both model-driven and canvas apps||

powerapps-docs/developer/component-framework/component-framework-for-canvas-apps.md

@@ -0,0 +1,102 @@
+---
+title: PowerApps component framework for canvas apps  | Microsoft Docs
+description: Create code components for canvas apps
+keywords:
+ms.author: nabuthuk
+author: Nkrb
+manager: kvivek
+ms.date: 08/31/2019
+ms.service: "powerapps"
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5d100dc3-bd82-4b45-964c-d90eaebc0735
+---
+
+# PowerApps component framework for canvas apps
+
+> [!IMPORTANT]
+> This feature is still experimental and disabled by default. For more information, see [Experimental and preview features](../../maker/canvas-apps/working-with-experimental.md).
+
+PowerApps component framework enables app makers to create code components to use in an app or across the apps. more information: [PowerApps component framework overview](overview.md) 
+
+In this experimental preview, PowerApps component framework enables app makers to create code components, debug, import and add them to canvas apps using the PowerApps CLI tooling. Only certain APIs are supported in this experimental preview. It is recommened to check each individual API whether it supports canvas apps or not. 
+
+> [!WARNING]
+> Code components contain code that may not be generated by Microsoft and can potentially access security tokens and data. When adding code components to an app, make sure that the custom component solutions are from trusted source.
+
+## Prerequisites
+
+1. System Administrator privileges is required to enable PowerApps component feature in the environment.
+
+> [!IMPORTANT]
+> By default PowerApps component framework is enabled for model-driven apps.
+
+## Enable PowerApps component framework feature
+
+To add code components to an app, you need to be enable the PowerApps component framework feature in each environment where they are to be used. To enable an environment to use code components inside its apps:
+
+1. Sign in to [PowerApps](https://powerapps.microsoft.com/en-us/).
+
+2. Click on the **Settings** icon and then select **Admin Center**.
+    
+    ![Settings admin center](media/select-admin-center-from-settings.png "Settings admin center") 
+
+3. Select the environment where you want to enable this feature and click on **...** and then select **Settings**.
+
+4. Under the **Products** tab, select **Features**.
+
+   ![Enable PCF](media/enable-pcf-feature.png "Enable PCF")
+
+5. From the list of available features, turn on the switch under the **PowerApps component framework for canvas apps**.
+
+6. Now, open the app where you want to add the code component and navigate to **File** > **App settings** and select **Advanced settings**.
+
+   ![Enable components for pcf](media/enable-components-for-pcf.png "Enable components for pcf")
+   
+7. Turn on the **Components** switch under the **Experimental feature** section.
+
+
+
+## Implementing code components
+
+After you enable the PowerApps component framework feature in your environment, you can start implementing the logic for code components. The [implement sample component](implementing-controls-using-typescript.md) topic demonstrates the step by step process to create code components right from implementing the custom logic, manifest file, debug process, and creating a solution zip file.
+
+> [!NOTE]
+> Implementing code components is same for both model-driven apps and canvas apps (experimental preview). The only difference is adding the code components. 
+
+## Add components to a canvas app
+
+To add code components to a canvas app:
+
+> [!NOTE]
+> To add code components to a field or an entity for model-driven apps, see [Add code components to model-driven apps](add-custom-controls-to-a-field-or-entity.md)
+
+1. Navigate to PowerApps Studio.
+2. Create a new canvas app or edit an existing app that you want to add the custom component to.
+
+   > [!IMPORTANT]
+   > Make sure the code components solution zip file is already [imported](https://docs.microsoft.com/en-us/powerapps/maker/common-data-service/import-update-export-solutions) into Common Data Service before you go onto the next step.
+
+3. Click on **Insert** > **Components** > **Import component**. 
+ 
+    ![Insert components](media/insert-components-import.png "Insert components")
+
+4. Select **Code (experimental)** tab and add a component from the list and click on **Import**. This adds the sample component in the **Components** menu.
+
+    ![Import sample component](media/import-component-add-sample-component.png "Insert sample component")
+
+5. Navigate to **Components** and select the component to add it to the app.
+
+   ![Add sample component](media/add-sample-component-from-list.png "Add sample component")
+
+## Known limitations
+
+1. Only the field type of components are supported in the experimental preview and not the data set type components. 
+2. Common Data Service dependent APIs including WebAPI along with few other APIs are not available for this experimental preview. For individual API availability for this experimental preview release, see [PowerApps component framework API reference](reference/index.md)
+
+## See also
+
+[PowerApps component framework overview](overview.md)<br/>
+[Implement sample component](implementing-controls-using-typescript.md)
+

powerapps-docs/developer/component-framework/control-implementation-library.md

@@ -1,6 +1,6 @@
 ---
 title: Component implementation library | Microsoft Docs
-description: Create custom components using JavaScript or TypeScript
+description: Create code components using JavaScript or TypeScript
 keywords:
 ms.author: nabuthuk
 author: Nkrb
@@ -13,7 +13,7 @@ ms.topic: "article"
 ms.assetid: 5d100dc3-bd82-4b45-964c-d90eaebc0735
 ---
 
-Implementing the component library is one of the key step when you are developing custom components using PowerApps component framework. Developers can implement component library using TypeScript. Each custom component must have a library that includes the definition of a function which returns an object that implements the methods described in the custom component interface. 
+Implementing the component library is one of the key step when you are developing code components using PowerApps component framework. Developers can implement component library using TypeScript. Each custom component must have a library that includes the definition of a function which returns an object that implements the methods described in the custom component interface. 
 
 The object implements the following methods:
 

powerapps-docs/developer/component-framework/create-custom-controls-using-pcf.md

@@ -1,7 +1,7 @@
 ---
 title: Create and build a custom component| Microsoft Docs
 description: Start creating a component using the PowerApps component framework Tooling
-keywords: PowerApps component framework, Custom components, Component Framework
+keywords: PowerApps component framework, code components, Component Framework
 ms.author: nabuthuk
 author: Nkrb
 manager: kvivek
@@ -17,7 +17,7 @@ ms.assetid: d2cbf58a-9112-45c2-b823-2c07a310714c
 
 [!INCLUDE[cc-beta-prerelease-disclaimer](../../includes/cc-beta-prerelease-disclaimer.md)]
 
-This topic demonstrates how to create and deploy custom components using PowerApps component framework. Ensure that you have installed Microsoft PowerApps CLI
+This topic demonstrates how to create and deploy code components using PowerApps component framework. Ensure that you have installed Microsoft PowerApps CLI
 
 ## Create a new component
 
@@ -76,9 +76,9 @@ To build the component project, open the project folder in Visual Studio Code an
 
 ### See also
 
-[Debug custom components](debugging-custom-controls.md)<br/>
+[Debug code components](debugging-custom-controls.md)<br/>
 [Package a custom component](import-custom-controls.md)<br/>
-[Add custom components to a field or entity](add-custom-controls-to-a-field-or-entity.md)<br/>
-[Updating existing custom components](updating-existing-controls.md)<br/>
+[Add code components to a field or entity](add-custom-controls-to-a-field-or-entity.md)<br/>
+[Updating existing code components](updating-existing-controls.md)<br/>
 [PowerApps component framework API Reference](reference/index.md)<br/>
 [PowerApps component framework Overview](overview.md)