web-services - 用于在 JasperServer 中填写报告的位置数据

Question

我在JasperSoft Studio中开发了模板设计并将jrxml文件上传到JasperServer。我想从我的 python 应用程序发送数据(JSON 或 XML)到填充报告模板，并使用 REST API 以 PDF、XLS 等流行格式取返回告。 我不想将数据存储在服务器上。我怎样才能做到这一点？或者数据必须存储在服务器上并且没有其他方式通过WEB服务传输数据？

Answer 1

数据不一定必须驻留在服务器上。

您可以按照 @tobi6 建议的方式设计模板，以便可以通过输入控制参数传递数据。 然后您可以使用报告服务或reportExecutions 服务来获取所需的输出。

在您的情况下，数据可以是实际数据(XML 或 JSON)或数据源(数据文件的 URL)。

以下是一些处理 XML 数据的基本示例(JSON 非常相似):

以实际数据作为参数

JasperReports 模板:

<?xml version="1.0" encoding="UTF-8"?>
<!-- Created with Jaspersoft Studio version 6.1.1.final using JasperReports Library version 6.1.1  -->
<!-- 2016-05-25T14:18:00 -->
<jasperReport xmlns="http://jasperreports.sourceforge.net/jasperreports" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://jasperreports.sourceforge.net/jasperreports http://jasperreports.sourceforge.net/xsd/jasperreport.xsd" name="XmlDSReport_with_data" pageWidth="595" pageHeight="842" columnWidth="555" leftMargin="20" rightMargin="20" topMargin="20" bottomMargin="20" uuid="85d7b9ad-6feb-43dc-84cc-5175bf629546">
  <parameter name="xmlString" class="java.lang.String">
    <defaultValueExpression><![CDATA["<?xml version=\"1.0\" encoding=\"UTF-8\"?><a><b><val>val1</val></b><b><val>val2</val></b></a>"]]></defaultValueExpression>
  </parameter>
  <parameter name="XML_INPUT_STREAM" class="java.io.InputStream">
    <defaultValueExpression><![CDATA[new java.io.ByteArrayInputStream($P{xmlString}.getBytes("UTF-8"))]]></defaultValueExpression>
  </parameter>
  <queryString language="xPath">
    <![CDATA[/a/b]]>
  </queryString>
  <field name="value" class="java.lang.String">
    <fieldDescription><![CDATA[val]]></fieldDescription>
  </field>
  <columnHeader>
    <band height="31" splitType="Stretch">
      <staticText>
        <reportElement x="150" y="0" width="100" height="30" uuid="b33a123d-8987-4da4-b21b-1f9ccc50e92d"/>
        <text><![CDATA[value]]></text>
      </staticText>
    </band>
  </columnHeader>
  <detail>
    <band height="30" splitType="Stretch">
      <textField>
        <reportElement x="150" y="0" width="100" height="30" uuid="14c51219-5ce2-47ce-abb9-71bc11a6f28c"/>
        <textFieldExpression><![CDATA[$F{value}]]></textFieldExpression>
      </textField>
    </band>
  </detail>
</jasperReport>

部署报表并为 xmlString 参数创建输入控件后，您可以对其进行测试。假设您想要传递此 XML，而不是保留默认值:

<?xml version="1.0" encoding="UTF-8"?>
<a>
  <b><val>new_val1</val></b>
  <b><val>new_val2</val></b>
</a>

要测试报告服务，您可以在终端中运行类似的内容(我对 XML 字符串进行 URL 编码)并检查结果:

curl  -u user:password \ 
      http://localhost:8080/jasperserver/rest_v2/reports/reports/XmlDSReport_with_data.pdf?xmlString=%3C%3Fxml%20version%3D%221.0%22%20encoding%3D%22UTF-8%22%3F%3E%0A%20%20%20%20%3Ca%3E%0A%20%20%20%20%20%20%3Cb%3E%3Cval%3Enew_val1%3C%2Fval%3E%3C%2Fb%3E%0A%20%20%20%20%20%20%3Cb%3E%3Cval%3Enew_val2%3C%2Fval%3E%3C%2Fb%3E%0A%20%20%20%20%3C%2Fa%3E > report.pdf

