我是SAP全球化服务的韩国(KR)开发团队、人力资本管理(HCM)的产品所有者。本博文面向希望采用HCM KR年终数据上传服务的SAP合作伙伴和客户,特别是SAP SuccessFactors员工中央工资客户,
接下来,我将指导您使用KR National Tax Service(NTS)提供的JAVA API在SAP云平台上创建一个原型,好评返现,以便于阅读,解密从NTS网站下载的PDF文档,然后将其转换为XML格式。
(请理解,这只是一个参考;一些功能不包括在示例代码中,如安全性或性能。所有发展风险由您自己承担。)
背景
作为KR员工,您的年终所得税扣除数据将由NTS以电子方式从银行、学校、医院等处收集。另一方面,您可以使用NTS提供的自助服务通过Hometax查看您的数据(). 您可以从Hometax下载您自己的数据作为电子PDF文档,其中包括适用于法律要求的年终收入和税款扣除信息。
PDF文档是加密的;NTS提供API来解密并将PDF文档中的收入和税款扣除信息提取为XML格式。作为SAP客户,您可以下载这些API来构建web服务应用程序。然后您就可以使用此web服务应用程序为您的员工上传他/她的PDF文档,以及年终收入和税款扣除信息。
前提条件
开发环境:
JDK 1.4马文3+带有Maven插件的EclipseEclipse的Spring工具4云铸造命令行界面访问云铸造环境(可选)邮递员
知识:
基础JAVA开发基本SAP云平台部署经验
(请理解,此开发环境不是强制性的,只是一个参考)
应用程序开发
使用Eclipse中的Spring Starter项目创建一个新的Spring Boot项目:
选择File->new->project…->Spring Boot->Spring Starter项目。指定组ID、工件ID、名称和描述。对于其他字段,您可以使用默认值。
例如:
(如果您使用不同的名称或ID,请在步骤1.3、1.4和1.5中相应地调整内容)
访问https://www.hometax.go.kr/,云服务器怎么用,智能家居物联网,导航至下载API,新手建站教程,大数据定义,如下:
解包NTS API,找到JAVA API。
在根目录中创建一个文件夹'lib',然后将下面的jar文件复制到这个文件夹:
bcprov-ext-jdk15-145.jarexportFile-2.0.2.jaritext-2.1.7.jar文件pdfbox-1.2.1.jar
(如果NTS更新API,您下载的文件可能有不同的版本名。)
在中删除、和pom.xml文件,然后插入以下内容:
复制文本:
(如果您在步骤1.1中使用不同的名称或ID,或者您下载的文件有不同的版本名,请指定你自己的内容pom.xml文件. 这里我建议使用JAVA版本1.8,因为如果JAVA版本太高,它将无法启动SAP云平台中的应用程序。)
创建控制器-FileServiceImpl.java文件包装下-com.example.demo示例:
然后复制并替换FileServiceImpl.java文件如下:
(如果您在步骤中使用不同的名称或ID1.1,请指定您自己的源路径和相应的包)
创建一个新文件清单.yml在根目录下。
将内容复制到清单.yml如下:
(如果您在步骤1.1中使用不同的名称或ID,请指定您自己的文件夹和名称。)
在此步骤之前,请检查您的项目属性并复制位置:
确保您的maven工作正常。打开命令提示符,尝试如下命令:
构建项目的jar文件。重定向到项目的文件夹,将{location}替换为项目的位置,如下所示:
使用maven命令行工具和以下命令:
等待BUILD SUCCESS显示。
首先为您找到合适的API端点。https://help.sap.com/viewer/3504ec5ef16548778610c7e89cc0eac3/Cloud/en-US/350356d1dc314d3199dca15bd2ab9b0e.html#loiof344a57233d34199b2123b9620d0bb41
如果需要,用自己的端点替换{endpoint}。
设置API端点:
然后登录:
输入您的电子邮件和密码。检查您的组织和空间
(必要时指定组织和空间)
登录后,您可以将应用推送到SAP云平台。使用如下命令:
等待web服务应用程序启动:
现在应用程序已部署。在SAP云平台驾驶舱中查看您的原型的应用路径。
例如,申请途径为:https://demo.xxxxxxxxxxxxx.com
您现在可以使用链接调用API:https://demo.xxxxxxxxxxxxxx.com/fileParsing
您可以使用邮递员检查web服务应用程序的链接。
将PDF(无密码)文件转换为XML格式。
然后您可以确认PDF文件的XML格式内容在正文
检查PDF文档的密码。将PDF(带密码)文件转换为XML格式。
进一步操作
现在您可以通过请求使用web服务应用程序,为KR员工上传其年终所得税扣除信息构建一个完整的解决方案。
但是,此原型只能帮助我们确保该过程正常工作。请注意,要使这个原型成为一个完整的解决方案,您还需要做更多的工作,如安全性、性能等。您还应该注意如何调用这个web服务应用程序以及如何使用xml格式的信息,如数据保护、病毒攻击、xml炸弹等。
请理解,所有的开发都是您自己的风险。