README

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

注意！该库不是直接与PRODESP通过协议提供的Web服务集成的。此库通过网页抓取技术收集信息，即该库通过自动化方式在用户系统中导航并提取信息。

功能

• 根据一个市获取学校信息
• 根据一个市和学校网络获取学校信息
• 根据一个学校获取班级信息
• 根据一个班级获取学生信息

先决条件

• PHP 7.0
• SED访问凭证

安装

在PHP项目的根目录下执行

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

使用

创建一个 \SedData\Application 类的实例，并提供系统GDAE的访问凭证

$sed = new \SedData\Application('usuario', 'senha');

获取一个市的学校信息

要获取某个市的公立学校信息，使用

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

该函数返回一个 \SedData\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 = $sed->grades->getAll($school);

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

该函数返回一个 \SedData\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 = $sed->students->getAll($school, $grade);

其中 $school 是一个 \SedData\Entity\School 类的对象，$grade 是一个 \SedData\Entity\Grade 类的对象，分别包含要查询的学校和班级的代码。

该函数返回一个 \SedData\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

在此特此授予任何人免费获得此软件及其相关文档文件（“软件”）副本的许可，以无限制地处理该软件，包括但不限于使用、复制、修改、合并、发布、分发、再许可和/或销售软件副本，并允许获得该软件的人这样做，前提是遵守以下条件

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

软件按“原样”提供，不提供任何形式的保证，无论是明示的还是暗示的，包括但不限于适销性、针对特定目的的适用性和非侵权性。在任何情况下，作者或版权所有者均不对任何索赔、损害或其他责任负责，无论这些索赔、损害或其他责任是由于合同行为、侵权行为或其他行为引起的，与软件或其使用或其他交易有关。