Package com.evolveum.midpoint.model.api.correlation

Interface CorrelationService

All Known Implementing Classes:

CorrelationServiceImpl

public interface CorrelationService

Contains correlation-related methods that should be accessible from the outside of `model` module.

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static interface	CorrelationService.CaseCloser
static class	CorrelationService.CorrelationCaseDescriptionOptions	Options for describeCorrelationCase(CaseType, CorrelationCaseDescriptionOptions, Task, OperationResult) method.

Method Summary

Modifier and Type	Method	Description
void	completeCorrelationCase(@NotNull CaseType currentCase, @NotNull CorrelationService.CaseCloser caseCloser, @NotNull Task task, @NotNull OperationResult result)	Completes given correlation case.
@NotNull CompleteCorrelationResult	correlate(@NotNull FocusType preFocus, @Nullable String archetypeOid, @NotNull Set<String> candidateOids, @NotNull CorrelatorDiscriminator discriminator, @NotNull Task task, @NotNull OperationResult result)	Correlates the provided (partial) focus object to a set of candidate matches.
@NotNull CorrelationCaseDescription<?>	describeCorrelationCase(@NotNull CaseType aCase, @Nullable CorrelationService.CorrelationCaseDescriptionOptions options, @NotNull Task task, @NotNull OperationResult result)	Describes the provided correlation case by providing CorrelationCaseDescription object.
PathSet	determineCorrelatorConfiguration(@NotNull CorrelatorDiscriminator discriminator, String archetypeOid, Task task, OperationResult result)	Instantiates a correlator

Method Details

correlate

@NotNull
@NotNull CompleteCorrelationResult correlate(@NotNull
 @NotNull FocusType preFocus,
 @Nullable
 @Nullable String archetypeOid,
 @NotNull
 @NotNull Set<String> candidateOids,
 @NotNull
 @NotNull CorrelatorDiscriminator discriminator,
 @NotNull
 @NotNull Task task,
 @NotNull
 @NotNull OperationResult result)
                                      throws SchemaException,
ExpressionEvaluationException,
CommunicationException,
SecurityViolationException,
ConfigurationException,
ObjectNotFoundException

Correlates the provided (partial) focus object to a set of candidate matches. TODO finish the method signature

Throws:

SchemaException

ExpressionEvaluationException

CommunicationException

SecurityViolationException

ConfigurationException

ObjectNotFoundException

describeCorrelationCase

@NotNull
@NotNull CorrelationCaseDescription<?> describeCorrelationCase(@NotNull
 @NotNull CaseType aCase,
 @Nullable
 @Nullable CorrelationService.CorrelationCaseDescriptionOptions options,
 @NotNull
 @NotNull Task task,
 @NotNull
 @NotNull OperationResult result)
                                                        throws SchemaException,
ConfigurationException,
ExpressionEvaluationException,
CommunicationException,
SecurityViolationException,
ObjectNotFoundException

Describes the provided correlation case by providing CorrelationCaseDescription object. Currently, it . takes the shadow stored in the correlation case (i.e. does NOT fetch it anew), . recomputes inbound mappings (i.e. ignores stored pre-focus), . and processes candidate owners stored in the correlation case (i.e. does NOT search for them again). The CorrelationService.CorrelationCaseDescriptionOptions parameter signals if the client wishes to provide also the correlation explanation, or not. (In the future, we may provide options also for behavior in points 1-3 mentioned above.)

Throws:

SchemaException

ConfigurationException

ExpressionEvaluationException

CommunicationException

SecurityViolationException

ObjectNotFoundException

completeCorrelationCase

void completeCorrelationCase(@NotNull
 @NotNull CaseType currentCase,
 @NotNull
 @NotNull CorrelationService.CaseCloser caseCloser,
 @NotNull
 @NotNull Task task,
 @NotNull
 @NotNull OperationResult result)
                      throws SchemaException,
ExpressionEvaluationException,
CommunicationException,
SecurityViolationException,
ConfigurationException,
ObjectNotFoundException

Completes given correlation case. Preconditions: - case is freshly fetched, - case is a correlation one

Parameters:

caseCloser - Makes the case definitely closed. (This functionality must be provided by the caller.)

Throws:

SchemaException

ExpressionEvaluationException

CommunicationException

SecurityViolationException

ConfigurationException

ObjectNotFoundException

determineCorrelatorConfiguration

PathSet determineCorrelatorConfiguration(@NotNull
 @NotNull CorrelatorDiscriminator discriminator,
 String archetypeOid,
 Task task,
 OperationResult result)
                                  throws SchemaException,
ConfigurationException,
ObjectNotFoundException

Instantiates a correlator

Throws:

SchemaException

ConfigurationException

ObjectNotFoundException