Klasse berufe

Berufsliste für die Sparte Unfall

Die Sparte Unfall erwartet einen Beruf aus einer festen Liste. Über diese Klasse holen Sie die Liste ab oder lösen einzelne Einträge auf – etwa für eine Autovervollständigung im Eingabeformular.

Alle Beispiele setzen die Hilfsfunktion curlSend() und den Aufbau aus den Grundlagen voraus.

MethodeZweck
fetchListAlle Berufe abrufen
loadFromIdBeruf anhand seiner ID auflösen
loadFromNameID anhand des vollständigen Namens ermitteln
searchFromNameBerufe anhand einer Teilbezeichnung suchen

fetchList – Alle Berufe

Es müssen keine Parameter übergeben werden.

Request
$UpdateParams = array (
    "dataUser" => array (
        'user' => 'IHREVERMITTLERNUMMER',
        'pass' => '********',
    ),
    "content"  => array (
        'berufe' => array (
            'fetchList' => array( "" ),
        ),
    ),
);
Response (gekürzt)
array (
  'response' =>
  array (
    'berufe' =>
    array (
      'fetchList' =>
      array (
        0 =>
        array (
          0 => array ( 'id' => '1', 'bezeichnung' => 'Abfallbeseitiger' ),
          1 => array ( 'id' => '2', 'bezeichnung' => 'Abgeordneter' ),
          2 => array ( 'id' => '3', 'bezeichnung' => 'Abteilungsleiter' ),
          3 => array ( 'id' => '4', 'bezeichnung' => 'Agraringenieur' ),
          4 => array ( 'id' => '5', 'bezeichnung' => 'Agrartechniker' ),
          // ...
        ),
      ),
    ),
  ),
)
Die Berufsliste ändert sich selten. Cachen Sie das Ergebnis in Ihrer Anwendung, statt es bei jedem Formularaufruf neu zu laden – das schont auch das Rate Limit.

loadFromId – Beruf per ID

ParameterBedeutung
idBekannte ID des Berufs
Request
$UpdateParams = array (
    "dataUser" => array (
        'user' => 'IHREVERMITTLERNUMMER',
        'pass' => '********',
    ),
    "content"  => array (
        'berufe' => array (
            'loadFromId' => array (
                array ( 'id' => '11' ),
            ),
        ),
    ),
);
Response
array (
  'response' =>
  array (
    'berufe' =>
    array (
      'loadFromId' =>
      array (
        0 =>
        array (
          0 => array ( 'id' => '11', 'bezeichnung' => 'Änderungsschneider' ),
        ),
      ),
    ),
  ),
)

loadFromName – ID per Name

ParameterBedeutung
nameBekannter vollständiger Name des Berufs
Request
$UpdateParams = array (
    "dataUser" => array (
        'user' => 'IHREVERMITTLERNUMMER',
        'pass' => '********',
    ),
    "content"  => array (
        'berufe' => array (
            'loadFromName' => array (
                array ( 'name' => 'Änderungsschneider' ),
            ),
        ),
    ),
);
Response
array (
  'response' =>
  array (
    'berufe' =>
    array (
      'loadFromName' =>
      array (
        0 =>
        array (
          0 => array ( 'id' => '11', 'bezeichnung' => 'Änderungsschneider' ),
        ),
      ),
    ),
  ),
)

searchFromName – Suche per Teilbezeichnung

Ideal für eine Autovervollständigung: liefert alle Berufe, die den übergebenen Teilstring enthalten.

ParameterBedeutung
nameTeilbezeichnung eines Berufs
Request
$UpdateParams = array (
    "dataUser" => array (
        'user' => 'IHREVERMITTLERNUMMER',
        'pass' => '********',
    ),
    "content"  => array (
        'berufe' => array (
            'searchFromName' => array (
                array ( 'name' => 'maler' ),
            ),
        ),
    ),
);
Response
array (
  'response' =>
  array (
    'berufe' =>
    array (
      'searchFromName' =>
      array (
        0 =>
        array (
          0 => array ( 'id' => '336', 'bezeichnung' => 'Glasmaler' ),
          1 => array ( 'id' => '476', 'bezeichnung' => 'Kunstmaler' ),
          2 => array ( 'id' => '519', 'bezeichnung' => 'Maler' ),
        ),
      ),
    ),
  ),
)

Die Suche findet den Teilstring auch innerhalb des Wortes – maler liefert deshalb auch Glasmaler und Kunstmaler.

✉ Feedback
Fehler oder Unstimmigkeit in dieser Doku entdeckt? Schreiben Sie uns: ts@mr-money.de