ztra / ecology · Files

Go to a project
action.html 32.2 KB
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385 386 387 388 389 390 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407 408 409 410 411 412 413 414 415 416 417 418 419 420 421 422 423 424 425 426 427 428 429 430 431 432 433 434 435 436 437 438 439 440 441 442 443 444 445 446 447 448 449 450 451 452 453 454 455 456 457 458 459 460 461 462 463 464 465 466 467 468 469 470 471 472 473 474 475 476 477 478 479 480 481 482 483 484 485 486 487 488 489 490 491 492 493 494 495 496 497 498 499 500 501 502 503 504 505 506 507 508 509 510 511 512 513 514 515 516 517 518 519 520 521 522 523 524 525 526 527 528 529 530 531 532 533 534 535 536 537 538 539 540 541 542 543 544 545 546 547 548 549 550 551 552 553 554 555 556 557 558 559 560 561 562 563 564 565 566 567 568 569 570 571 572 573 574 575 576 577 578 579 580 581 582 583 584 585 586 587 588 589 590 591 592 593 594 595 596 597 598 599 600 601 602 603 604 605 606 607 608 609 610 611 612 613 614 615 616 617 618 619 620 621 622 623 624 625 626 627 628 629 630 631 632 633 634 635 636 637 638 639 640 641 642 643 644 645 646 647 648 649 650 651 652 653 654 655 656 657 658 659 660 661 662 663 664 665 666 667 668 669 670 671 672 673 674 675 676 677 678 679 680 681 682 683 684 685 686 687 688 689 690 691 692 693 694 695 696 697 698 699 700 701 702 703 704 705 706 707 708 709 710 711 712 713 714 715 716 717 718 719 720 721 722 723 724 725 726 727 728 729 730 731 732 733 734 735 736 737 738 739 740 741 742 743 744 745 746 747 748 749 750 751 752 753 754 755 756 757 758 759 760 761 762 763 764 765 766 767 768 769 770 771 772 773 774 775 776 777 778 779 780 781 782 783 
<!DOCTYPE html>
<html>
<head>
<title>action.md</title>
<meta http-equiv="Content-type" content="text/html;charset=UTF-8">

<style>
/*---------------------------------------------------------------------------------------------
 *  Copyright (c) Microsoft Corporation. All rights reserved.
 *  Licensed under the MIT License. See License.txt in the project root for license information.
 *--------------------------------------------------------------------------------------------*/

body {
	font-family: "Segoe WPC", "Segoe UI", "SFUIText-Light", "HelveticaNeue-Light", sans-serif, "Droid Sans Fallback";
	font-size: 14px;
	padding: 0 12px;
	line-height: 22px;
	word-wrap: break-word;
}

#code-csp-warning {
	position: fixed;
	top: 0;
	right: 0;
	color: white;
	margin: 16px;
	text-align: center;
	font-size: 12px;
	font-family: sans-serif;
	background-color:#444444;
	cursor: pointer;
	padding: 6px;
	box-shadow: 1px 1px 1px rgba(0,0,0,.25);
}

#code-csp-warning:hover {
	text-decoration: none;
	background-color:#007acc;
	box-shadow: 2px 2px 2px rgba(0,0,0,.25);
}


body.scrollBeyondLastLine {
	margin-bottom: calc(100vh - 22px);
}

body.showEditorSelection .code-line {
	position: relative;
}

body.showEditorSelection .code-active-line:before,
body.showEditorSelection .code-line:hover:before {
	content: "";
	display: block;
	position: absolute;
	top: 0;
	left: -12px;
	height: 100%;
}

body.showEditorSelection li.code-active-line:before,
body.showEditorSelection li.code-line:hover:before {
	left: -30px;
}

.vscode-light.showEditorSelection .code-active-line:before {
	border-left: 3px solid rgba(0, 0, 0, 0.15);
}

.vscode-light.showEditorSelection .code-line:hover:before {
	border-left: 3px solid rgba(0, 0, 0, 0.40);
}

.vscode-dark.showEditorSelection .code-active-line:before {
	border-left: 3px solid rgba(255, 255, 255, 0.4);
}

.vscode-dark.showEditorSelection .code-line:hover:before {
	border-left: 3px solid rgba(255, 255, 255, 0.60);
}

.vscode-high-contrast.showEditorSelection .code-active-line:before {
	border-left: 3px solid rgba(255, 160, 0, 0.7);
}

.vscode-high-contrast.showEditorSelection .code-line:hover:before {
	border-left: 3px solid rgba(255, 160, 0, 1);
}

img {
	max-width: 100%;
	max-height: 100%;
}

a {
	color: #4080D0;
	text-decoration: none;
}

a:focus,
input:focus,
select:focus,
textarea:focus {
	outline: 1px solid -webkit-focus-ring-color;
	outline-offset: -1px;
}

hr {
	border: 0;
	height: 2px;
	border-bottom: 2px solid;
}

