}//END getReport class

        // =====================================================================================
        /// <summary>
        /// This class retrieves a report object by is scope and retrieves the first instance.
        /// </summary>
        /// <param name="Scope">EvReport.ReportScopeTypes: Report Scope.</param>
        /// <returns>EvReport: a report object</returns>
        // -------------------------------------------------------------------------------------
        public EdReport getReportByScope(EdReport.ReportScopeTypes Scope)
        {
            this._DebugLog = new System.Text.StringBuilder( );
            this.LogMethod("getReportByScope method. ");
            this.LogDebug("Scope: " + Scope);
            EdReport report = new EdReport( );

            List <EdReport> reportList = this._dalReportTemplates.getReportList(
                EdReport.ReportTypeCode.Null,
                Scope, String.Empty, false);

            if (reportList.Count == 0)
            {
                return(report);
            }

            report = this._dalReportTemplates.getReport(reportList [0].Guid);

            this.LogClass(this._dalReportTemplates.Log);

            //
            // Return the role.
            //
            return(report);
        }//END getReport class
        // =====================================================================================
        /// <summary>
        /// This class retrieves the list of reports based on the scope.
        /// </summary>
        /// <param name="ProjectId">string: (Mandatory) The selection trial identifier</param>
        /// <param name="ReportTypeId">EvReport.ReportTypeCode: (Mandatory) The selection Report QueryType identifier</param>
        /// <param name="Category">string: (Optional) The selection category</param>
        /// <param name="ReportScope">EvReport.ReportScopeTypes: a report scope</param>
        /// <returns>List of EvReport: a list of report objects</returns>
        /// <remarks>
        /// This method consists of the following steps:
        ///
        /// 1. Execute the method for retrieving a list of report objects
        ///
        /// 2. Return a list of report objects.
        /// </remarks>
        // -------------------------------------------------------------------------------------
        public List <EdReport> getReportList(
            EdReport.ReportTypeCode ReportTypeId,
            String Category,
            EdReport.ReportScopeTypes ReportScope)
        {
            this._DebugLog = new System.Text.StringBuilder( );
            this.LogMethod("getReportList method ");
            this.LogDebug("ReportTypeId: " + ReportTypeId);
            this.LogDebug("Category: " + Category);
            this.LogDebug("ReportScope: " + ReportScope);

            List <EdReport> view = this._dalReportTemplates.getReportList(
                ReportTypeId, ReportScope, Category, false);

            this.LogClass(this._dalReportTemplates.Log);

            return(view);
        }