diklabu_kurswahl.psm1
|
<#
VERBEN: *add ..... fügt einen Kurs (oder mehrere) zur Kurswahl hinzu *remove .. löscht einen (oder mehrere) Kurse aus der Kurswahl *enable .. schaltet die Kurswahl frei *disable . sperrt die Kurswahl *clear ... löscht die Kurswünsche nach Rückfrage (oder Schalter -force ist gesetzt) *reset ... Löscht den Kurswunsch für einen (oder mehrere) Schüler *new ..... Eine Kurswahl für einen (oder mehrere) Schüler durchführen *Stop .... Einen Wurswunsch als gebucht setzten get ...... Liste der Schüler, die einen Kurs gewählt haben list ..... Zeigt die Kurse an, die zur Wahl stehen *) nur als Admin möglich NOMEN: Coursevoting #> <# .Synopsis Einen oder mehrere Kurse zur Wahl hinzufügen .DESCRIPTION Fügt einen oder mehrere Kurs zur Kurswahl hinzu .EXAMPLE Add-Coursevoting -id 612 .EXAMPLE Add-Coursevoting -kid 612 -uri http://localhost:8080/Diklabu/api/v1/ .EXAMPLE 11234,5678,7654 | Add-Coursevoting .EXAMPLE Find-Course -KNAME "WPK%lila" | Add-Coursevoting Fügt alle Kurse, die mit "WPK" beginnen und mit "lila" enden der Kurswahl hinzu #> function Add-Coursevoting { Param ( # id der Klasse [Parameter(Mandatory=$true,ValueFromPipeline=$true,ValueFromPipelineByPropertyName=$true,Position=0)] [int]$id, # Adresse des Diklabu Servers [String]$uri=$global:server, [switch]$whatif ) Begin { $headers=@{} $headers["content-Type"]="application/json;charset=iso-8859-1" $headers["auth_token"]=$global:auth_token; } Process { try { if (-not $whatif) { $r=Invoke-RestMethod -Method Post -Uri ($uri+"coursevoting/admin/"+$id) -Headers $headers } Write-Verbose "Der Kurs mit der ID $ID wird zur Kurswahl hinzugefügt!" return $r; } catch { Write-Error "Add-Coursevoting: Status-Code"$_.Exception.Response.StatusCode.value__ " "$_.Exception.Response.StatusDescription } } } <# .Synopsis Kurs(e) von der Wahl entfernen .DESCRIPTION Entfernt einen oder mehrere Kurs aus der Kurswahl. Dieses ist nur möglich, sofern der Kurs nicht schon gewählt wurde! .EXAMPLE Remove-Coursevoting -id 612 .EXAMPLE Remove-Coursevoting -id 612 -uri http://localhost:8080/Diklabu/api/v1/ .EXAMPLE 11234,5678,7654 | Remove-Coursevoting .EXAMPLE Find-Course -KNAME "%WPK%lila" | Remove-Coursevoting #> function Remove-Coursevoting { Param ( # id der Klasse [Parameter(Mandatory=$true,ValueFromPipeline=$true,ValueFromPipelineByPropertyName=$true,Position=0)] [int]$id, # Adresse des Diklabu Servers [String]$uri=$global:server, [switch]$whatif ) Begin { $headers=@{} $headers["content-Type"]="application/json;charset=iso-8859-1" $headers["auth_token"]=$global:auth_token; } Process { try { if (-not $whatif) { $r=Invoke-RestMethod -Method Delete -Uri ($uri+"coursevoting/admin/"+$id) -Headers $headers } Write-Verbose "Der Kurs mit der ID $id wird aus der Kurswahl entfernt!" return $r; } catch { Write-Error "Remove-Coursevoting: Status-Code"$_.Exception.Response.StatusCode.value__ " "$_.Exception.Response.StatusDescription } } } <# .Synopsis Kurswahl freigeben .DESCRIPTION Gibt die Kurswahl frei .EXAMPLE Enable-Coursevoting .EXAMPLE Enable-Coursevoting -uri http://localhost:8080/Diklabu/api/v1/ #> function Enable-Coursevoting { Param ( # Adresse des Diklabu Servers [String]$uri=$global:server, [switch]$whatif ) Begin { $headers=@{} $headers["content-Type"]="application/json;charset=iso-8859-1" $headers["auth_token"]=$global:auth_token; try { if (-not $whatif) { $r=Invoke-RestMethod -Method post -Uri ($uri+"coursevoting/admin/voting/1") -Headers $headers } Write-Verbose "Kurswahl freigeschaltet!" return $r; } catch { Write-Error "Enable-Coursevoting: Status-Code"$_.Exception.Response.StatusCode.value__ " "$_.Exception.Response.StatusDescription } } } <# .Synopsis Kurswahl sperren .DESCRIPTION Sperrt die Kurswahl .EXAMPLE Disable-Coursevoting .EXAMPLE Disable-Coursevoting -uri http://localhost:8080/Diklabu/api/v1/ #> function Disable-Coursevoting { Param ( # Adresse des Diklabu Servers [String]$uri=$global:server, [switch]$whatif ) Begin { $headers=@{} $headers["content-Type"]="application/json;charset=iso-8859-1" $headers["auth_token"]=$global:auth_token; try { if (-not $whatif) { $r=Invoke-RestMethod -Method post -Uri ($uri+"coursevoting/admin/voting/0") -Headers $headers } Write-Verbose "Kurswahl gesperrt!" return $r; } catch { Write-Error "Disable-Coursevoting: Status-Code"$_.Exception.Response.StatusCode.value__ " "$_.Exception.Response.StatusDescription } } } <# .Synopsis Löscht die Kurswahl von einem oder mehreren Schülern .DESCRIPTION Löscht die Kurswahl von einem oder mehreren Schülern .EXAMPLE Reset-Coursevoting -id 612 .EXAMPLE Reset-Coursevoting -id 612 -uri http://localhost:8080/Diklabu/api/v1/ .EXAMPLE 11234,5678,7654 | Reset-Coursevoting .EXAMPLE Find-Coursemember -KNAME FISI13A | Reset-Coursevoting Löscht die Kurswahl der Schüler aus der Klasse Fisi13A .EXAMPLE import-Csv schueler.csv | Find-Pupil | Reset-Coursevoting Löscht die Kurswahl der in der CSV Datei enthaltenen Schüler .EXAMPLE Find-Pupil -VNAME Jörg -NNAME Tuttas -GEBDAT 1968-04-11 | Reset-Coursevoting Löscht die Kurswahl des angegebenen Schülers Schüler #> function Reset-Coursevoting { Param ( # ID des Schülers [Parameter(Mandatory=$true,ValueFromPipeline=$true,ValueFromPipelineByPropertyName=$true,Position=0)] [int]$id, # Adresse des Diklabu Servers [String]$uri=$global:server, [switch]$whatif ) Begin { $headers=@{} $headers["content-Type"]="application/json;charset=iso-8859-1" $headers["auth_token"]=$global:auth_token; } Process { try { if (-not $whatif) { $r=Invoke-RestMethod -Method Delete -Uri ($uri+"coursevoting/admin/schueler/"+$id) -Headers $headers } Write-Verbose "Die Kurswahl für den Schülker mit der ID $id wurde zurückgesetzt: Ergebnis $r" return $r; } catch { Write-Error "Reset-Coursevoting: Status-Code"$_.Exception.Response.StatusCode.value__ " "$_.Exception.Response.StatusDescription } } } <# .Synopsis Löscht alle Kurswahlen .DESCRIPTION Löscht alle getätigten Kurswahlen. Löscht die Tabelle Kurswunsch .EXAMPLE Reset-Coursevoting .EXAMPLE Reset-Coursevoting -uri http://localhost:8080/Diklabu/api/v1/ .EXAMPLE Reset-Coursevoting -force #> function Clear-Coursevoting { Param ( # force [switch]$force, # Adresse des Diklabu Servers [String]$uri=$global:server, [switch]$whatif ) Begin { if (!$force) { $s=Read-Host "Wollen Sie alle Kurswünsche zurück setzten? (J/N)" if ($s -eq "J") { $force=$true } } if ($force) { $headers=@{} $headers["content-Type"]="application/json;charset=iso-8859-1" $headers["auth_token"]=$global:auth_token; try { if (-not $whatif) { $r=Invoke-RestMethod -Method Delete -Uri ($uri+"coursevoting/admin/") -Headers $headers } Write-Verbose "Alle Kurswahlen wurden zurückgesetzt (gelöscht!)"; return $r; } catch { Write-Error "Clear-Coursevoting: Status-Code"$_.Exception.Response.StatusCode.value__ " "$_.Exception.Response.StatusDescription } } } } <# .Synopsis Abfrage der Kurswahl .DESCRIPTION Zeigt die Schüler an, die einen (oder mehrere) Kurs gewählt haben. Dabei werden nur nicht gebuchte Kurse gelistet (siehe Option gebucht) .EXAMPLE Get-Coursevoting -id 123 -priotity 2 .EXAMPLE Get-Coursevoting -id 123 -gebucht Zeigt die Schüler an, die einen (oder mehrere) Kurs gewählt haben. Dabei werden nur gebuchte Kurse gelistet! .EXAMPLE Get-Coursevoting -id 123 -uri http://localhost:8080/Diklabu/api/v1/ .EXAMPLE 1234,5678 | get-Coursevoting -priority 1 .EXAMPLE Find-Course -KNAME "WPK%lila"| get-Coursevoting -priority 1 Zeigt die alle Schüler an, die einen WPK Kurs mit der Priorität 1 gewählt haben, dessen Namen mit WPK beginnt und mit lila endet! #> function Get-Coursevoting { Param ( # ID der Klasse [Parameter(Mandatory=$true,ValueFromPipelineByPropertyName=$true,ValueFromPipeline=$true,Position=0)] [int]$id, # Priorität des Kurswunsches [String]$priority=1, # Adresse des Diklabu Servers [String]$uri=$global:server, # Schalter (nur gebuchte Kurse anzeigen) [switch]$gebucht=$false ) Begin { $headers=@{} $headers["content-Type"]="application/json;charset=iso-8859-1" $headers["auth_token"]=$global:auth_token; } Process { try { $r=Invoke-RestMethod -Method Get -Uri ($uri+"coursevoting/"+$id+"/"+$priority+"/"+$gebucht) -Headers $headers Write-Verbose "Abfrage der Kurswahl für den Kurs mit der ID $id und der priorität $priority (gebucht = $gebucht)" return $r; } catch { Write-Error "Get-Coursevoting: Status-Code"$_.Exception.Response.StatusCode.value__ " "$_.Exception.Response.StatusDescription } } } <# .Synopsis Setzten einer Kurswahl .DESCRIPTION Ein Schüler wählt Drei Kurse aus .EXAMPLE New-Coursevoting -id 123 -course1 1234 -course2 4567 -course3 891 .EXAMPLE 1234,5678 | New-Coursevoting -course1 1234 -course2 4567 -course3 891 .EXAMPLE Import-Csv schueler.csv | Find-Pupil | New-Coursevoting -course1 1234 -course2 4567 -course3 891 Alle Schüler die in der CSV Datei enthalten sind, wählen die genannten Kurse #> function New-Coursevoting { Param ( # ID des Schülers [Parameter(Mandatory=$true,ValueFromPipeline=$true,ValueFromPipelineByPropertyName=$true,Position=0)] [int]$id, [Parameter(Mandatory=$true)] # Priorität 1 des Kurswunsches [String]$course1, [Parameter(Mandatory=$true)] # Priorität 2 des Kurswunsches [String]$course2, [Parameter(Mandatory=$true)] # Priorität 3 des Kurswunsches [String]$course3, # Adresse des Diklabu Servers [String]$uri=$global:server, [switch]$whatif ) Begin { $headers=@{} $headers["content-Type"]="application/json;charset=iso-8859-1" $headers["auth_token"]=$global:auth_token; } Process { try { $wunsch=echo "" | Select-Object -Property "ID_SCHUELER","ID_KURS","PRIORITAET","GEBUCHT" $wunsch.ID_SCHUELER=$id $wunsch.ID_KURS=$course1 $wunsch.PRIORITAET="1"; $wunsch.GEBUCHT="0"; if (-not $whatif) { $r=Invoke-RestMethod -Method POST -Uri ($uri+"coursevoting/admin/schueler/") -Headers $headers -Body (ConvertTo-Json $wunsch) } Write-Verbose "Buche einen Kurswunsch $wunsch . Ergebnis:$r" $wunsch=echo "" | Select-Object -Property "ID_SCHUELER","ID_KURS","PRIORITAET","GEBUCHT" $wunsch.ID_SCHUELER=$id $wunsch.ID_KURS=$course2 $wunsch.PRIORITAET="2"; $wunsch.GEBUCHT="0"; if (-not $whatif) { $r=Invoke-RestMethod -Method POST -Uri ($uri+"coursevoting/admin/schueler/") -Headers $headers -Body (ConvertTo-Json $wunsch) } Write-Verbose "Buche einen Kurswunsch $wunsch . Ergebnis:$r" $wunsch=echo "" | Select-Object -Property "ID_SCHUELER","ID_KURS","PRIORITAET","GEBUCHT" $wunsch.ID_SCHUELER=$id $wunsch.ID_KURS=$course3 $wunsch.PRIORITAET="3"; $wunsch.GEBUCHT="0"; if (-not $whatif) { $r=Invoke-RestMethod -Method POST -Uri ($uri+"coursevoting/admin/schueler/") -Headers $headers -Body (ConvertTo-Json $wunsch) } Write-Verbose "Buche einen Kurswunsch $wunsch . Ergebnis:$r" } catch { Write-Error "New-Coursevoting: Status-Code"$_.Exception.Response.StatusCode.value__ " "$_.Exception.Response.StatusDescription } } } <# .Synopsis Beendet die Kurswahl für einen oder mehrere Schüler .DESCRIPTION Beendet die Kurswahl für einen oder mehrere Schüler, das Attribut GEBUCHT wird in der Tabelle Kurswunsch auf "1" gesetzte! .EXAMPLE Stop-Coursevoting -id 123 .EXAMPLE 1234,5678 | Stop-Coursevoting .EXAMPLE Import-Csv schueler.csv | Find-Pupil | Stop-Coursevoting Alle Schüler die in der CSV Datei enthalten sind, werden in der Kurswahl auf gebucht gesetzt #> function Stop-Coursevoting { Param ( # ID des Schülers [Parameter(Mandatory=$true,ValueFromPipeline=$true,ValueFromPipelineByPropertyName=$true,Position=0)] [int]$id, # Adresse des Diklabu Servers [String]$uri=$global:server, [whatif]$whatif ) Begin { $headers=@{} $headers["content-Type"]="application/json;charset=iso-8859-1" $headers["auth_token"]=$global:auth_token; } Process { try { if (-not $whatif) { $r=Invoke-RestMethod -Method Put -Uri ($uri+"coursevoting/admin/schueler/$id") -Headers $headers } Write-Verbose "Beende die Kurswahl für Schüler mit der ID $id . Ergebnis: $r"; return $r } catch { Write-Error "Stop-Coursevoting: Status-Code"$_.Exception.Response.StatusCode.value__ " "$_.Exception.Response.StatusDescription } } } <# .Synopsis Listet die Kurse die zur Wahl stehen .DESCRIPTION Zeigt alle Kurse an, die zur Wahl stehen .EXAMPLE Get-Coursevotings .EXAMPLE Get-Coursevotings -uri http://localhost:8080/Diklabu/api/v1/ #> function Get-Coursevotings { Param ( # Adresse des Diklabu Servers [String]$uri=$global:server ) Begin { $headers=@{} $headers["content-Type"]="application/json;charset=iso-8859-1" $headers["auth_token"]=$global:auth_token; try { $r=Invoke-RestMethod -Method Get -Uri ($uri+"coursevoting/") -Headers $headers Write-Verbose "Liste der Kurs die zur Wahl stehen!" return $r; } catch { Write-Error "Get-Coursevoting: Status-Code"$_.Exception.Response.StatusCode.value__ " "$_.Exception.Response.StatusDescription } } } |