bsp

webservice接口

提供webservice接口给第三方调用，部署包请联系基础平台。 HIS9.0.1

wsdl地址

iris2021

https://ip:1443/imedical/webservice/BSP.MSG.SRV.WSInterface.cls?wsdl=1&IRISUserName=dhwebservice&IRISPassword=密码&IRISNoRedirect=1

cache2016 http://ip/imedical/web/BSP.MSG.SRV.WSInterface.cls?wsdl=1&CacheUserName=dhwebservice&CachePassword=密码&CacheNoRedirect=1

http://ip/dthealth/web/BSP.MSG.SRV.WSInterface.cls?wsdl=1&CacheUserName=dhwebservice&CachePassword=密码&CacheNoRedirect=1

cache2010 http://ip/dthealth/web/BSP.MSG.SRV.WSInterface.cls?wsdl=1

方法Call

统一的调用方法入口，通过FuncCode参数区分不同功能

参数名 说明 备注
FuncCode 功能代码 见功能列表
input 实际参数 xml格式，节点随功能而变

功能列表

功能代码 说明
Send 发送消息
Exec 处理消息
Cancel 撤销消息
发送消息

FuncCode=Send

对应后台类方法##class(BSP.MSG.BL.WSInterface).Send(Input)

input节点说明
节点 说明 备注
ActionTypeCode 消息动作类型代码 代码参见动作类型清单
BizObjId 业务ID 如申请单号，申请记录ID，报告ID等
Context 消息内容 消息内容
FromUserCode 发送人工号 发送人在HIS内工号
FromUserName 发送人姓名 发送人工号和姓名至少一个不为空
CreateLocCode 发送人科室代码 可以为空
CreateLocDesc 发送人科室名称 可以为空
EpisodeId 就诊ID 如果业务有尽量传，可以为空
OrdItemId 医嘱ID 如果业务有尽量传，多个医嘱ID 用英文逗号分隔，可以为空
EffectiveDays 有效天数 超过有效天数自动置为已处理
ReceiverList 接收对象列表 需要结合实际，如果接收对象是可以在HIS内配置出来的，不需要传，
如果是业务指定某些人接收的，需要传。
列表元素节点说明见下方接收对象列表元素节点说明
BizLink 业务处理链接 此参数应为完整链接，传了此参数，则BizLinkParam不生效
BizLinkParam 业务处理链接参数 如EpisodeId=1&b=2 和消息类型配置处的链接组合成完整链接
BizLinkWidth 链接窗口宽度 如1200
BizLinkHeight 链接窗口高度 如500
BizLinkTarget 链接目标窗口 _blank表示新窗口打开，其他为hisui模态框

接收对象列表元素节点说明

节点 说明
RecType 接收者类型
RecCode 接收者代码
RecType取值 说明 RecCode取值
L 科室用户 科室代码
LCP 科室人员 科室代码
LCPD 科室医生 科室代码
LCPN 科室护士 科室代码
G 安全组用户 安全组名称
U 用户 用户工号
input示例
<MsgSend>
    <ActionTypeCode>2000</ActionTypeCode>
    <BizObjId>5</BizObjId>
    <Context>测试消息</Context>
    <FromUserCode>demo</FromUserCode>
    <FromUserName></FromUserName>
    <CreateLocCode></CreateLocCode>
    <CreateLocDesc></CreateLocDesc>
    <EpisodeId>1</EpisodeId>
    <OrdItemId></OrdItemId>
    <EffectiveDays></EffectiveDays>
    <ReceiverList>
        <Receiver>
            <RecType>U</RecType>
            <RecCode>demo^ys01^ys02</RecCode>
        </Receiver>
        <Receiver>
            <RecType>G</RecType>
            <RecCode>Demo Group</RecCode>
        </Receiver>
        <Receiver>
            <RecType>L</RecType>
            <RecCode>ZYHL003</RecCode>
        </Receiver>
    </ReceiverList>
    <BizLink>https://baidu.com?a=1</BizLink>
    <BizLinkParam></BizLinkParam>
    <BizLinkWidth></BizLinkWidth>
    <BizLinkHeight></BizLinkHeight>
    <BizLinkTarget>_blank</BizLinkTarget>
</MsgSend>
返回值示例
<Response>
    <Body>
        <ResultCode>1</ResultCode>
        <ResultContent>12555</ResultContent>
    </Body>
    <Header></Header>
</Response>
处理消息

FuncCode=Exec

对应后台类方法##class(BSP.MSG.BL.WSInterface).Exec(Input)

input节点说明
节点 说明 备注
ActionTypeCode 消息动作类型代码 代码参见动作类型清单
BizObjId 业务ID 如申请单号，申请记录ID，报告ID等，应和发送对应
ExecUserCode 处理人工号 处理人在HIS内工号
ExecDate 处理日期 yyyyy-MM-dd 空默认取当前日期
ExecTime 处理时间 hh:mm:ss 空默认取当前时间
OnlyExecUserCode 只处理某个用户的消息 适用于一条消息同时发送给多个人，只处理其中某一个人的消息
OnlyExecUserType 只处理某类用户的消息 适用于一条消息同时发送给多个人，只处理其中某类用户的消息 如DOCTOR医生 NURSE护士
input示例
<MsgExec>
    <ActionTypeCode>2000</ActionTypeCode>
    <BizObjId>5</BizObjId>
    <ExecUserCode>demo</ExecUserCode>
    <ExecDate></ExecDate>
    <ExecTime></ExecTime>
    <OnlyExecUserCode></OnlyExecUserCode>
    <OnlyExecUserType></OnlyExecUserType>
</MsgExec>
返回值示例
<Response>
    <Body>
        <ResultCode>1</ResultCode>
        <ResultContent>1975</ResultContent>
    </Body>
    <Header></Header>
</Response>
撤销消息

FuncCode=Cancel

对应后台类方法##class(BSP.MSG.BL.WSInterface).Cancel(Input)

input节点说明
节点 说明 备注
ActionTypeCode 消息动作类型代码 代码参见动作类型清单
BizObjId 业务ID 如申请单号，申请记录ID，报告ID等，应和发送对应
CancelUserCode 撤销人工号 撤销人在HIS内工号
CancelDate 撤销日期 yyyyy-MM-dd 空默认取当前日期
CancelTime 撤销时间 hh:mm:ss 空默认取当前时间
input示例
<MsgCancel>
    <ActionTypeCode>2000</ActionTypeCode>
    <BizObjId>5</BizObjId>
    <CancelUserCode>demo</CancelUserCode>
    <CancelDate>2022-01-01</CancelDate>
    <CancelTime>12:01:01</CancelTime>
</MsgCancel>
返回值示例
<Response>
    <Body>
        <ResultCode>-1</ResultCode>
        <ResultContent>消息状态不可撤回</ResultContent>
    </Body>
    <Header></Header>
</Response>

常见问题

1.Cache2016开始，web应用程序配置禁止了匿名访问，所以通过链接获取wsdl时需带上用户名密码

2.IRIS版本链接中的用户名密码参数名从Cache…变成了IRIS…

3.HIS8.3开始web应用程序由/dthealth/web变更为了/imedical/web

4.IRIS版本webservice放在了一个单独的web应用程序 /imedical/webservice

5.使用https协议的，HIS端的https证书可能会有问题，有可能需要忽略掉验证服务器和证书是否匹配