Question

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

Answer 1

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

您可以设计模板，以便您可以通过@ tobi6建议的输入控制参数传递数据。然后，您可以使用reports服务或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.发出请求（您需要保存会话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>

对于数据作为源网址，请将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。

Answer 2

API在三个域中分开：

管理服务
存储库服务
报告服务

要生成报告，首先必须通过存储库服务将它们部署到服务器。如果需要生成稍后的报告，则通过报告服务调用它。这里，还可以启动同步或异步报告生成。

因此报告需要存放在存储库中。

修改

由于您还需要提供参数，请参阅this example，它的工作原理如下：

添加报告参数

为报告参数添加输入控件

使用输入参数http://<host>:<port>/jasperserver[-pro]/rest_v2/reports/reports/samples/EmployeeAccounts.html?EmployeeID=sarah_id
调用API
根据需要执行其他参数

在JasperServer中填写报告的位置数据

2 个答案:

将实际数据作为参数

将数据作为源URL