README

随着PRODESP提供的系统的发展，GDAE的学生登记已让位于新的系统SED（数字学校秘书处），用于处理教育信息。因此，这个库不再功能正常。

此库将仅在线上维护，供查询和研究使用。

一个新的库，用于读取SED数据的库，可在https://github.com/tmarquesini/sed-data找到。

GDAE数据

Biblioteca用于从PRODESP的GDAE系统中获取学校、班级和学生的数据。

注意！此库不是与PRODESP通过协议提供的web服务直接集成。此库收集的信息是通过网络爬虫技术获取的，即库会自动在用户系统中导航并提取信息。

功能

• 通过指定一个市来获取学校
• 通过指定一个市和教学网络来获取学校
• 通过指定一个学校来获取班级
• 通过指定一个班级来获取学生

先决条件

• PHP 7.0
• 访问GDAE的凭证

安装

在PHP项目的根目录下执行

$ composer require tmarquesini/gdae-data:dev-master

使用

创建一个\GdaeData\Application类的实例，并指定您对GDAE系统访问的凭证

$gdae = new \GdaeData\Application('usuario', 'senha');

获取一个市内的学校

要获取某个市的市政学校，使用以下命令：

$schools = $gdae->schools->getAll('nome_do_municipio');

该函数返回一个包含\GdaeData\Entity\School类的对象的集合，可以迭代，例如，在foreach结构中。集合中的每个对象都有以下方法

// obter o código da escola sem formatação (ex. 123456)
$school->getCode(); 

// obter o código da escola com formatação de pontos de milhar (ex. 123.456)
$school->getFormattedCode();

// obter o nome da escola
$school->getName();

获取一个学校的班级

要获取某个学校的班级，使用以下命令：

$grades = $gdae->grades->getAll($school);

其中$school是包含要查询的学校代码的\GdaeData\Entity\School类的对象。

该函数返回一个包含\GdaeData\Entity\Grade类的对象的集合，可以迭代，例如，在foreach结构中。集合中的每个对象都有以下方法

// obter o código da escola sem formatação (ex. 123456789)
$grade->getCode(); 

// obter o código da escola com formatação de pontos de milhar (ex. 123.456.789)
$grade->getFormattedCode();

// obter o código do tipo de ensino (ex. 14)
$grade->getType();

// obter a descrição do tipo de ensino (ex. ENSINO FUNDAMENTAL DE 9 ANOS para código 14)
$grade->getTypeDescription();

// obter o código período (ex. 1)
$grade->getPeriod();

// obter a descrição do período (ex. MANHÃ para código 1)
$grade->getPeriodDescription();

// obter a série (ex. 1 para 1º ano)
$grade->getSeries();

// obter a classe (ex. A para turma A)
$grade->getClass();

// obter o semestre (ex. 1 para 1º semestre)
$grade->getSemester();

// obter o número de estudantes ativos
$grade->getActiveStudents();

获取一个班级的学生

要获取某个班级的学生，使用以下命令：

$students = $gdae->students->getAll($school, $grade);

其中$school是包含要查询的学校代码的\GdaeData\Entity\School类的对象，而$grade是包含要查询的班级代码的\GdaeData\Entity\Grade类的对象。

该函数返回一个包含\GdaeData\Entity\Student类的对象的集合，可以迭代，例如，在foreach结构中。集合中的每个对象都有以下方法

// obter o número do aluno
$student->getNumber();

// obter o nome do aluno
$student->getStudent();

// obter o Registro de Aluno (RA) sem o dígito
$student->getRa();

// obter o dígito do RA, quando houver
$student->getDigit();

// obter o código do status do aluno, quando houver (ex. T para transferido)
$student->getStatus();

许可证

MIT许可证（MIT）

版权（c）2017 Thiago Pavão Marquesini

本软件及其相关文档文件（以下简称“软件”）的副本的任何个人均可免费使用、处理软件，不受限制，包括但不限于使用、复制、修改、合并、发布、分发、许可和/或销售软件副本的权利，并允许向软件提供者提供软件的人进行此类操作，但须遵守以下条件：

上述版权声明和本许可声明应包含在软件的所有副本或主要部分中。

软件按“原样”提供，不提供任何形式的保证，无论是明示的、暗示的，包括但不限于适销性、特定用途适用性和非侵权性保证。在任何情况下，作者或版权所有者不对任何索赔、损害或其他责任承担责任，无论是由合同、侵权或其他原因引起的，无论该索赔、损害或其他责任与软件或其使用或其他方面有关。