要测试reportExecutions服务，主要步骤是:

1.使用请求创建一个 XML 文件(将其命名为 reportExecutionRequest.xml)

<reportExecutionRequest>
    <reportUnitUri>/reports/XmlDSReport_with_data</reportUnitUri>
    <outputFormat>pdf</outputFormat>
    <freshData>true</freshData>
    <saveDataSnapshot>false</saveDataSnapshot>
    <interactive>true</interactive>    
    <allowInlineScripts>true</allowInlineScripts>
    <async>false</async>
    <parameters>
        <reportParameter name="xmlString">
            <value><![CDATA[<?xml version="1.0" encoding="UTF-8"?>
                <a><b><val>new_val1</val></b><b><val>new_val2</val></b></a>]]></value>
        </reportParameter>
    </parameters>
</reportExecutionRequest>

2.发出请求(您需要保存 session cookie以检索输出):

curl  -u user:password \
      -H "Content-Type: application/xml" \
      -d @reportExecutionRequest.xml \
      -c cookies.txt \
      http://localhost:8080/jasperserver/rest_v2/reportExecutions

3.从上一个请求的结果中获取带有requestID和exportID的输出:

curl  -b cookies.txt \
      http://localhost:8080/jasperserver/rest_v2/reportExecutions/cc57b351-cfb6-429e-8c92-d0aebebbed66/exports/b71d6353-1eec-4304-8713-5d0f3105680e/outputResource > report.pdf

以数据作为源 URL

它是相同的报告模板，但两个参数替换为:

<parameter name="xmlSource" class="java.lang.String">
  <defaultValueExpression><![CDATA["http://serverwithdata/xmlData.xml"]]></defaultValueExpression>
</parameter>
<parameter name="net.sf.jasperreports.xml.source" class="java.lang.String">
  <defaultValueExpression><![CDATA[$P{xmlSource}]]></defaultValueExpression>
</parameter>

注意:我在这里创建了两个参数，只是因为我想在通过报告服务传递参数时保留更短的参数名称。我还专门为 xmlSource 参数创建了一个输入控件。

本例中的测试类似。

编辑:要使用JSON而不是XML，原始JasperReports模板需要这样调整:

对于数据作为参数，只需将 xmlString 参数、XML_INPUT_STREAM 参数和 queryString 更改为此:

<parameter name="jsonString" class="java.lang.String">
  <defaultValueExpression><![CDATA["{\"a\": [ {\"b\": { \"val\": \"val1\"}}, {\"b\": { \"val\": \"val2\" }}]}"]]></defaultValueExpression>
</parameter>
<parameter name="JSON_INPUT_STREAM" class="java.io.InputStream">
  <defaultValueExpression><![CDATA[new java.io.ByteArrayInputStream($P{jsonString}.getBytes("UTF-8"))]]></defaultValueExpression>
</parameter>
<queryString language="json">
  <![CDATA[a.b]]>
</queryString>

对于数据作为源 URL，将 xmlString 参数、XML_INPUT_STREAM 参数和 queryString 更改为此:

<parameter name="jsonSource" class="java.lang.String">
  <defaultValueExpression><![CDATA["http://serverwithdata/jsonData.json"]]></defaultValueExpression>
</parameter>
<parameter name="net.sf.jasperreports.json.source" class="java.lang.String">
  <defaultValueExpression><![CDATA[$P{jsonSource}]]></defaultValueExpression>
</parameter>
<queryString language="json">
  <![CDATA[a.b]]>
</queryString>

REST 服务的 cURL 测试基本相同，主要区别在于您将传递 JSON 而不是 XML，并使用 JSON 特定参数 jsonString 或 jsonSource .