h1 {
	padding-bottom: 0.3em;
	line-height: 1.2;
	border-bottom-width: 1px;
	border-bottom-style: solid;
}

h1, h2, h3 {
	font-weight: normal;
}

h1 code,
h2 code,
h3 code,
h4 code,
h5 code,
h6 code {
	font-size: inherit;
	line-height: auto;
}

a:hover {
	color: #4080D0;
	text-decoration: underline;
}

table {
	border-collapse: collapse;
}

table > thead > tr > th {
	text-align: left;
	border-bottom: 1px solid;
}

table > thead > tr > th,
table > thead > tr > td,
table > tbody > tr > th,
table > tbody > tr > td {
	padding: 5px 10px;
}

table > tbody > tr + tr > td {
	border-top: 1px solid;
}

blockquote {
	margin: 0 7px 0 5px;
	padding: 0 16px 0 10px;
	border-left: 5px solid;
}

code {
	font-family: Menlo, Monaco, Consolas, "Droid Sans Mono", "Courier New", monospace, "Droid Sans Fallback";
	font-size: 14px;
	line-height: 19px;
}

body.wordWrap pre {
	white-space: pre-wrap;
}

.mac code {
	font-size: 12px;
	line-height: 18px;
}

pre:not(.hljs),
pre.hljs code > div {
	padding: 16px;
	border-radius: 3px;
	overflow: auto;
}

/** Theming */

.vscode-light,
.vscode-light pre code {
	color: rgb(30, 30, 30);
}

.vscode-dark,
.vscode-dark pre code {
	color: #DDD;
}

.vscode-high-contrast,
.vscode-high-contrast pre code {
	color: white;
}

.vscode-light code {
	color: #A31515;
}

.vscode-dark code {
	color: #D7BA7D;
}

.vscode-light pre:not(.hljs),
.vscode-light code > div {
	background-color: rgba(220, 220, 220, 0.4);
}

.vscode-dark pre:not(.hljs),
.vscode-dark code > div {
	background-color: rgba(10, 10, 10, 0.4);
}

.vscode-high-contrast pre:not(.hljs),
.vscode-high-contrast code > div {
	background-color: rgb(0, 0, 0);
}

.vscode-high-contrast h1 {
	border-color: rgb(0, 0, 0);
}

.vscode-light table > thead > tr > th {
	border-color: rgba(0, 0, 0, 0.69);
}

.vscode-dark table > thead > tr > th {
	border-color: rgba(255, 255, 255, 0.69);
}

.vscode-light h1,
.vscode-light hr,
.vscode-light table > tbody > tr + tr > td {
	border-color: rgba(0, 0, 0, 0.18);
}

.vscode-dark h1,
.vscode-dark hr,
.vscode-dark table > tbody > tr + tr > td {
	border-color: rgba(255, 255, 255, 0.18);
}

.vscode-light blockquote,
.vscode-dark blockquote {
	background: rgba(127, 127, 127, 0.1);
	border-color: rgba(0, 122, 204, 0.5);
}

.vscode-high-contrast blockquote {
	background: transparent;
	border-color: #fff;
}
</style>
<link rel="stylesheet" href="file:///file%3A///D%3A/Program%20Files/Microsoft%20VS%20Code/css/def.css" type="text/css">
<style>
/* Tomorrow Theme */
/* http://jmblog.github.com/color-themes-for-google-code-highlightjs */
/* Original theme - https://github.com/chriskempson/tomorrow-theme */

/* Tomorrow Comment */
.hljs-comment,
.hljs-quote {
	color: #8e908c;
}

/* Tomorrow Red */
.hljs-variable,
.hljs-template-variable,
.hljs-tag,
.hljs-name,
.hljs-selector-id,
.hljs-selector-class,
.hljs-regexp,
.hljs-deletion {
	color: #c82829;
}

/* Tomorrow Orange */
.hljs-number,
.hljs-built_in,
.hljs-builtin-name,
.hljs-literal,
.hljs-type,
.hljs-params,
.hljs-meta,
.hljs-link {
	color: #f5871f;
}

/* Tomorrow Yellow */
.hljs-attribute {
	color: #eab700;
}

/* Tomorrow Green */
.hljs-string,
.hljs-symbol,
.hljs-bullet,
.hljs-addition {
	color: #718c00;
}

/* Tomorrow Blue */
.hljs-title,
.hljs-section {
	color: #4271ae;
}

/* Tomorrow Purple */
.hljs-keyword,
.hljs-selector-tag {
	color: #8959a8;
}

.hljs {
	display: block;
	overflow-x: auto;
	color: #4d4d4c;
	padding: 0.5em;
}

.hljs-emphasis {
	font-style: italic;
}

.hljs-strong {
	font-weight: bold;
}
</style>

<style>
/*
 * Markdown PDF CSS
 */

 body {
	font-family:  "Meiryo", "Segoe WPC", "Segoe UI", "SFUIText-Light", "HelveticaNeue-Light", sans-serif, "Droid Sans Fallback";
}

