Merge branch 'main' into alaug-patch-18

Author: mduelae

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Important update on GitHub Issues [select Open to know more]
+    url: https://learn.microsoft.com/office/new-feedback
+    about: We're transitioning our feedback experience away from GitHub Issues. For more information, select Open.

.openpublishing.redirection.json

@@ -9034,6 +9034,31 @@
       "source_path": "powerapps-docs/user/copilot-chat-in-webplayer.md",
       "redirect_url": "/power-platform/responsible-ai-overview",
       "redirect_document_id": "false"
+    },
+    {
+      "source_path": "powerapps-docs/maker/portals/control-portal-creation.md",
+      "redirect_url": "/power-pages/admin/control-site-creation",
+      "redirect_document_id": "false"
+    },
+    {
+      "source_path": "powerapps-docs/maker/portals/create-additional-portals.md",
+      "redirect_url": "/power-pages/admin/create-additional-sites",
+      "redirect_document_id": "false"
+    },
+    {
+      "source_path": "powerapps-docs/maker/portals/manage-existing-portals.md",
+      "redirect_url": "/power-pages/getting-started/create-manage",
+      "redirect_document_id": "false"
+    },
+    {
+      "source_path": "powerapps-docs/maker/portals/provision-portal-add-on.md",
+      "redirect_url": "/power-pages/admin/provision-add-on",
+      "redirect_document_id": "false"
+    },
+    {
+      "source_path": "powerapps-docs/user/[email protected]",
+      "redirect_url": "collaboration",
+      "redirect_document_id": "false"
     }
   ]
 }

powerapps-docs/developer/model-driven-apps/clientapi/reference/Xrm-WebApi/createRecord.md

@@ -3,7 +3,7 @@ title: "createRecord (Client API reference) in model-driven apps| MicrosoftDocs"
 description: Includes description and supported parameters for the createRecord method.
 author: lancedMicrosoft
 ms.author: lanced
-ms.date: 08/22/2022
+ms.date: 04/29/2024
 ms.reviewer: jdaly
 ms.topic: reference
 applies_to: "Dynamics 365 (online)"
