Externer Zugriff auf Persondaten

Aus KreisAlarm-Dokumentation
Wechseln zu: Navigation, Suche

<kw_bread_crumbs></kw_bread_crumbs>


Zugriff über eigenen Webserver

Sie können leicht auf KreisAlarm-Personendaten zugreifen, indem Sie sich die Seriendruck-Funktionalität zunutze machen.

Wichtiger Hinweis: Die Anzeige von Personendaten unterliegt natürlich dem Datenschutz - Sie sind dafür verantwortlich, was mit den Personendaten, auf die Sie über KreisAlarm zugreifen dürfen, gemacht wird.

Gehen Sie folgendermaßen vor:

  1. Erstellen Sie ein Template mit den entsprechenden Suchkriterien und Ergebnisattribute (Hinweis: Bitte schränken Sie die Treffermenge so weit wie möglich ein - dies schont die Resourcen des Servers, die Bandbreite und steigert die Ausführungsgeschwindigkeit ihres Skriptes. Zusätzlich trägt dies zum Datenschutz bei.
  2. Laden Sie sich die Serienbrief-Batch-Datei zu diesem Template herunter und öffnen Sie diese in einem Texteditor.
  3. Sie finden in der Batch-Datei eine URL (https://kreisalarm.de/...?...), die auf den KreisAlarm-Server verweist. Ändern Sie die Dateiendung von .xls auf .xml und merken notieren Sie sich die URL und übernehmen Sie diese in Ihrem Skript.

Anbei finden Sie ein Beispiel-PHP-Skript.

Wichtiger Hinweis: Zum Download benötigen Sie den entsprechenden Benutzernamen und das Passwort. Diese Daten dürfen natürlich nicht für Dritte einsehbar sein - mit den Daten kann man sich in KreisAlarm einloggen!!! Schützen Sie daher das Skript und geben Sie es nicht weiter.

<?php 

  // Temporäre Datei
  $tmpfile_name = "personen.html";
  // Wenn es die Datei noch nicht gibt oder diese älter als 60 Minuten ist, dann neu vom Server holen
  if (@filemtime($tmpfile_name) <= time () - 3600 
     || @filesize ($tmpfile_name) == 0) {
    
     $tmpfile = @fopen ($tmpfile_name, w);

     // Curl initialisieren (benötigt wegen SSL-Verbindung)
     $ch = curl_init ();
  
     curl_setopt ($ch, CURLOPT_URL, "https://kreisalarm.de/aktivenverwaltung/personensuche/output.xml?templateID=***TEMPLATE_ID***&login=****LOGIN****&passwd=***PASSWORT***&projectID=***PROJEKT_ID***");
     curl_setopt ($ch, CURLOPT_RETURNTRANSFER, 1);
     curl_setopt ($ch, CURLOPT_SSL_VERIFYPEER, 0);
     curl_setopt ($ch, CURLOPT_SSL_VERIFYHOST, 0);
 
     $result = curl_exec ($ch);
     $error = curl_error($ch);
     curl_close ($ch);

     // Wenn kein Fehler passiert ist, dann die Datei neu schreiben,
     // ansonsten wird die alte genommen
     if ($error == "") {
        $xml = simplexml_load_string ($result);

        fwrite ($tmpfile, "<html><head></head><body><pre>");
        foreach ($xml->xpath ('/objects/all-personen/objects/person') as $person) {
                fwrite ($tmpfile, "Name:    " . $person->nachname . ", " . $person->vorname . "\n");
                fwrite ($tmpfile, "Telefon: " . $person->{'telefon-privat'} . "\n");
                }
        fwrite ($tmpfile, "</pre></body></html>");
        } else {
               echo ($error);
               }

     fclose ($tmpfile);
     }

 // Nun die geschriebene Datei einfach ausgeben
 readfile ($tmpfile_name);
 ?>

Das Skript wurde durch Herrn Held auch für PHP4 umgeschrieben:

<?php

$tmpfile_name = "personen.html";
  // Wenn es die Datei noch nicht gibt oder diese älter als 60 Minuten ist, dann neu vom Server holen
  if (@filemtime($tmpfile_name) <= time () - 3600 
     || @filesize ($tmpfile_name) == 0) 
  {
           
      $tmpfile = @fopen ($tmpfile_name, w);
      $str = "";
      // Curl initialisieren (benötigt wegen SSL-Verbindung)
      $ch = curl_init ();
      
      curl_setopt ($ch, CURLOPT_URL, "https://kreisalarm.de/aktivenverwaltung/personensuche/output.xml?templateID=1268&login=xxx&passwd=xxx&projectID=8");
      curl_setopt ($ch, CURLOPT_RETURNTRANSFER, 1);
      curl_setopt ($ch, CURLOPT_SSL_VERIFYPEER, 0);
      curl_setopt ($ch, CURLOPT_SSL_VERIFYHOST, 0);
      
      $result = curl_exec ($ch);
      $error = curl_error($ch);
      curl_close ($ch);
      
      // Wenn kein Fehler passiert ist, dann die Datei neu schreiben,
      // ansonsten wird die alte genommen
      if ($error == "") 
      {
         $_arr = xml2array( $result );                      
         
         fwrite ($tmpfile, "<html><head></head><body><pre>");
         foreach ($_arr['objects']['all-personen']['objects']['person'] as $person)         
         {            
            fwrite ($tmpfile, "Name:    " . $person['nachname']['value'] . ", " . $person['vorname']['value'] . "\n");
            fwrite ($tmpfile, "Telefon: " . $person['telefon-mobil']['value'] . "\n");
         }
         fwrite ($tmpfile, "</pre></body></html>");
      } 
      else 
      {
        echo ($error);
      }
      @fclose ($tmpfile);         
   }
   readfile ($tmpfile_name);

/*********************************************************************
* FUNCTION   : 
* DESCRIPTION: 
* PARAMETERS :  
* RETURNS    : 
*********************************************************************/
function xml2array($contents, $get_attributes=1) {
    if(!$contents) return array();

    if(!function_exists('xml_parser_create')) {
        //print "'xml_parser_create()' function not found!";
        return array();
    }
    //Get the XML parser of PHP - PHP must have this module for the parser to work
    $parser = xml_parser_create();
    xml_parser_set_option( $parser, XML_OPTION_CASE_FOLDING, 0 );
    xml_parser_set_option( $parser, XML_OPTION_SKIP_WHITE, 1 );
    xml_parse_into_struct( $parser, $contents, $xml_values );
    xml_parser_free( $parser );

    if(!$xml_values) return;//Hmm...

    //Initializations
    $xml_array = array();
    $parents = array();
    $opened_tags = array();
    $arr = array();

    $current = &$xml_array;

    //Go through the tags.
    foreach($xml_values as $data) {
        unset($attributes,$value);//Remove existing values, or there will be trouble

        //This command will extract these variables into the foreach scope
        // tag(string), type(string), level(int), attributes(array).
        extract($data);//We could use the array by itself, but this cooler.

        $result = '';
        if($get_attributes) {//The second argument of the function decides this.
            $result = array();
            if(isset($value)) $result['value'] = $value;

            //Set the attributes too.
            if(isset($attributes)) {
                foreach($attributes as $attr => $val) {
                    if($get_attributes == 1) $result['attr'][$attr] = $val; //Set all the attributes in a array called 'attr'
                    /**  :TODO: should we change the key name to '_attr'? Someone may use the tagname 'attr'. Same goes for 'value' too */
                }
            }
        } elseif(isset($value)) {
            $result = $value;
        }

        //See tag status and do the needed.
        if($type == "open") {//The starting of the tag '<tag>'
            $parent[$level-1] = &$current;

            if(!is_array($current) or (!in_array($tag, array_keys($current)))) { //Insert New tag
                $current[$tag] = $result;
                $current = &$current[$tag];

            } else { //There was another element with the same tag name
                if(isset($current[$tag][0])) {
                    array_push($current[$tag], $result);
                } else {
                    $current[$tag] = array($current[$tag],$result);
                }
                $last = count($current[$tag]) - 1;
                $current = &$current[$tag][$last];
            }

        } elseif($type == "complete") { //Tags that ends in 1 line '<tag />'
            //See if the key is already taken.
            if(!isset($current[$tag])) { //New Key
                $current[$tag] = $result;

            } else { //If taken, put all things inside a list(array)
                if((is_array($current[$tag]) and $get_attributes == 0)//If it is already an array...
                        or (isset($current[$tag][0]) and is_array($current[$tag][0]) and $get_attributes == 1)) {
                    array_push($current[$tag],$result); // ...push the new element into that array.
                } else { //If it is not an array...
                    $current[$tag] = array($current[$tag],$result); //...Make it an array using using the existing value and the new value
                }
            }

        } elseif($type == 'close') { //End of tag '</tag>'
            $current = &$parent[$level-1];
        }
    }

    return($xml_array);
}