pre {
	background-color: #f8f8f8;
	border: 1px solid #cccccc;
	border-radius: 3px;
	overflow-x: auto;
	white-space: pre-wrap;
	overflow-wrap: break-word;
}

pre:not(.hljs) {
	padding: 23px;
	line-height: 19px;
}

blockquote {
	background: rgba(127, 127, 127, 0.1);
	border-color: rgba(0, 122, 204, 0.5);
}

.emoji {
	height: 1.4em;
}

/* for inline code */
:not(pre):not(.hljs) > code {
	color: #C9AE75; /* Change the old color so it seems less like an error */
	font-size: inherit;
}

/* Page Break : use <div class="page"/> to insert page break
-------------------------------------------------------- */
.page {
	page-break-after: always;
}

</style>
<link rel="stylesheet" href="file:///e%3A/%E8%B5%84%E6%96%99/%E9%9B%86%E6%88%90%E4%B8%AD%E5%BF%83/table.css" type="text/css">
</head>
<body>
<p><font color=#666666 size=5 face="PingFangSC-Regular">流程流转集成</font></p>
<ul>
<li><a href="#0">使用场景</a></li>
<li><a href="#1">操作说明</a>
<ul>
<li><a href="#10">DML接口</a></li>
<li><a href="#11">WebService接口</a></li>
<li><a href="#12">自定义接口</a></li>
<li><a href="#13">ESB接口</a></li>
<li><a href="#14">在流程中使用接口</a></li>
</ul>
</li>
<li><a href="#2">开发相关</a></li>
</ul>
<H3 id=0 style="border-left: 4px solid #3677D5;height:42px;line-height:42px;background:#F4F4F4"><font color=#08C size=4 face="PingFangSC-Semibold" >&emsp;使用场景</font></H3>
<p><strong>流程流转集成</strong> 是实现流程流转到某一节点时，需要做一些操作动作，如：向外系统数据库回写数据、调用外系统接口、调用本系统所开发的动作类等。</p>
<p><span style="background:yellow"><strong>注意：</strong> 流程流转集成的WebService接口在使用前，需要先申请非标功能<strong>WebService注册</strong></span></p>
<H3 id=1 style="border-left: 4px solid #3677D5;height:42px;line-height:42px;background:#F4F4F4"><font color=#08C size=4 face="PingFangSC-Semibold" >&emsp;操作说明</font></H3>
<p><strong>流程流转集成</strong> 包括四种接口：DML接口、WebService接口、自定义接口、ESB接口<br>
<strong>DML接口：</strong> 将流程数据写进指定数据源的数据表中，可以对数据进行 <strong>增、删、改</strong> 操作。<br>
<strong>WebService接口：</strong> 是调用在 <strong>集成中心</strong> - <strong>WebService注册</strong> 中所注册的WebService接口的指定方法。<br>
<strong>自定义接口：</strong> 是调用在本系统中开发的 <strong>动作类</strong><br>
<strong>ESB接口：</strong> 是调用在 <strong>ESB中心</strong> 中所发布的接口<br>
<strong>流程流转集成</strong> 所设置的接口可以在 <strong>流程引擎</strong> - <strong>路径设置</strong> - <strong>流转设置</strong> - <strong>节点信息</strong> 的 <strong>节点前附加操作</strong> 和 <strong>节点后附加操作</strong>中使用<br>
<img src="image/action02.png" alt="流程流转集成"><br>
<span id=10><strong><font color=red size=4 face="幼圆体" >DML接口</font></strong></span></p>
<p>将流程数据写进指定数据源的数据表中，可以对数据进行 <strong>增、删、改</strong> 操作<br>
点击 <strong>注册DML接口</strong>， 弹出 <strong>注册DML接口</strong> 页面<br>
<img src="image/action01.png" alt="流程流转集成"><br>
<strong>名称：</strong> 接口名称，接口类型一致时名称不能重复<br>
<strong>表单名称：</strong> 选择流程表单，使当前DML接口与指定流程关联，该接口只能在所关联的表单流程中使用<br>
<strong>数据源：</strong> 选择数据表所在的数据库，数据源信息是在 <strong>集成中心</strong> - <strong>数据源设置</strong> 中维护<br>
  当未设置 <strong>数据源</strong> 时，<strong>外部主表</strong> 选择的是当前系统的数据库表<br>
