public static Guid RegisterStep(CrmOrganization org, CrmPluginStep step)
{
if (org == null)
{
throw new ArgumentNullException("org");
}
else if (step == null)
{
throw new ArgumentNullException("step");
}
Dictionary <string, object> entityList = step.GenerateCrmEntities();
SdkMessageProcessingStep sdkStep = (SdkMessageProcessingStep)entityList[SdkMessageProcessingStep.EntityLogicalName];
//This is a sanity check. The UI won't allow a user to set the secure configuration.
if (org.SecureConfigurationPermissionDenied)
{
sdkStep.Attributes.Remove("sdkmessageprocessingstepsecureconfigid");
sdkStep.RelatedEntities.Clear();
}
else if (entityList.ContainsKey(Entities.SdkMessageProcessingStepSecureConfig.EntityLogicalName))
{
Guid secureConfigId = Guid.NewGuid();
//Create the related secure config in the related entities
SdkMessageProcessingStepSecureConfig sdkSecureConfig =
(SdkMessageProcessingStepSecureConfig)entityList[SdkMessageProcessingStepSecureConfig.EntityLogicalName];
sdkSecureConfig.Id = secureConfigId;
sdkStep.RelatedEntities[new Relationship(CrmPluginStep.RelationshipStepToSecureConfig)] =
new EntityCollection(new Entity[] { sdkSecureConfig })
{
EntityName = sdkSecureConfig.LogicalName
};
step.SecureConfigurationId = secureConfigId;
}
return(org.OrganizationService.Create(sdkStep));
}
public static bool UpdateStep(CrmOrganization org, CrmPluginStep step, Guid?origSecureConfigId,
IList <CrmPluginImage> updateImages)
{
if (org == null)
{
throw new ArgumentNullException("org");
}
else if (step == null)
{
throw new ArgumentNullException("step");
}
Dictionary <string, object> entityList = step.GenerateCrmEntities();
SdkMessageProcessingStep sdkStep = (SdkMessageProcessingStep)entityList[SdkMessageProcessingStep.EntityLogicalName];
// Loop through each image and set the new message property
List <SdkMessageProcessingStepImage> sdkImages = null;
if (null != updateImages)
{
// Ensure that the given message supports images
CrmMessage message = org.Messages[step.MessageId];
if (0 == message.ImageMessagePropertyNames.Count && step.Images.Count > 0)
{
throw new InvalidOperationException(string.Format(CultureInfo.InvariantCulture,
"The step has images registered, but the \"{0}\" message doesn't support images.{1}In order to change the message to \"{0}\", delete the existing images.",
message.Name, Environment.NewLine));
}
// Loop through the existing images and update their message property name values
sdkImages = new List <SdkMessageProcessingStepImage>(updateImages.Count);
foreach (CrmPluginImage image in updateImages)
{
// Set the message property name for each of the images
string propertyName = MessagePropertyNameForm.SelectMessagePropertyName(message);
if (string.IsNullOrWhiteSpace(propertyName))
{
return(false);
}
else if (string.Equals(image.MessagePropertyName, propertyName, StringComparison.Ordinal))
{
continue;
}
// Create the entity to update the value
SdkMessageProcessingStepImage sdkImage = new SdkMessageProcessingStepImage();
sdkImage.Id = image.ImageId;
sdkImage.MessagePropertyName = propertyName;
sdkImage.EntityState = EntityState.Changed;
sdkImages.Add(sdkImage);
}
}
//This is a sanity check. The UI won't allow a user to set the secure configuration.
if (org.SecureConfigurationPermissionDenied)
{
sdkStep.Attributes.Remove("sdkmessageprocessingstepsecureconfigid");
sdkStep.RelatedEntities.Clear();
origSecureConfigId = null;
}
else if (entityList.ContainsKey(Entities.SdkMessageProcessingStepSecureConfig.EntityLogicalName))
{
if (null == origSecureConfigId)
{
entityList.Remove(Entities.SdkMessageProcessingStepSecureConfig.EntityLogicalName);
}
else
{
SdkMessageProcessingStepSecureConfig sdkSecureConfig =
(SdkMessageProcessingStepSecureConfig)entityList[SdkMessageProcessingStepSecureConfig.EntityLogicalName];
Guid secureConfigId;
EntityState secureConfigState;
if (step.SecureConfigurationId == origSecureConfigId && origSecureConfigId.GetValueOrDefault() != Guid.Empty)
{
//Set the ID of the secure configuration to be the
secureConfigId = origSecureConfigId.GetValueOrDefault();
secureConfigState = EntityState.Changed;
//Set the original secure config id so that the current id is not deleted
sdkStep.SdkMessageProcessingStepSecureConfigId =
new EntityReference(SdkMessageProcessingStepSecureConfig.EntityLogicalName, secureConfigId);
}
else
{
secureConfigId = Guid.NewGuid();
secureConfigState = EntityState.Created;
}
//Set the configuration id for the step
step.SecureConfigurationId = secureConfigId;
//Populate the secure configuration object and add it to the related entities
sdkSecureConfig.SdkMessageProcessingStepSecureConfigId = secureConfigId;
sdkSecureConfig.EntityState = secureConfigState;
//Update the related entities
sdkStep.sdkmessageprocessingstepsecureconfigid_sdkmessageprocessingstep = sdkSecureConfig;
//Reset the original secure configuration
origSecureConfigId = null;
}
}
else if (null != origSecureConfigId)
{
// To null out if it was set before
sdkStep.SdkMessageProcessingStepSecureConfigId = null;
step.SecureConfigurationId = Guid.Empty;
if (Guid.Empty == origSecureConfigId)
{
origSecureConfigId = null;
}
}
// If the images need to be updated, there are two possible scenarios:
// 1) The step is profiled -- The parent of the image is not the step that is currently being updated
// but rather the profiler step itself. In order to avoid changing this, there will have to be two SDK
// operations (update the step and update the images). Otherwise, the next time the profiled step executes,
// the images won't be present.
// 2) The step is not profiled -- The image can be added to the related entities because the parent step is the
// current step being updated.
if (null != sdkImages && sdkImages.Count > 0)
{
if (!step.IsProfiled || step.ProfilerStepId == step.StepId)
{
sdkStep.sdkmessageprocessingstepid_sdkmessageprocessingstepimage = sdkImages;
}
}
//Update the step
org.OrganizationService.Update(sdkStep);
if (step.IsProfiled && null != sdkImages && sdkImages.Count > 0)
{
// Update the Profiler step with the new property values as a single transaction to minimize the
// possibility of data corruption.
SdkMessageProcessingStep profilerStep = new SdkMessageProcessingStep();
profilerStep.Id = step.ProfilerStepId.GetValueOrDefault();
profilerStep.sdkmessageprocessingstepid_sdkmessageprocessingstepimage = sdkImages;
org.OrganizationService.Update(profilerStep);
}
// Refresh the objects so that the caller has up-to-date data
OrganizationHelper.RefreshStep(org, step);
if (null != updateImages)
{
foreach (CrmPluginImage image in updateImages)
{
OrganizationHelper.RefreshImage(org, image, step);
}
}
// Delete the orphaned Secure config when nulling out the value on the step
if (null != origSecureConfigId)
{
org.OrganizationService.Delete(SdkMessageProcessingStepSecureConfig.EntityLogicalName, origSecureConfigId.GetValueOrDefault());
}
return(true);
}