@@ -28,7 +28,7 @@ contributors:
 |`entityLogicalName`|String|Yes|Logical name of the table you want to create. For example: `account`.|
 |`data`|Object|Yes|A JSON object defining the columns and values for the new table record. See [Examples](#examples)|
 |`successCallback`|Function|No|A function to call when a record is created. See [Return Value](#return-value)|
-|`errorCallback`|Function|No|A function to call when the operation fails. An object with the following properties will be passed:<br /> - `errorCode`: Number. The error code.<br /> - `message`: String. An error message describing the issue.|
+|`errorCallback`|Function|No|A function to call when the operation fails. An object with the following properties is passed:<br /> - `errorCode`: Number. The error code.<br /> - `message`: String. An error message describing the issue.|
 
 
 ## Return Value
@@ -74,9 +74,12 @@ Xrm.WebApi.createRecord("account", data).then(
 );
 ```
 
+> [!NOTE]
+> Creating records with a primary image is not supported for offline mode. Primary images can only be set with create in online mode. Other image columns cannot be set with create. [Learn more about Primary images](../../../../data-platform/image-column-data.md#primary-images)
+
 ### Create related table records along with the primary record
 
- You can create tables related to each other by defining them as navigation properties values. This is known as *deep insert*. In this example, we will create a sample account record along with the primary contact record and an associated opportunity record.
+ You can create tables related to each other by defining them as navigation properties values. This pattern is known as *deep insert*. In this example, we create a sample account record along with the primary contact record and an associated opportunity record.
 
 > [!NOTE]
 > Creating related table records in a single create operation is not supported for offline mode.
@@ -123,7 +126,7 @@ To associate new table records to existing table records, set the value of singl
 > [!NOTE]
 > The names of single-valued navigation properties are not always the same as the `LogicalName` for the lookup attribute. You should make sure you are using the `Name` attribute value of the `NavigationProperty` element in the Web API $metadata service document. More information: [Web API Navigation Properties](../../../../data-platform/webapi/web-api-navigation-properties.md)
 
-Here is code example:
+Here's code example:
 
 The following example creates an account record, and associates it to an existing contact record to set the latter as the primary contact for the new account record:
 
@@ -150,7 +153,7 @@ Xrm.WebApi.createRecord("account", data).then(
 **Deprecated method for mobile offline scenario**
 
 > [!NOTE]
-> Instead of using `@odata.bind` annotation example above, the deprecated **lookup** object with case-sensitive properties (`logicalname` and `id`) is still supported for existing customizations. However, it is recommended to use `@odata.bind` annotation for both online and offline scenario instead of using this deprecated object.
+> Instead of using `@odata.bind` annotation example shown previously, the deprecated **lookup** object with case-sensitive properties (`logicalname` and `id`) is still supported for existing customizations. However, it is recommended to use `@odata.bind` annotation for both online and offline scenario instead of using this deprecated object.
 
 The following example uses the deprecated method to create an account record, and associate it to an existing contact record to set the latter as the primary contact for the new account record from mobile clients when working in the offline mode:
 

powerapps-docs/developer/model-driven-apps/image-web-resources.md

@@ -1,11 +1,11 @@
 ---
-title: "Image web resources (model-driven apps) | Microsoft Docs" # Intent and product brand in a unique string of 43-59 chars including spaces
-description: "Learn about using image web resources to make images available for use" # 115-145 characters including spaces. This abstract displays in the search result.
-author: sriharibs-msft
-ms.author: srihas
-ms.date: 04/01/2022
+title: "Image web resources (model-driven apps)"
+description: "Learn about using image web resources to make images available for use."
+author: chmoncay
+ms.author: chmoncay
+ms.date: 04/26/2024
 ms.reviewer: jdaly
-ms.topic: "article"
+ms.topic: article
 ms.subservice: mda-developer
 search.audienceType: 
   - developer
@@ -17,43 +17,69 @@ contributors:
 
 Use image web resources to make images available for use in model-driven apps.  
 
-There are 5 types of image web resources: 
-* PNG Format
-* JPG Format
-* GIF Format
-* ICO Format
-* Vector Format (SVG)
+There are five types of image web resources:
+
+- PNG Format
+- JPG Format
+- GIF Format
+- ICO (Windows icon format) Format
+- SVG (Scalable Vector Graphics) format
 
 > [!NOTE]
 > Vector Format (SVG) web resources were added with the model-driven apps.
 
-  
-<a name="BKMK_Capabilities"></a>   
 
-## Capabilities of image web resources  
-With image web resources you can add images where you need them. Common uses include the following:  
+## Capabilities of image web resources
+
+With image web resources, you can add images where you need them. Common uses include:  
 
-- Custom table icons  
-- Icons for custom ribbon controls and `SiteMap` subareas  
-- Decorative graphics for forms and webpage web resources.  
-- Background images that are used by CSS web resources.  
+- Custom table icons.
+- Icons for custom ribbon controls and `SiteMap` subareas.
+- Decorative graphics for forms and webpage web resources.
+- Background images that are used by CSS web resources.
 
 [!INCLUDE[cc-terminology](../data-platform/includes/cc-terminology.md)]
 
-Use Vector Format (SVG) web resources for any icon presented in the application. Vector images are defined as Scalable Vector Graphics (SVG) an XML-based vector image format. The advantage of SVG over other image web resources is scale, smaller in size, and if the fill color is removed the model-driven app can control the icon color to avoid contrast issues.  When defining the SVG or before uploading it into the web resource please remove any "fill color" attributes. We recommend using SVG over other image types like PNG and JPG. You can define one vector image and re-use it rather than provide multiple sizes of images. You will use these in with a new <xref:Microsoft.Xrm.Sdk.Metadata.EntityMetadata>.<xref:Microsoft.Xrm.Sdk.Metadata.EntityMetadata.IconVectorName> property to define the icon for a custom table instead of the `IconLargeName`, `IconMediumName`, or `IconSmallName` properties.
+## Working with Scalable Vector Graphics (SVG)
+
+Use Vector Format (SVG) web resources for any icon presented in the application. Vector images are defined as Scalable Vector Graphics (SVG), an XML-based vector image format. We recommend using SVG over other image types like PNG and JPG because they have better accessibility, smaller in file size, and can scale with their container.
+
+### Better accessibility
+
+Model-driven apps can control the icon color to avoid contrast issues when SVG's don't contain hex values for colors. Using the [currentColor](https://developer.mozilla.org/docs/Web/CSS/color_value#currentcolor_keyword) can help ensure that the correct theme colors are used.
+
+```html
+<path fill="currentColor" d="M16,0c-0,0-0-0.0-0-0.0v-0c0-0,0-0.0,0-0.0s0,0.0,0,0.0v0C00,0.0,00,0,00,0z"/>
+```
+
+### Smaller file size
+
+SVG files are typically smaller than raster type images, such as jpg or png.
+
+### Scale with their container
+
+You can reuse a single SVG rather than provide multiple sizes of images. Use SVG web resources in the [EntityMetadata.IconVectorName](xref:Microsoft.Xrm.Sdk.Metadata.EntityMetadata.IconVectorName) property to define the icon for a custom table instead of the `IconLargeName`, `IconMediumName`, or `IconSmallName` properties.  
+
+### Best practices
+
+Ensure that a default size is set through the [svg](https://developer.mozilla.org/docs/Web/SVG/Element/svg) element [width](https://developer.mozilla.org/docs/Web/SVG/Attribute/width), [height](https://developer.mozilla.org/docs/Web/SVG/Attribute/height), and [viewBox](https://developer.mozilla.org/docs/Web/SVG/Attribute/viewBox) attributes.
+
+Where possible, remove any hard coded fill colors and don't use embedded style sheets and classes within the SVG. Embedded stylesheets could leak styles if other SVG files are referencing that same class. Use the style attribute to assign values instead. For example:
+
+```html
+<path style="fill:#231F20;" d="M16,0c-0,0-0-0.0-0-0.0v-0c0-0,0-0.0,0-0.0s0,0.0,0,0.0v0C00,0.0,00,0,00,0z"/>
+```
 
 > [!NOTE]
 > Vector Format (SVG) web resources are treated like the [Script (JScript)](./script-jscript-web-resources.md) web resources, and carry the same security risks as JavaScript web resources because SVG files allow JScript embedding.
-  
-<a name="BKMK_Limitations"></a>   
 
-## Limitations of image web resources  
-Like all web resources, image web resources use the security context. Only licensed users who have the necessary privileges can access them.  
- 
-  
-<a name="BKMK_ReferenceFromWebPageWebResource"></a>   
-## Reference an image web resource from a webpage web resource  
- All web resources can use relative URLs to reference each other. In the following example, for the webpage (HTML) web resource new_/content/contentpage.htm to reference the image web resource new_/Images/image1.png, add the following HTML code to new_/content/contentpage.htm:  
+## Limitations of image web resources
+
+Image web resources use the security context like all web resources. Only licensed users who have the necessary privileges can access them.
+
+## Reference an image web resource from a webpage web resource
+
+All web resources can use relative URLs to reference each other. In the following example, for the webpage (HTML) web resource new_/content/contentpage.htm to reference the image web resource new_/Images/image1.png, add the following HTML code to new_/content/contentpage.htm:  
 
 ```html  
 <img src="../Images/image1.png" />  
@@ -62,45 +88,32 @@ Like all web resources, image web resources use the security context. Only licen
 
 ## Reference an image web resource from a form  
 
-#### Add an image to a form  
-  
-1. Navigate to the form editor for a table.  
-  
-2. Select where you want to add the image in the form.  
-  
-3. On the **Insert tab**, select **Web Resource**.  
-  
-4. On the **General** tab, select the web resource image that you want to add.  
-  
-5. Specify a name for the web resource. You can also specify a label and alternative text.  
+### Add an image to a form  
 
-6. On the **Formatting** tab, you can define:  
+1. Navigate to the form editor for a table.
+1. Select where you want to add the image in the form.
+1. On the **Insert tab**, select **Web Resource**.
+1. On the **General** tab, select the web resource image that you want to add.
+1. Specify a name for the web resource. You can also specify a label and alternative text.
+1. On the **Formatting** tab, you can define:
 
-    - The number of columns the images should use.  
-  
-    - The number of rows the images should use, or if it should automatically expand to use available space.  
-  
-    -  The size of the image using the following options:  
+    - The number of columns the images should use.
+    - The number of rows the images should use, or if it should automatically expand to use available space.
+    - The size of the image using the following options:
 
         - **Stretch to fit**  
-  
-        - **Stretch to fit (maintain aspect ratio)**  
-  
+        - **Stretch to fit (maintain aspect ratio)**
         - **Original**  
-  
         - **Specific**  
 
-    -   If you select "Specific," you can enter the desired height and width in pixels.  
-  
-7.  Select **OK**.  
+    - If you select "Specific," you can enter the desired height and width in pixels.  
 
-8.  You must save your changes and publish the form before users can see the image in the form.  
-  
-<a name="BKMK_ReferenceWithWebResourcedirective"></a> 
+1. Select **OK**.
+1. You must save your changes and publish the form before users can see the image in the form.
 
 ## Reference an image web resource from a ribbon element or from the Site Map subarea  
 
-Use the `$webresource:` directive to specify a web resource image to use as an icon in the ribbon or in the application navigation using Site Map. The following sample shows how to specify icons for a button in the ribbon.  
+Use the `$webresource:` directive to specify a web resource image to use as an icon in the ribbon or in the application navigation using Site Map. The following sample shows how to specify icons for a button in the ribbon.
 
 ```xml  
 <Button Id="MyISV.opportunity.form.actions.FlyoutAnchor.Button.1" Image16by16="$webresource:new_/icons/oneIcon16.png" Image32by32="$webresource:new_/icons/oneIcon32.png"/>  
@@ -109,13 +122,14 @@ Use the `$webresource:` directive to specify a web resource image to use as an i
 > [!NOTE]
 > Using the `$webresource:` directive adds a solution dependency that prevents the referenced image web resources from being deleted as long as they are used by another solution component.  
   
-### See also  
- [Web resources](web-resources.md)   
- [Using Web Page (HTML) web resources](webpage-html-web-resources.md)   
- [Using Style Sheet (CSS) web resources](css-web-resources.md)   
- [Using JavaScript web resources](script-jscript-web-resources.md)   
- [Using Data (XML) web resources](data-xml-web-resources.md)     
- [Using Stylesheet (XSL) web resources](stylesheet-xsl-web-resources.md)
+### See also
+
+[Web resources](web-resources.md)   
+[Using Web Page (HTML) web resources](webpage-html-web-resources.md)   
+[Using Style Sheet (CSS) web resources](css-web-resources.md)   
+[Using JavaScript web resources](script-jscript-web-resources.md)   
+[Using Data (XML) web resources](data-xml-web-resources.md)     
+[Using Stylesheet (XSL) web resources](stylesheet-xsl-web-resources.md)
 
 
 [!INCLUDE[footer-include](../../includes/footer-banner.md)]

powerapps-docs/docfx.json

@@ -42,7 +42,9 @@
         "marycc",
         "tinaburden",
         "almostdunh",
-        "AshleyWoodruff"
+        "AshleyWoodruff",
+        "kimberleybrown",
+        "nathlaroche"
       ],
       "breadcrumb_path": "breadcrumb/toc.yml",
       "ms.suite": "office",

powerapps-docs/maker/TOC.yml

@@ -245,6 +245,8 @@
     href: search.md
   - name: Get help from a virtual agent
     href: ./common/virtual-agent.md
+  - name: Copilot in Power Apps overview
+    href: ./canvas-apps/ai-overview.md
 - name: Canvas apps
   items:
   - name: Canvas apps
@@ -286,10 +288,8 @@
           - name: Troubleshoot common errors
             href: ./canvas-apps/figma/common-errors.md
             displayName: Troubleshoot common errors when creating app from Figma
-    - name: Create an app using AI Copilot 
+    - name: Create an app using Copilot
       items:
-      - name: Overview
-        href: ./canvas-apps/ai-overview.md
       - name: Create an app from conversations
         href: ./canvas-apps/ai-conversations-create-app.md
       - name: Continue editing your app with Copilot (preview)
@@ -1851,16 +1851,6 @@
   items:
     - name: What is Power Pages?
       href: /power-pages/introduction
-    - name: Create and manage sites
-      items:
-        - name: Create a site using the older add-on
-          href: ./portals/provision-portal-add-on.md
-        - name: Create additional sites in an environment
-          href: ./portals/create-additional-portals.md
-        - name: Control site creation in a tenant
-          href: ./portals/control-portal-creation.md
-        - name: Manage existing sites
-          href: ./portals/manage-existing-portals.md
     - name: List OData feeds
       href: ./portals/configure/list-odata-feeds.md
     - name: Create custom Portal Management app
@@ -2051,6 +2041,10 @@
           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: Create low-code plug-ins to use with a copilot
+          href: ./data-platform/low-code-plugins-copilot-studio.md
+        - name: Low-code plug-ins tips and known issues
+          href: ./data-platform/low-code-plug-ins-tips.md
       - name: Work with actions
         items:
         - name: Use actions