<img src="image/action03.png" alt="流程流转集成"><br>
<strong>DML类型：</strong> 可选择 <strong>insert</strong>、 <strong>update</strong>、 <strong>delete</strong> 和 <strong>自定义类型</strong>四种<br>
<strong>DML类型 - insert:</strong> 在 <strong>外部主表</strong> 中 <strong>插入</strong> 数据<br>
<strong>DML类型 - update:</strong> 在 <strong>外部主表</strong> 中 <strong>更新</strong> 数据<br>
<strong>DML类型 - delete:</strong> 在 <strong>外部主表</strong> 中 <strong>删除</strong> 数据<br>
   <span style="background:yellow"><strong>注意：</strong></span><br>
   <span style="background:yellow"><strong>insert、update、delete类型</strong> 只是限制 <strong>DML赋值设置</strong> 对数据库表的操作动作，不会限制 <strong>自定义DML语句</strong> 中的sql语句类型</span><br>
   <span style="background:yellow">如果DML类型为 <strong>update、delete</strong>，那么必须有 <strong>DML触发条件</strong> 或者 <strong>自定义触发条件</strong>，否则此DML不被执行</span><br>
<strong>DML类型 - 自定义类型:</strong> 只有 <strong>自定义DML语句</strong> 生效，<strong>DML赋值语句</strong> 即使设置也不会被执行</p>
<p><strong>数据来源：</strong> 是决定 <strong>DML赋值设置</strong> 中 <strong>同步对应字段</strong> 的数据来源<br>
  当 <strong>数据来源</strong> 为 <strong>主表</strong> 时，<strong>流程主表</strong>字段显示的是主表表名，<strong>DML赋值设置</strong> 中的 <strong>同步对应字段</strong> 中除 <strong>系统字段</strong> 外，只能看到 <strong>主表字段</strong><br>
<img src="image/action04.png" alt="流程流转集成"><br>
  当 <strong>数据来源</strong> 为某个 <strong>明细表</strong> 时，<strong>流程主表</strong>字段显示的是主表表名，<strong>DML赋值设置</strong> 中的 <strong>同步对应字段</strong> 中除 <strong>系统字段</strong> 外，还能看到 <strong>主表字段</strong> 和 <strong>所选明细表字段</strong><br>
<img src="image/action05.png" alt="流程流转集成"><br>
<strong>DML赋值设置：</strong> 将 <strong>同步对应字段</strong> 所对应的流程数据，赋值给 <strong>外部主表</strong> 中所对应的 <strong>字段名称</strong> 字段<br>
<img src="image/action06.png" alt="流程流转集成"></p>
<p><strong>DML触发条件设置：</strong> 赋值条件为 <strong>外部主表</strong> 的字段值与 <strong>流程表单</strong> 的字段值相等<br>
<img src="image/action10.png" alt="流程流转集成"><br>
<strong>自定义触发条件：</strong> 赋值条件可以为自定义内容<br>
下图中的 <strong>DML触发条件设置</strong> 与 <strong>自定义触发条件</strong> 功能一样，只需设置一种即可<br>
<img src="image/action11.png" alt="流程流转集成"><br>
<span style="background:yellow"><strong>注意：</strong> <strong>DML触发条件设置</strong> 与 <strong>自定义触发条件</strong> 都设置条件的话，两处条件都会生效，以and连接两部分内容所设置的条件</span></p>
<p><strong>转换规则：</strong> 在 <strong>DML赋值设置</strong> 和 <strong>DML触发条件设置</strong>中有 <strong>转换规则</strong> 项<br>
  在 <strong>DML赋值设置</strong> 中是将 <strong>转换规则</strong> 所转换后的数据，赋值给数据表字段<br>
  在 <strong>DML触发条件设置</strong> 中将 <strong>转换规则</strong> 所转换后的数据，做为条件与数据表字段数据进行比较<br>
<strong>转换规则</strong> - <strong>空值：</strong><br>
<strong>转换规则</strong> - <strong>固定值：</strong> 不管 <strong>同步对应字段</strong> 中是否有选择流程字段，流程表单数据都是所设置的固定值。<br>
<strong>转换规则</strong> - <strong>自定义SQL：</strong> 按sql语句必须为select，即按所写sql语句查询出的数据做为该项的数据值。<br>
  若取表单字段，可写 <strong>{?表单字段名称}</strong>，如下例：<br>
<img src="image/action07.png" alt="流程流转集成"><br>
  其中的自定义sql语句为：</p>
