Browse Source

初步校核文档记录

master
张献维 4 weeks ago
commit
9411ad817d
  1. 1
      .gitignore
  2. 6
      Writerside/c.list
  3. 13
      Writerside/cfg/buildprofiles.xml
  4. 7
      Writerside/cfg/glossary.xml
  5. BIN
      Writerside/images/00000.png
  6. BIN
      Writerside/images/00001.png
  7. BIN
      Writerside/images/00002.png
  8. BIN
      Writerside/images/00003.png
  9. BIN
      Writerside/images/00004.png
  10. BIN
      Writerside/images/00005.png
  11. BIN
      Writerside/images/00006.png
  12. BIN
      Writerside/images/00007.png
  13. BIN
      Writerside/images/00008.png
  14. 14
      Writerside/in.tree
  15. 79
      Writerside/topics/备份.md
  16. 38
      Writerside/topics/开始.md
  17. 63
      Writerside/topics/规则分类.md
  18. 98
      Writerside/topics/规则详解.md
  19. 6
      Writerside/v.list
  20. 11
      Writerside/writerside.cfg

1
.gitignore

@ -0,0 +1 @@
/.idea/

6
Writerside/c.list

@ -0,0 +1,6 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE categories
SYSTEM "https://resources.jetbrains.com/writerside/1.0/categories.dtd">
<categories>
<category id="wrs" name="Writerside documentation" order="1"/>
</categories>

13
Writerside/cfg/buildprofiles.xml

@ -0,0 +1,13 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE buildprofiles SYSTEM "https://resources.jetbrains.com/writerside/1.0/build-profiles.dtd">
<buildprofiles xsi:noNamespaceSchemaLocation="https://resources.jetbrains.com/writerside/1.0/build-profiles.xsd"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<variables></variables>
<build-profile instance="in">
<variables>
<noindex-content>true</noindex-content>
</variables>
</build-profile>
</buildprofiles>

7
Writerside/cfg/glossary.xml

@ -0,0 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE terms SYSTEM "https://resources.jetbrains.com/writerside/1.0/glossary.dtd">
<terms>
<term name="foo">
Description of what "foo" is.
</term>
</terms>

BIN
Writerside/images/00000.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.2 MiB

BIN
Writerside/images/00001.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 383 KiB

BIN
Writerside/images/00002.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 166 KiB

BIN
Writerside/images/00003.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 171 KiB

BIN
Writerside/images/00004.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 194 KiB

BIN
Writerside/images/00005.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 170 KiB

BIN
Writerside/images/00006.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 180 KiB

BIN
Writerside/images/00007.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 410 KiB

BIN
Writerside/images/00008.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 254 KiB

14
Writerside/in.tree

@ -0,0 +1,14 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE instance-profile
SYSTEM "https://resources.jetbrains.com/writerside/1.0/product-profile.dtd">
<instance-profile id="in"
name="Instance Name"
start-page="开始.md">
<toc-element toc-title="数据校核">
<toc-element topic="开始.md"/>
<toc-element topic="规则分类.md"/>
<toc-element topic="规则详解.md"/>
</toc-element>
</instance-profile>

79
Writerside/topics/备份.md

