SSRS Report Docentric Replicas
Download and Install Docentric SSRS Replicas
|Installation type||Download link||Instructions|
|Project with all replicas||How to import a project >>|
|Model with all replicas||How to import a model >>
How to remove a model >>
|Deployable package with all replicas||How to apply a deployable package >>|
|SSRS report name||Description|
See how to design this report step by step >>
|FreeTextInvoice.Report||Free text invoice|
|CustAccountStatementExt.Report||Customer account statement|
|CustCollectionJour.Report||Collection letter note|
|AgreementConfirmation.Report||Sales agreement confirmation|
|SalesConfirm.Report||Sales order confirmation|
|SalesPackingSlip.Report||Sales order packing slip|
|SSRS report name||Description|
|PurchReceiptsList.Report||Purchase order product receipt|
|PurchPackingSlip.Report||Purchase order receipts list|
|RFQSend.Report||Request for quotation|
|AgreementConfirmation.Report||Purchase agreement confirmation|
|Cheque_US.Report||U.S. check format|
|SSRS report name||Description|
|LedgerTransListAccount.Report||Ledger transaction list|
1. What are Docentric replicas
These are copies or replicas of the built-in SSRS report designs created with Docentric designer. All data from a SSRS report is by default completely reused in the created Docentric design. Docentric designs or layouts are called report templates. These templates are just ordinary Word documents with special tags used to show report data. So, a Docentric replica of a particular SSRS report design is a Docentric template which has the same data and uses similar styles and formats as the source SSRS report design.
2. What are Optimized Docentric replicas
These are Docentric replicas with optimized report data source. Sometimes in the source SSRS report there is only one table which contains both header and line fields (e.g. Customer account statement, Collection letter note, etc.). This can cause difficulties when such a report is customized. This is the reason why their data source is reshaped and restructured into ‘header’ and ‘line’ records. On the other hand, in some reports such as Customer or Free text invoice, hundreds of fields are kept together in the single table instead of multiple ones, so these data are also reshaped and regrouped into meaningful sections, enabling this way much easier and faster report design.
Also note that some of reports have only Optimized replicas because otherwise it would be very hard to design and customize them. This is especially true for end-users.
3. How report data source is optimized for Optimized Docentric replicas
To be able to reuse original SSRS report data, Docentric AX Framework fetches the data from SSRS report RDP tables that are filled by SSRS report data provider, and serialize them into XML always in the same manner: each record from a report RDP table becomes an XML element and each field from this table becomes its XML attribute. This XML is called DDSP (Docentric Data Source Package), and both Docentric designer and Docentric Server understand it. Serialization of SSRS RDP tables to DDSP is done by the the default Docentric DSP (Data Source Provider) class called DocDataSourceProviderSrsReporting.
4. What about custom placeholders
A custom Docentric DSP class can also be used for defining custom placeholders that will be available for use in the report print destinations. For example Purchase ID, Vendor Account and Vendor Name are custom placeholders in the case of the Purchase Order report, and you can use them in the Email body, subject or file output name.
Note that from the version 3.0.5, most of the Docentric SSRS replicas provide a certain set of custom placeholders out-of-the-box, which means that they have custom Docentric DSP classes assigned but not necessary data source reshaped (optimized). One such report is Purchase order product receipt (i.e. PurchPackingSlip.Report).
5. How can I add some additional data to my report
If you want to add some additional data to your report, you can do it in the standard way: add new fields to the built-in SSRS report RDP table(s), and implement business logic within the built-in SSRS report data provider class (e.g. PurchPurchaseOrderDP for the Purchase order report). The newly added fields will be visible immediately in the regenerated DDSP file, so you can use them to customize your report further with Docentric designer.
We encourage you to use this standard approach for a particular report if you plan to switch from Docentric to SSRS design in the same AX project. Sometimes this can be a better approach in terms of performance as well.
The alternative way of adding additional data to your report is to add them without modifying the built-in SSRS report artifacts (RDP tables, DP class) through the code in a custom Docentric DSP class for this report.
Read all about this technique >>
Hence, using a custom Docentric DSP class doesn’t mean only optimizing report data source. It also enables much faster development as well as great flexibility regarding data shaping and structuring. For example, using this approach you can easily add a sub-line for each line of a quote, or any other entity. Otherwise, you would need to create and fill an additional RDP table. You can also structure additional (and existing) data into meaningful groups, exclude unnecessary data, etc.
6. Why do I not see my custom data in Optimized replica
If you are using an Optimized replica (that has a custom Docentric DSP class reshaping the report data source), it can happen that you don’t see the custom fields your company has added to the built-in SSRS report RDP tables for customization purposes in the report DDSP file. In other words, you don’t see these fields in the Docentric designer when you load the regenerated DDSP file while customizing the report design (aka Docentric template), starting from its Optimized Docentric replica.
In this case please open the custom DSP class and search for all TODO tasks. One of them will suggest you where and how to handle this issue.
If you cannot solve the issue please contact us at email@example.com and we will gladly help you to resolve it.
7. How can I develop a completely new SSRS report
You can imagine that custom Docentric DSP classes play the main role when developing a custom report from scratch. Learn about developing custom reports in detail >>