<pre class="hljs"><code><div><span class="hljs-keyword">select</span> jsje <span class="hljs-keyword">from</span> <span class="hljs-keyword">test</span> <span class="hljs-keyword">where</span> <span class="hljs-keyword">id</span> = {?id22}
</div></code></pre>
<p>  <span style="background:yellow"><strong>注意：</strong> 转换规则为 <strong>自定义SQL</strong> 的 <strong>同步对应字段</strong> 可随意设置，但是不能为空。自定义SQL中的 <strong>{?表单字段名称}</strong> 可以与所设置的<strong>同步对应字段</strong>不一致，</span></p>
<p><strong>自定义DML语句：</strong> 可以直接写完整的sql语句。
<img src="image/action12.png" alt="流程流转集成"></p>
<p><span style="background:yellow"><strong>注意：</strong></span><br>
<span style="background:yellow">当 <strong>DML类型</strong> 不是 <strong>自定义类型</strong> 时， <strong>DML赋值设置</strong> 与 <strong>自定义DML语句</strong> 都会被执行。</span><br>
<span style="background:yellow">当 <strong>DML类型</strong> 是 <strong>自定义类型</strong> 时，只有 <strong>自定义DML语句</strong> 会被执行。<strong>DML赋值设置</strong> 不会被执行。</span><br>
<strong>固定属性：</strong> 系统预置了一些属性变量，可以在 <strong>转换规则</strong>、<strong>自定义触发条件</strong>、<strong>自定义DML语句</strong>使用<br>
<img src="image/action14.png" alt="流程流转集成"><br>
<strong>固定属性表：节点操作者基本信息</strong></p>
<table>
<thead>
<tr>
<th>属性名</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>$user.firstname$</td>
<td>姓</td>
</tr>
<tr>
<td>$user.lastname$</td>
<td>名</td>
</tr>
<tr>
<td>$user.uid$</td>
<td>唯一主键</td>
</tr>
<tr>
<td>$user.mobile$</td>
<td>移动电话</td>
</tr>
<tr>
<td>$user.sex$</td>
<td>性别</td>
</tr>
<tr>
<td>$user.jobtitle$</td>
<td>岗位</td>
</tr>
<tr>
<td>$user.jobactivity$</td>
<td>职务</td>
</tr>
<tr>
<td>$user.joblevel$</td>
<td>职级</td>
</tr>
<tr>
<td>$user.seclevel$</td>
<td>安全级别</td>
</tr>
<tr>
<td>$user.usersubcompany1$</td>
<td>所属分部1</td>
</tr>
<tr>
<td>$user.userdepartment$</td>
<td>所属部门</td>
</tr>
<tr>
<td>$user.managerid$</td>
<td>直接上级</td>
</tr>
<tr>
<td>$user.logintype$</td>
<td>登录类型</td>
</tr>
<tr>
<td>$user.email$</td>
<td>邮箱</td>
</tr>
</tbody>
</table>
<p><strong>固定属性表：当前请求流程基本信息</strong></p>
<table>
<thead>
<tr>
<th>属性名</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>$workflowid$</td>
<td>流程类型id</td>
</tr>
<tr>
<td>$requestid$</td>
<td>当前请求id</td>
</tr>
<tr>
<td>$canmodify$</td>
<td>表单是否可修改</td>
</tr>
<tr>
<td>$Isagentcreater$</td>
<td>是否代理人创建</td>
</tr>
<tr>
<td>$beagenter$</td>
<td>被代理人</td>
</tr>
<tr>
<td>$hastriggeredsubwf$</td>
<td>已触发子流程</td>
</tr>
<tr>
<td>$submitnodeId$</td>
<td>提交节点id</td>
</tr>
<tr>
<td>$Iscreate$</td>
<td>是否创建节点</td>
</tr>
<tr>
<td>$formid$</td>
<td>表单id</td>
</tr>
<tr>
<td>$Isbill$</td>
<td>是否单据</td>
</tr>
<tr>
<td>$nodeid$</td>
<td>当前节点id</td>
</tr>
<tr>
<td>$nodetype$</td>
<td>当前节点类型</td>
</tr>
<tr>
<td>$requestname$</td>
<td>请求标题</td>
</tr>
<tr>
<td>$requestlevel$</td>
<td>紧急程度</td>
</tr>
<tr>
<td>$remark$</td>
<td>请求状态</td>
</tr>
<tr>
<td>$lastnodeid$</td>
<td>上个节点id</td>
</tr>
<tr>
<td>$lastnodetype$</td>
<td>上个节点类型</td>
</tr>
<tr>
<td>$nextnodeid$</td>
<td>下个节点id</td>
</tr>
<tr>
<td>$nextnodetype$</td>
<td>下个节点类型</td>
</tr>
<tr>
<td>$creater$</td>
<td>请求创建人</td>
</tr>
</tbody>
</table>
<p><span id=211><strong><font color=orage size=4 face="幼圆体" >DML接口操作示例</font></strong></span></p>
<ol>
<li><strong>转换规则示例</strong></li>
</ol>
<p>下图的赋值逻辑为：<strong>如果</strong>，流程表单中id字段的值为 <strong>5</strong>，<strong>则</strong>，将 <strong>test</strong> 表中 <strong>id</strong> 为 <strong>5</strong> 的 <strong>jsje</strong> 数据，赋值给 <strong>testTrigger</strong> 表中 <strong>id</strong> 为 <strong>5</strong> 的 <strong>je</strong> 数据<br>
<img src="image/action08.png" alt="流程流转集成"><br>
此接口执行时，所执行的sql语句为：</p>
<pre class="hljs"><code><div><span class="hljs-keyword">update</span> testTrigger <span class="hljs-keyword">set</span> je = (<span class="hljs-keyword">select</span> jsje <span class="hljs-keyword">from</span> <span class="hljs-keyword">test</span> <span class="hljs-keyword">where</span> <span class="hljs-keyword">id</span> = <span class="hljs-number">5</span>) <span class="hljs-keyword">where</span> <span class="hljs-keyword">id</span> = <span class="hljs-number">5</span>
</div></code></pre>
<p>DML接口设置与sql语句的对应关系为<br>
<img src="image/action09.png" alt="流程流转集成"></p>
<ol start="2">
<li><strong>自定义DML语句示例</strong></li>
</ol>
<p>下面两图中的设置具有同样效果，二者选其一即可。<br>
<strong>图一</strong><br>
<img src="image/action12.png" alt="流程流转集成"><br>
<strong>图二</strong><br>
<img src="image/action13.png" alt="流程流转集成"></p>
<p><span id=11><strong><font color=red size=4 face="幼圆体" >WebService接口</font></strong></span><br>
调用WebService接口，可以将流程数据作为参数传给WebService接口</p>
<p>点击 <strong>注册WebService接口</strong>， 弹出 <strong>注册WebService接口</strong> 页面<br>
<img src="image/action15.png" alt="流程流转集成"><br>
<strong>名称：</strong> WebService接口名称，接口类型一致时名称不能重复<br>
<strong>表单名称：</strong> 选择流程表单，选择表单后，会在注册界面最下方显示出该表单的主表和明细表字段<br>
<img src="image/action16.png" alt="流程流转集成"><br>
<strong>WebService地址：</strong> 选择在OA中注册的WebService信息，已注册的接口数据来自于 <strong>集成中心</strong> - <strong>WebService注册</strong>中<br>
<strong>WebService方法：</strong> 选择调用接口的方法，可以选择在 <strong>WebService注册</strong> 中已注册的方法<br>
<strong>WebService命名空间：</strong> .net写的webservice接口，需要结合命名空间才能正常调用。</p>
<p>选择 <strong>WebService方法：</strong> 后，会自动加载出该方法所需要的参数并显示<br>
<strong>参数名：</strong> 自动带出，不能修改，该参数名可用于 <strong>参数设置</strong>中<br>
<strong>参数类型：</strong> 自动带出，不能修改。若未复杂类型，则需要在 <strong>参数设置</strong> 中进行详细设置<br>
<strong>参数值：</strong> 可设置固定值，也可以引用表单数据，表单数据的引用规则为 <strong>$主表字段名$</strong> 或者 <strong>$detail_明细字段名$</strong><br>
<img src="image/action17.png" alt="流程流转集成"></p>
<p><strong>返回值：</strong> 获取调用接口后的返回值，用来判断接口执行是否成功，或将返回值赋值到OA数据表中<br>
<strong>返回值</strong> - <strong>返回值类型：</strong> 包含两种： <strong>字符串</strong> 和 <strong>执行SQL</strong><br>
<img src="image/action18.png" alt="流程流转集成"><br>
<strong>返回值</strong> - <strong>返回值类型</strong> - <strong>字符串：</strong> 判断接口是否执行成功。调用接口后获得返回值，直接与所设置的返回值做比较。如果相同，则表示执行成功。如果不相同，则表示执行失败。<br>
<strong>返回值</strong> - <strong>返回值类型</strong> - <strong>执行SQL：</strong> 将调用接口后获得返回值，替换所设置的返回值SQL语句中的返回值标签 ，并执行该SQL语句。返回值标签为 <strong>$retstr$</strong><br>
  例如，返回值将替换下面sql语句中的 <strong>$retstr$</strong>:</p>
