Baseline 2.5 CanBeFrozen
Used to check whether the baseline can be frozen or not.
The method executes the same checks as the Freeze method without freezing the baseline or labelling the version objects.
Parameters
| Name | Type | Direction | Description |
|---|---|---|---|
| psAuthContext | String | InOut | Deprecated proprietary authentication context only used by .ASMX web services based on internal username/password authentication. Claims based security standards drive all the WCF .SVC web services making this parameter redundant. |
| psBaselineId | String | In | The element name of the baseline. |
| psOutXMLBaselineFreezeReport | String | InOut | The Baseline Freeze Report XML indicates why the Baseline freeze could not be executed successfully |
| pbOutCanBeFrozen | Boolean | Out | Boolean that indicates whether the baseline can be frozen or not. When the parameter is false, the reason can be found in the psOutXMLBaselineFreezeReport parameter. |
- The user must have write access to the baseline.
- When no baseline is found with the supplied
psBaselineId, anInvalidObjectExceptionis thrown.
- First the baseline is identified and some minor checks are executed:
Is the baseline already frozen?
Yes, an
BaselineAlreadyReleasedExceptionis thrown.Has the user write access?
No, an
ObjectIsReadOnlyExceptionis thrown.
- Then all publication which reference the baseline are retrieved (see PublicationOutput.UsingBaseline)
- Each publication must have at least one starting point. So, the fields
FISHMASTERREFandFISHRESOURCESshould not both be empty. When the publication has no starting point, anFreezeFailureMasterRefMissingExceptionis thrown. - For each publication an ExpandBaseline is executed using the values of the following fields:
- StartLogicalIds =
FISHMASTERREF - StartResourceLogicalIds =
FISHRESOURCES - pasLanguages =
FISHPUBSOURCELANGUAGES - pasIllustrationLanguages =
FISHPUBSOURCELANGUAGES - pasResourceLanguages =
FISHPUBSOURCELANGUAGES - pasResolutions =
FISHREQUIREDRESOLUTIONS
- StartLogicalIds =
- The
Baseline Report XMLis used to execute the following checks for each item:Is a version selected in the baseline?
No, a
NoVersionSelectedExceptionis inserted in the BaselineFreezeReport XMLIs the object available in the requested languages (and resolutions)?
No, an
ObjectMissingExceptionis inserted in the BaselineFreezeReport XMLIs the object released?
No, an
ObjectNotReleasedExceptionis inserted in the BaselineFreezeReport XML
- For all valid (released and unreleased) language objects the hyperlinks, conrefs and variables are checked:
Are all variables assigned once?
For each variable which is not assigned, an
VariableNotResolvedExceptionis inserted in the BaselineFreezeReport XMLAre no variables assigned more than once?
For each variable which is assigned more than once, at least 2
DuplicateVariableAssignmentInPublicationExceptionsare inserted in the BaselineFreezeReport XMLCan all conrefs be resolved?
For each conref which is not resolved, an
ConrefNotResolvedExceptionis inserted in the BaselineFreezeReport XMLCan all hyperlinks be resolved?
For each hyperlink which is not resolved, an
HyperlinkTargetMissingExceptionis inserted in the BaselineFreezeReport XML
- If the Baseline Freeze Report contains exceptions for one of the publications, the method returns false.