Edusign连接器

发送什么，不发送什么

连接器首先发送课时。每个课时在Edusign中成为一门课程，并以Omniscol的标识符作为外部引用。这样日后无需另外维护对照表，就能找到、更新或删除它。

日历中的事件也可以走同样的路径：讲座、答辩或迎新日同样可以发送到Edusign签名。如果您不想全部发送，也可以用筛选器限制导出——下文会再谈到。

教师和小组也可以发送，有两种方式：如果启用了该选项，则在导出课时的过程中即时创建；或者通过 实体导出 选项卡批量同步，此时以Omniscol为准。学生则从不自动推送：只能手动触发发送，原因见下文。

一个重要的提醒：不要混用两种创建签到表的方式。

要么课时在Omniscol中产生，由连接器在Edusign中创建：如果您的课表经常变动，这是最一致的选择，因为修正、缺勤和代课都会随之更新。

要么直接在Edusign中创建课程。这也可以，但这些课程就此独立于Omniscol：连接器不会去动它们，您的课表变更也不会同步到那里。

最稳妥的做法，是一开始就选定在哪一边生成签到表，然后一直坚持。这样可以避免同一个课时出现两个版本。

首次导出之前

对Edusign来说，没有教师的课时无法使用：必须知道由谁负责签到表。后续步骤取决于一个问题：您的教师在Edusign中是否已有账户？

**他们已存在，且两边的电子邮箱相同。**无需任何操作：自动匹配。这是最常见的情况，也是为什么必须在Omniscol中填写准确可靠的邮箱——它是用于匹配的标识符，也是登录Edusign的账号。如果Omniscol中有两位教师使用同一个邮箱，连接器会尝试用姓名来区分：下文详细说明它的做法，以及什么情况下会受阻。

他们已存在，但邮箱不一致。这就需要关联：关联界面会把您的教师与Edusign账户并排列出，每个已建立的关联都优先于任何邮箱匹配。当共用邮箱无法用姓名区分时，同样使用这种办法。

**他们在Edusign中尚不存在。**有两种选择：

• 即时创建——在系统配置的 系统配置 选项卡中勾选远程创建，连接器会在某个课时需要时创建对应账户；
• 教师同步——在 实体导出 选项卡中一次性推送全部教师，这样在第一个课时之前账户就已存在，以Omniscol为准。

无论是即时创建还是批量创建，Edusign都规定每个邮箱只能对应一个账户。如果邮箱已被占用，创建会失败，该教师的课时也随之失败；如果在Omniscol中两位教师共用一个邮箱，连接器一个都不会创建——连第一位也不会，否则会把邮箱随机绑定给其中一位——他们的课时会等到每人都有自己的邮箱。因此，创建只适用于确实不存在的账户——对于Edusign中已有的教师，请使用匹配或关联。

在要求从Omniscol向Edusign创建之前，还有一点要注意：根据您的Edusign账户配置，创建用户可能会立刻通过电子邮件把登录信息发给他。这样，您的教师在第一次导出时就会发现这个新工具，却毫无准备。如果您希望自己通知账户开通，请在发起导出之前，先在Edusign一侧检查这项设置。

如果教师仍然找不到，课时不会发送。连接器会统计并明确提示：否则，缺失签到表这类问题总会在最不合适的时候才被发现。

通过电子邮箱匹配

对于没有建立关联、且账户不是由连接器创建的教师，匹配依据是电子邮箱，两边的姓和名是否一致都无关紧要。因此邮箱必须准确：邮箱错误会使课时受阻，两个邮箱互换则会让两位教师的签到表对调。

姓和名只用来区分重复项：在Omniscol中有两位教师登记了同一个邮箱——例如秘书处的信箱，或兼职教师共用的地址。此时连接器会把姓名与Edusign账户的姓名进行比对。这几乎总能解决问题：每个人找到自己的账户，课时随即发出。

两位完全同名者使用同一个邮箱，很可能是同一个人在您这里被录入了两次。无论选中哪个账户，签到表上的姓名、科目和班级都是正确的：课时会发出，集成日志会记录这条重复项，便于您日后清理。

还有一种情况是没有任何姓名匹配。这位教师可能根本没有账户，而随意发送会让出勤签名落到别人的签到表上：这些课时会被搁置。导出汇总会给出相关的姓名和邮箱——甚至包括那个只创建重复项、却不授课、您很久都想不到的人。

长久的解决办法，是让每个人都使用自己的邮箱。在此之前，请手动建立关联：关联一旦建立，标识符即为准。

按单位筛选发送

