jonas/divis-to-iserv-elternmodul
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

Added more description and MIN_NAME_MATCHING_PERCENTAGE parameter

Browse Source
This commit is contained in:
Jonas Lührig
2023-07-28 01:58:51 +02:00
parent 5af1314fb0
commit 864a531363
2 changed files with 16 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files

6
IServ_Elternimport_Divis.php
View File

@@ -19,6 +19,7 @@
* $ php ./IServ_Elternimport_Divis.php iserv-user-export.csv divis-parents-export.csv > Parents_Import.csv * $ php ./IServ_Elternimport_Divis.php iserv-user-export.csv divis-parents-export.csv > Parents_Import.csv
*/ */
define ("MIN_NAME_MATCHING_PERCENTAGE", 85);
define ("WRITE_TO_CONSOLE", true); define ("WRITE_TO_CONSOLE", true);
define ("IS_CLI", (php_sapi_name() == "cli")); define ("IS_CLI", (php_sapi_name() == "cli"));
@@ -71,7 +72,10 @@ function find_parent_by_student ($firstname, $lastname) {
// If match is bigger or equal to 85% and this match is higher // If match is bigger or equal to 85% and this match is higher
// ranked than the last, make this the current best match // ranked than the last, make this the current best match
if ($perc >= 85 && $best_match["match_perc"] < $perc) { if (
$perc >= MIN_NAME_MATCHING_PERCENTAGE &&
$best_match["match_perc"] < $perc
) {
console_write ("INFO: New best match '{$hash}' at {$perc}%"); console_write ("INFO: New best match '{$hash}' at {$perc}%");
$best_match = [ $best_match = [
"match_perc" => $perc, "match_perc" => $perc,

8
README.md
View File

@@ -13,6 +13,14 @@ The student <> parents mapped CSV from DiViS should have the following columns:
The CSV exported by this script will have the following columns: The CSV exported by this script will have the following columns:
`Nachname;Vorname;Kind-ID;Klasse` `Nachname;Vorname;Kind-ID;Klasse`
Rows that are not of type "Schüler" in the IServ user export CSV are skipped. Students for which a parent
was not found are skipped in the output CSV, however a warning is displayed.
To compare the first and last name of the student to the DiViS list, the `similar_text()` PHP function is used to allow
minimal character spelling mistakes between the two files. This behaviour can be disabled by adjusting the
MIN_NAME_MATCHING_PERCENTAGE constant defined at the top of the script to 100, meaning the first and last names must
match exactly. Otherwise, only 85% of the name must match (typically equating to 1-2 different characters per full name).
Status messages, information and errors are always written to `STDERR`, while the generated CSV Status messages, information and errors are always written to `STDERR`, while the generated CSV
will be exported to `STDOUT`, meaning you can redirect the `STDOUT` output of this script to a file will be exported to `STDOUT`, meaning you can redirect the `STDOUT` output of this script to a file
to export the CSV and still be able to read any informational messages: to export the CSV and still be able to read any informational messages: