İşlem şablonuna rapor ekleme

Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018 - TFS 2013
Azure DevOps Server adı daha önce Visual Studio Team Foundation Server.

Bir proje oluşturursanız, Raporlama eklentisi bir Rapor sitesi oluşturur ve raporlarda Rapor Raporları düğümü altında görünecek Icon_reportTErapor Takım Gezgini. Bu eklenti için şirket içi TFS örneğinizi ve proje koleksiyonu yapılandırmanız gerekir. Burada, SQL Server Analysis Services ve SQL Server Reporting Services.

Raporlama eklentiyi kullanarak iki ana görev belirtirsiniz. İlk olarak, site öğesini kullanarak raporlama sitesini oluşturun. İkincisi, klasör ve rapor öğelerini kullanarak siteye yüklenilen klasör yapısını ve raporlarıbelirtirsiniz. Karşıya yüklediğiniz raporlar bir .rdl uzantısına sahip ve Reporting Services ile birlikte kullanım için tasarlanmıştır. TFS işlem şablonlarının sağ açık olduğu raporlara genel bir bakış için bkz. Reporting Services Raporları.

İşlem şablonundan bir proje oluşturulduktan sonra, raporlar için klasör yapısını ekleyebilir, kaldırabilir, yeniden adlandırabilirsiniz ve değiştirebilirsiniz. Daha fazla bilgi için bkz. Raporları görüntüleme, karşıya yükleme ve düzenleme.

Eklenti adını ve konumunu raporlama

Aşağıdaki tabloda, Agile ve CMMI işlem şablonları için dosya, klasör ve eklentinin adları özetlenmiştir.

Dosya adı:ReportsTasks.xml
Klasör adı:Raporlar
Eklenti adı:Microsoft.ProjectCreationWizard.Reporting

XML dosyasında, bir veya daha fazla görevi ve bunların bağımlılıklarını belirtirsiniz. Bir rapor kümesi belirten bir görev örneği için Çevik işlem şablonunda ReportsTasks.xml dosyasına bakın.

Eklenti söz dizimi yapısını raporlama

Raporlama eklenti dosyası, Rosetta.xsd dosyasında tanımlanan ve kendi dosyasında belirtilen ReportingServices için şema tanımına uygun olmalıdır.

Aşağıdaki söz dizimi Raporlama eklentisinin yapısını gösterir. Her öğenin açıklaması için bu konunun devamlarında yer alan ReportingServices alt öğelerine bakın.

<?xml version="1.0" encoding="utf-8"? 
<tasks 
  <task id="Site" plugin="Microsoft.ProjectCreationWizard.Reporting" completionMessage="Project Reporting site created." 
    <dependencies / 
    <taskXml 
      <ReportingServices 
        <site</site 
      </ReportingServices 
    </taskXml 
  </task 
  <task id="Populate Reports" plugin="Microsoft.ProjectCreationWizard.Reporting" completionMessage="Project reports uploaded." 
    <dependencies 
      <dependency taskId="Site" / 
    </dependencies 
    <taskXml 
      <ReportingServices 
        <folders. . . </folders 
        <reports. . . </reports 
      </ReportingServices 
    </taskXml 
  </task 
</tasks 

Raporlar sitesini oluşturma

İlk görev raporlama sitesini oluşturmaktır. Raporlama sitesi, proje portalı giriş sayfasında buna bir bağlantı içerir ve bağlantı Rapor Raporları olarakIcon_reportTE. Aşağıdaki örnekte olduğu gibi siteyi oluşturmak için site öğesini kullanın:

<taskXml>  
      <ReportingServices>  
        <site></site>  
      </ReportingServices>  
</taskXml>   

Raporlama klasörlerini tanımlama

Raporlama sitesinde klasör oluşturmak için klasör öğesini kullanırsınız. Yeni klasörün göreli yol adını belirtmek için path özniteliğini kullanın. Klasör proje sitesinde ve raporlarda Raporlar klasörünün altında Takım Gezgini.

Aşağıdaki örnek, raporlama sitesinde dört üst düzey klasör ve iki alt klasör oluşturur. Üst düzey klasörler Hatalar, Derlemeler, Project Yönetimi ve Testler olarak etiketlenmiş. İki alt klasör, Project Management altında bulunur ve alm Visual Studio Visual Studio etiketlenmiş.

<taskXml 
      <ReportingServices 
      <folders 
         <folder path="Bugs" / 
          <folder path="Builds" / 
          <folder path="Project Management" / 
          <folder path="Project Management/Visual Studio" / 
          <folder path="Project Management/Visual Studio ALM" / 
          <folder path="Tests" / 
      </folders 
      </ReportingServices 
</taskXml 

Karşıya yüklenilen raporları belirtme

.rdl raporlarını raporlama sitesine eklemek için, her .rdl dosyalarını işlem şablonunda Raporlar klasörünün altındaki bir klasöre kopyalayın. Ardından rapor için gerekli özellikleri ve veri kaynaklarını açıklamak üzere rapor öğesini kullanın.

Aşağıdaki örnek, Kalan Work.rdl dosyasının Project Management klasörüne yük olacağını belirtir. Her rapor için ExplicitProject parametresini ve veri kaynaklarını belirtmeniz gerekir. Aşağıdaki örnekte yer alan veri kaynakları, küp ve veri ambarı ilişkisel veritabanına Analysis Services atanan adlara karşılık gelir.

<taskXml 
      <ReportingServices 
     <reports 
       <report name="Remaining Work" filename="Reports\Remaining Work.rdl" folder="Project Management" cacheExpiration="30" 
       <parameters 
          <parameter name="ExplicitProject" value="" / 
       </parameters 
       <datasources 
          <reference name="/Tfs2010OlapReportDS" dsname="TfsOlapReportDS" / 
          <reference name="/Tfs2010ReportDS" dsname="TfsReportDS" / 
       </datasources 
       </report 
 . . .   
     </reports 
      </ReportingServices 
</taskXml 

ReportingServices öğeleri

Aşağıdaki söz dizimi ReportingServices öğesinin ve alt öğelerinin yapısını gösterir. Bu öğeleri taskXml kapsayıcı öğesinde ve yalnızca Raporlama eklentisi için belirtirsiniz.

<ReportingServices 
      <folders 
      <folder / 
 . . .   
      </folders 
      <reports 
      <report 
         <parameters 
               <parameter / 
         </parameters 
         <datasources 
               <reference / 
         </datasources 
      </report 
 . . .   
      </reports 
</ReportingServices  

Aşağıdaki tabloda, bir projeye yüklemek üzere bir rapor belirtmek için kullanabileceğiniz ve bir rapor aracılığıyla erişilebilen öğeler SQL Server Reporting Services.

<datasources>
<reference />
</datasources>

<folder path="FolderName" />

<folders>
<folder path="FolderName" />
</folders>

<parameter name="ParameterName" value="ParameterValue" />

<parameters>
<parameter />
</parameters>

<properties>
<property />
</properties>

<property name="PropertyName" value="PropertyValue" />

<reference name="RelationalDBName" dsname="OLAPDBName"  />

<report name="ReportName" filename="ReportFilePathName"  folder="FolderName" 
cacheExpiration="CacheDuration">
<parameters> . . . </parameters>
<datasources> . . . </datasources>
<properties> . . . </properties>
</report>

<reports>
<report />
</reports>

<ReportingServices>
<folders> . . . </folders>
<reports> . . . </reports>
<properties> . . . </properties>
</ReportingServices>

<site>
. . . 
</site>

İlgili makaleler:

• İşlem şablonunu özelleştirme
• İşlem şablonu ve eklenti dosyaları