单位是一个组织层面的概念：它在您的账户内把若干班级归在一起，与校区和教室无关。如果您已声明单位，可以只发送其中某些单位的课时。该选择在 实体导出 选项卡中，位于课时区域下方。

只要课时的至少一个班级属于所选单位，该课时就会发送：因此两个单位共享的课程只会发送一次。但是，一旦您按某些单位筛选，没有分配单位的班级就会被排除在外：由于它不属于任何所选单位，连接器无法把它包括进来。

如果您之后缩小了选择范围，不再属于其中的课时会从Edusign中移除——已经进行过的课时除外，它们的签到已成定局。不选任何单位等于全部发送。

同步时间窗口

Edusign用于对即将进行的课时进行签名。已经过去的课时不再需要准备签到，Edusign也会将其锁定。

**同步时间窗口**在导出选项卡中设置，课时和事件各设一个，由两个按相对于今天的天数计算的界限组成：负数为之前，正数为之后。留空时，分别为往前两天和往后90天。实际上，往前几天就够了：它们只是用来补上课时刚结束后做出的修正。

**移出窗口的课时永远不会被删除。**它已经上过，Edusign保存着它的签到，而签到无法重建。只有在Omniscol中真正被删除的课时才会从Edusign中移除——而且仅限尚未进行的。

实时与补发

有两种机制并存，各司其职。

实时随时发送每一处修改。这是正常模式：它让Edusign几乎即时保持最新。但应把它看作一个便利的通道，而不是绝对的保证：请求可能失败，进程可能重启。

定时完整导出用于定期协调两边。它发送整个窗口内的课时，读取Edusign中现有的内容，然后删除那些在您这边已不存在、但实时同步漏掉的课时。这是安全网：没有它，网络故障或重启会留下悄无声息的差异。

学生

学生只能手动触发发送，并且需格外谨慎。

Edusign只能通过我们设置的外部引用来匹配学生——既不能通过邮箱，也不能通过它的内部标识符。因此，Edusign中已存在但没有该引用的学生无法触及：发送会创建出第二条使用同一邮箱的记录。

所以连接器宁可不做，也不创建重复项。它先读取Edusign中已有的学生，只创建确实不存在的，其余的搁置。没有电子邮箱的学生出于同样的原因被排除：他们无法通过任何方式匹配。触发结束时，汇总会准确告诉您哪些没有创建，并给出两边的身份信息，供您逐个决定。活动日志也会保留记录。

实际上，只有在您需要实名签到表时才必须有学生。只要课时带有教师和小组，签到即使没有学生也能进行。

事件

讲座、答辩、模拟考试：您在日历中放置的课时之外的内容，同样可以发送到Edusign。事件在 实体导出 选项卡中有自己的区域，紧接在课时下方，有自己的筛选器和发送规则。

事件与课时携带相同的信息：日期、参与者、教室。在受邀者中，教师负责签到表；班级和小组构成受众。

您不必全部发送。连接器按您在事件上设置的标签筛选——参见 临时事件：只发送带某个标签的事件，或者反过来，除带某个标签的之外全部发送。排除始终优先，因此最实用的规则是：全部发送，但您标记为无需签名的除外（例如）。

已有ERP的情况

最简单的情况是学校在Omniscol中管理课时，然后在Edusign中签名。这是连接器最直接的使用场景。

在已围绕ERP（如Aurion或Auriga）搭建体系的学校里，架构通常是以该ERP为中心的星形结构。它把基础数据发送到Omniscol——教师、教室、科目、小组，甚至学生——然后Omniscol把自己生成的课时回传给它。

从这时起，Edusign多数情况下接入的是ERP，而不是直接接入Omniscol。视所选的组织方式，要么由ERP把课时转发给Edusign（必要时经由ETL），要么由Edusign定期从ERP中读取。

在这种拓扑中，外部引用不会相互替换：它们按需要完成的交换叠加。同一位教师在Omniscol中可以带有一个ERP引用，必要时再带有一个独立的Edusign引用。在 实体同步 选项卡中，每个已配置的系统针对相同的实体仍分别关联。

重置

清除按钮会从Edusign中移除当前学年内来自Omniscol的课时。它不会触及教师、小组，也不会触及直接在Edusign中创建的课程：目的是清理连接器推送的内容，而不是清除您环境中的其余部分。

Edusign对删除频率限制很严：每次最多移除几百个课时。如果还有剩余，请再次运行清除——活动日志会显示每次之后剩余的数量。

连接器在Edusign中创建的内容并不总是严格意义上的清除：在那里删除教师实际上是归档。因此，请在了解这一点的前提下启用创建功能。