iesde 1.1.1 → 2.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 489a6788ad5398cb6a8c323b7547b5bb29c8c7ca
-  data.tar.gz: 5dff3b42851d2f5153594c8a164e4bf5a3c67434
+  metadata.gz: 6937ba51e796cd6ffb2c1a3ac5935f3a79d4ca17
+  data.tar.gz: b56cacb34cf8197e5c3b848a24d2691ba2a9c3de
 SHA512:
-  metadata.gz: 1e72b75a2bbaeb4c246199fd801cbfa4b17941f64c975b7a334d8f54ead804f02a27efe25196ae71cf2b748228c29f4f7eb1637b93f517896a25124443b85b32
-  data.tar.gz: 2c2298fdc04545a7bc20565180e694b69dda1223e8e05f2a510cd2989b44f4234156a4a1c00d251b08df5fdcbd0a4a7957489b1a11d8b4f1d33b8c4cda4ca1a9
+  metadata.gz: 1be65ff4d63f2cac4ef9cec5a7f935e1560d01707832a21b17d5a2ca5c606bb0ea55a7b9e80c0ccd53b15473cea39e02e84c3aa40b4fe4ff23618926ed5f76cb
+  data.tar.gz: 5f99358d7178bbb4b88af2c1124fa48bd6766ee363ec5601028e1a42290d67d7cfd1a0a0b3e5d003e2fc99f8a5f210e900f0489aaa51b13140d3109a7b115641

data/.gitignore

@@ -6,4 +6,5 @@
 /doc/
 /pkg/
 /spec/reports/
+/spec/fixtures/
 /tmp/

data/README-OLD-API.md