<pre class="hljs"><code><div><span class="hljs-keyword">update</span> formtable_main_100 <span class="hljs-keyword">set</span> field001=<span class="hljs-string">'$retstr$'</span> <span class="hljs-keyword">where</span> requestid=$requestid$ 
</div></code></pre>
<p><strong>参数设置：</strong> 当 <strong>WebService方法</strong>的参数为复杂对象时，可以在 <strong>参数设置</strong> 中设置参数的值<br>
<img src="image/action19.png" alt="流程流转集成"><br>
<strong>参数设置</strong> - <strong>传入参数名：</strong> 与解析出的 <strong>参数名</strong>相同，代表设置该参数的参数值<br>
<strong>参数设置</strong> - <strong>XML模板：</strong> 可以设置指定格式的参数值，可以为xml格式或json格式等<br>
xml格式举例：</p>
<pre class="hljs"><code><div><span class="php"><span class="hljs-meta">&lt;?</span>xml version=<span class="hljs-string">"1.0"</span> encodING=<span class="hljs-string">"UTF-8"</span><span class="hljs-meta">?&gt;</span></span>
<span class="hljs-tag">&lt;<span class="hljs-name">root</span>&gt;</span>
	<span class="hljs-tag">&lt;<span class="hljs-name">hrmlist</span>&gt;</span>
		<span class="hljs-tag">&lt;<span class="hljs-name">hrm</span> <span class="hljs-attr">action</span>=<span class="hljs-string">"add"</span>&gt;</span>
			<span class="hljs-tag">&lt;<span class="hljs-name">workcode</span>&gt;</span>$field19706$<span class="hljs-tag">&lt;/<span class="hljs-name">workcode</span>&gt;</span>
			<span class="hljs-tag">&lt;<span class="hljs-name">loginid</span>&gt;</span>$creater$<span class="hljs-tag">&lt;/<span class="hljs-name">loginid</span>&gt;</span>
			<span class="hljs-tag">&lt;<span class="hljs-name">title</span>&gt;</span>$requestname$<span class="hljs-tag">&lt;/<span class="hljs-name">title</span>&gt;</span>
		<span class="hljs-tag">&lt;/<span class="hljs-name">hrm</span>&gt;</span>
	<span class="hljs-tag">&lt;/<span class="hljs-name">hrmlist</span>&gt;</span>
