/// <summary>
/// Metadata write operations will be duplicated and cleared client side.
/// Unallowed fields for write operations (IshFieldDefinition.AllowOnCreate/AllowOnUpdate) will be stripped with a Debug log message.
/// </summary>
/// <remarks>Logs debug entry for unknown combinations of ishTypes, ishField (name, level), mandatory, multi-value,... entries - will not throw.</remarks>
/// <param name="ishTypes">Given ISHTypes (like ISHMasterDoc, ISHLibrary, ISHConfiguration,...) to verify/alter the IshFields for</param>
/// <param name="ishFields">Incoming IshFields entries will be transformed to matching and allowed IshMetadataField entries</param>
/// <param name="actionMode">MetadataFields only has value for write operations like Create, Update,...</param>
public IshFields ToIshMetadataFields(Enumerations.ISHType[] ishTypes, IshFields ishFields, Enumerations.ActionMode actionMode)
{
IshFields metadataFields = new IshFields();
foreach (Enumerations.ISHType ishType in ishTypes)
{
foreach (IshField ishField in ishFields.Fields())
{
var key = Enumerations.Key(ishType, ishField.Level, ishField.Name);
// Any unknown field will be skipped, unless strict is Off
if (!_ishTypeFieldDefinitions.ContainsKey(key))
{
switch (_strictMetadataPreference)
{
case Enumerations.StrictMetadataPreference.SilentlyContinue:
_logger.WriteDebug($"ToIshMetadataFields skipping unknown ishType[{ishType}] level[{ishField.Level}] name[{ishField.Name}] valueType[{ishField.ValueType}]");
break;
case Enumerations.StrictMetadataPreference.Continue:
_logger.WriteVerbose($"ToIshMetadataFields skipping unknown ishType[{ishType}] level[{ishField.Level}] name[{ishField.Name}] valueType[{ishField.ValueType}]");
break;
case Enumerations.StrictMetadataPreference.Off:
metadataFields.AddOrUpdateField(ishField.ToMetadataField(), actionMode);
break;
}
continue; // move to next ishField
}
// Known field, however could be not allowed for current action
switch (actionMode)
{
case Enumerations.ActionMode.Create:
if (!_ishTypeFieldDefinitions[key].AllowOnCreate)
{
switch (_strictMetadataPreference)
{
case Enumerations.StrictMetadataPreference.Continue:
_logger.WriteVerbose($"ToIshMetadataFields AllowOnCreate removed ishType[{ishType}] level[{ishField.Level}] name[{ishField.Name}] valueType[{ishField.ValueType}]");
break;
}
}
else
{
switch (_strictMetadataPreference)
{
case Enumerations.StrictMetadataPreference.SilentlyContinue:
case Enumerations.StrictMetadataPreference.Continue:
// Doing an Add, as a later RemoveDuplicateFields can be smarter to keep the 'best' metadata field
metadataFields.AddField(ishField.ToMetadataField());
break;
case Enumerations.StrictMetadataPreference.Off:
// Doing an AddOrUpdate (Replace), so only one ValueType is left to avoid ambiguity on a Create/Update API call
metadataFields.AddOrUpdateField(ishField.ToMetadataField(), actionMode);
break;
}
}
break;
case Enumerations.ActionMode.Update:
if (!_ishTypeFieldDefinitions[key].AllowOnUpdate)
{
switch (_strictMetadataPreference)
{
case Enumerations.StrictMetadataPreference.Continue:
_logger.WriteVerbose($"ToIshMetadataFields AllowOnUpdate removed ishType[{ishType}] level[{ishField.Level}] name[{ishField.Name}]");
break;
}
}
else
{
switch (_strictMetadataPreference)
{
case Enumerations.StrictMetadataPreference.SilentlyContinue:
case Enumerations.StrictMetadataPreference.Continue:
// Doing an Add, as a later RemoveDuplicateFields can be smarter to keep the 'best' metadata field
metadataFields.AddField(ishField.ToMetadataField());
break;
case Enumerations.StrictMetadataPreference.Off:
// Doing an AddOrUpdate (Replace), so only one ValueType is left to avoid ambiguity on a Create/Update API call
metadataFields.AddOrUpdateField(ishField.ToMetadataField(), actionMode);
break;
}
//TODO [Should] IshTypeFieldSetup - Potential conflict if ishField having multiple ishvaluetype have conflicting entries for id/element/value
// 1. For IshBaseline the name field is a controlled field, so FISHDOCUMENTRELEASE linked to DDOCUMENTRELEASE.
// Specifying the label FISHDOCUMENTRELEASE overrules the element name, because you are renaming
// 2. For IshDocumentObj the author field is a controlled field, so FAUTHOR linked to USER
// Specifying the label "Admin" is less accurate than the element name "VUSERADMIN"
// Two cases to illustrate that is not easy to fix. Workaround is to do Set-* cmdlets by -Id and -Metadata instead of -IshObject holding the new values
// ==> For now solved by passing ActionMode to IshFields.AddOrUpdateField where for Create/Update all ValueTypes are removed, last one wins
}
break;
default:
_logger.WriteDebug($"ToIshMetadataFields called for actionMode[{actionMode}], skipping");
break;
}
}
}
switch (_strictMetadataPreference)
{
case Enumerations.StrictMetadataPreference.SilentlyContinue:
_logger.WriteDebug($"Removing duplicate IshField entries");
metadataFields = RemoveDuplicateFields(metadataFields);
break;
case Enumerations.StrictMetadataPreference.Continue:
_logger.WriteVerbose($"Removing duplicate IshField entries");
metadataFields = RemoveDuplicateFields(metadataFields);
break;
case Enumerations.StrictMetadataPreference.Off:
// not removing duplicate entries potentially causing errors like: [-105007] The field "FISHUSERLANGUAGE" can only be specified once on level "None". [105007;FieldAlreadySpecified]
break;
}
return(metadataFields);
}
/// <summary>
/// Requested metadata fields will be duplicated and enriched to cater our Public Objects initilization.
/// The minimal fields (IsDescriptive) will be added to allow initialization of the various IshObject types for all ValueTypes.
/// Unallowed fields for read operations (IshFieldDefinition.AllowOnRead) will be stripped with a Debug log message.
/// </summary>
/// <remarks>Logs debug entry for unknown combinations of ishTypes and ishField (name, level) entries - will not throw.</remarks>
/// <param name="ishTypes">Given ISHTypes (like ISHMasterDoc, ISHLibrary, ISHConfiguration,...) to verify/alter the IshFields for</param>
/// <param name="ishFields">Incoming IshFields entries will be transformed to matching and allowed IshRequestedMetadataField entries</param>
/// <param name="actionMode">RequestedMetadataFields only has value for read operations like Read, Find, Search,...</param>
public IshFields ToIshRequestedMetadataFields(Enumerations.ISHType[] ishTypes, IshFields ishFields, Enumerations.ActionMode actionMode)
{
IshFields requestedMetadataFields = new IshFields();
foreach (Enumerations.ISHType ishType in ishTypes)
{
// Check incoming IshField with IshTypeFieldDefinitions
foreach (IshField ishField in ishFields.Fields())
{
var key = Enumerations.Key(ishType, ishField.Level, ishField.Name);
if (!_ishTypeFieldDefinitions.ContainsKey(key))
{
switch (_strictMetadataPreference)
{
case Enumerations.StrictMetadataPreference.SilentlyContinue:
_logger.WriteDebug($"ToIshRequestedMetadataFields skipping unknown ishType[{ishType}] level[{ishField.Level}] name[{ishField.Name}] valueType[{ishField.ValueType}]");
break;
case Enumerations.StrictMetadataPreference.Continue:
_logger.WriteVerbose($"ToIshRequestedMetadataFields skipping unknown ishType[{ishType}] level[{ishField.Level}] name[{ishField.Name}] valueType[{ishField.ValueType}]");
break;
case Enumerations.StrictMetadataPreference.Off:
requestedMetadataFields.AddField(ishField.ToRequestedMetadataField());
break;
}
continue; // move to next ishField
}
switch (actionMode)
{
case Enumerations.ActionMode.Read:
case Enumerations.ActionMode.Find:
if (!_ishTypeFieldDefinitions[key].AllowOnRead)
{
switch (_strictMetadataPreference)
{
case Enumerations.StrictMetadataPreference.Continue:
_logger.WriteVerbose($"ToIshRequestedMetadataFields AllowOnRead removed ishType[{ishType}] level[{ishField.Level}] name[{ishField.Name}] valueType[{ishField.ValueType}]");
break;
case Enumerations.StrictMetadataPreference.Off:
requestedMetadataFields.AddField(ishField.ToRequestedMetadataField());
break;
}
}
else
{
requestedMetadataFields.AddOrUpdateField(ishField.ToRequestedMetadataField(), actionMode);
}
break;
case Enumerations.ActionMode.Search:
if (!_ishTypeFieldDefinitions[key].AllowOnSearch)
{
switch (_strictMetadataPreference)
{
case Enumerations.StrictMetadataPreference.Continue:
_logger.WriteVerbose($"ToIshRequestedMetadataFields AllowOnSearch removed ishType[{ishType}] level[{ishField.Level}] name[{ishField.Name}] valueType[{ishField.ValueType}]");
break;
case Enumerations.StrictMetadataPreference.Off:
requestedMetadataFields.AddField(ishField.ToRequestedMetadataField());
break;
}
}
else
{
requestedMetadataFields.AddOrUpdateField(ishField.ToRequestedMetadataField(), actionMode);
}
break;
default:
_logger.WriteDebug($"ToIshRequestedMetadataFields called for actionMode[{actionMode}], skipping");
break;
}
}
}
//Add IsDescriptive fields for the incoming IshType to allow basic descriptive/minimal object initialization
requestedMetadataFields = AddDescriptiveFields(ishTypes, requestedMetadataFields, actionMode);
//TODO [Should] Merges in IsDescriptive for all ValueTypes (for LOV/Card)... we cannot do IMetadataBinding fields yet. Server-side they are retrieved anyway, so the only penalty is xml transfer size.
return(requestedMetadataFields);
}