Share via


Solution entity messages and methods

 

Applies To: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

A solution represents a group of solution components that can be exported or imported.

When a solution is managed, it is treated as a single unit of software. Deleting a managed solution removes all the solution components.

When a solution is unmanaged, it is just a named grouping for a set of solution components. Deleting an unmanaged solution just removes the group. All solution components remain. A managed solution is created by exporting an unmanaged solution and selecting to export it as a managed solution. The schema name for this entity is Solution. To view the entity metadata for your organization, install the Metadata Browser solution described in Browse the metadata for your organization. You can also view the metadata for an uncustomized organization in the Excel file called EntityMetadata.xlsx included in the top-level folder of the SDK download.

The following table describes the messages for this entity, which you use with the IOrganizationService.Execute method.

Message

Description

AssociateRequest

Creates a link between a record and one or more records that participate in a relationship. You can also use the IOrganizationService.Associate method. For more information, see Actions on entity records. For a list of default relationships for this entity, see Solution entity metadata. You can find this information in the metadata for your organization. See the preceding metadata browser information.

CloneAsPatchRequest

Creates a patch for a solution. The patch contains changes to entities and other entity related assets. For more information see Create patches to simplify solution updates.

CloneAsSolutionRequest

Creates a duplicate copy of an unmanaged solution with a higher major.minor version number. For more information see Create patches to simplify solution updates.

CreateRequest

Creates a solution. You can also call the IOrganizationService.Create method.

DeleteRequest

Deletes a solution. You can also call the IOrganizationService.Delete method.

DeleteAndPromoteRequest

Can be used on a base solution when there’s a new version of the solution imported as a holding solution. This message request deletes the base solution and its patches and renames the holding solution to the same name as that of the base solution. More information:  Create patches to simplify solution updates.

DisassociateRequest

Removes a link between a record and one or more records that participate in a relationship. You can also use the IOrganizationService.Disassociate method. For more information, see Actions on entity records. For a list of default relationships for this entity, see the Solution entity metadata. You can find this information in the metadata for your organization. See the preceding metadata browser information.

ExportSolutionRequest

Export a managed or unmanaged solution.

ImportSolutionRequest

Import a managed or unmanaged solution.

Note

This message can be used with the ExecuteAsyncRequest See Execute messages in the background (asynchronously) for more information.

InitializeFromRequest

Initializes a new record from an existing record provided that an attribute map is defined for the two entities. For more information, see Customize entity and attribute mappings.

RetrieveDuplicatesRequest

Detects and retrieves duplicate records for the specified record provided that duplicate detection is enabled and there are published duplicate detection rules for the entity. For more information, see Detect duplicate data.

RetrieveRequest

Retrieves a solution. You can also call the IOrganizationService.Retrieve method.

RetrieveMultipleRequest

Retrieves a collection of solutions. You can also call the IOrganizationService.RetrieveMultiple method.

UpdateRequest

Updates a solution. You can also call the IOrganizationService.Update method.

Constant SolutionId Values

When you program using solutions you may need to reference the following solution records. Each Microsoft Dynamics 365 organization has the following solutions that can be referenced by the SolutionId values.

Name

SolutionId

Description

Default

{FD140AAF-4DF4-11DD-BD17-0019B9312238}

The Default solution does not contain any solution components. It contains references to all the managed and unmanaged solution components in the system.

Active

{FD140AAE-4DF4-11DD-BD17-0019B9312238}

The Active solution represents the current published unmanaged customizations that define the behavior of the application.

See Also

Solution entities
SolutionComponent entity messages and methods
Introduction to solutions
Privileges by entity

Microsoft Dynamics 365

© 2016 Microsoft. All rights reserved. Copyright