Skip to content

Commit 7727d2a

Browse files
committed
Merge branch 'master' into portals-copyedit-4-1844159
2 parents 9f1dd3a + 37b92ce commit 7727d2a

File tree

112 files changed

+2537
-2699
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

112 files changed

+2537
-2699
lines changed

.openpublishing.redirection.json

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,10 @@
11
{
22
"redirections": [
3+
{
4+
"source_path": "powerapps-docs/maker/model-driven-apps/customize-power-bi-content-packs.md",
5+
"redirect_url": "../common-data-service/use-powerbi-with-cds",
6+
"redirect_document_id": "false"
7+
},
38
{
49
"source_path": "powerapps-docs/maker/common-data-service/how-managed-solutions-merged.md",
510
"redirect_url": "https://docs.microsoft.com/power-platform/alm/how-managed-solutions-merged",

README.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,10 +4,10 @@ This is the GitHub repository for the technical product documentation for **Powe
44

55
## How to contribute
66

7-
Thanks for your interest in contributing to [Docs.microsoft.com](https://docs.microsoft.com/), home of technical content for Microsoft products and services.
7+
Thanks for your interest in contributing to [docs.microsoft.com](https://docs.microsoft.com/), home of technical content for Microsoft products and services.
88

99
To learn how to make contributions to the content in this repository, start with our [Docs contributor guide](https://docs.microsoft.com/contribute). If you are a Microsoft employee, please visit the [internal version](https://aka.ms/docsguidescontribute) of this guide.
1010

1111
## Code of conduct
1212

13-
This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/). For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [[email protected]](mailto:[email protected]) with any additional questions or comments.
13+
This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/). For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [[email protected]](mailto:[email protected]) with any additional questions or comments.

powerapps-docs/developer/common-data-service/cds-sql-query.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: "Use SQL to query data (Common Data Service) | Microsoft Docs" # Intent and product brand in a unique string of 43-59 chars including spaces
33
description: "Learn how to query Common Data Service entity data using SQL." # 115-145 characters including spaces. This abstract displays in the search result.
44
ms.custom: ""
5-
ms.date: 05/05/2020
5+
ms.date: 05/26/2020
66
ms.reviewer: "pehecke"
77
ms.service: powerapps
88
ms.topic: "article"
@@ -25,7 +25,7 @@ A SQL data connection is available on the Common Data Service endpoint. The SQL
2525
> [!IMPORTANT]
2626
> - This is a preview feature, and isn't available in all regions.
2727
> - [!INCLUDE[cc_preview_features_definition](../../includes/cc-preview-features-definition.md)]
28-
> - Instructions to enable the feature can be found here: [View entity data in Power BI Desktop](/powerapps/maker/common-data-service/view-entity-data-power-bi).
28+
> - Instructions to enable the feature can be found here: [View entity data in Power BI Desktop](/powerapps/maker/common-data-service/view-entity-data-power-bi), and [Manage feature settings](/power-platform/admin/settings-features) (see TDS endpoint setting).
2929
3030
## Applications support
3131

powerapps-docs/developer/common-data-service/file-attributes.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -39,6 +39,9 @@ When a file attribute is added to an entity some additional attributes are creat
3939
### MaxSizeInKB attribute
4040

4141
This value represents the maximum size (in kilobytes) of the file data that the attribute can contain. Set this value to the smallest useable data size appropriate for your particular application. See the <xref:Microsoft.Xrm.Sdk.Metadata.FileAttributeMetadata.MaxSizeInKB> property for the allowable size limit and the default value.
42+
43+
> [!NOTE]
44+
> MaxSizeInKB is set when the File attribute is added to an entity. This cannot be changed after it is set.
4245
4346
<a name="BKMK_RetrievingFiles"></a>
4447

powerapps-docs/developer/common-data-service/image-attributes.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -72,6 +72,9 @@ In addition to image attributes, custom entities support zero or more file attri
7272
### MaxSizeInKB attribute
7373

7474
This value represents the maximum size (in kilobytes) of the image data that the attribute can contain. Set this value to the smallest useable data size appropriate for your particular application. See the <xref:Microsoft.Xrm.Sdk.Metadata.ImageAttributeMetadata.MaxSizeInKB> property for the allowable size limit and the default value.
75+
76+
> [!NOTE]
77+
> MaxSizeInKB is set when the Image attribute is added to an entity. This cannot be changed after it is set.
7578
7679
### CanStoreFullImage attribute
7780

powerapps-docs/developer/common-data-service/powerapps-cli.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -49,7 +49,7 @@ This table lists some common commands used in the CLI:
4949
|Command|Description|Examples|
5050
|------|-----------|--------|
5151
|**pcf**|Commands for working with [Power Apps component framework](/powerapps/developer/component-framework/overview). It has the following parameters: <br/> - **init**: Initializes the code component project. It has the following parameters <br/> - *namespace*: Namespace of the code component. <br/> - *name*: Name of the code component. <br/> - *template*: Field or dataset <br/> - **push**: Pushes the code component to the Common Data Service instance with all the latest changes. It has the following parameter: <br/> - *publisher-prefix*: Publisher prefix of the organization.<br/> - **Version**: Updates the component manifest file with the specified patch version. It has the following parameters: <br/> - *patchversion*: Patch version of the code component. `patchversion` will only take value of the third part of the version tuple: `Major.Minor.Patch`.<br/> - *path*: Absolute or relative path of the component manifest file.<br/> - *allmanifests*: Updates the patch version for all the component manifest files.| `pac pcf init --namespace <specify your namespace here> --name <Name of the code component> --template <component type>` <br/> <br/> `pac pcf push --publisher-prefix <your publisher prefix>` <br/><br/> `pac pcf version --patchversion <number> --path <Absolute or relative path to component manifest file --allmanifests`|
52-
|**solution**|Commands for working with [Common Data Service solution projects](/powerapps/maker/common-data-service/solutions-overview). It has the following parameters: <br/> - **init**: Initializes the solution project. It has the following parameters:<br/> - *publisher-name*: Publisher name of the organization. <br/> - *publisher-prefix*: Publisher prefix of the organization. <br/> - **add-reference**: Sets the reference path to the component project folder by passing the `path` parameter.<br/> - **clone**: Creates a solution project based up on the existing solution project by passing the following parameters `name`, `version`, and `include`|`pac solution init --publisher-name <enter your publisher name> --publisher-prefix <enter your publisher prefix>` <br/><br/> `pac solution add-reference --path <path to your Power Apps component framework project>`<br/><br/> `pac solution clone –name<name of the solution to be exported> --version <version of your solution> --include <settings that should be included>`|
52+
|**solution**|Commands for working with [Common Data Service solution projects](/powerapps/maker/common-data-service/solutions-overview). It has the following parameters: <br/> - **init**: Initializes the solution project. It has the following parameters:<br/> - *publisher-name*: Publisher name of the organization. <br/> - *publisher-prefix*: Publisher prefix of the organization. <br/> - **add-reference**: Sets the reference path to the component project folder by passing the `path` parameter.<br/> - **clone**: Creates a solution project based up on the existing solution project by passing the following parameters:<br/> -*name*: The name of the solution to be exported.<br/> -*targetversion*: The version that the exported solution supports.<br/> -*include*: Settings that should be included in the solution being exported.<br/> -**Export**: Exports a Common Data Service solution project from the current organization. It has the following parameters:<br/> -*path*: Place where the exported solution zip file will be saved.<br/> - *name*: Name oft he solution that needs to be exported.<br/> - *managed*: Defines whether the solution should be exported as a managed solution or not.<br/>-*targetversion*: The version that the exported solution supports.<br/> -*include*: Settings that should be included in the solution being exported.|`pac solution init --publisher-name <enter your publisher name> --publisher-prefix <enter your publisher prefix>` <br/><br/> `pac solution add-reference --path <path to your Power Apps component framework project>`<br/><br/> `pac solution clone –name<name of the solution to be exported> --version <version of your solution> --include <settings that should be included>`|
5353
|**auth**|Commands to [authenticate to Common Data Service](/powerapps/developer/component-framework/import-custom-controls#connecting-to-your-environment). It has the following parameters: <br/> - **create**: Creates the authentication profile for your organization by passing the `url` parameter. Pass the organization url for the `url` parameter. <br/> - **list**: Provides the list of authentication profiles. <br/> - **select**: Provides a way to switch between previously created authentication profiles by passing the `index` parameter.<br/>**delete**: Deletes the authentication profile created by passing the `index` parameter.|`pac auth create --url <your Common Data Service org’s url>` <br/> <br/> `pac auth list` <br/><br/> `Pac auth select --index <index of the active profile>`|
5454
|**telemetry**|Manages the telemetry settings. It has the following parameters: <br/>- *enable*: Enables the telemetry option.<br/> - *disable*: Disables the telemetry option.<br/> - *status*: Returns whether the telemetry is enabled or disabled.|`pac telemetry enable` <br/><br/> `pac telemetry disable`|
5555
|**org**|Command to work with Common Data Service.|`pac org who`|

powerapps-docs/developer/component-framework/import-custom-controls.md

Lines changed: 31 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@ To create and import a solution file:
2222
2. Create a new solutions project using the following command. The solution project is used for bundling the code component into a solution zip file that is used for importing into Common Data Service.
2323

2424
```CLI
25-
pac solution init --publisher-name <enter your publisher name> --publisher-prefix <enter your publisher prefix>
25+
pac solution init --publisher-name developer --publisher-prefix dev
2626
```
2727

2828
> [!NOTE]
@@ -31,7 +31,7 @@ To create and import a solution file:
3131
3. Once the new solution project is created, refer the **Solutions** folder to the ___location where the created sample component is located. You can add the reference using the command shown below. This reference informs the solution project about which code components should be added during the build. You can add references to multiple components in a single solution project.
3232

3333
```CLI
34-
pac solution add-reference --path <path to your Power Apps component framework project>
34+
pac solution add-reference --path c:\downloads\mysamplecomponent
3535
```
3636

3737
3. To generate a zip file from the solution project, go into your solution project directory and build the project using the following command. This command uses *MSBuild* to build the solution project by pulling down the *NuGet* dependencies as part of the restore. Use the `/restore` only for the first time when the solution project is built. For every build after that, you can run the command `msbuild`.
@@ -53,12 +53,12 @@ To create and import a solution file:
5353

5454
You can deploy the code components directly from the Power Apps CLI by connecting to the Common Data Service environment and then pushing the updated components.
5555

56-
Use the following steps to create the authentication profile, connect to Common Data Service, and push the updated components.
56+
Follow the steps below to create the authentication profile, connect to Common Data Service, and push the updated components.
5757

5858
1. Create your authentication profile using the command:
5959

6060
```CLI
61-
pac auth create --url <https://xyz.crm.dynamics.com>
61+
pac auth create --url https://xyz.crm.dynamics.com
6262
```
6363
6464
2. If you have previously created an authentication profile, you can view all the existing profiles using the command:
@@ -84,7 +84,11 @@ Use the following steps to create the authentication profile, connect to Common
8484
8585
## Deploying code components
8686
87-
After you have successfully created an authentication profile, you can start pushing the code components to the Common Data Service instance with all the latest changes. The `push` capability speeds up the inner-developer cycle development because it bypasses the code component versioning requirements and does not require that you build your solution (cdsproj) to import the code component. To use the `push` capability, do the following:
87+
After you have successfully created an authentication profile, you can start pushing the code components to the Common Data Service instance with all the latest changes.
88+
89+
The `push` capability speeds up the inner-developer cycle development because it bypasses the code component versioning requirements and does not require that you build your solution (cdsproj) to import the code component.
90+
91+
To use the `push` capability, do the following:
8892
8993
1. Ensure that you have a valid authentication profile created.
9094
2. Navigate to the root directory where the code component project is created.
@@ -105,9 +109,12 @@ To create a solution project based on an existing solution in Common Data Servic
105109
2. Run the command
106110

107111
```CLI
108-
pac solution clone –name(-n) <name of the solution to be exported> --version(-v) <version of your solution> --include(-i) <settings that should be included>
112+
pac solution clone –-name(-n) <name of the solution to be exported> --targetversion(-v) <version of your solution> --include(-i) <settings that should be included>
109113
```
110114

115+
> [!NOTE]
116+
> Settings Values: autonumbering, calendar, customization, emailtracking, externalapplications, general, isvconfig, marketing, outlooksynchronization, relationshiproles, sales.
117+
111118
More information: [Settings options](https://docs.microsoft.com/dotnet/api/microsoft.crm.sdk.messages.exportsolutionrequest?view=dynamics-general-ce-9)
112119

113120
## Create a plug-in project and add a reference to it in your solution
@@ -116,30 +123,30 @@ More information: [Settings options](https://docs.microsoft.com/dotnet/api/micro
116123
> The plugin command is in public preview and
117124
Power Apps CLI now supports creating a plug-in project and packaging it in a solution by adding a reference to the plug-in project. The `pac plugin init` command creates the template files (csproj, Plugin.cs & ServiceHelper.cs) in the directory. To do so:
118125

119-
1. Ensure that you have a valid authentication profile created.
120-
2. Navigate to the root directory where you want the project to be created.
121-
3. Run the command
126+
1. Ensure that you have a valid authentication profile created.
127+
2. Navigate to the root directory where you want the project to be created.
128+
3. Run the command
122129

123-
```CLI
124-
pac auth create –url <https://xyz.crm.dynamics.com>
125-
```
126-
4. Run the command to create the plug-in project
130+
```CLI
131+
pac auth create –url <https://xyz.crm.dynamics.com>
132+
```
133+
4. Run the command to create the plug-in project
127134

128-
```CLI
129-
pac plugin init
130-
```
135+
```CLI
136+
pac plugin init
137+
```
131138

132-
5. Add a reference to your solution project using the following command so that the plug-in project gets built when the solution is built.
139+
5. Add a reference to your solution project using the following command so that the plug-in project gets built when the solution is built.
133140

134-
```CLI
135-
pac solution add-reference –path <path to your plugin project>
136-
```
141+
```CLI
142+
pac solution add-reference –path <path to your plugin project>
143+
```
137144

138-
6. Run the command to build the solution and the referenced plug-in.
145+
6. Run the command to build the solution and the referenced plug-in.
139146

140-
```CLI
141-
msbuild
142-
```
147+
```CLI
148+
msbuild
149+
```
143150

144151
## Remove components from a solution
145152

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1 @@
1-
PowerApps
1+
Power Apps

powerapps-docs/index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -406,7 +406,7 @@ ms.custom:
406406
<h3 style="font-size: 1.15rem">Environment and security</h3>
407407
<hr/>
408408
<p><a class="barLink" style="font-size: 0.95rem" href="/power-platform/admin/environments-overview">Environments overview</a></p>
409-
<p><a class="barLink" style="font-size: 0.95rem" href="/power-platform/admin/trial-environments">Trial environements</a></p>
409+
<p><a class="barLink" style="font-size: 0.95rem" href="/power-platform/admin/trial-environments">Trial environments</a></p>
410410
<p><a class="barLink" style="font-size: 0.95rem" href="/power-platform/admin/database-security">Environment security</a></p>
411411
</div>
412412
</div>

0 commit comments

Comments
 (0)