@@ -0,0 +1,258 @@
+# Iesde
+
+Interface para acesso ao WebService do [Iesde][siteiesde] para sistemas Rails. Não se trata de uma ferramenta oficial pois foi desenvolvida por necessidade dos nossos desenvolvedores. Sintam-se livres para contribuir.
+
+## Índice
+\- [Iesde](#iesde)
+  - [Versão](#vers%C3%A3o)
+  - [Instalação](#instala%C3%A7%C3%A3o)
+  - [Uso](#uso)
+    - [Listagem de Cursos](#listagem-de-cursos)
+    - [Busca de curso por Id](#busca-de-curso-por-id)
+    - [Listagem de Aulas](#listagem-de-aulas)
+    - [Listagem de Matrículas](#listagem-de-matr%C3%ADculas)
+    - [PDF](#pdf)
+    - [Matricular Aluno](#matricular-aluno)
+    - [Inativação de Aluno](#inativa%C3%A7%C3%A3o-de-aluno)
+    - [Logout](#logout)
+  - [Default Configs](#default-configs)
+  - [Relacionamentos](#relacionamentos)
+
+## Versão
+1.1.1 - Seguindo a documentação v14 do WebService
+
+## Instalação
+
+```sh
+gem install iesde -v 1.1.1
+```
+
+Ou no seu Gemfile
+```ruby
+gem 'iesde', '~> 1.1.1'
+```
+
+## Uso
+
+> Todas as buscas no WebService exigem os parâmetros **login** e **senha**.
+> Caso você possua apenas um usuário de acesso ao WebService, você pode configurar esses parâmetros em um initializer.
+> Veja na seção [Default Configs](#default-configs).
+
+### Listagem de Cursos
+
+Retorna um array de ```Iesde::Model::Curso```
+```ruby
+parametros = {
+    login:  "0123456789",
+    senha: "9d7d5741ab23397aa15937fcd4121a32",
+    busca: "",
+    tipo: "C",
+    site: "",
+    idCurso: ""
+}
+cursos = Iesde::Model::Curso.buscar(parametros)
+=> [#<Iesde::Model::Curso>, #<Iesde::Model::Curso>, #<Iesde::Model::Curso>, ...]
+```
+### Busca de curso por Id
+Esta busca realiza uma varredura em todos os cursos e pacotes em busca do **id** passado como parâmetro.
+
+Retorna um ```Iesde::Model::Curso```
+```ruby
+curso = Iesde::Model::Curso.find id: 1000, login: "0123456789", senha: "9d7d5741ab23397aa15937fcd4121a32"
+=> #<Iesde::Model::Curso>
+
+curso.id
+=> "1000"
+
+curso.nome
+=> "A BUSCA DA PERFEICÃO"
+```
+
+### Listagem de Aulas
+Retorna um array de ```Iesde::Model::Aula```
+
+```ruby
+parametros = {
+    login: "0123456789",
+    senha: "9d7d5741ab23397aa15937fcd4121a32",
+    loginAluno: "",
+    cpf: "",
+    curso: "1000",
+    ancora: "",
+    tipo: "C"
+}
+aulas = Iesde::Model::Aula.buscar(parametros)
+=> [#<Iesde::Model::Aula>, #<Iesde::Model::Aula>, #<Iesde::Model::Aula>, ...]
+```
+
+Ou já tendo o curso carregado...
+
+```ruby
+curso.aulas
+=> [#<Iesde::Model::Aula>, #<Iesde::Model::Aula>, #<Iesde::Model::Aula>, ...]
+```
+
+### Listagem de Matrículas
+
+Retorna um array de ```Iesde::Model::Matricula ```
+
+```ruby
+parametros = {
+    login: "0123456789",
+    senha: "9d7d5741ab23397aa15937fcd4121a32",
+    curso: "6376",
+    tipo: "C"
+}
+Iesde::Model::Matricula.buscar(parametros)
+=> [#<Iesde::Model::Matricula>, #<Iesde::Model::Matricula>, #<Iesde::Model::Matricula>, ...]
+```
+Ou já tendo o curso carregado...
+
+```ruby
+curso.matriculas
+=> [#<Iesde::Model::Matricula>, #<Iesde::Model::Matricula>, #<Iesde::Model::Matricula>, ...]
+```
+### PDF
+
+Para obter o link do PDF da aula, basta carregar o modelo ```Iesde::Model::Aula``` e usar os métodos auxiliares:
+
+```ruby
+# passando email e cpf do aluno...
+aula.link_pdf "aluno@minhaorganizacao.com.br", "12345678900"
+=> "http://ws.videoaulasonline.com.br/pdf/imprime/caracteres_malucos"
+
+# passando um modelo Iesde::Model::Aluno...
+aula.link_para aluno
+=> "http://ws.videoaulasonline.com.br/pdf/imprime/caracteres_malucos"
+```
+
+### Matricular Aluno
+
+Realiza a matrícula no WebService e retorna um ```Iesde::Model::Matricula```
+
+```ruby
+parametros = {
+    login: "0190001388",
+    senha: "9d7d5741ab23397afeb81829a3d5ebd7",
+    loginAluno: "aluno@minhaorganizacao.com.br",
+    cpf: "12345678900",
+    curso: "1000",
+    duracao: "90",
+    tipo: "C",
+    valor: ""
+}
+matricula = Iesde::Model::Matricula.criar(parametros)
+=> #<Iesde::Model::Matricula>
+```
+
+### Inativação de Aluno
+
+Inativa a matrícula e retorna ```true``` se sucesso.
+
+```ruby
+parametros = {
+    login: "0190001388",
+    senha: "9d7d5741ab23397afeb81829a3d5ebd7",
+    :"LoginID" => "12345"
+}
+Iesde::Model::Matricula.inativar(parametros)
+=> true
+```
+
+Ou caso já possua a matrícula carregada...
+
+```ruby
+matricula.inativar
+=> true
+```
+### Logout
+
+Realiza logout do aluno e retorna ```true``` se sucesso.
+
+```ruby
+parametros = {
+    login: "0190001388",
+    senha: "9d7d5741ab23397afeb81829a3d5ebd7",
+    loginAluno: "aluno@minhaorganizacao.com.br",
+    cpf: "12345678900"
+}
+Iesde::Model::Aluno.logout(parametros)
+=> true
+```
+
+Ou você pode obter a instância de ```Iesde::Model::Aluno``` e chamar diretamente...
+
+```ruby
+aluno = matricula.aluno
+=> #<Iesde::Model::Aluno>
+aluno.logout
+=> true
+```
+
+```ruby
+aluno = curso.matriculas.first.aluno
+=> #<Iesde::Model::Aluno>
+aluno.logout
+=> true
+```
+
+## Default Configs
+Caso você utilize apenas um usuário do WebService em sua aplicação, seria interessante não passar os parâmetros **login** e **senha** em toda busca.
+
+Você pode configurar num initializer esses parâmetros:
+
+```ruby
+Iesde::configure do |config|
+    config.default_username = "0190001388"
+    config.default_password = "9d7d5741ab23397afeb81829a3d5ebd7"
+end
+```
+
+Então poderá realizar as requisições sem passar estes parâmetros. Exemplos:
+
+```ruby
+cursos = Iesde::Model::Curso.buscar busca: "", tipo: "C", site: "", idCurso: ""
+=> [#<Iesde::Model::Curso>, #<Iesde::Model::Curso>, #<Iesde::Model::Curso>, ...]
+
+curso = Iesde::Model::Curso.find id: 1000
+=> #<Iesde::Model::Curso>
+
+Iesde::Model::Matricula.inativar :"LoginID" => "12345"
+=> true
+```
+
+## Relacionamentos
+
+ - Um ```Iesde::Model::Curso``` possui várias ```Iesde::Model::Aula```e várias ```Iesde::Model::Matricula```
+ - Uma ```Iesde::Model::Matricula``` possui um ```Iesde::Model::Aluno``` e um ```Iesde::Model::Curso```
+ - Logo ```Iesde::Model::Curso``` possui vários ```Iesde::Model::Aluno```
+```ruby
+# Busca aulas no WS do curso
+curso.aulas
+=> [#<Iesde::Model::Aula>, #<Iesde::Model::Aula>, #<Iesde::Model::Aula>, ...]
+
+aula.curso
+=> #<Iesde::Model::Curso>
+
+curso.matriculas
+=> [#<Iesde::Model::Matricula>, #<Iesde::Model::Matricula>, #<Iesde::Model::Matricula>, ...]
+
+matricula.curso
+=> #<Iesde::Model::Curso>
+
+matricula.aluno
+=> #<Iesde::Model::Aluno>
+
+curso.alunos
+=> [#<Iesde::Model::Aluno>, #<Iesde::Model::Aluno>, #<Iesde::Model::Aluno>, ...]
+```
+
+> A maioria destas operações só busca do WS uma vez. Ao buscar as aulas de um curso, elas já vem com o curso carregado em suas instâncias, evitando outra chamada ao WS para buscar o curso ao fazer ```aula.curso```.
+
+## Licença
+
+MIT Licence. Copyright (c) 2016 Fortes Tecnologia. http://www.fortestecnologia.com.br
+
+![ft](http://www.fortestecnologia.com.br/templates/fortesinfo/images/grupo-fortes.png)
+
+[siteiesde]:<http://www.iesde.com.br>

data/README.md

@@ -1,258 +1,218 @@
 # Iesde
 
-Interface para acesso ao WebService do [Iesde][siteiesde] para sistemas Rails. Não se trata de uma ferramenta oficial pois foi desenvolvida por necessidade dos nossos desenvolvedores. Sintam-se livres para contribuir.
-
-## Índice
-\- [Iesde](#iesde)
-  - [Versão](#vers%C3%A3o)
-  - [Instalação](#instala%C3%A7%C3%A3o)
-  - [Uso](#uso)
-    - [Listagem de Cursos](#listagem-de-cursos)
-    - [Busca de curso por Id](#busca-de-curso-por-id)
-    - [Listagem de Aulas](#listagem-de-aulas)
-    - [Listagem de Matrículas](#listagem-de-matr%C3%ADculas)
-    - [PDF](#pdf)
-    - [Matricular Aluno](#matricular-aluno)
-    - [Inativação de Aluno](#inativa%C3%A7%C3%A3o-de-aluno)
-    - [Logout](#logout)
-  - [Default Configs](#default-configs)
-  - [Relacionamentos](#relacionamentos)
+Interface para acesso ao WebService do [IESDE](http://www.iesde.com.br) para sistemas Rails. Não se trata de uma ferramenta oficial pois foi desenvolvida por necessidade dos nossos desenvolvedores. Sintam-se livres para contribuir.
 
 ## Versão
-1.0.1 - Seguindo a documentação v14 do WebService
+2.0.0 - Seguindo a nova documentação WebService REST. Caso esteja usando o antigo WebService SOAP utilize a [documentação da versão 1.1.1](README-OLD-API.md)
 
 ## Instalação
 
 ```sh
-gem install iesde -v 1.0.1
+gem install iesde -v 2.0.0
 ```
 
 Ou no seu Gemfile
 ```ruby
-gem 'iesde', '~> 1.0.1'
+gem 'iesde', '~> 2.0.0'
 ```
 
-## Uso
 
-> Todas as buscas no WebService exigem os parâmetros **login** e **senha**.
-> Caso você possua apenas um usuário de acesso ao WebService, você pode configurar esses parâmetros em um initializer.
-> Veja na seção [Default Configs](#default-configs).
+## Default Configs
+Caso você utilize apenas um usuário do WebService em sua aplicação, seria interessante não passar as chaves de acesso em toda busca.
 
-### Listagem de Cursos
+Você pode configurar num initializer esses parâmetros:
 
-Retorna um array de ```Iesde::Model::Curso```
 ```ruby
-parametros = {
-    login:  "0123456789",
-    senha: "9d7d5741ab23397aa15937fcd4121a32",
-    busca: "",
-    tipo: "C",
-    site: "",
-    idCurso: ""
-}
-cursos = Iesde::Model::Curso.buscar(parametros)
-=> [#<Iesde::Model::Curso>, #<Iesde::Model::Curso>, #<Iesde::Model::Curso>, ...]
+# config/initializers/iesde.rb
+
+Iesde.configure do |c|
+  c.user        = "1234567890123456"
+  c.password    = "1234567890123456"
+  c.ead_api_key = "1234567890123456"
+end
 ```
-### Busca de curso por Id
-Esta busca realiza uma varredura em todos os cursos e pacotes em busca do **id** passado como parâmetro.
 
-Retorna um ```Iesde::Model::Curso```
-```ruby
-curso = Iesde::Model::Curso.find id: 1000, login: "0123456789", senha: "9d7d5741ab23397aa15937fcd4121a32"
-=> #<Iesde::Model::Curso>
+### Listagem de Disciplinas
 
-curso.id
-=> "1000"
+Retorna um array de ```Iesde::Model::Disciplina```
+```ruby
+disciplinas = Iesde::Model::Disciplina.buscar
+=> [#<Iesde::Model::Disciplina>, #<Iesde::Model::Disciplina>, #<Iesde::Model::Disciplina>, ...]
 
-curso.nome
-=> "A BUSCA DA PERFEICÃO"
-```
+disciplina = disciplinas.first
 
-### Listagem de Aulas
-Retorna um array de ```Iesde::Model::Aula```
+disciplina.curso_id
+=> "123456"
 
-```ruby
-parametros = {
-    login: "0123456789",
-    senha: "9d7d5741ab23397aa15937fcd4121a32",
-    loginAluno: "",
-    cpf: "",
-    curso: "1000",
-    ancora: "",
-    tipo: "C"
-}
-aulas = Iesde::Model::Aula.buscar(parametros)
-=> [#<Iesde::Model::Aula>, #<Iesde::Model::Aula>, #<Iesde::Model::Aula>, ...]
+disciplina.computed
+=> "ELABORAÇÃO DE ROTEIROS E PACOTES"
 ```
 
-Ou já tendo o curso carregado...
+### Listagem de Matrículas
 
+Retorna um array de ```Iesde::Model::Matricula```
 ```ruby
-curso.aulas
-=> [#<Iesde::Model::Aula>, #<Iesde::Model::Aula>, #<Iesde::Model::Aula>, ...]
-```
+Matriculas = Iesde::Model::Matricula.buscar
+=> [#<Iesde::Model::Matricula>, #<Iesde::Model::Matricula>, #<Iesde::Model::Matricula>, ...]
 
-### Listagem de Matrículas
+matricula = matriculas.first
 
-Retorna um array de ```Iesde::Model::Matricula ```
+matricula.matricula_id
+=> "123456"
 
-```ruby
-parametros = {
-    login: "0123456789",
-    senha: "9d7d5741ab23397aa15937fcd4121a32",
-    curso: "6376",
-    tipo: "C"
+matricula.aluno
+=> "Fulano da Silva"
+
+matricula.situacao
+=> "A"
+```
+
+### Criar uma Matrícula
+
+Retorna a ```Iesde::Model::Matricula``` criada quando parâmetros enviados corretamente.
+
+```ruby
+params = {
+  'CursoID'     => 123456 ,
+  'PoloID'      => 123,
+  'Nome'        => 'Aluno da Silva',
+  'CPF'         => '12345678900',
+  'Email'       => 'aluno@email.com',
+  'RG'          => '2003000152000',
+  'OrgaoRG'     => 'ABC',
+  'UFRG'        => 'CE',
+  'CEP'         => '60120-140',
+  'Endereco'    => 'Rua dos Anzois Pereira',
+  'Bairro'      => 'Bairroso',
+  'Numero'      => 123,
+  'Compl'       => 'Bloco Z apto 500',
+  'Telefone'    => '8588889999',
+  'Celular'     => '8599999999',
+  'DtNascto'    => '06/01/1966',
+  'EstadoCivil' => 1,
+  'Sexo'        => 'M'
 }
-Iesde::Model::Matricula.buscar(parametros)
-=> [#<Iesde::Model::Matricula>, #<Iesde::Model::Matricula>, #<Iesde::Model::Matricula>, ...]
-```
-Ou já tendo o curso carregado...
 
-```ruby
-curso.matriculas
-=> [#<Iesde::Model::Matricula>, #<Iesde::Model::Matricula>, #<Iesde::Model::Matricula>, ...]
+matricula = Iesde::Model::Matricula.criar(params)
+=> #<Iesde::Model::Matricula>
 ```
-### PDF
 
-Para obter o link do PDF da aula, basta carregar o modelo ```Iesde::Model::Aula``` e usar os métodos auxiliares:
+Se não, uma ```Iesde::Error::WSError``` é lançada com a mensagem do erro.
 
 ```ruby
-# passando email e cpf do aluno...
-aula.link_pdf "aluno@minhaorganizacao.com.br", "12345678900"
-=> "http://ws.videoaulasonline.com.br/pdf/imprime/caracteres_malucos"
+Iesde::Model::Matricula.criar(parametros)
+=> CPF inválido! (Iesde::Error::WSError)
 
-# passando um modelo Iesde::Model::Aluno...
-aula.link_para aluno
-=> "http://ws.videoaulasonline.com.br/pdf/imprime/caracteres_malucos"
-```
+Iesde::Model::Matricula.criar(parametros2)
+=> Erro: Encontramos o CPF ( 12345678900 ) para o E-MAIL ( usuario@outro.com ) (Iesde::Error::WSError)
 
-### Matricular Aluno
+Iesde::Model::Matricula.criar(parametros)
+=> Curso é um campo obrigatório! (Iesde::Error::WSError)
+```
 
-Realiza a matrícula no WebService e retorna um ```Iesde::Model::Matricula```
+Nem todos os parâmetros são obrigatórios. Você pode utilizar o método: 
 
 ```ruby
-parametros = {
-    login: "0190001388",
-    senha: "9d7d5741ab23397afeb81829a3d5ebd7",
-    loginAluno: "aluno@minhaorganizacao.com.br",
-    cpf: "12345678900",
-    curso: "1000",
-    duracao: "90",
-    tipo: "C",
-    valor: ""
-}
-matricula = Iesde::Model::Matricula.criar(parametros)
-=> #<Iesde::Model::Matricula>
+criar_com_campos_obrigatorios(id_curso, nome, cpf, email, cep, numero_casa)
 ```
-
-### Inativação de Aluno
-
-Inativa a matrícula e retorna ```true``` se sucesso.
+que retorna matrícula
 
 ```ruby
-parametros = {
-    login: "0190001388",
-    senha: "9d7d5741ab23397afeb81829a3d5ebd7",
-    :"LoginID" => "12345"
-}
-Iesde::Model::Matricula.inativar(parametros)
-=> true
+  matricula = Iesde::Model::Matricula.criar_com_campos_obrigatorios(123456, 'Fulan Da Silva', '12345678900', 'fulan@email.com','60120-140', 123)
+  => #<Iesde::Model::Matricula>
 ```
 
-Ou caso já possua a matrícula carregada...
+Você pode ativar ou desativar uma matrícula através dos métodos
 
 ```ruby
-matricula.inativar
-=> true
-```
-### Logout
+  matricula = matricula.ativar!
+  => #<Iesde::Model::Matricula>
 
-Realiza logout do aluno e retorna ```true``` se sucesso.
+  matricula.situacao
+  => "A"
 
-```ruby
-parametros = {
-    login: "0190001388",
-    senha: "9d7d5741ab23397afeb81829a3d5ebd7",
-    loginAluno: "aluno@minhaorganizacao.com.br",
-    cpf: "12345678900"
-}
-Iesde::Model::Aluno.logout(parametros)
-=> true
+  matricula = matricula.inativar!
+  => #<Iesde::Model::Matricula>
+
+  matricula.situacao
+  => "I"
 ```
 
-Ou você pode obter a instância de ```Iesde::Model::Aluno``` e chamar diretamente...
+### Listagem de Aulas
 
-```ruby
-aluno = matricula.aluno
-=> #<Iesde::Model::Aluno>
-aluno.logout
-=> true
-```
+Retorna um array de ```Iesde::Model::Aula``` para a matrícula cujo id é passado como parâmetro.
 
 ```ruby
-aluno = curso.matriculas.first.aluno
-=> #<Iesde::Model::Aluno>
-aluno.logout
-=> true
-```
+# Pega uma disciplina
 
-## Default Configs
-Caso você utilize apenas um usuário do WebService em sua aplicação, seria interessante não passar os parâmetros **login** e **senha** em toda busca.
+disciplina = Iesde::Model::Disciplina.buscar.first
+=> #<Iesde::Model::Disciplina>
 
-Você pode configurar num initializer esses parâmetros:
+# Lista suas aulas
 
-```ruby
-Iesde::configure do |config|
-    config.default_username = "0190001388"
-    config.default_password = "9d7d5741ab23397afeb81829a3d5ebd7"
-end
+disciplina.aulas(matricula.matricula_id)
+=> [#<Iesde::Model::Aula>, #<Iesde::Model::Aula>, #<Iesde::Model::Aula>, ...]
 ```
 
-Então poderá realizar as requisições sem passar estes parâmetros. Exemplos:
+### Link para o PDF da Disciplina
+
+Recebe o id da matricula e retorna o link para o download do PDF
 
 ```ruby
-cursos = Iesde::Model::Curso.buscar busca: "", tipo: "C", site: "", idCurso: ""
-=> [#<Iesde::Model::Curso>, #<Iesde::Model::Curso>, #<Iesde::Model::Curso>, ...]
+# Pega uma disciplina
+
+disciplina = Iesde::Model::Disciplina.buscar.first
+=> #<Iesde::Model::Disciplina>
 
-curso = Iesde::Model::Curso.find id: 1000
-=> #<Iesde::Model::Curso>
+# obtem link do pdf
 
-Iesde::Model::Matricula.inativar :"LoginID" => "12345"
-=> true
+disciplina.pdf(matricula.matricula_id)
+=> "https:://linkparao.pdf"
 ```
 
-## Relacionamentos
+### Link para o vídeo da aula
+
+Retorna o link para o video da aula
 
- - Um ```Iesde::Model::Curso``` possui várias ```Iesde::Model::Aula```e várias ```Iesde::Model::Matricula```
- - Uma ```Iesde::Model::Matricula``` possui um ```Iesde::Model::Aluno``` e um ```Iesde::Model::Curso```
- - Logo ```Iesde::Model::Curso``` possui vários ```Iesde::Model::Aluno```
 ```ruby
-# Busca aulas no WS do curso
-curso.aulas
-=> [#<Iesde::Model::Aula>, #<Iesde::Model::Aula>, #<Iesde::Model::Aula>, ...]
+# Pega uma disciplina
 
-aula.curso
-=> #<Iesde::Model::Curso>
+disciplina = Iesde::Model::Disciplina.buscar.first
+=> #<Iesde::Model::Disciplina>
 
-curso.matriculas
-=> [#<Iesde::Model::Matricula>, #<Iesde::Model::Matricula>, #<Iesde::Model::Matricula>, ...]
+# Pega uma aula
+aula = disciplina.aulas.first
 
-matricula.curso
-=> #<Iesde::Model::Curso>
+# obtem link do video
 
-matricula.aluno
-=> #<Iesde::Model::Aluno>
+aula.link_video
+=> "https:://linkparaovideo.mp4"
+```
+
+## Passando chaves de acesso dinamicamente
+
+Todas as funções do sistema permitem que sejam passadas as chaves de acesso de forma dinâmica limitando-se àquela ação.
 
-curso.alunos
-=> [#<Iesde::Model::Aluno>, #<Iesde::Model::Aluno>, #<Iesde::Model::Aluno>, ...]
+Ex:
+```ruby
+aulas = Iesde::Model::Aula.buscar({
+    'MatriculaID'  => 12345,
+    'DisciplinaID' => 123,
+    config: {
+      user:         ENV['IESDE_USER'],
+      password:     ENV['IESDE_PWD'],
+      ead_api_key:  ENV['EAD_API_KEY']
+    }
+  })
 ```
 
-> A maioria destas operações só busca do WS uma vez. Ao buscar as aulas de um curso, elas já vem com o curso carregado em suas instâncias, evitando outra chamada ao WS para buscar o curso ao fazer ```aula.curso```.
+## Exemplos
+
+Você pode ver exemplos de utilização da gem na pasta [examples](https://github.com/fortesinformatica/iesde/tree/master/examples).
 
 ## Licença
 
-MIT Licence. Copyright (c) 2016 Fortes Tecnologia. http://www.fortestecnologia.com.br
+MIT Licence. Copyright (c) 2017 Elore Tecnologia. http://www.elore.com.br
 
+![el](https://d257kcgu1mtlxa.cloudfront.net/organizacoes/logotipos/000/000/036/normal/Logo_Elore.png)
 ![ft](http://www.fortestecnologia.com.br/templates/fortesinfo/images/grupo-fortes.png)
-
-[siteiesde]:<http://www.iesde.com.br>