@ -0,0 +1,79 @@
# Starter
<!--Writerside adds this topic when you create a new documentation project.
You can use it as a sandbox to play with Writerside features, and remove it from the TOC when you don't need it anymore.-->
## Add new topics
You can create empty topics, or choose a template for different types of content that contains some boilerplate structure to help you get started:
![Create new topic options](new_topic_options.png){ width=290 }{border-effect=line}
## Write content
%product% supports two types of markup: Markdown and XML.
When you create a new help article, you can choose between two topic types, but this doesn't mean you have to stick to a single format.
You can author content in Markdown and extend it with semantic attributes or inject entire XML elements.
## Inject XML
For example, this is how you inject a procedure:
<procedure title="Inject a procedure" id="inject-a-procedure">
<step>
<p>Start typing and select a procedure type from the completion suggestions:</p>
<img src="completion_procedure.png" alt="completion suggestions for procedure" border-effect="line"/>
</step>
<step>
<p>Press <shortcut>Tab</shortcut> or <shortcut>Enter</shortcut> to insert the markup.</p>
</step>
</procedure>
## Add interactive elements
### Tabs
To add switchable content, you can make use of tabs (inject them by starting to type `tab` on a new line):
<tabs>
<tab title="Markdown">
<code-block lang="plain text">![Alt Text](new_topic_options.png){ width=450 }</code-block>
</tab>
<tab title="Semantic markup">
<code-block lang="xml">
<![CDATA[<img src="new_topic_options.png" alt="Alt text" width="450px"/>]]></code-block>
</tab>
</tabs>
### Collapsible blocks
Apart from injecting entire XML elements, you can use attributes to configure the behavior of certain elements.
For example, you can collapse a chapter that contains non-essential information:
#### Supplementary info {collapsible="true"}
Content under a collapsible header will be collapsed by default,
but you can modify the behavior by adding the following attribute:
`default-state="expanded"`
### Convert selection to XML
If you need to extend an element with more functions, you can convert selected content from Markdown to semantic markup.
For example, if you want to merge cells in a table, it's much easier to convert it to XML than do this in Markdown.
Position the caret anywhere in the table and press <shortcut>Alt+Enter</shortcut>:
<img src="convert_table_to_xml.png" alt="Convert table to XML" width="706" border-effect="line"/>
## Feedback and support
Please report any issues, usability improvements, or feature requests to our
<a href="https://youtrack.jetbrains.com/newIssue?project=WRS">YouTrack project</a>
(you will need to register).
You are welcome to join our
<a href="https://jb.gg/WRS_Slack">public Slack workspace</a>.
Before you do, please read our [Code of conduct](https://www.jetbrains.com/help/writerside/writerside-code-of-conduct.html).
We assume that you’ve read and acknowledged it before joining.
You can also always email us at [writerside@jetbrains.com](mailto:writerside@jetbrains.com).
<seealso>
<category ref="wrs">
<a href="https://www.jetbrains.com/help/writerside/markup-reference.html">Markup reference</a>
<a href="https://www.jetbrains.com/help/writerside/manage-table-of-contents.html">Reorder topics in the TOC</a>
<a href="https://www.jetbrains.com/help/writerside/local-build.html">Build and publish</a>
<a href="https://www.jetbrains.com/help/writerside/configure-search.html">Configure Search</a>
</category>
</seealso>

38
Writerside/topics/开始.md

@ -0,0 +1,38 @@
# 《%mainJob%》开始
## 功能位置
<procedure title="" id="gn-id-00001">
<step>
<p>开始操作 <shortcut>系统登录</shortcut> : </p>
<img src="00000.png" alt="completion suggestions for procedure" border-effect="line"/>
</step>
<step>
<p>点击 <shortcut>机构信息管理</shortcut><shortcut>人员信息管理</shortcut> 进入。</p>
<img src="00001.png" alt="completion suggestions for procedure" border-effect="line"/>
</step>
<step>
<p>校核功能包含 <shortcut>机构%mainJob%</shortcut><shortcut>人员%mainJob%</shortcut><shortcut>整库%mainJob%</shortcut><shortcut>校核规则管理</shortcut> 等功能。</p>
<img src="00002.png" alt="completion suggestions for procedure" thumbnail="true" width="200"/>
<img src="00003.png" alt="completion suggestions for procedure" thumbnail="true" width="200"/>
<img src="00004.png" alt="completion suggestions for procedure" thumbnail="true" width="200"/>
<img src="00005.png" alt="completion suggestions for procedure" thumbnail="true" width="200"/>
</step>
<step>
<p>数据维护包含 <shortcut>机构信息维护</shortcut><shortcut>人员信息维护</shortcut><shortcut>排序信息维护</shortcut> 等功能。</p>
<img src="00006.png" alt="completion suggestions for procedure" thumbnail="true" width="200"/>
<img src="00007.png" alt="completion suggestions for procedure" thumbnail="true" width="200"/>
<img src="00008.png" alt="completion suggestions for procedure" thumbnail="true" width="200"/>
</step>
</procedure>
## 功能说明
%projectName%的%mainJob%,更多可以理解为数据查询,但是校核不仅仅只有查询,也包含 **校核规则定义****校核结果维护** 等。
## 校核的区别 {collapsible="true"}
其实校核中的`机构%mainJob%`、`人员%mainJob%`,其实都是`整库%mainJob%`的功能`界面`,针对不同的校核功能,进行校核`条件的过滤`。
就是人员校核,展示人员校核条件;机构校核,只展示机构校核条件。
> 主要校核区别,就是定义校核规则的主校验表是否为 `B01` 表。

63
Writerside/topics/规则分类.md

@ -0,0 +1,63 @@
# 《%mainJob%》分类
> 校核规则主要分为无前提条件校核和有前提条件校核两个部分。
## 无前提条件校核
是指该部分校核,不存在前置条件,直接作为校核(查询)依据,该部分校核多为单条件,
或为某指标项为空(或未填写);
或为某指标项包含特殊字符串(多使用正则匹配);
或为某指标项不为6或8位数字(由于当前描述时间指标项均为字符串类型,可以填写到月,也可以精确的日,其实潜在描述不为 `时间字符串` );
或为某指标项是否超出代码值范围等。
<tabs>
<tab title="指标项为空(或未填写)">
<code-block lang="markdown">a</code-block>
</tab>
<tab title="指标项包含特殊字符串">
<code-block lang="markdown">a</code-block>
</tab>
<tab title="指标项不为6或8位数字">
<code-block lang="markdown">a</code-block>
</tab>
<tab title="指标项是否超出代码值范围">
<code-block lang="markdown">a</code-block>
</tab>
</tabs>
## 有前提条件校核
是指该部分校核,不存在前置条件,直接作为校核(查询)依据,该部分校核多为单条件,
或为某指标项为空(未填写);
或为某指标项(时间指标)不在某时间范围,或与校核截至时间比较;
或为某指标项是否超出代码值范围等。
> 补充:其中也存在某些前提条件,主要看校核描述是否存在前提条件因子。
> <code-block lang="sql">-- 机构信息集“机构类别”超出代码值范围或为根节点代码值
> <![CDATA[select count(1) from B01_temp WHERE 1=1 AND B01_temp.B0111 = :B0111 AND B0194='1' AND B0131 IS NOT NULL AND B0131<>'' AND B0131 NOT IN(SELECT code_value FROM code_value WHERE code_type='ZB04' and CODE_STATUS='1' and CODE_LEAF='1')]]>
> </code-block>
> 存在前提条件“属于法人单位的机构”才进行
> (补充:<shortcut>WHERE 1=1 AND B01_temp.B0111 = :B0111 AND</shortcut>特定格式)
## 每年变动规则
该部分校核规则多与指定时间有关,脚本中会写死具体条件。当汇数年度发生变化,该部分年份信息,也需要跟着修改。
## 总结
数据校核是一项解决数据质量重要手段,但是往往校核规则会被简化成俗语,有些精简的比较深的话,里面包含大量的前提条件;同时有些被简化的俗语,按照直观意思无法理解。
> `有些精简的比较深的话,里面包含大量的前提条件`:涉及存在前提条件,需要积累一些公务员人事的常识,或者咨询定制规则的用户。
> `被简化的俗语,按照直观意思无法理解`:需要咨询定制规则的用户,用户目的到底是什么。
往往在完成校核条件定义的时候,开发人员常使用固定SQL语句进行实现,当然也可以通过校核方案进行配置,但是这些条件都仅仅是针对简单规则易用。
### 最后结论: `咨询定制规则的用户`

98
Writerside/topics/规则详解.md

@ -0,0 +1,98 @@
# 《%mainJob%》规则详解
## 每年变动规则 {collapsible="true"}
## 无前提条件校核 {collapsible="true"}
### 2017年1月以后的选调生,未填写考录信息
### 2021年“考核结果”未填写
### 填写了“学位名称”,但“学位代码”为空
### “学位名称”、“学位代码”、“学历名称”、“学历代码”同时为空
### 工作单位及职务中在任职务的“是否领导成员”为空
### 家庭成员“工作单位及职务”为空或小于2个字
### 人员排序号为空
### 工作单位及职务中已免职务的“任职机构代码”为空
### “职务层次(职级)”为空
### 家庭成员出生日期为空,但未检测到“(已去世)”
### “现工作单位及职务全称”为空
### 是“选调生”,但“进入选调生时间”为空
### “最高学历”为空
### “机构编码”为空
### “出生年月”为空
### “籍贯”为空
### “出生地”为空
### “职位类别”为空或职位类别超出代码值范围
### “健康状况”为空
### “参加工作时间”为空
### “人员类别”为空
### “人员管理状态”为空
### “管理类别代码”为空
### “任现领导职务时间(职务层次批准日期)”不为空,“现职务层次”为空
### “身份证号”为空
### “任现职级层次时间”(职级层次批准日期)为空
### “现职务层次”和“现职级层次”不能同时为空
### “是否具有两年以上基层工作经历”为空
### 奖惩综述为空
### “年度考核结果综述”为空
### “政治面貌”为空
### 人员的职务信息的排序号为空
### “考核年度”为空
### 家庭成员“工作单位及职务”为空
### “性别”为空
### 中专以上学历“学校及院系名称”未填写
### “编制类型”为空
### 选择了领导成员但“成员类别”为空
### “现职级层次”不为空,但“任现职级层次时间”(职级层次批准日期)为空
### 职务层次与职级信息集中“状态”为空
### 机构排序号为空
### 2023年“考核结果”未填写
### 职务层次与职级信息集中“类别”为空
### 是“考录”,但“录用审批(或备案 )时间”为空
### 工作单位及职务中已免职务的“任职时间”为空
### “现领导职务”(现职务层次)不为空,但“任现领导职务时间”(职务层次批准日期)为空
### 工作单位及职务中已免职务的“免职时间”为空
### “学校及院系名称”为空
### 工作单位及职务中在任职务的“任职机构名称”为空
### “民族”为空
### “隶属关系”为空
### 工作单位及职务中已免职务的“职务输出标识”为空
### 工作单位及职务中的“是否破格提拔”为空
### “机构类别”为空
### 学历与学位同时为空
### 工作单位及职务中在任职务的“职务名称”为空
### “法人单位标识”为空
### “是否考录”为空
### 学历信息集“教育类别”为空
### “考核结论”为空
### 工作单位及职务中在任职务的“任职机构代码”为空
### “是否选调生”为空
### 家庭成员“姓名”为空
### 工作单位及职务中已免职务的“任职机构名称”为空
### 中专以上学历“学校及院系名称”和与所学专业都未填写
### 2022年“考核结果”未填写
### “现职级层次”不为空,但“职级起算时间”为空
### “现领导职务”为厅局级正职时,现职级应当为空
### 工作单位及职务中已免职务的“是否领导成员”为空
### 14岁以上家庭成员的政治面貌为空
### 工作单位及职务中已免职务的“主职务”为空
### 填写了“学历名称”,但“学历代码”为空
### 填写了“学历代码”,但“学历名称”为空
### 工作单位及职务中的“任职状态”为空
### 工作单位及职务中在任职务的“职务输出标识”为空
### “称谓”为空
### 填写了“学位代码”,但“学位名称”为空
### 工作单位及职务中在任职务的“任职时间”为空
### “机构级别”为空
### 学历信息集“输出标识”为空
### 工作单位及职务中在任职务的“主职务”为空
### “所在政区”为空
### “姓名”为空
### 工作单位及职务中已免职务的“职务名称”为空
### “现工作单位及职务简称”为空
### 大专以上“所学专业名称”未填写
### 专业技术信息集的“专业技术资格”名称为空
### 奖惩信息集中“奖惩名称”为空
## 有前提条件校核 {collapsible="true"}

6
Writerside/v.list

@ -0,0 +1,6 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE vars SYSTEM "https://resources.jetbrains.com/writerside/1.0/vars.dtd">
<vars>
<var name="projectName" value="全国公务员"/>
<var name="mainJob" value="数据校核"/>
</vars>

11
Writerside/writerside.cfg

@ -0,0 +1,11 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE ihp SYSTEM "https://resources.jetbrains.com/writerside/1.0/ihp.dtd">
<ihp version="2.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="https://resources.jetbrains.com/writerside/1.0/writerside-cfg.xsd">
<topics dir="topics"/>
<images dir="images" web-path="images"/>
<categories src="c.list"/>
<vars src="v.list"/>
<instance src="in.tree"/>
</ihp>
Loading…
Cancel
Save