<span class="hljs-tag">&lt;/<span class="hljs-name">root</span>&gt;</span>
</div></code></pre>
<p>json格式举例：</p>
<pre class="hljs"><code><div>{<span class="hljs-attr">"workcode"</span>:$field19706$,<span class="hljs-attr">"loginid:$creater$,"</span>title<span class="hljs-attr">":$requestname$}
</span></div></code></pre>
<p><span id=231><strong><font color=orage size=4 face="幼圆体" >WebService接口操作示例：</font></strong> </span><br>
<img src="image/action22.png" alt="流程流转集成"><br>
按如上设置，调用testAction的接口getName方法，方法有三个参数：第一个传入的是明细表的sqysje字段的值，第二个传入主表的je字段的值，第三个传入json格式的字符串。当接口返回值为1时，表示接口调用成功，否则接口调用失败，流程会报错提示。</p>
<p><span id=12><strong><font color=red size=4 face="幼圆体" >自定义接口</font></strong></span><br>
调用自定义接口，可以将流程数据作为参数传给自定义接口</p>
<p>点击 <strong>注册自定义接口</strong>， 弹出 <strong>注册自定义接口</strong> 页面<br>
<img src="image/action20.png" alt="流程流转集成"></p>
<p><strong>接口动作名称：</strong> 接口名称，不能重复<br>
<strong>接口动作标识：</strong> 接口的唯一标识，后台存储时使用，不能重复<br>
<strong>接口动作类文件：</strong> 必须是动作类的类全名，该类必须实现接口 <strong>weaver.interfaces.workflow.action.Action</strong> 方法 <strong>public String execute(RequestInfo request)</strong></p>
<p><strong>计划任务</strong> - <strong>参数设置</strong> 中的参数名，需要和java类中的成员变量名一致<br>
当参数的 <strong>是否数据源</strong> 为是时，成员变量类型应为<strong>weaver.interfaces.datasource.DataSource</strong><br>
当参数的 <strong>是否数据源</strong> 为否时，成员变量类型应为<strong>String</strong>
计划任务执行时，相关的成员变量会自动获取到所设置的值<br>
<span style="background:yellow">此处的使用逻辑与 <strong>计划任务</strong> 中的 <strong>参数设置</strong> 的逻辑一致</span></p>
<p><span id=231><strong><font color=orage size=4 face="幼圆体" >自定义接口操作示例：</font></strong></span></p>
<pre class="hljs"><code><div><span class="hljs-keyword">package</span> weaver.test;

<span class="hljs-keyword">import</span> weaver.interfaces.datasource.DataSource;
<span class="hljs-keyword">import</span> weaver.interfaces.workflow.action.Action;
<span class="hljs-keyword">import</span> weaver.soa.workflow.request.RequestInfo;

<span class="hljs-keyword">public</span> <span class="hljs-class"><span class="hljs-keyword">class</span> <span class="hljs-title">TestAction</span> <span class="hljs-keyword">implements</span> <span class="hljs-title">Action</span> </span>{
    <span class="hljs-comment">//在参数设置中需要设置同名参数</span>
    String workflowid;
    <span class="hljs-comment">//在参数设置中需要设置同名参数，且是否数据源为是</span>
    DataSource newds;
    <span class="hljs-meta">@Override</span>
    <span class="hljs-function"><span class="hljs-keyword">public</span> String <span class="hljs-title">execute</span><span class="hljs-params">(RequestInfo request)</span> </span>{
        String requestId = request.getRequestid();
        String workflowid = request.getWorkflowid();
        weaver.hrm.User user = request.getRequestManager().getUser();
        <span class="hljs-keyword">int</span> formid = request.getRequestManager().getFormid();
        <span class="hljs-keyword">int</span> isbill = request.getRequestManager().getIsbill();
        <span class="hljs-keyword">return</span> <span class="hljs-string">"success"</span>;
    }
}
</div></code></pre>
<p>页面设置如下：<br>
<img src="image/action21.png" alt="流程流转集成"></p>
<p><span id=13><strong><font color=red size=4 face="幼圆体" >ESB接口</font></strong></span><br>
调用ESB接口，可以将流程数据作为参数传给ESB接口，<strong>KB81001806</strong> 之后的版本才有此功能</p>
<p>点击 <strong>注册ESB接口</strong>， 弹出 <strong>注册ESB接口</strong> 页面<br>
<img src="image/action23.png" alt="流程流转集成"><br>
<strong>名称：</strong> ESB接口的名称，不可重复<br>
<strong>表单名称：</strong> 选择流程表单，选择后该ESB接口必须由所选择的流程表单使用<br>
<strong>ESB服务：</strong> 选择 <strong>ESB中心</strong> 中发布的ESB服务，选择ESB服务后，会自动带出该ESB服务所需的参数列表<br>
<strong>参数名、参数类型、是否数组：</strong> ESB服务中所发布的名称、类型和数组，不可更改<br>
<strong>同步对应字段、转换规则：</strong> 流程表单中的字段，将该字段的值按所设置的 <strong>转换规则</strong> 转换后传给ESB服务的该参数中。<br>
<img src="image/action24.png" alt="流程流转集成"><br>
<strong>返回值控制设置：</strong> 根据接口的返回值控制该接口是否调用成功。当符合所设置的调用条件时，则接口调用成功。否则接口调用失败，流程表单中抛出异常。<br>
<img src="image/action25.png" alt="流程流转集成"><br>
<strong>返回值赋值设置：</strong> 当接口调用成功后，将接口的返回值赋值给流程表单的字段中<br>
<img src="image/action26.png" alt="流程流转集成"></p>
<p><span id=14><strong><font color=red size=4 face="幼圆体" >在流程中使用接口</font></strong></span><br>
接口定义好后，如果想在流程中使用接口，可以使用以下两种方法的任意一种：</p>
<ol>
<li>
<p>在 <strong>流程流转集成</strong> - <strong>流程接口部署</strong> 中<br>
<img src="image/action27.png" alt="流程流转集成"><br>
点击 <strong>新建</strong>， 弹出 <strong>新建流程接口部署</strong> 页面<br>
<img src="image/action28.png" alt="流程流转集成"><br>
选择流程、接口，设置节点或出口即可<br>
<img src="image/action29.png" alt="流程流转集成"><br>
<span style="background:yellow"><strong>注意：</strong> 由于 <strong>DML接口</strong> 、 <strong>WebService接口</strong>、 <strong>ESB接口</strong> 在设置时已经绑定了流程表单，所以在 <strong>流程接口部署</strong> 中 需要先选择流程表单，才能看到该表单所设置的接口。</span>
<span style="background:yellow"><strong>自定义接口</strong> 由于未绑定流程表单，所以可以一直参照到</span></p>
</li>
<li>
<p>在 <strong>流程引擎 - 路径设置 - 流转设置 - 节点信息</strong> 的 <strong>节点前附加操作</strong> 和 <strong>节点后附加操作</strong> 中</p>
</li>
</ol>
<p><img src="image/action30.png" alt="流程流转集成"><br>
设置该流程的外部接口，使该流程使用所设置的接口<br>
<img src="image/action31.png" alt="流程流转集成"></p>
<ol start="3">
<li>在 <strong>流程引擎 - 路径设置 - 流转设置 - 出口信息</strong> 的 <strong>附加规则</strong> 中</li>
</ol>
<p><img src="image/action32.png" alt="流程流转集成"><br>
设置该流程的外部接口，使该流程使用所设置的接口<br>
<img src="image/action33.png" alt="流程流转集成"></p>
<H3 id=2 style="border-left: 4px solid #3677D5;height:42px;line-height:42px;background:#F4F4F4"><font color=#08C size=4 face="PingFangSC-Semibold" >&emsp;开发相关</font></H3>
<ol>
<li><strong>数据库相关</strong>
<ol>
<li>DML接口设置数据表： <strong>formactionset</strong>、 <strong>formactionsqlset</strong></li>
<li>WebService接口设置数据表： <strong>wsformactionset</strong></li>
<li>自定义接口设置数据表： <strong>actionsetting</strong></li>
<li>ESB接口设置数据表：<strong>esbformactionset</strong></li>
</ol>
</li>
<li><strong>代码相关</strong>
<ol>
<li>流程接口注册列表页面：<strong>/integration/formactionlist.jsp</strong></li>
<li>新建注册DML接口页面：<strong>/workflow/dmlaction/FormActionSettingAdd.jsp</strong></li>
<li>DML接口执行类：<strong>weaver.workflow.dmlaction.commands.actions.DMLAction</strong></li>
<li>自定义接口必须实现的类：<strong>weaver.interfaces.workflow.action.Action</strong></li>
<li>ESB接口执行类：<strong>weaver.workflow.action.ESBAction</strong></li>
</ol>
</li>
</ol>

</body>
</html>