Exemple #1
0
        /// <summary>
        /// Method intended to be called when starting a processing step in the middle of an orchestration. It is expected that a
        /// tracking context has been created previously, at the start of the orchestration by a call to <see
        /// cref="Process.Initiate(XLANGMessage)"/> or by a call to this method. A new processing step tracking activity is
        /// always started, and it is always linked to the process tracking activity identified in <paramref
        /// name="trackingContext"/>.
        /// </summary>
        /// <param name="trackingContext">
        ///   The tracking context that is applicable just before entering the new processing step.
        /// </param>
        /// <param name="processingStepName">
        ///   The name of the processing step entered.
        /// </param>
        /// <returns>
        /// The new <see cref="TrackingContext"/> for the processing step scope.
        /// </returns>
        public static TrackingContext Initiate(TrackingContext trackingContext, string processingStepName)
        {
            if (string.IsNullOrEmpty(processingStepName))
            {
                throw new ArgumentNullException(nameof(processingStepName));
            }
            if (trackingContext.ProcessActivityId.IsNullOrEmpty())
            {
                throw new ArgumentException("trackingContext.ProcessActivityId is null or empty: process tracking has not been initiated.", nameof(trackingContext));
            }

            var processingStep = new ProcessingStep();

            processingStep.BeginProcessingStepActivity();
            processingStep.BeginTime         = DateTime.UtcNow;
            processingStep.MachineName       = Environment.MachineName;
            processingStep.ProcessActivityID = trackingContext.ProcessActivityId;
            processingStep.Status            = TrackingStatus.Pending;
            processingStep.StepName          = processingStepName;
            // set up continuation for later processing step completion or failure
            processingStep.EnableContinuation();
            processingStep.CommitProcessingStepActivity();
            processingStep.EndProcessingStepActivity();

            // propagate the tracking context with this processing step's activity id
            var newTrackingContext = trackingContext;

            newTrackingContext.ProcessingStepActivityId = processingStep.ActivityId;
            return(newTrackingContext);
        }
Exemple #2
0
        private static void Terminate(TrackingContext trackingContext, string status, string errorDescription)
        {
            if (trackingContext.ProcessingStepActivityId.IsNullOrEmpty())
            {
                throw new ArgumentException("trackingContext.ProcessingStepActivityId is null or empty: processing step tracking has not been initiated.", nameof(trackingContext));
            }

            var processingStep = new ProcessingStep(ContinuationPrefix + trackingContext.ProcessingStepActivityId)
            {
                EndTime          = DateTime.UtcNow,
                ErrorDescription = errorDescription,
                MachineName      = Environment.MachineName,
                Status           = status
            };

            processingStep.CommitProcessingStepActivity();
            processingStep.EndProcessingStepActivity();
        }