Wikizone - Benutzerbeiträge [de]

Narda

2015-10-23T18:45:36Z

87.165.0.123: /* Änderungen */

== Überblick ==
RMA und ACC liegen auf Geo-bit Server und sind per iFrame eingebunden:
<pre>
<iframe width="940" height="1000" src="/1/RMA/rma_select_01.php?req_art=rep_cal"></iframe>
<iframe width="940" height="1000" src="/1/RMA/rma_select_01.php?req_art=warranty"></iframe>
<iframe width="940" height="1000" src="/1/acc-2/login.php"></iframe>
</pre>
direkt erreichbar über:

http://narda-sts.com.w00eb738.kasserver.com/1/RMA/rma_select_01.php?req_art=rep_cal
http://narda-sts.com.w00eb738.kasserver.com/1/RMA/rma_select_01.php?req_art=warranty
http://narda-sts.com.w00eb738.kasserver.com/1/acc-2/login.php

== TYPO3 RMA Extension ==
=== Dokumentation ===
Narda RMA Prozess [[Dokumentation gbrma]]

=== Zus. Leistungen ===
<pre>
Mail an Admin 6h / Mailtemplates
pdf Generierung
Vorfilterung nach Geräteklasse + Auswahlkontrolle
Admin Ansicht benötigt ???
Zusätzliche States
Geräteliste zum Aufklappen ab 5 Zeilen
Templatevarianten für
SRM / IDA
NBM
Detailansicht für beendete RMA
Express Calibration
fpdf Integration für acc
Bespr. Narda 2h
Setting up Testing Area
Klassen müssen ebenfalls einer Familie zugeordnet werden
Checkboxen (calib, mod/upgr., repair, no service, nur dann anzeigen, wenn sinnvoll
Checkboxen komplett weg für ACC
Regel für mehrere Basedevices erlaubt (Radman)
Clientnr. in fe_user
Zeige Rmas by Client nr.
Modification ausblenden wenn keine vorhanden
Auslagerung von Texten in Lokalisierungstextfiles
Möglichkeit zur Auswahl von Texten je nach Geräteklasse
Erklärungstexte für Status
ACC Filterung auf Geräteklassenebene
Mail an Admin bei Delete
Mapping des ERP Exports und checken der RMAs
Test Scheduler einrichten
</pre>

=== Änderungen ===
* Client ID Mode -> Speichern der Client ID implementieren - '''OK'''
* Client ID Mode -> Wenn angeschaltet Listing an ClientID statt an User ID ausrichten - '''OK'''
* Client ID Mode -> Wenn angeschaltet UserValid Test an ClientID statt User ID ausrichten - ''' OK'''

* Fehler beim '''Import''' wenn Leerzeilen enthalten - '''OK'''
* Feature: Statt RMA Date immer '''Datum der letzten Status Aktualisierung'''. 1. Angelegt in T3 2. Datum der letzten Bearbeitung aus ERP Datei - '''OK'''
** Model erweitern (tstamp) - '''OK'''
** Templates auf tstamp statt cdate - '''OK'''
** Anpassen im Code - '''OK'''
* F: '''Datatables''' Skript für Listenansicht - '''OK'''
* '''Validierungen'''
** Keine Beschreibung bei Repair eingegeben - '''OK'''
** Kein Service Request gewählt - '''OK'''
** Inspection Repair und No Service nicht gemeinsam anwählbar - '''OK'''
** F: Wenn Repair dann keine Kalibrierung (ist beinhaltet) -> Änderung Calib und Repair möglich - '''OK'''
** F: Wenn Kalibrierung dann kein Repair -> ist doch möglich - '''OK'''
* F: Am Ende Auswahlfeld Expresskalibrierung aber nur wenn Kalibrierung ausgewählt ist '''Todo'''
* F: + Textfeld (Additional information) -> '''OK''' wird immer angezeigt auch wenn keine Expresskalib. ''' Evtl. anpassen (nach Rücksprache)'''
* '''Beispielbilder''' "Wo finde ich die Seriennummer" in Add Metadevice - '''ToDo'''
* Bug: Add Main Device, Add 2.Device, Zurück auf Main Device Tab => '''Tabs''' werden nicht mehr richtig dargestellt - '''OK'''
* Nichtssagende '''Fehlermeldung''' in AddMetadevice wenn die Validierung scheitert (Seite wird erneut angezeigt) - '''OK'''
* Feature: NewFormFields soll Auswahl für Acc nur anbieten wenn Userrecht vorliegt (Safety) - '''OK'''
* '''RMA Doku''' -> z.T. aus E-Mails übernehmen - '''TODO'''
* '''Fehlermeldungen von Extbase''' verhindern bei Browserbedienung (vor und zurück Buttons) - '''ToDo'''
** Wenn '''RMA nicht vorhanden''' (z.B. gelöscht) dann aussagekräftige Fehlermeldung) ''' ToDo '''
* Feature: '''RMA gelöscht Mail''' nur dann wenn Status 2 erreicht (also wenn schon eine Info bei Narda ankam) - '''OK'''
* '''RMA Nummern''' werden nur als gelöscht markiert bzw. eine Nummer wird nie mehrfach vergeben. - '''OK'''
* '''ACC'''
** '''PDF''' muß auch an Kunden (FE-User) gesendet werden - '''OK'''
* '''RMA löschen Bestätigung''' (JS) - '''OK'''
* SRM Auswahl der Geräte -> richtige Tabs aktiv -> bei SRM 3 Tabs "rf-cable" - '''OK'''
* E-Mail RMA Type weg, RMA Prominent oben, evtl. im Betreff - '''OK'''
* Zuerst Device Title dann SN - '''OK'''
* Umbenennungen
** Express Order -> Express Calibration Service - '''OK'''
** Factory Calibration / Repair -> ohne Warranty Request - '''OK'''
** Modification Texte 5 und 6 - '''OK'''
* F: ClientID Mode -> User mit der selben Client ID können RMAs anderer User sehen - '''ToDo'''
** Client Id als Merkmal im User - ''' ToDo '''
** Client ID muß beim abspreichern vorliegen und mit abgespeichert werden.

== Internet Präsenz Narda ==

Mischung aus verschiedenen Systemen

Hauptdomain: www.narda-sts.de

=== Content Management System ===
Frontend ist TYPO3 allerdings werden einige Download-Listen über ein php-Skript generiert.
Diese Inhalte werden über ein eigenes Tool realisiert.

=== FTP-Zugänge ===

Die Seite würd über vodafone gehostet. Vodafone der Zugriff erfolgt Zentral über
ftp.vodafone-ip.de

Im Admin Bereich von Vodafone kann man FTP Benutzer anlegen.
Der Zugriff erfolgt dann über [benutzername]%[domainname]
Also z.B. aszwei%narda-sts.de

=== Server Verwaltung ===
Hier kann man FTP Zugänge anlegen, auf phpMyAdmin zugreifen etc.
Login unter: https://webadmin.arcor.net/Secure/

=== phpMyAdmin ===
Direkt zu erreichen unter:

== Eigenes Admin System ==
Zur Verwaltung von downloads, etc.
http://www.narda-sts.de/admin/

Greift auf eine separate Datenbank zu, in der die Daten abgelegt sind.

==== Anpassen eines Software Downloads ====
Um einen Download anzupassen spielt man die Datei per FTP unterhalb des Verzeichnisses
/download/software/

Als nächstes öffnet man das Admin Tool und geht in den Menüpunkt
SoftwareUpdate (beta)
Dort kann man die Release Nummer anpassen (z.B. 2011) und aus dem Dropdownfeld die passende Datei auswählen.

==== Anlegen eines neuen Downloads ====
Hierbei muß man beachten daß in TYPO3 ein php Schnipsel eingebunden wird.
<pre>
<?php
include("fileadmin/user_upload/scripts/db_func.inc");
print (get_software_information("EFC_HF_Demo_EN"));
?>
</pre>

gibt einen Download Block inkl. Link und Beschreibung aus.
Wobei als Parameter der Name im Datenbankfeld re_call übergeben wird. Dieser wird beim Anlegen der Software manuell Vergeben

== Sales Partner Extranet ==
www.narda-sts.de/sp (oder /vp)

== RMA Garantie und Rücklaufgeräte ==
Dies wird über Vertragspartner erledigt, und es gibt ein weiteres Tool. Der User holt sich ein RMA Ticket (Online Formular) Je nach Region wird dann an den Vertriebspartner eine E-Mail versendet. Außerdem an Narda.

Auf dem Serverl liegt es im Ordner /1/RMA/

Im Quelltext sind auch etliche E-Mail Adressen hinterlegt die auf Mails zu Aichele und dem Programmierer hinweisen. Das müßte mal ausgemistet werden.

=== Kontaktdaten der Vertriebspartner ===
Diese sind in der Datenbank in der Tabelle ''' rma_requests''' hinterlegt.
Es gibt auch eine Tabelle Vertriebspartner. Ist aber nicht ganz klar wann diese benutzt werden.
Ich habe noch kein Administrationstool gefunden. Die Änderung kann aber direkt in der Datenbank erfolgen.

Edit:

Vertriebspartner in der Tabelle vertriebspartner werden vom RMA Prozess Tool (und vom neuen acc Tool) genutzt.

Es gibt außerdem eine Ausgabe der Vertriebspartner Adressen. Dabei werden über das Admin Tool (Narda Tool -> Partner Update) html Dateien geschrieben, die dann im Typo eingebunden sind. (Total umständlich). Es wird die Tabelle ??? genutzt.

=== Funktionsweise technische Realisierung (PHP-Skripte) ===
Siehe MindMap

Einstieg für den RMA Prozess ist der Link:

http://www.narda-sts.de/1/RMA/rma_select_01.php?req_art=rep_cal

In diesem Schritt wird die Länderauswahl angezeigt und die Art der Anfrege übergeben.
Nach der Länderauswahl sieht der link dann ungefähr so aus:

https://ssl.arcor-secure.de/narda-sts.de/1/RMA/rma_persData_02.php?req_art=rep_cal&req_id=P20110214_gF164223&req_reg=2

Es wird also eine req_id und req_reg Übergeben. Und die Persönlichen Daten abgefragt.

RMA/rma_reCall.php

== ACC Prozess ==
Für den ACC (Accredited Callbration) wurde das Tool komplett überarbeitet und entschlackt. Im Moment läuft es nicht auf dem Narda Server, sondern auf dem Geo-bit Server.

=== Hinweise zur Datenbank ===
Die Partner sind hier in der Tabelle Vertriebspartner hinterlegt. Sie Loggen sich mit ihrer ID und einem Passwort ein. Die Tabelle wurde ursprünglich kopiert und um einige Felder erweitert.

Es können sich nur Partner anmelden die im Feld

== Weitere Skripte ==

Es sind einige weitere Skripte im Einsatz:

=== Funktionsübersicht von Produkten ===
/doc/fileadmin/user_upload/scripts/func_overview.inc.php

Wird in Typo3 so aufgerufen:

<pre>
<?php
include("fileadmin/user_upload/scripts/func_overview.inc.php");
$config_file = "typo3conf/localconf.php";
$image_path = "fileadmin/user_upload/products/personal_protection";
$page_id = 70; // ID DER UEBERGEORDNETEN SEITE
print get_overview($page_id,$image_path,"Personal Monitor");
?>

</pre>

Funktion:

* Liest die aktuelle Sprache aus dem L Parameter oder der RealURL Adresse
* Liest die pid der untergeordneten Seiten aus.

=== Mailfunktion RMA / ACC ===
==== RMA ====
Es werden mehrere Mails generiert.

1. Schritt User Registrierung => Mail mit dem Ticket. Dieses enthält einen Link. Für die Geräteeingabe
Mailversand in '''rma_persData_02.php'''

2. Schritt Versand der RMA Daten
$html_mail_versand = send_html_mail($req_number,$req_ident_number,$req_art);
kommt aus '''mail_html_function.inc.php'''

==== ACC ====
Das Formular zur Eingabe liegt in '''acc_form.ph'''p Nach Absenden wird '''acc_form_send.php''' aufgerufen. In diesem wird die Mail über die Funktion
$success = send_acc_mail($rma_num,$arrForm,$arrPartner);
versendet. Die Funktion wird in '''lib/acal_functions.php''' zur Verfügung gestellt.
<pre>
FORMULAR MAILVERSAND / FEEDBACK
acc_form.php -> acc_form_send.php <- includes acal_functions.php (send_acc_mail)

</pre>

Narda

2015-10-23T18:37:49Z

87.165.0.123: /* Änderungen */

== Überblick ==
RMA und ACC liegen auf Geo-bit Server und sind per iFrame eingebunden:
<pre>
<iframe width="940" height="1000" src="/1/RMA/rma_select_01.php?req_art=rep_cal"></iframe>
<iframe width="940" height="1000" src="/1/RMA/rma_select_01.php?req_art=warranty"></iframe>
<iframe width="940" height="1000" src="/1/acc-2/login.php"></iframe>
</pre>
direkt erreichbar über:

http://narda-sts.com.w00eb738.kasserver.com/1/RMA/rma_select_01.php?req_art=rep_cal
http://narda-sts.com.w00eb738.kasserver.com/1/RMA/rma_select_01.php?req_art=warranty
http://narda-sts.com.w00eb738.kasserver.com/1/acc-2/login.php

== TYPO3 RMA Extension ==
=== Dokumentation ===
Narda RMA Prozess [[Dokumentation gbrma]]

=== Zus. Leistungen ===
<pre>
Mail an Admin 6h / Mailtemplates
pdf Generierung
Vorfilterung nach Geräteklasse + Auswahlkontrolle
Admin Ansicht benötigt ???
Zusätzliche States
Geräteliste zum Aufklappen ab 5 Zeilen
Templatevarianten für
SRM / IDA
NBM
Detailansicht für beendete RMA
Express Calibration
fpdf Integration für acc
Bespr. Narda 2h
Setting up Testing Area
Klassen müssen ebenfalls einer Familie zugeordnet werden
Checkboxen (calib, mod/upgr., repair, no service, nur dann anzeigen, wenn sinnvoll
Checkboxen komplett weg für ACC
Regel für mehrere Basedevices erlaubt (Radman)
Clientnr. in fe_user
Zeige Rmas by Client nr.
Modification ausblenden wenn keine vorhanden
Auslagerung von Texten in Lokalisierungstextfiles
Möglichkeit zur Auswahl von Texten je nach Geräteklasse
Erklärungstexte für Status
ACC Filterung auf Geräteklassenebene
Mail an Admin bei Delete
Mapping des ERP Exports und checken der RMAs
Test Scheduler einrichten
</pre>

=== Änderungen ===
* Client ID Mode -> Speichern der Client ID implementieren - '''OK'''
* Client ID Mode -> Wenn angeschaltet Listing an ClientID statt an User ID ausrichten - '''OK'''
* Client ID Mode -> Wenn angeschaltet UserValid Test an ClientID statt User ID ausrichten - ''' ToDo'''

* Fehler beim '''Import''' wenn Leerzeilen enthalten - '''OK'''
* Feature: Statt RMA Date immer '''Datum der letzten Status Aktualisierung'''. 1. Angelegt in T3 2. Datum der letzten Bearbeitung aus ERP Datei - '''OK'''
** Model erweitern (tstamp) - '''OK'''
** Templates auf tstamp statt cdate - '''OK'''
** Anpassen im Code - '''OK'''
* F: '''Datatables''' Skript für Listenansicht - '''OK'''
* '''Validierungen'''
** Keine Beschreibung bei Repair eingegeben - '''OK'''
** Kein Service Request gewählt - '''OK'''
** Inspection Repair und No Service nicht gemeinsam anwählbar - '''OK'''
** F: Wenn Repair dann keine Kalibrierung (ist beinhaltet) -> Änderung Calib und Repair möglich - '''OK'''
** F: Wenn Kalibrierung dann kein Repair -> ist doch möglich - '''OK'''
* F: Am Ende Auswahlfeld Expresskalibrierung aber nur wenn Kalibrierung ausgewählt ist '''Todo'''
* F: + Textfeld (Additional information) -> '''OK''' wird immer angezeigt auch wenn keine Expresskalib. ''' Evtl. anpassen (nach Rücksprache)'''
* '''Beispielbilder''' "Wo finde ich die Seriennummer" in Add Metadevice - '''ToDo'''
* Bug: Add Main Device, Add 2.Device, Zurück auf Main Device Tab => '''Tabs''' werden nicht mehr richtig dargestellt - '''OK'''
* Nichtssagende '''Fehlermeldung''' in AddMetadevice wenn die Validierung scheitert (Seite wird erneut angezeigt) - '''OK'''
* Feature: NewFormFields soll Auswahl für Acc nur anbieten wenn Userrecht vorliegt (Safety) - '''OK'''
* '''RMA Doku''' -> z.T. aus E-Mails übernehmen - '''TODO'''
* '''Fehlermeldungen von Extbase''' verhindern bei Browserbedienung (vor und zurück Buttons) - '''ToDo'''
** Wenn '''RMA nicht vorhanden''' (z.B. gelöscht) dann aussagekräftige Fehlermeldung) ''' ToDo '''
* Feature: '''RMA gelöscht Mail''' nur dann wenn Status 2 erreicht (also wenn schon eine Info bei Narda ankam) - '''OK'''
* '''RMA Nummern''' werden nur als gelöscht markiert bzw. eine Nummer wird nie mehrfach vergeben. - '''OK'''
* '''ACC'''
** '''PDF''' muß auch an Kunden (FE-User) gesendet werden - '''OK'''
* '''RMA löschen Bestätigung''' (JS) - '''OK'''
* SRM Auswahl der Geräte -> richtige Tabs aktiv -> bei SRM 3 Tabs "rf-cable" - '''OK'''
* E-Mail RMA Type weg, RMA Prominent oben, evtl. im Betreff - '''OK'''
* Zuerst Device Title dann SN - '''OK'''
* Umbenennungen
** Express Order -> Express Calibration Service - '''OK'''
** Factory Calibration / Repair -> ohne Warranty Request - '''OK'''
** Modification Texte 5 und 6 - '''OK'''
* F: ClientID Mode -> User mit der selben Client ID können RMAs anderer User sehen - '''ToDo'''
** Client Id als Merkmal im User - ''' ToDo '''
** Client ID muß beim abspreichern vorliegen und mit abgespeichert werden.

== Internet Präsenz Narda ==

Mischung aus verschiedenen Systemen

Hauptdomain: www.narda-sts.de

=== Content Management System ===
Frontend ist TYPO3 allerdings werden einige Download-Listen über ein php-Skript generiert.
Diese Inhalte werden über ein eigenes Tool realisiert.

=== FTP-Zugänge ===

Die Seite würd über vodafone gehostet. Vodafone der Zugriff erfolgt Zentral über
ftp.vodafone-ip.de

Im Admin Bereich von Vodafone kann man FTP Benutzer anlegen.
Der Zugriff erfolgt dann über [benutzername]%[domainname]
Also z.B. aszwei%narda-sts.de

=== Server Verwaltung ===
Hier kann man FTP Zugänge anlegen, auf phpMyAdmin zugreifen etc.
Login unter: https://webadmin.arcor.net/Secure/

=== phpMyAdmin ===
Direkt zu erreichen unter:

== Eigenes Admin System ==
Zur Verwaltung von downloads, etc.
http://www.narda-sts.de/admin/

Greift auf eine separate Datenbank zu, in der die Daten abgelegt sind.

==== Anpassen eines Software Downloads ====
Um einen Download anzupassen spielt man die Datei per FTP unterhalb des Verzeichnisses
/download/software/

Als nächstes öffnet man das Admin Tool und geht in den Menüpunkt
SoftwareUpdate (beta)
Dort kann man die Release Nummer anpassen (z.B. 2011) und aus dem Dropdownfeld die passende Datei auswählen.

==== Anlegen eines neuen Downloads ====
Hierbei muß man beachten daß in TYPO3 ein php Schnipsel eingebunden wird.
<pre>
<?php
include("fileadmin/user_upload/scripts/db_func.inc");
print (get_software_information("EFC_HF_Demo_EN"));
?>
</pre>

gibt einen Download Block inkl. Link und Beschreibung aus.
Wobei als Parameter der Name im Datenbankfeld re_call übergeben wird. Dieser wird beim Anlegen der Software manuell Vergeben

== Sales Partner Extranet ==
www.narda-sts.de/sp (oder /vp)

== RMA Garantie und Rücklaufgeräte ==
Dies wird über Vertragspartner erledigt, und es gibt ein weiteres Tool. Der User holt sich ein RMA Ticket (Online Formular) Je nach Region wird dann an den Vertriebspartner eine E-Mail versendet. Außerdem an Narda.

Auf dem Serverl liegt es im Ordner /1/RMA/

Im Quelltext sind auch etliche E-Mail Adressen hinterlegt die auf Mails zu Aichele und dem Programmierer hinweisen. Das müßte mal ausgemistet werden.

=== Kontaktdaten der Vertriebspartner ===
Diese sind in der Datenbank in der Tabelle ''' rma_requests''' hinterlegt.
Es gibt auch eine Tabelle Vertriebspartner. Ist aber nicht ganz klar wann diese benutzt werden.
Ich habe noch kein Administrationstool gefunden. Die Änderung kann aber direkt in der Datenbank erfolgen.

Edit:

Vertriebspartner in der Tabelle vertriebspartner werden vom RMA Prozess Tool (und vom neuen acc Tool) genutzt.

Es gibt außerdem eine Ausgabe der Vertriebspartner Adressen. Dabei werden über das Admin Tool (Narda Tool -> Partner Update) html Dateien geschrieben, die dann im Typo eingebunden sind. (Total umständlich). Es wird die Tabelle ??? genutzt.

=== Funktionsweise technische Realisierung (PHP-Skripte) ===
Siehe MindMap

Einstieg für den RMA Prozess ist der Link:

http://www.narda-sts.de/1/RMA/rma_select_01.php?req_art=rep_cal

In diesem Schritt wird die Länderauswahl angezeigt und die Art der Anfrege übergeben.
Nach der Länderauswahl sieht der link dann ungefähr so aus:

https://ssl.arcor-secure.de/narda-sts.de/1/RMA/rma_persData_02.php?req_art=rep_cal&req_id=P20110214_gF164223&req_reg=2

Es wird also eine req_id und req_reg Übergeben. Und die Persönlichen Daten abgefragt.

RMA/rma_reCall.php

== ACC Prozess ==
Für den ACC (Accredited Callbration) wurde das Tool komplett überarbeitet und entschlackt. Im Moment läuft es nicht auf dem Narda Server, sondern auf dem Geo-bit Server.

=== Hinweise zur Datenbank ===
Die Partner sind hier in der Tabelle Vertriebspartner hinterlegt. Sie Loggen sich mit ihrer ID und einem Passwort ein. Die Tabelle wurde ursprünglich kopiert und um einige Felder erweitert.

Es können sich nur Partner anmelden die im Feld

== Weitere Skripte ==

Es sind einige weitere Skripte im Einsatz:

=== Funktionsübersicht von Produkten ===
/doc/fileadmin/user_upload/scripts/func_overview.inc.php

Wird in Typo3 so aufgerufen:

<pre>
<?php
include("fileadmin/user_upload/scripts/func_overview.inc.php");
$config_file = "typo3conf/localconf.php";
$image_path = "fileadmin/user_upload/products/personal_protection";
$page_id = 70; // ID DER UEBERGEORDNETEN SEITE
print get_overview($page_id,$image_path,"Personal Monitor");
?>

</pre>

Funktion:

* Liest die aktuelle Sprache aus dem L Parameter oder der RealURL Adresse
* Liest die pid der untergeordneten Seiten aus.

=== Mailfunktion RMA / ACC ===
==== RMA ====
Es werden mehrere Mails generiert.

1. Schritt User Registrierung => Mail mit dem Ticket. Dieses enthält einen Link. Für die Geräteeingabe
Mailversand in '''rma_persData_02.php'''

2. Schritt Versand der RMA Daten
$html_mail_versand = send_html_mail($req_number,$req_ident_number,$req_art);
kommt aus '''mail_html_function.inc.php'''

==== ACC ====
Das Formular zur Eingabe liegt in '''acc_form.ph'''p Nach Absenden wird '''acc_form_send.php''' aufgerufen. In diesem wird die Mail über die Funktion
$success = send_acc_mail($rma_num,$arrForm,$arrPartner);
versendet. Die Funktion wird in '''lib/acal_functions.php''' zur Verfügung gestellt.
<pre>
FORMULAR MAILVERSAND / FEEDBACK
acc_form.php -> acc_form_send.php <- includes acal_functions.php (send_acc_mail)

</pre>

Extbase - Zugriff auf die fe user Tabelle

2015-10-23T18:28:12Z

87.165.0.123: /* Model für weitere Felder der fe_users erweitern */

http://wiki.zone30.info/wikizone/index.php/Extbase_Extensions_-_Snippets_und_Glossar#Auf_Daten_andererer_Modelle_.2F_Repositorys_im_Controller_zugreifen._.28verkn.C3.BCpfte_Daten_auflisten.29

http://www.derhansen.de/2012/06/zugriff-auf-frontend-user-tabelle-aus.html

http://www.derhansen.de/2012/12/typo3-extbase-mapping-existing-fields.html

== Einleitung ==
=== Wie kriege ich die Daten ===
Wir möchten die Daten der fe_users Tabelle, also die Frontenduser in unserer eigenen Extension verwenden. Extbase hat ein eigenes Domain Model und ein eigenes Repository vorbereitet um auf die Standard Felder der fe_users Tabelle zuzugreifen. Das bedeutet man kann die Daten einfach nutzen, wenn man sein eigenes Model erweitert. Ich brauche keine Getter und Setter Methoden etc. mehr. Zu definieren.
=== fe_users extended ===
Allerdings wird gerade die Tabelle fe_users oftmals von anderen Extensions um weitere Felder erweitert (z.B. sr_feuser_register). Diese Felder sind natürlich nicht im Model von extbase enthalten. Deshalb muß man sie nochmal separat behandeln. Man erweitert einfach sein eigenes Datenmodell um diese Felder. So funktioniert das ganze.

Zu guter letzt möchten wir vielleicht auch noch die fe_users um eigene Felder erweitern.

=== Hinweise ===
* Nicht verwechseln: ''$user=$GLOBALS['TSFE']->fe_user->user;'' gibt den aktuell angemeldeten User zurück.
* findAll() soll laut einem Forumseintrag nicht funktionieren. $user = $this->userRepository->findByUid($uid); schon.

== Beispiel: Einfacher Zugriff auf fe_users Daten in eigener Extension ==
Wenn man einfach nur ein paar Daten aus fe_users braucht, kann man das Standard Repository einfach injecten.
=== Übersicht ===
# fe_users-Repository per Dependency Injection zu Verfügung stellen
# Auslesen der Userdaten
# Mapping beachten

=== fe_user Tabelle Injecten ===
Im Controller deiner Extension
Ab 6.0
<syntaxhighlight lang="php">
/**
* @var \TYPO3\CMS\Extbase\Domain\Repository\FrontendUserRepository
* @inject
*/
protected $frontendUserRepository;
</syntaxhighlight>

Old School (<4.7)
<syntaxhighlight lang="php">
/**
* @var Tx_Extbase_Domain_Repository_FrontendUserRepository
*/
protected $userRepository;

/**
* Inject the user repository
*
* @param Tx_Extbase_Domain_Repository_FrontendUserRepository $userRepository
* @return void
*/
public function injectFrontendUserRepository(Tx_Extbase_Domain_Repository_FrontendUserRepository $userRepository) {
$this->userRepository = $userRepository;
}
</syntaxhighlight>

=== Userdaten holen ===
Z.B. im Controller:
$user = $this->userRepository->findByUid($uid);

=== Problem: User werden nicht ausgegeben weil record type nicht gesetzt ist ===
Hinweis: In neueren Versionen von Extbase ist das Mapping anders definiert -> nur bei alten Versionen wichtig (nicht verifiziert)

Achtung: Extbase erweitert die fe_users und fe_groups um '''das Feld tx_extbase_type (Record Type) Ist dies nicht vorhanden gibt es nichts zurück.'''
Im TypoScript definiert Extbase
<pre>
config.tx_extbase.persistence.classes {
Tx_Extbase_Domain_Model_FrontendUser {
mapping.recordType = Tx_Extbase_Domain_Model_FrontendUser
}
}
</pre>
Im Mapping ist der recordType gesetzt d.h. es sucht nur fe_user mit dem recordType Tx_Extbase_Domain_Model_FrontendUser

Lösung:
* Recordtype setzen
* oder Mapping löschen
<pre>
config.tx_extbase.persistence.classes {
Tx_Extbase_Domain_Model_FrontendUser {
mapping.recordType >
}
}
</pre>
* zusätzlich evtl. Recordtype automatisch vorbelegen -> im PageTS
<pre>
TCAdefaults.fe_users.tx_extbase_type = Tx_Extbase_Domain_Model_FrontendUser
TCAdefaults.fe_groups.tx_extbase_type = Tx_Extbase_Domain_Model_FrontendUserGroup
</pre>

== Beispiel: FE User in eigener Extension speichern ==
Am Beispiel der Extension gbrma. Der aktuell angemeldete User soll im Feld rma_user gespeichert werden. Dieses gehört zum Model 'Rma'
=== Vorgehen ===
* Feld in ext_tables.sql anlegen -> Datenbank
* Feld in TCA anlegen -> Backend
* Feld in Model anlegen und Controller bearbeiten:
** mit Getter und Setter ergänzen-> Extbase Handling
** aktuell angemeldeter User abfragen
** User speichern (in create Action)
* Templates anpassen (wird hier nicht gezeigt)
=== ext_tables.sql ===
<syntaxhighlight lang="sql">
...
rma_user int(11) unsigned DEFAULT '0' NOT NULL,
...
</syntaxhighlight>

=== TCA ===
Configuration/TCA/Rma.php
<syntaxhighlight lang="php">
...
'rma_user' => array(
'exclude' => 1,
'label' => 'LLL:EXT:gbrma/Resources/Private/Language/locallang_db.xlf:tx_gbrma_domain_model_rna.rma_user',
'config' => array(
'type' => 'select',
'items' => array (
array('',0),
),
'foreign_table' => 'fe_users',
'foreign_class' => '\TYPO3\CMS\Extbase\Domain\Model\FrontendUser',
'minitems' => 0,
'maxitems' => 1,
'size' => 1,
'appearance' => array(
'collapseAll' => 0,
'levelLinksPosition' => 'top',
'showSynchronizationLink' => 1,
'showPossibleLocalizationRecords' => 1,
'showAllLocalizationLink' => 1
),
),
),
...
</syntaxhighlight>
=== Model ===
'''Geobit\Gbrma\Domain\Model Rma.php'''
<syntaxhighlight lang="php">
...
/**
* rmaUser
*
* @var integer
*/
protected $rmaUser = 0;

...
/**
* Returns the rmaUser
*
* @return integer $rmaUser
*/
public function getRmaUser() {
return $this->rmaUser;
}

/**
* Sets the rmaUser
*
* @param integer $rmaUser
* @return void
*/
public function setRmaUser($rmaUser) {
$this->rmaUser = $rmaUser;
}
...
</syntaxhighlight>

=== Controller ===
FrontendUser Repository bereitstellen (wir erweitern das von Extbase vorbereitete FrontendUser Repository, damit stehen uns dessen Objekte zur Verfügung:

'''Geobit\Gbrma\Controller RmaController.php'''
<syntaxhighlight lang="php">
...
/**
* FrontendUser Repository
*
* @var \TYPO3\CMS\Extbase\Domain\Repository\FrontendUserRepository
* @inject
*/
protected $userRepository;
...
</syntaxhighlight>
Testen ob die fe_user jetzt zur Verfügung stehen kann man das z.B. in der List Action:
<syntaxhighlight lang="php">
$user = $this->userRepository->findByUid(1);
print \TYPO3\CMS\Extbase\Utility\DebuggerUtility::var_dump( $user );
</syntaxhighlight>
Achtung: findAll() geht nicht !

Jetzt wollen beim anlegen eines Datensatzes den aktuell angemeldeten User hinterlegen.

Auch in der Listenansicht möchten wir nur die Datensätze des aktuellen Users anzeige.

== Beispiel: Einfacher Zugriff auf fe_users Daten über ID ==
Wir möchten in unserer Extension in einem Feld die ID eines Users speichern und später auf die Daten des Users zugreifen.
Um die Daten eines Users zu nutzen müssen wir:

Einfach das bereits in der Extbase Extension vorhandene Repository in unseren Controller injecten

Controller
<syntaxhighlight lang="php">
/**
* FrontendUser Repository
*
* @var \TYPO3\CMS\Extbase\Domain\Repository\FrontendUserRepository
* @inject
*/
protected $userRepository;

//... Zugriff z.B. um das Userobjekt des aktuellen Users zu holen
/**
* Get current user obj
*
* @return \TYPO3\CMS\Extbase\Domain\Repository\FrontendUserRepository
*/
private function getCurrentUser() {
if ($GLOBALS['TSFE']->fe_user->user['uid'] > 0) {
$userId = $GLOBALS['TSFE']->fe_user->user['uid'];
$this->currentUser = $this->userRepository->findByUid($userId);
return $this->currentUser;
}else return false;
}
</syntaxhighlight>

== Beispiel: Erweitern der fe_user um eigene Felder ==
FE-users um eigene Felder erweitern (http://t3-developer.com/extbase-fluid/cheats-extbase/model/verwendung-der-fe-users-in-extbase/ 2015-06)

Soll die Tabelle FE-Users um eigene Felder erweitert werden, sind folgende Dateien anzupassen:

* '''MeineExtension/extension_tables.sql''' -> SQL Anweisung um die Tabellle FE-Users in der Datenbank um eigene Felder zu ergänzen
* '''MeineExtension/extension_tables.php''' -> Neue Felder im Backend verfügbar machen
* '''MeineExtension/Configuration/TypoScript/setup.txt''' -> Mapping der eigenen Tabellenfelder für Extbase
* '''MeineExtension/Classes/Domain/Model/MeinFeUserModel.php''' -> Objekte initialisieren und Setter/Getter setzen

In den nachfolgenden Beispiellistings wird die fe-users Tabelle um ein Textfeld "Meinfeld" ergänzt.

'''Datei: MeineExtension/extension_tables.sql'''
<syntaxhighlight lang="sql">
CREATE TABLE fe_users {
mein_feld varchar(255) DEFAULT '' NOT NULL,
};
</syntaxhighlight>

'''Datei: MeineExtension/ext_tables.php'''
<syntaxhighlight lang="php">
...
//**************************************************//
// USER | Erweiterung fe_users um Feld MeinFeld
//**************************************************//
t3lib_div::loadTCA('fe_users');
$addColumnArray = array(
'mein_feld' => array(
'exclude' => 0,
'label' => 'Feldbeschriftung:',
'config' => array(
'type' => 'input',
'size' => 20,
'eval' => 'trim',
)
),
);
t3lib_extMgm::addTCAcolumns('fe_users', $addColumnArray);
t3lib_extMgm::addToAllTCAtypes('fe_users', '--div--;NeuerReiter , mein_feld');

</syntaxhighlight>

== Beispiel: Erweiterte FE_User Felder in eigener Extension nutzen ==
Siehe auch http://www.derhansen.de/2012/12/typo3-extbase-mapping-existing-fields.html (2015-06) dort wird noch die alte Schreibweise statt der Namespace Schreibweise genutzt.

Wenn wir von anderen Extension erweiterte Felder aus fe_users nutzen, oder Felder selbst erweitern wollen, können wir nciht wie oben vorgehen und direkt in den Controller injecten. Wir müssen wir für unsere User in unserer Extension ein '''eigenes Model''' und ein '''eigenes Repository''' einbauen. Und '''dieses injecten'''. Zum Glück ist in Extbase für fe_users einiges bereitgestellt, das wir durch erweitern direkt übernehmen können.
=== Eigenes Model für die fe_user erstellen ===
In der eigenen Extension zuerst ein '''Model anlegen'''. Normalerweise wird dazu Abstract Entity erweitert und alle Felder selbst anlegen. Wir sparen uns Arbeit und '''erweitern''' diesmal das bereits von Extbase angelegte Model, somit haben wir dessen Eigenschaften bereits (kann man schön in der extbase extension im Quelltext sehen.)
<syntaxhighlight lang="php">
class RmaUser extends TYPO3\CMS\Extbase\Domain\Model\FrontendUser {

}
</syntaxhighlight>

Hinweis: Um nur die Standardfelder der fe_users zu benutzen und die Daten zu holen, brauchen wir diese Datei nicht anzulegen Siehe Beispiel oben.

=== Repository für die fe_user erstellen ===
Auch hier erweitern wir das bereits vorhandene Repository. Also statt \TYPO3\CMS\Extbase\Persistence\Repository zu erweitern. Nehmen wir:
<syntaxhighlight lang="php">
class RmaUser extends TYPO3\CMS\Extbase\Domain\Model\FrontendUser {
}
</syntaxhighlight>

=== Mapping für die fe_user Standardfelder===
Wir haben in unserer Extension jetzt das Datenmodell und die Datenrepository also das Behältnis. Extbase weiß aber noch nicht welche Tabelle es nehmen soll, wenn eine Anfrage unserer Extension kommt. Deshalb mappen wir unser Model auf die Tabelle fe_user. Das erledigen wir mit TypoScript:
<syntaxhighlight lang="typoscript">
config.tx_extbase.persistence.classes {
Geobit/Gbrma/Domain/Model/RmaUser {
mapping {
tableName = fe_users
}
}
}
</syntaxhighlight>

=== Model für weitere Felder der fe_users erweitern ===
'''Todo''' namespace schreibweise

Jetzt können wir unser Model nutzen um alle Standard Felder zu nutzen. Jetzt müssen wir aber noch Zugriff auf Felder bekommen, die z.B. andere Extensions angelegt haben. Wir legen dazu die passenden Getter und Setter in unserem Model an. Im Beispiel gehen wir von einem Feld "comment" aus, das wir nutzen wollen.

<syntaxhighlight lang="php">
class Tx_Testext1_Domain_Model_FrontendUser extends Tx_Extbase_Domain_Model_FrontendUser {

/**
* Comment
*
* @var string
*/
protected $comment;

/**
* Setter for comment
*
* @param string $comment
* @return void
*/
public function setComment ($comment) {
$this->comment = $comment;
}

/**
* Getter for comment
*
* @return string
*/
public function getComment () {
return $this->comment;
}
}
</syntaxhighlight>

=== Neues Model im Controller nutzen ===
'''Todo''' neue Namespace Schreibweise

Mittels Injection kann man das neue Model im Controller nutzen
<syntaxhighlight lang="php">
/**
* @var Tx_Testext1_Domain_Repository_FrontendUserRepository
*/
protected $userRepository;

/**
* Inject the user repository
*
* @param Tx_Testext1_Domain_Repository_FrontendUserRepository $userRepository
* @return void
*/
public function injectFrontendUserRepository (Tx_Testext1_Domain_Repository_FrontendUserRepository $userRepository) {
$this->userRepository = $userRepository;
}

/**
* Test action
*
* @return void
*/
public function testAction () {
$user = $this->userRepository->findByUid(1);
t3lib_utility_Debug::debug($user);
}
</syntaxhighlight>

=== Eigene Felder erweitern ===
Todo

== Fallstricke ==
=== SQL Exeption - falsche Tabelle ===
Hier liegt meist ein falsches Mapping vor. Je nachdem wie das UserModel erzeugt wurde muß man beim Mapping darauf achten das das Plugin Model nochmal auf die fe_users gemappt wird (und nicht das Extbase Model)
Bei ältern Typo3 Versionen wird das Mapping Setup nur in der ext_typoscript_setup.txt erkannt.

Siehe auch: http://wiki.zone30.info/wikizone/index.php/Extbase_-_Zugriff_auf_Tabellen_anderer_Extbase_Extensions#Tabelle_mappen
=== Extbase Model ab 6.0 ===
TYPO3\CMS\Extbase\Domain\Model\FrontendUser

Im Seiten TS der Rootseite habe ich folgenden Eintrag:
TCAdefaults.fe_users.tx_extbase_type = TYPO3\CMS\Extbase\Domain\Model\FrontendUser
TCAdefaults.fe_groups.tx_extbase_type = TYPO3\CMS\Extbase\Domain\Model\FrontendUserGroup

=== FE-User müssen einer Gruppe zugeordnet sein ===

Extbase - Zugriff auf die fe user Tabelle

2015-10-23T18:27:22Z

87.165.0.123: /* Neues Model im Controller nutzen */

http://wiki.zone30.info/wikizone/index.php/Extbase_Extensions_-_Snippets_und_Glossar#Auf_Daten_andererer_Modelle_.2F_Repositorys_im_Controller_zugreifen._.28verkn.C3.BCpfte_Daten_auflisten.29

http://www.derhansen.de/2012/06/zugriff-auf-frontend-user-tabelle-aus.html

http://www.derhansen.de/2012/12/typo3-extbase-mapping-existing-fields.html

== Einleitung ==
=== Wie kriege ich die Daten ===
Wir möchten die Daten der fe_users Tabelle, also die Frontenduser in unserer eigenen Extension verwenden. Extbase hat ein eigenes Domain Model und ein eigenes Repository vorbereitet um auf die Standard Felder der fe_users Tabelle zuzugreifen. Das bedeutet man kann die Daten einfach nutzen, wenn man sein eigenes Model erweitert. Ich brauche keine Getter und Setter Methoden etc. mehr. Zu definieren.
=== fe_users extended ===
Allerdings wird gerade die Tabelle fe_users oftmals von anderen Extensions um weitere Felder erweitert (z.B. sr_feuser_register). Diese Felder sind natürlich nicht im Model von extbase enthalten. Deshalb muß man sie nochmal separat behandeln. Man erweitert einfach sein eigenes Datenmodell um diese Felder. So funktioniert das ganze.

Zu guter letzt möchten wir vielleicht auch noch die fe_users um eigene Felder erweitern.

=== Hinweise ===
* Nicht verwechseln: ''$user=$GLOBALS['TSFE']->fe_user->user;'' gibt den aktuell angemeldeten User zurück.
* findAll() soll laut einem Forumseintrag nicht funktionieren. $user = $this->userRepository->findByUid($uid); schon.

== Beispiel: Einfacher Zugriff auf fe_users Daten in eigener Extension ==
Wenn man einfach nur ein paar Daten aus fe_users braucht, kann man das Standard Repository einfach injecten.
=== Übersicht ===
# fe_users-Repository per Dependency Injection zu Verfügung stellen
# Auslesen der Userdaten
# Mapping beachten

=== fe_user Tabelle Injecten ===
Im Controller deiner Extension
Ab 6.0
<syntaxhighlight lang="php">
/**
* @var \TYPO3\CMS\Extbase\Domain\Repository\FrontendUserRepository
* @inject
*/
protected $frontendUserRepository;
</syntaxhighlight>

Old School (<4.7)
<syntaxhighlight lang="php">
/**
* @var Tx_Extbase_Domain_Repository_FrontendUserRepository
*/
protected $userRepository;

/**
* Inject the user repository
*
* @param Tx_Extbase_Domain_Repository_FrontendUserRepository $userRepository
* @return void
*/
public function injectFrontendUserRepository(Tx_Extbase_Domain_Repository_FrontendUserRepository $userRepository) {
$this->userRepository = $userRepository;
}
</syntaxhighlight>

=== Userdaten holen ===
Z.B. im Controller:
$user = $this->userRepository->findByUid($uid);

=== Problem: User werden nicht ausgegeben weil record type nicht gesetzt ist ===
Hinweis: In neueren Versionen von Extbase ist das Mapping anders definiert -> nur bei alten Versionen wichtig (nicht verifiziert)

Achtung: Extbase erweitert die fe_users und fe_groups um '''das Feld tx_extbase_type (Record Type) Ist dies nicht vorhanden gibt es nichts zurück.'''
Im TypoScript definiert Extbase
<pre>
config.tx_extbase.persistence.classes {
Tx_Extbase_Domain_Model_FrontendUser {
mapping.recordType = Tx_Extbase_Domain_Model_FrontendUser
}
}
</pre>
Im Mapping ist der recordType gesetzt d.h. es sucht nur fe_user mit dem recordType Tx_Extbase_Domain_Model_FrontendUser

Lösung:
* Recordtype setzen
* oder Mapping löschen
<pre>
config.tx_extbase.persistence.classes {
Tx_Extbase_Domain_Model_FrontendUser {
mapping.recordType >
}
}
</pre>
* zusätzlich evtl. Recordtype automatisch vorbelegen -> im PageTS
<pre>
TCAdefaults.fe_users.tx_extbase_type = Tx_Extbase_Domain_Model_FrontendUser
TCAdefaults.fe_groups.tx_extbase_type = Tx_Extbase_Domain_Model_FrontendUserGroup
</pre>

== Beispiel: FE User in eigener Extension speichern ==
Am Beispiel der Extension gbrma. Der aktuell angemeldete User soll im Feld rma_user gespeichert werden. Dieses gehört zum Model 'Rma'
=== Vorgehen ===
* Feld in ext_tables.sql anlegen -> Datenbank
* Feld in TCA anlegen -> Backend
* Feld in Model anlegen und Controller bearbeiten:
** mit Getter und Setter ergänzen-> Extbase Handling
** aktuell angemeldeter User abfragen
** User speichern (in create Action)
* Templates anpassen (wird hier nicht gezeigt)
=== ext_tables.sql ===
<syntaxhighlight lang="sql">
...
rma_user int(11) unsigned DEFAULT '0' NOT NULL,
...
</syntaxhighlight>

=== TCA ===
Configuration/TCA/Rma.php
<syntaxhighlight lang="php">
...
'rma_user' => array(
'exclude' => 1,
'label' => 'LLL:EXT:gbrma/Resources/Private/Language/locallang_db.xlf:tx_gbrma_domain_model_rna.rma_user',
'config' => array(
'type' => 'select',
'items' => array (
array('',0),
),
'foreign_table' => 'fe_users',
'foreign_class' => '\TYPO3\CMS\Extbase\Domain\Model\FrontendUser',
'minitems' => 0,
'maxitems' => 1,
'size' => 1,
'appearance' => array(
'collapseAll' => 0,
'levelLinksPosition' => 'top',
'showSynchronizationLink' => 1,
'showPossibleLocalizationRecords' => 1,
'showAllLocalizationLink' => 1
),
),
),
...
</syntaxhighlight>
=== Model ===
'''Geobit\Gbrma\Domain\Model Rma.php'''
<syntaxhighlight lang="php">
...
/**
* rmaUser
*
* @var integer
*/
protected $rmaUser = 0;

...
/**
* Returns the rmaUser
*
* @return integer $rmaUser
*/
public function getRmaUser() {
return $this->rmaUser;
}

/**
* Sets the rmaUser
*
* @param integer $rmaUser
* @return void
*/
public function setRmaUser($rmaUser) {
$this->rmaUser = $rmaUser;
}
...
</syntaxhighlight>

=== Controller ===
FrontendUser Repository bereitstellen (wir erweitern das von Extbase vorbereitete FrontendUser Repository, damit stehen uns dessen Objekte zur Verfügung:

'''Geobit\Gbrma\Controller RmaController.php'''
<syntaxhighlight lang="php">
...
/**
* FrontendUser Repository
*
* @var \TYPO3\CMS\Extbase\Domain\Repository\FrontendUserRepository
* @inject
*/
protected $userRepository;
...
</syntaxhighlight>
Testen ob die fe_user jetzt zur Verfügung stehen kann man das z.B. in der List Action:
<syntaxhighlight lang="php">
$user = $this->userRepository->findByUid(1);
print \TYPO3\CMS\Extbase\Utility\DebuggerUtility::var_dump( $user );
</syntaxhighlight>
Achtung: findAll() geht nicht !

Jetzt wollen beim anlegen eines Datensatzes den aktuell angemeldeten User hinterlegen.

Auch in der Listenansicht möchten wir nur die Datensätze des aktuellen Users anzeige.

== Beispiel: Einfacher Zugriff auf fe_users Daten über ID ==
Wir möchten in unserer Extension in einem Feld die ID eines Users speichern und später auf die Daten des Users zugreifen.
Um die Daten eines Users zu nutzen müssen wir:

Einfach das bereits in der Extbase Extension vorhandene Repository in unseren Controller injecten

Controller
<syntaxhighlight lang="php">
/**
* FrontendUser Repository
*
* @var \TYPO3\CMS\Extbase\Domain\Repository\FrontendUserRepository
* @inject
*/
protected $userRepository;

//... Zugriff z.B. um das Userobjekt des aktuellen Users zu holen
/**
* Get current user obj
*
* @return \TYPO3\CMS\Extbase\Domain\Repository\FrontendUserRepository
*/
private function getCurrentUser() {
if ($GLOBALS['TSFE']->fe_user->user['uid'] > 0) {
$userId = $GLOBALS['TSFE']->fe_user->user['uid'];
$this->currentUser = $this->userRepository->findByUid($userId);
return $this->currentUser;
}else return false;
}
</syntaxhighlight>

== Beispiel: Erweitern der fe_user um eigene Felder ==
FE-users um eigene Felder erweitern (http://t3-developer.com/extbase-fluid/cheats-extbase/model/verwendung-der-fe-users-in-extbase/ 2015-06)

Soll die Tabelle FE-Users um eigene Felder erweitert werden, sind folgende Dateien anzupassen:

* '''MeineExtension/extension_tables.sql''' -> SQL Anweisung um die Tabellle FE-Users in der Datenbank um eigene Felder zu ergänzen
* '''MeineExtension/extension_tables.php''' -> Neue Felder im Backend verfügbar machen
* '''MeineExtension/Configuration/TypoScript/setup.txt''' -> Mapping der eigenen Tabellenfelder für Extbase
* '''MeineExtension/Classes/Domain/Model/MeinFeUserModel.php''' -> Objekte initialisieren und Setter/Getter setzen

In den nachfolgenden Beispiellistings wird die fe-users Tabelle um ein Textfeld "Meinfeld" ergänzt.

'''Datei: MeineExtension/extension_tables.sql'''
<syntaxhighlight lang="sql">
CREATE TABLE fe_users {
mein_feld varchar(255) DEFAULT '' NOT NULL,
};
</syntaxhighlight>

'''Datei: MeineExtension/ext_tables.php'''
<syntaxhighlight lang="php">
...
//**************************************************//
// USER | Erweiterung fe_users um Feld MeinFeld
//**************************************************//
t3lib_div::loadTCA('fe_users');
$addColumnArray = array(
'mein_feld' => array(
'exclude' => 0,
'label' => 'Feldbeschriftung:',
'config' => array(
'type' => 'input',
'size' => 20,
'eval' => 'trim',
)
),
);
t3lib_extMgm::addTCAcolumns('fe_users', $addColumnArray);
t3lib_extMgm::addToAllTCAtypes('fe_users', '--div--;NeuerReiter , mein_feld');

</syntaxhighlight>

== Beispiel: Erweiterte FE_User Felder in eigener Extension nutzen ==
Siehe auch http://www.derhansen.de/2012/12/typo3-extbase-mapping-existing-fields.html (2015-06) dort wird noch die alte Schreibweise statt der Namespace Schreibweise genutzt.

Wenn wir von anderen Extension erweiterte Felder aus fe_users nutzen, oder Felder selbst erweitern wollen, können wir nciht wie oben vorgehen und direkt in den Controller injecten. Wir müssen wir für unsere User in unserer Extension ein '''eigenes Model''' und ein '''eigenes Repository''' einbauen. Und '''dieses injecten'''. Zum Glück ist in Extbase für fe_users einiges bereitgestellt, das wir durch erweitern direkt übernehmen können.
=== Eigenes Model für die fe_user erstellen ===
In der eigenen Extension zuerst ein '''Model anlegen'''. Normalerweise wird dazu Abstract Entity erweitert und alle Felder selbst anlegen. Wir sparen uns Arbeit und '''erweitern''' diesmal das bereits von Extbase angelegte Model, somit haben wir dessen Eigenschaften bereits (kann man schön in der extbase extension im Quelltext sehen.)
<syntaxhighlight lang="php">
class RmaUser extends TYPO3\CMS\Extbase\Domain\Model\FrontendUser {

}
</syntaxhighlight>

Hinweis: Um nur die Standardfelder der fe_users zu benutzen und die Daten zu holen, brauchen wir diese Datei nicht anzulegen Siehe Beispiel oben.

=== Repository für die fe_user erstellen ===
Auch hier erweitern wir das bereits vorhandene Repository. Also statt \TYPO3\CMS\Extbase\Persistence\Repository zu erweitern. Nehmen wir:
<syntaxhighlight lang="php">
class RmaUser extends TYPO3\CMS\Extbase\Domain\Model\FrontendUser {
}
</syntaxhighlight>

=== Mapping für die fe_user Standardfelder===
Wir haben in unserer Extension jetzt das Datenmodell und die Datenrepository also das Behältnis. Extbase weiß aber noch nicht welche Tabelle es nehmen soll, wenn eine Anfrage unserer Extension kommt. Deshalb mappen wir unser Model auf die Tabelle fe_user. Das erledigen wir mit TypoScript:
<syntaxhighlight lang="typoscript">
config.tx_extbase.persistence.classes {
Geobit/Gbrma/Domain/Model/RmaUser {
mapping {
tableName = fe_users
}
}
}
</syntaxhighlight>

=== Model für weitere Felder der fe_users erweitern ===
Jetzt können wir unser Model nutzen um alle Standard Felder zu nutzen. Jetzt müssen wir aber noch Zugriff auf Felder bekommen, die z.B. andere Extensions angelegt haben. Wir legen dazu die passenden Getter und Setter in unserem Model an. Im Beispiel gehen wir von einem Feld "comment" aus, das wir nutzen wollen.

<syntaxhighlight lang="php">
class Tx_Testext1_Domain_Model_FrontendUser extends Tx_Extbase_Domain_Model_FrontendUser {

/**
* Comment
*
* @var string
*/
protected $comment;

/**
* Setter for comment
*
* @param string $comment
* @return void
*/
public function setComment ($comment) {
$this->comment = $comment;
}

/**
* Getter for comment
*
* @return string
*/
public function getComment () {
return $this->comment;
}
}
</syntaxhighlight>

=== Neues Model im Controller nutzen ===
'''Todo''' neue Namespace Schreibweise

Mittels Injection kann man das neue Model im Controller nutzen
<syntaxhighlight lang="php">
/**
* @var Tx_Testext1_Domain_Repository_FrontendUserRepository
*/
protected $userRepository;

/**
* Inject the user repository
*
* @param Tx_Testext1_Domain_Repository_FrontendUserRepository $userRepository
* @return void
*/
public function injectFrontendUserRepository (Tx_Testext1_Domain_Repository_FrontendUserRepository $userRepository) {
$this->userRepository = $userRepository;
}

/**
* Test action
*
* @return void
*/
public function testAction () {
$user = $this->userRepository->findByUid(1);
t3lib_utility_Debug::debug($user);
}
</syntaxhighlight>

=== Eigene Felder erweitern ===
Todo

== Fallstricke ==
=== SQL Exeption - falsche Tabelle ===
Hier liegt meist ein falsches Mapping vor. Je nachdem wie das UserModel erzeugt wurde muß man beim Mapping darauf achten das das Plugin Model nochmal auf die fe_users gemappt wird (und nicht das Extbase Model)
Bei ältern Typo3 Versionen wird das Mapping Setup nur in der ext_typoscript_setup.txt erkannt.

Siehe auch: http://wiki.zone30.info/wikizone/index.php/Extbase_-_Zugriff_auf_Tabellen_anderer_Extbase_Extensions#Tabelle_mappen
=== Extbase Model ab 6.0 ===
TYPO3\CMS\Extbase\Domain\Model\FrontendUser

Im Seiten TS der Rootseite habe ich folgenden Eintrag:
TCAdefaults.fe_users.tx_extbase_type = TYPO3\CMS\Extbase\Domain\Model\FrontendUser
TCAdefaults.fe_groups.tx_extbase_type = TYPO3\CMS\Extbase\Domain\Model\FrontendUserGroup

=== FE-User müssen einer Gruppe zugeordnet sein ===

Extbase - Zugriff auf die fe user Tabelle

2015-10-23T18:26:42Z

87.165.0.123: /* Beispiel: Erweiterte FE_User Felder in eigener Extension nutzen */

http://wiki.zone30.info/wikizone/index.php/Extbase_Extensions_-_Snippets_und_Glossar#Auf_Daten_andererer_Modelle_.2F_Repositorys_im_Controller_zugreifen._.28verkn.C3.BCpfte_Daten_auflisten.29

http://www.derhansen.de/2012/06/zugriff-auf-frontend-user-tabelle-aus.html

http://www.derhansen.de/2012/12/typo3-extbase-mapping-existing-fields.html

== Einleitung ==
=== Wie kriege ich die Daten ===
Wir möchten die Daten der fe_users Tabelle, also die Frontenduser in unserer eigenen Extension verwenden. Extbase hat ein eigenes Domain Model und ein eigenes Repository vorbereitet um auf die Standard Felder der fe_users Tabelle zuzugreifen. Das bedeutet man kann die Daten einfach nutzen, wenn man sein eigenes Model erweitert. Ich brauche keine Getter und Setter Methoden etc. mehr. Zu definieren.
=== fe_users extended ===
Allerdings wird gerade die Tabelle fe_users oftmals von anderen Extensions um weitere Felder erweitert (z.B. sr_feuser_register). Diese Felder sind natürlich nicht im Model von extbase enthalten. Deshalb muß man sie nochmal separat behandeln. Man erweitert einfach sein eigenes Datenmodell um diese Felder. So funktioniert das ganze.

Zu guter letzt möchten wir vielleicht auch noch die fe_users um eigene Felder erweitern.

=== Hinweise ===
* Nicht verwechseln: ''$user=$GLOBALS['TSFE']->fe_user->user;'' gibt den aktuell angemeldeten User zurück.
* findAll() soll laut einem Forumseintrag nicht funktionieren. $user = $this->userRepository->findByUid($uid); schon.

== Beispiel: Einfacher Zugriff auf fe_users Daten in eigener Extension ==
Wenn man einfach nur ein paar Daten aus fe_users braucht, kann man das Standard Repository einfach injecten.
=== Übersicht ===
# fe_users-Repository per Dependency Injection zu Verfügung stellen
# Auslesen der Userdaten
# Mapping beachten

=== fe_user Tabelle Injecten ===
Im Controller deiner Extension
Ab 6.0
<syntaxhighlight lang="php">
/**
* @var \TYPO3\CMS\Extbase\Domain\Repository\FrontendUserRepository
* @inject
*/
protected $frontendUserRepository;
</syntaxhighlight>

Old School (<4.7)
<syntaxhighlight lang="php">
/**
* @var Tx_Extbase_Domain_Repository_FrontendUserRepository
*/
protected $userRepository;

/**
* Inject the user repository
*
* @param Tx_Extbase_Domain_Repository_FrontendUserRepository $userRepository
* @return void
*/
public function injectFrontendUserRepository(Tx_Extbase_Domain_Repository_FrontendUserRepository $userRepository) {
$this->userRepository = $userRepository;
}
</syntaxhighlight>

=== Userdaten holen ===
Z.B. im Controller:
$user = $this->userRepository->findByUid($uid);

=== Problem: User werden nicht ausgegeben weil record type nicht gesetzt ist ===
Hinweis: In neueren Versionen von Extbase ist das Mapping anders definiert -> nur bei alten Versionen wichtig (nicht verifiziert)

Achtung: Extbase erweitert die fe_users und fe_groups um '''das Feld tx_extbase_type (Record Type) Ist dies nicht vorhanden gibt es nichts zurück.'''
Im TypoScript definiert Extbase
<pre>
config.tx_extbase.persistence.classes {
Tx_Extbase_Domain_Model_FrontendUser {
mapping.recordType = Tx_Extbase_Domain_Model_FrontendUser
}
}
</pre>
Im Mapping ist der recordType gesetzt d.h. es sucht nur fe_user mit dem recordType Tx_Extbase_Domain_Model_FrontendUser

Lösung:
* Recordtype setzen
* oder Mapping löschen
<pre>
config.tx_extbase.persistence.classes {
Tx_Extbase_Domain_Model_FrontendUser {
mapping.recordType >
}
}
</pre>
* zusätzlich evtl. Recordtype automatisch vorbelegen -> im PageTS
<pre>
TCAdefaults.fe_users.tx_extbase_type = Tx_Extbase_Domain_Model_FrontendUser
TCAdefaults.fe_groups.tx_extbase_type = Tx_Extbase_Domain_Model_FrontendUserGroup
</pre>

== Beispiel: FE User in eigener Extension speichern ==
Am Beispiel der Extension gbrma. Der aktuell angemeldete User soll im Feld rma_user gespeichert werden. Dieses gehört zum Model 'Rma'
=== Vorgehen ===
* Feld in ext_tables.sql anlegen -> Datenbank
* Feld in TCA anlegen -> Backend
* Feld in Model anlegen und Controller bearbeiten:
** mit Getter und Setter ergänzen-> Extbase Handling
** aktuell angemeldeter User abfragen
** User speichern (in create Action)
* Templates anpassen (wird hier nicht gezeigt)
=== ext_tables.sql ===
<syntaxhighlight lang="sql">
...
rma_user int(11) unsigned DEFAULT '0' NOT NULL,
...
</syntaxhighlight>

=== TCA ===
Configuration/TCA/Rma.php
<syntaxhighlight lang="php">
...
'rma_user' => array(
'exclude' => 1,
'label' => 'LLL:EXT:gbrma/Resources/Private/Language/locallang_db.xlf:tx_gbrma_domain_model_rna.rma_user',
'config' => array(
'type' => 'select',
'items' => array (
array('',0),
),
'foreign_table' => 'fe_users',
'foreign_class' => '\TYPO3\CMS\Extbase\Domain\Model\FrontendUser',
'minitems' => 0,
'maxitems' => 1,
'size' => 1,
'appearance' => array(
'collapseAll' => 0,
'levelLinksPosition' => 'top',
'showSynchronizationLink' => 1,
'showPossibleLocalizationRecords' => 1,
'showAllLocalizationLink' => 1
),
),
),
...
</syntaxhighlight>
=== Model ===
'''Geobit\Gbrma\Domain\Model Rma.php'''
<syntaxhighlight lang="php">
...
/**
* rmaUser
*
* @var integer
*/
protected $rmaUser = 0;

...
/**
* Returns the rmaUser
*
* @return integer $rmaUser
*/
public function getRmaUser() {
return $this->rmaUser;
}

/**
* Sets the rmaUser
*
* @param integer $rmaUser
* @return void
*/
public function setRmaUser($rmaUser) {
$this->rmaUser = $rmaUser;
}
...
</syntaxhighlight>

=== Controller ===
FrontendUser Repository bereitstellen (wir erweitern das von Extbase vorbereitete FrontendUser Repository, damit stehen uns dessen Objekte zur Verfügung:

'''Geobit\Gbrma\Controller RmaController.php'''
<syntaxhighlight lang="php">
...
/**
* FrontendUser Repository
*
* @var \TYPO3\CMS\Extbase\Domain\Repository\FrontendUserRepository
* @inject
*/
protected $userRepository;
...
</syntaxhighlight>
Testen ob die fe_user jetzt zur Verfügung stehen kann man das z.B. in der List Action:
<syntaxhighlight lang="php">
$user = $this->userRepository->findByUid(1);
print \TYPO3\CMS\Extbase\Utility\DebuggerUtility::var_dump( $user );
</syntaxhighlight>
Achtung: findAll() geht nicht !

Jetzt wollen beim anlegen eines Datensatzes den aktuell angemeldeten User hinterlegen.

Auch in der Listenansicht möchten wir nur die Datensätze des aktuellen Users anzeige.

== Beispiel: Einfacher Zugriff auf fe_users Daten über ID ==
Wir möchten in unserer Extension in einem Feld die ID eines Users speichern und später auf die Daten des Users zugreifen.
Um die Daten eines Users zu nutzen müssen wir:

Einfach das bereits in der Extbase Extension vorhandene Repository in unseren Controller injecten

Controller
<syntaxhighlight lang="php">
/**
* FrontendUser Repository
*
* @var \TYPO3\CMS\Extbase\Domain\Repository\FrontendUserRepository
* @inject
*/
protected $userRepository;

//... Zugriff z.B. um das Userobjekt des aktuellen Users zu holen
/**
* Get current user obj
*
* @return \TYPO3\CMS\Extbase\Domain\Repository\FrontendUserRepository
*/
private function getCurrentUser() {
if ($GLOBALS['TSFE']->fe_user->user['uid'] > 0) {
$userId = $GLOBALS['TSFE']->fe_user->user['uid'];
$this->currentUser = $this->userRepository->findByUid($userId);
return $this->currentUser;
}else return false;
}
</syntaxhighlight>

== Beispiel: Erweitern der fe_user um eigene Felder ==
FE-users um eigene Felder erweitern (http://t3-developer.com/extbase-fluid/cheats-extbase/model/verwendung-der-fe-users-in-extbase/ 2015-06)

Soll die Tabelle FE-Users um eigene Felder erweitert werden, sind folgende Dateien anzupassen:

* '''MeineExtension/extension_tables.sql''' -> SQL Anweisung um die Tabellle FE-Users in der Datenbank um eigene Felder zu ergänzen
* '''MeineExtension/extension_tables.php''' -> Neue Felder im Backend verfügbar machen
* '''MeineExtension/Configuration/TypoScript/setup.txt''' -> Mapping der eigenen Tabellenfelder für Extbase
* '''MeineExtension/Classes/Domain/Model/MeinFeUserModel.php''' -> Objekte initialisieren und Setter/Getter setzen

In den nachfolgenden Beispiellistings wird die fe-users Tabelle um ein Textfeld "Meinfeld" ergänzt.

'''Datei: MeineExtension/extension_tables.sql'''
<syntaxhighlight lang="sql">
CREATE TABLE fe_users {
mein_feld varchar(255) DEFAULT '' NOT NULL,
};
</syntaxhighlight>

'''Datei: MeineExtension/ext_tables.php'''
<syntaxhighlight lang="php">
...
//**************************************************//
// USER | Erweiterung fe_users um Feld MeinFeld
//**************************************************//
t3lib_div::loadTCA('fe_users');
$addColumnArray = array(
'mein_feld' => array(
'exclude' => 0,
'label' => 'Feldbeschriftung:',
'config' => array(
'type' => 'input',
'size' => 20,
'eval' => 'trim',
)
),
);
t3lib_extMgm::addTCAcolumns('fe_users', $addColumnArray);
t3lib_extMgm::addToAllTCAtypes('fe_users', '--div--;NeuerReiter , mein_feld');

</syntaxhighlight>

== Beispiel: Erweiterte FE_User Felder in eigener Extension nutzen ==
Siehe auch http://www.derhansen.de/2012/12/typo3-extbase-mapping-existing-fields.html (2015-06) dort wird noch die alte Schreibweise statt der Namespace Schreibweise genutzt.

Wenn wir von anderen Extension erweiterte Felder aus fe_users nutzen, oder Felder selbst erweitern wollen, können wir nciht wie oben vorgehen und direkt in den Controller injecten. Wir müssen wir für unsere User in unserer Extension ein '''eigenes Model''' und ein '''eigenes Repository''' einbauen. Und '''dieses injecten'''. Zum Glück ist in Extbase für fe_users einiges bereitgestellt, das wir durch erweitern direkt übernehmen können.
=== Eigenes Model für die fe_user erstellen ===
In der eigenen Extension zuerst ein '''Model anlegen'''. Normalerweise wird dazu Abstract Entity erweitert und alle Felder selbst anlegen. Wir sparen uns Arbeit und '''erweitern''' diesmal das bereits von Extbase angelegte Model, somit haben wir dessen Eigenschaften bereits (kann man schön in der extbase extension im Quelltext sehen.)
<syntaxhighlight lang="php">
class RmaUser extends TYPO3\CMS\Extbase\Domain\Model\FrontendUser {

}
</syntaxhighlight>

Hinweis: Um nur die Standardfelder der fe_users zu benutzen und die Daten zu holen, brauchen wir diese Datei nicht anzulegen Siehe Beispiel oben.

=== Repository für die fe_user erstellen ===
Auch hier erweitern wir das bereits vorhandene Repository. Also statt \TYPO3\CMS\Extbase\Persistence\Repository zu erweitern. Nehmen wir:
<syntaxhighlight lang="php">
class RmaUser extends TYPO3\CMS\Extbase\Domain\Model\FrontendUser {
}
</syntaxhighlight>

=== Mapping für die fe_user Standardfelder===
Wir haben in unserer Extension jetzt das Datenmodell und die Datenrepository also das Behältnis. Extbase weiß aber noch nicht welche Tabelle es nehmen soll, wenn eine Anfrage unserer Extension kommt. Deshalb mappen wir unser Model auf die Tabelle fe_user. Das erledigen wir mit TypoScript:
<syntaxhighlight lang="typoscript">
config.tx_extbase.persistence.classes {
Geobit/Gbrma/Domain/Model/RmaUser {
mapping {
tableName = fe_users
}
}
}
</syntaxhighlight>

=== Model für weitere Felder der fe_users erweitern ===
Jetzt können wir unser Model nutzen um alle Standard Felder zu nutzen. Jetzt müssen wir aber noch Zugriff auf Felder bekommen, die z.B. andere Extensions angelegt haben. Wir legen dazu die passenden Getter und Setter in unserem Model an. Im Beispiel gehen wir von einem Feld "comment" aus, das wir nutzen wollen.

<syntaxhighlight lang="php">
class Tx_Testext1_Domain_Model_FrontendUser extends Tx_Extbase_Domain_Model_FrontendUser {

/**
* Comment
*
* @var string
*/
protected $comment;

/**
* Setter for comment
*
* @param string $comment
* @return void
*/
public function setComment ($comment) {
$this->comment = $comment;
}

/**
* Getter for comment
*
* @return string
*/
public function getComment () {
return $this->comment;
}
}
</syntaxhighlight>

=== Neues Model im Controller nutzen ===
Mittels Injection kann man das neue Model im Controller nutzen
<syntaxhighlight lang="php">
/**
* @var Tx_Testext1_Domain_Repository_FrontendUserRepository
*/
protected $userRepository;

/**
* Inject the user repository
*
* @param Tx_Testext1_Domain_Repository_FrontendUserRepository $userRepository
* @return void
*/
public function injectFrontendUserRepository (Tx_Testext1_Domain_Repository_FrontendUserRepository $userRepository) {
$this->userRepository = $userRepository;
}

/**
* Test action
*
* @return void
*/
public function testAction () {
$user = $this->userRepository->findByUid(1);
t3lib_utility_Debug::debug($user);
}
</syntaxhighlight>
=== Eigene Felder erweitern ===
Todo

== Fallstricke ==
=== SQL Exeption - falsche Tabelle ===
Hier liegt meist ein falsches Mapping vor. Je nachdem wie das UserModel erzeugt wurde muß man beim Mapping darauf achten das das Plugin Model nochmal auf die fe_users gemappt wird (und nicht das Extbase Model)
Bei ältern Typo3 Versionen wird das Mapping Setup nur in der ext_typoscript_setup.txt erkannt.

Siehe auch: http://wiki.zone30.info/wikizone/index.php/Extbase_-_Zugriff_auf_Tabellen_anderer_Extbase_Extensions#Tabelle_mappen
=== Extbase Model ab 6.0 ===
TYPO3\CMS\Extbase\Domain\Model\FrontendUser

Im Seiten TS der Rootseite habe ich folgenden Eintrag:
TCAdefaults.fe_users.tx_extbase_type = TYPO3\CMS\Extbase\Domain\Model\FrontendUser
TCAdefaults.fe_groups.tx_extbase_type = TYPO3\CMS\Extbase\Domain\Model\FrontendUserGroup

=== FE-User müssen einer Gruppe zugeordnet sein ===

Extbase - Zugriff auf die fe user Tabelle

2015-10-23T18:23:33Z

87.165.0.123: /* Beispiel: Erweiterte FE_User Felder in eigener Extension nutzen */

http://wiki.zone30.info/wikizone/index.php/Extbase_Extensions_-_Snippets_und_Glossar#Auf_Daten_andererer_Modelle_.2F_Repositorys_im_Controller_zugreifen._.28verkn.C3.BCpfte_Daten_auflisten.29

http://www.derhansen.de/2012/06/zugriff-auf-frontend-user-tabelle-aus.html

http://www.derhansen.de/2012/12/typo3-extbase-mapping-existing-fields.html

== Einleitung ==
=== Wie kriege ich die Daten ===
Wir möchten die Daten der fe_users Tabelle, also die Frontenduser in unserer eigenen Extension verwenden. Extbase hat ein eigenes Domain Model und ein eigenes Repository vorbereitet um auf die Standard Felder der fe_users Tabelle zuzugreifen. Das bedeutet man kann die Daten einfach nutzen, wenn man sein eigenes Model erweitert. Ich brauche keine Getter und Setter Methoden etc. mehr. Zu definieren.
=== fe_users extended ===
Allerdings wird gerade die Tabelle fe_users oftmals von anderen Extensions um weitere Felder erweitert (z.B. sr_feuser_register). Diese Felder sind natürlich nicht im Model von extbase enthalten. Deshalb muß man sie nochmal separat behandeln. Man erweitert einfach sein eigenes Datenmodell um diese Felder. So funktioniert das ganze.

Zu guter letzt möchten wir vielleicht auch noch die fe_users um eigene Felder erweitern.

=== Hinweise ===
* Nicht verwechseln: ''$user=$GLOBALS['TSFE']->fe_user->user;'' gibt den aktuell angemeldeten User zurück.
* findAll() soll laut einem Forumseintrag nicht funktionieren. $user = $this->userRepository->findByUid($uid); schon.

== Beispiel: Einfacher Zugriff auf fe_users Daten in eigener Extension ==
Wenn man einfach nur ein paar Daten aus fe_users braucht, kann man das Standard Repository einfach injecten.
=== Übersicht ===
# fe_users-Repository per Dependency Injection zu Verfügung stellen
# Auslesen der Userdaten
# Mapping beachten

=== fe_user Tabelle Injecten ===
Im Controller deiner Extension
Ab 6.0
<syntaxhighlight lang="php">
/**
* @var \TYPO3\CMS\Extbase\Domain\Repository\FrontendUserRepository
* @inject
*/
protected $frontendUserRepository;
</syntaxhighlight>

Old School (<4.7)
<syntaxhighlight lang="php">
/**
* @var Tx_Extbase_Domain_Repository_FrontendUserRepository
*/
protected $userRepository;

/**
* Inject the user repository
*
* @param Tx_Extbase_Domain_Repository_FrontendUserRepository $userRepository
* @return void
*/
public function injectFrontendUserRepository(Tx_Extbase_Domain_Repository_FrontendUserRepository $userRepository) {
$this->userRepository = $userRepository;
}
</syntaxhighlight>

=== Userdaten holen ===
Z.B. im Controller:
$user = $this->userRepository->findByUid($uid);

=== Problem: User werden nicht ausgegeben weil record type nicht gesetzt ist ===
Hinweis: In neueren Versionen von Extbase ist das Mapping anders definiert -> nur bei alten Versionen wichtig (nicht verifiziert)

Achtung: Extbase erweitert die fe_users und fe_groups um '''das Feld tx_extbase_type (Record Type) Ist dies nicht vorhanden gibt es nichts zurück.'''
Im TypoScript definiert Extbase
<pre>
config.tx_extbase.persistence.classes {
Tx_Extbase_Domain_Model_FrontendUser {
mapping.recordType = Tx_Extbase_Domain_Model_FrontendUser
}
}
</pre>
Im Mapping ist der recordType gesetzt d.h. es sucht nur fe_user mit dem recordType Tx_Extbase_Domain_Model_FrontendUser

Lösung:
* Recordtype setzen
* oder Mapping löschen
<pre>
config.tx_extbase.persistence.classes {
Tx_Extbase_Domain_Model_FrontendUser {
mapping.recordType >
}
}
</pre>
* zusätzlich evtl. Recordtype automatisch vorbelegen -> im PageTS
<pre>
TCAdefaults.fe_users.tx_extbase_type = Tx_Extbase_Domain_Model_FrontendUser
TCAdefaults.fe_groups.tx_extbase_type = Tx_Extbase_Domain_Model_FrontendUserGroup
</pre>

== Beispiel: FE User in eigener Extension speichern ==
Am Beispiel der Extension gbrma. Der aktuell angemeldete User soll im Feld rma_user gespeichert werden. Dieses gehört zum Model 'Rma'
=== Vorgehen ===
* Feld in ext_tables.sql anlegen -> Datenbank
* Feld in TCA anlegen -> Backend
* Feld in Model anlegen und Controller bearbeiten:
** mit Getter und Setter ergänzen-> Extbase Handling
** aktuell angemeldeter User abfragen
** User speichern (in create Action)
* Templates anpassen (wird hier nicht gezeigt)
=== ext_tables.sql ===
<syntaxhighlight lang="sql">
...
rma_user int(11) unsigned DEFAULT '0' NOT NULL,
...
</syntaxhighlight>

=== TCA ===
Configuration/TCA/Rma.php
<syntaxhighlight lang="php">
...
'rma_user' => array(
'exclude' => 1,
'label' => 'LLL:EXT:gbrma/Resources/Private/Language/locallang_db.xlf:tx_gbrma_domain_model_rna.rma_user',
'config' => array(
'type' => 'select',
'items' => array (
array('',0),
),
'foreign_table' => 'fe_users',
'foreign_class' => '\TYPO3\CMS\Extbase\Domain\Model\FrontendUser',
'minitems' => 0,
'maxitems' => 1,
'size' => 1,
'appearance' => array(
'collapseAll' => 0,
'levelLinksPosition' => 'top',
'showSynchronizationLink' => 1,
'showPossibleLocalizationRecords' => 1,
'showAllLocalizationLink' => 1
),
),
),
...
</syntaxhighlight>
=== Model ===
'''Geobit\Gbrma\Domain\Model Rma.php'''
<syntaxhighlight lang="php">
...
/**
* rmaUser
*
* @var integer
*/
protected $rmaUser = 0;

...
/**
* Returns the rmaUser
*
* @return integer $rmaUser
*/
public function getRmaUser() {
return $this->rmaUser;
}

/**
* Sets the rmaUser
*
* @param integer $rmaUser
* @return void
*/
public function setRmaUser($rmaUser) {
$this->rmaUser = $rmaUser;
}
...
</syntaxhighlight>

=== Controller ===
FrontendUser Repository bereitstellen (wir erweitern das von Extbase vorbereitete FrontendUser Repository, damit stehen uns dessen Objekte zur Verfügung:

'''Geobit\Gbrma\Controller RmaController.php'''
<syntaxhighlight lang="php">
...
/**
* FrontendUser Repository
*
* @var \TYPO3\CMS\Extbase\Domain\Repository\FrontendUserRepository
* @inject
*/
protected $userRepository;
...
</syntaxhighlight>
Testen ob die fe_user jetzt zur Verfügung stehen kann man das z.B. in der List Action:
<syntaxhighlight lang="php">
$user = $this->userRepository->findByUid(1);
print \TYPO3\CMS\Extbase\Utility\DebuggerUtility::var_dump( $user );
</syntaxhighlight>
Achtung: findAll() geht nicht !

Jetzt wollen beim anlegen eines Datensatzes den aktuell angemeldeten User hinterlegen.

Auch in der Listenansicht möchten wir nur die Datensätze des aktuellen Users anzeige.

== Beispiel: Einfacher Zugriff auf fe_users Daten über ID ==
Wir möchten in unserer Extension in einem Feld die ID eines Users speichern und später auf die Daten des Users zugreifen.
Um die Daten eines Users zu nutzen müssen wir:

Einfach das bereits in der Extbase Extension vorhandene Repository in unseren Controller injecten

Controller
<syntaxhighlight lang="php">
/**
* FrontendUser Repository
*
* @var \TYPO3\CMS\Extbase\Domain\Repository\FrontendUserRepository
* @inject
*/
protected $userRepository;

//... Zugriff z.B. um das Userobjekt des aktuellen Users zu holen
/**
* Get current user obj
*
* @return \TYPO3\CMS\Extbase\Domain\Repository\FrontendUserRepository
*/
private function getCurrentUser() {
if ($GLOBALS['TSFE']->fe_user->user['uid'] > 0) {
$userId = $GLOBALS['TSFE']->fe_user->user['uid'];
$this->currentUser = $this->userRepository->findByUid($userId);
return $this->currentUser;
}else return false;
}
</syntaxhighlight>

== Beispiel: Erweitern der fe_user um eigene Felder ==
FE-users um eigene Felder erweitern (http://t3-developer.com/extbase-fluid/cheats-extbase/model/verwendung-der-fe-users-in-extbase/ 2015-06)

Soll die Tabelle FE-Users um eigene Felder erweitert werden, sind folgende Dateien anzupassen:

* '''MeineExtension/extension_tables.sql''' -> SQL Anweisung um die Tabellle FE-Users in der Datenbank um eigene Felder zu ergänzen
* '''MeineExtension/extension_tables.php''' -> Neue Felder im Backend verfügbar machen
* '''MeineExtension/Configuration/TypoScript/setup.txt''' -> Mapping der eigenen Tabellenfelder für Extbase
* '''MeineExtension/Classes/Domain/Model/MeinFeUserModel.php''' -> Objekte initialisieren und Setter/Getter setzen

In den nachfolgenden Beispiellistings wird die fe-users Tabelle um ein Textfeld "Meinfeld" ergänzt.

'''Datei: MeineExtension/extension_tables.sql'''
<syntaxhighlight lang="sql">
CREATE TABLE fe_users {
mein_feld varchar(255) DEFAULT '' NOT NULL,
};
</syntaxhighlight>

'''Datei: MeineExtension/ext_tables.php'''
<syntaxhighlight lang="php">
...
//**************************************************//
// USER | Erweiterung fe_users um Feld MeinFeld
//**************************************************//
t3lib_div::loadTCA('fe_users');
$addColumnArray = array(
'mein_feld' => array(
'exclude' => 0,
'label' => 'Feldbeschriftung:',
'config' => array(
'type' => 'input',
'size' => 20,
'eval' => 'trim',
)
),
);
t3lib_extMgm::addTCAcolumns('fe_users', $addColumnArray);
t3lib_extMgm::addToAllTCAtypes('fe_users', '--div--;NeuerReiter , mein_feld');

</syntaxhighlight>

== Beispiel: Erweiterte FE_User Felder in eigener Extension nutzen ==
Siehe auch http://www.derhansen.de/2012/12/typo3-extbase-mapping-existing-fields.html (2015-06) dort wird noch die alte Schreibweise statt der Namespace Schreibweise genutzt.

Wenn wir von anderen Extension erweiterte Felder aus fe_users nutzen, oder Felder selbst erweitern wollen, können wir nciht wie oben vorgehen und direkt in den Controller injecten. Wir müssen wir für unsere User in unserer Extension ein '''eigenes Model''' und ein '''eigenes Repository''' einbauen. Und '''dieses injecten'''. Zum Glück ist in Extbase für fe_users einiges bereitgestellt, das wir durch erweitern direkt übernehmen können.
=== Eigenes Model für die fe_user ===
In der eigenen Extension zuerst ein '''Model anlegen'''. Normalerweise wird dazu Abstract Entity erweitert und alle Felder selbst anlegen. Wir sparen uns Arbeit und '''erweitern''' diesmal das bereits von Extbase angelegte Model, somit haben wir dessen Eigenschaften bereits (kann man schön in der extbase extension im Quelltext sehen.)
<syntaxhighlight lang="php">
class RmaUser extends TYPO3\CMS\Extbase\Domain\Model\FrontendUser {

}
</syntaxhighlight>

Hinweis: Um nur die Standardfelder der fe_users zu benutzen und die Daten zu holen, brauchen wir diese Datei nicht anzulegen Siehe Beispiel oben.

=== Repository für die fe_user ===
Auch hier erweitern wir das bereits vorhandene Repository. Also statt \TYPO3\CMS\Extbase\Persistence\Repository zu erweitern. Nehmen wir:
<syntaxhighlight lang="php">
class RmaUser extends TYPO3\CMS\Extbase\Domain\Model\FrontendUser {
}
</syntaxhighlight>

=== Mapping für die fe_user ===
Wir haben in unserer Extension jetzt das Datenmodell und die Datenrepository also das Behältnis. Extbase weiß aber noch nicht welche Tabelle es nehmen soll, wenn eine Anfrage unserer Extension kommt. Deshalb mappen wir unser Model auf die Tabelle fe_user. Das erledigen wir mit TypoScript:
<syntaxhighlight lang="typoscript">
config.tx_extbase.persistence.classes {
Geobit/Gbrma/Domain/Model/RmaUser {
mapping {
tableName = fe_users
}
}
}
</syntaxhighlight>

=== Erweiterte Felder der fe_users nutzen ===
Jetzt können wir unser Model nutzen um alle Standard Felder zu nutzen. Jetzt müssen wir aber noch Zugriff auf Felder bekommen, die z.B. andere Extensions angelegt haben. Wir legen dazu die passenden Getter und Setter in unserem Model an. Im Beispiel gehen wir von einem Feld "comment" aus, das wir nutzen wollen.

<syntaxhighlight lang="php">
class Tx_Testext1_Domain_Model_FrontendUser extends Tx_Extbase_Domain_Model_FrontendUser {

/**
* Comment
*
* @var string
*/
protected $comment;

/**
* Setter for comment
*
* @param string $comment
* @return void
*/
public function setComment ($comment) {
$this->comment = $comment;
}

/**
* Getter for comment
*
* @return string
*/
public function getComment () {
return $this->comment;
}
}
</syntaxhighlight>
=== Eigene Felder erweitern ===
Todo

== Fallstricke ==
=== SQL Exeption - falsche Tabelle ===
Hier liegt meist ein falsches Mapping vor. Je nachdem wie das UserModel erzeugt wurde muß man beim Mapping darauf achten das das Plugin Model nochmal auf die fe_users gemappt wird (und nicht das Extbase Model)
Bei ältern Typo3 Versionen wird das Mapping Setup nur in der ext_typoscript_setup.txt erkannt.

Siehe auch: http://wiki.zone30.info/wikizone/index.php/Extbase_-_Zugriff_auf_Tabellen_anderer_Extbase_Extensions#Tabelle_mappen
=== Extbase Model ab 6.0 ===
TYPO3\CMS\Extbase\Domain\Model\FrontendUser

Im Seiten TS der Rootseite habe ich folgenden Eintrag:
TCAdefaults.fe_users.tx_extbase_type = TYPO3\CMS\Extbase\Domain\Model\FrontendUser
TCAdefaults.fe_groups.tx_extbase_type = TYPO3\CMS\Extbase\Domain\Model\FrontendUserGroup

=== FE-User müssen einer Gruppe zugeordnet sein ===

Extbase - Zugriff auf die fe user Tabelle

2015-10-23T18:22:46Z

87.165.0.123: /* Beispiel: Erweiterte FE_User Felder in eigener Extension nutzen */

http://wiki.zone30.info/wikizone/index.php/Extbase_Extensions_-_Snippets_und_Glossar#Auf_Daten_andererer_Modelle_.2F_Repositorys_im_Controller_zugreifen._.28verkn.C3.BCpfte_Daten_auflisten.29

http://www.derhansen.de/2012/06/zugriff-auf-frontend-user-tabelle-aus.html

http://www.derhansen.de/2012/12/typo3-extbase-mapping-existing-fields.html

== Einleitung ==
=== Wie kriege ich die Daten ===
Wir möchten die Daten der fe_users Tabelle, also die Frontenduser in unserer eigenen Extension verwenden. Extbase hat ein eigenes Domain Model und ein eigenes Repository vorbereitet um auf die Standard Felder der fe_users Tabelle zuzugreifen. Das bedeutet man kann die Daten einfach nutzen, wenn man sein eigenes Model erweitert. Ich brauche keine Getter und Setter Methoden etc. mehr. Zu definieren.
=== fe_users extended ===
Allerdings wird gerade die Tabelle fe_users oftmals von anderen Extensions um weitere Felder erweitert (z.B. sr_feuser_register). Diese Felder sind natürlich nicht im Model von extbase enthalten. Deshalb muß man sie nochmal separat behandeln. Man erweitert einfach sein eigenes Datenmodell um diese Felder. So funktioniert das ganze.

Zu guter letzt möchten wir vielleicht auch noch die fe_users um eigene Felder erweitern.

=== Hinweise ===
* Nicht verwechseln: ''$user=$GLOBALS['TSFE']->fe_user->user;'' gibt den aktuell angemeldeten User zurück.
* findAll() soll laut einem Forumseintrag nicht funktionieren. $user = $this->userRepository->findByUid($uid); schon.

== Beispiel: Einfacher Zugriff auf fe_users Daten in eigener Extension ==
Wenn man einfach nur ein paar Daten aus fe_users braucht, kann man das Standard Repository einfach injecten.
=== Übersicht ===
# fe_users-Repository per Dependency Injection zu Verfügung stellen
# Auslesen der Userdaten
# Mapping beachten

=== fe_user Tabelle Injecten ===
Im Controller deiner Extension
Ab 6.0
<syntaxhighlight lang="php">
/**
* @var \TYPO3\CMS\Extbase\Domain\Repository\FrontendUserRepository
* @inject
*/
protected $frontendUserRepository;
</syntaxhighlight>

Old School (<4.7)
<syntaxhighlight lang="php">
/**
* @var Tx_Extbase_Domain_Repository_FrontendUserRepository
*/
protected $userRepository;

/**
* Inject the user repository
*
* @param Tx_Extbase_Domain_Repository_FrontendUserRepository $userRepository
* @return void
*/
public function injectFrontendUserRepository(Tx_Extbase_Domain_Repository_FrontendUserRepository $userRepository) {
$this->userRepository = $userRepository;
}
</syntaxhighlight>

=== Userdaten holen ===
Z.B. im Controller:
$user = $this->userRepository->findByUid($uid);

=== Problem: User werden nicht ausgegeben weil record type nicht gesetzt ist ===
Hinweis: In neueren Versionen von Extbase ist das Mapping anders definiert -> nur bei alten Versionen wichtig (nicht verifiziert)

Achtung: Extbase erweitert die fe_users und fe_groups um '''das Feld tx_extbase_type (Record Type) Ist dies nicht vorhanden gibt es nichts zurück.'''
Im TypoScript definiert Extbase
<pre>
config.tx_extbase.persistence.classes {
Tx_Extbase_Domain_Model_FrontendUser {
mapping.recordType = Tx_Extbase_Domain_Model_FrontendUser
}
}
</pre>
Im Mapping ist der recordType gesetzt d.h. es sucht nur fe_user mit dem recordType Tx_Extbase_Domain_Model_FrontendUser

Lösung:
* Recordtype setzen
* oder Mapping löschen
<pre>
config.tx_extbase.persistence.classes {
Tx_Extbase_Domain_Model_FrontendUser {
mapping.recordType >
}
}
</pre>
* zusätzlich evtl. Recordtype automatisch vorbelegen -> im PageTS
<pre>
TCAdefaults.fe_users.tx_extbase_type = Tx_Extbase_Domain_Model_FrontendUser
TCAdefaults.fe_groups.tx_extbase_type = Tx_Extbase_Domain_Model_FrontendUserGroup
</pre>

== Beispiel: FE User in eigener Extension speichern ==
Am Beispiel der Extension gbrma. Der aktuell angemeldete User soll im Feld rma_user gespeichert werden. Dieses gehört zum Model 'Rma'
=== Vorgehen ===
* Feld in ext_tables.sql anlegen -> Datenbank
* Feld in TCA anlegen -> Backend
* Feld in Model anlegen und Controller bearbeiten:
** mit Getter und Setter ergänzen-> Extbase Handling
** aktuell angemeldeter User abfragen
** User speichern (in create Action)
* Templates anpassen (wird hier nicht gezeigt)
=== ext_tables.sql ===
<syntaxhighlight lang="sql">
...
rma_user int(11) unsigned DEFAULT '0' NOT NULL,
...
</syntaxhighlight>

=== TCA ===
Configuration/TCA/Rma.php
<syntaxhighlight lang="php">
...
'rma_user' => array(
'exclude' => 1,
'label' => 'LLL:EXT:gbrma/Resources/Private/Language/locallang_db.xlf:tx_gbrma_domain_model_rna.rma_user',
'config' => array(
'type' => 'select',
'items' => array (
array('',0),
),
'foreign_table' => 'fe_users',
'foreign_class' => '\TYPO3\CMS\Extbase\Domain\Model\FrontendUser',
'minitems' => 0,
'maxitems' => 1,
'size' => 1,
'appearance' => array(
'collapseAll' => 0,
'levelLinksPosition' => 'top',
'showSynchronizationLink' => 1,
'showPossibleLocalizationRecords' => 1,
'showAllLocalizationLink' => 1
),
),
),
...
</syntaxhighlight>
=== Model ===
'''Geobit\Gbrma\Domain\Model Rma.php'''
<syntaxhighlight lang="php">
...
/**
* rmaUser
*
* @var integer
*/
protected $rmaUser = 0;

...
/**
* Returns the rmaUser
*
* @return integer $rmaUser
*/
public function getRmaUser() {
return $this->rmaUser;
}

/**
* Sets the rmaUser
*
* @param integer $rmaUser
* @return void
*/
public function setRmaUser($rmaUser) {
$this->rmaUser = $rmaUser;
}
...
</syntaxhighlight>

=== Controller ===
FrontendUser Repository bereitstellen (wir erweitern das von Extbase vorbereitete FrontendUser Repository, damit stehen uns dessen Objekte zur Verfügung:

'''Geobit\Gbrma\Controller RmaController.php'''
<syntaxhighlight lang="php">
...
/**
* FrontendUser Repository
*
* @var \TYPO3\CMS\Extbase\Domain\Repository\FrontendUserRepository
* @inject
*/
protected $userRepository;
...
</syntaxhighlight>
Testen ob die fe_user jetzt zur Verfügung stehen kann man das z.B. in der List Action:
<syntaxhighlight lang="php">
$user = $this->userRepository->findByUid(1);
print \TYPO3\CMS\Extbase\Utility\DebuggerUtility::var_dump( $user );
</syntaxhighlight>
Achtung: findAll() geht nicht !

Jetzt wollen beim anlegen eines Datensatzes den aktuell angemeldeten User hinterlegen.

Auch in der Listenansicht möchten wir nur die Datensätze des aktuellen Users anzeige.

== Beispiel: Einfacher Zugriff auf fe_users Daten über ID ==
Wir möchten in unserer Extension in einem Feld die ID eines Users speichern und später auf die Daten des Users zugreifen.
Um die Daten eines Users zu nutzen müssen wir:

Einfach das bereits in der Extbase Extension vorhandene Repository in unseren Controller injecten

Controller
<syntaxhighlight lang="php">
/**
* FrontendUser Repository
*
* @var \TYPO3\CMS\Extbase\Domain\Repository\FrontendUserRepository
* @inject
*/
protected $userRepository;

//... Zugriff z.B. um das Userobjekt des aktuellen Users zu holen
/**
* Get current user obj
*
* @return \TYPO3\CMS\Extbase\Domain\Repository\FrontendUserRepository
*/
private function getCurrentUser() {
if ($GLOBALS['TSFE']->fe_user->user['uid'] > 0) {
$userId = $GLOBALS['TSFE']->fe_user->user['uid'];
$this->currentUser = $this->userRepository->findByUid($userId);
return $this->currentUser;
}else return false;
}
</syntaxhighlight>

== Beispiel: Erweitern der fe_user um eigene Felder ==
FE-users um eigene Felder erweitern (http://t3-developer.com/extbase-fluid/cheats-extbase/model/verwendung-der-fe-users-in-extbase/ 2015-06)

Soll die Tabelle FE-Users um eigene Felder erweitert werden, sind folgende Dateien anzupassen:

* '''MeineExtension/extension_tables.sql''' -> SQL Anweisung um die Tabellle FE-Users in der Datenbank um eigene Felder zu ergänzen
* '''MeineExtension/extension_tables.php''' -> Neue Felder im Backend verfügbar machen
* '''MeineExtension/Configuration/TypoScript/setup.txt''' -> Mapping der eigenen Tabellenfelder für Extbase
* '''MeineExtension/Classes/Domain/Model/MeinFeUserModel.php''' -> Objekte initialisieren und Setter/Getter setzen

In den nachfolgenden Beispiellistings wird die fe-users Tabelle um ein Textfeld "Meinfeld" ergänzt.

'''Datei: MeineExtension/extension_tables.sql'''
<syntaxhighlight lang="sql">
CREATE TABLE fe_users {
mein_feld varchar(255) DEFAULT '' NOT NULL,
};
</syntaxhighlight>

'''Datei: MeineExtension/ext_tables.php'''
<syntaxhighlight lang="php">
...
//**************************************************//
// USER | Erweiterung fe_users um Feld MeinFeld
//**************************************************//
t3lib_div::loadTCA('fe_users');
$addColumnArray = array(
'mein_feld' => array(
'exclude' => 0,
'label' => 'Feldbeschriftung:',
'config' => array(
'type' => 'input',
'size' => 20,
'eval' => 'trim',
)
),
);
t3lib_extMgm::addTCAcolumns('fe_users', $addColumnArray);
t3lib_extMgm::addToAllTCAtypes('fe_users', '--div--;NeuerReiter , mein_feld');

</syntaxhighlight>

== Beispiel: Erweiterte FE_User Felder in eigener Extension nutzen ==
Siehe auch http://www.derhansen.de/2012/12/typo3-extbase-mapping-existing-fields.html (2015-06) dort wird noch die alte Schreibweise statt der Namespace Schreibweise genutzt.

Wenn wir von anderen Extension erweiterte Felder aus fe_users nutzen, oder Felder selbst erweitern wollen, können wir nciht wie oben vorgehen und direkt in den Controller injecten. Wir müssen wir für unsere User in unserer Extension ein '''eigenes Model''' und ein '''eigenes Repository''' einbauen. Und '''dieses injecten'''. Zum Glück ist in Extbase für fe_users einiges bereitgestellt, das wir durch erweitern direkt übernehmen können.
=== Eigenes Model für die fe_user ===
In der eigenen Extension zuerst ein '''Model anlegen'''. Normalerweise wird dazu Abstract Entity erweitert und alle Felder selbst anlegen. Wir sparen uns Arbeit und '''erweitern''' diesmal das bereits von Extbase angelegte Model, somit haben wir dessen Eigenschaften bereits (kann man schön in der extbase extension im Quelltext sehen.)
<syntaxhighlight lang="php">
class RmaUser extends TYPO3\CMS\Extbase\Domain\Model\FrontendUser {

}
</syntaxhighlight>

Hinweis: Um nur die Standardfelder der fe_users zu benutzen und die Daten zu holen, brauchen wir diese Datei nicht anzulegen Siehe Beispiel oben.

=== Repository für die fe_user ===
Auch hier erweitern wir das bereits vorhandene Repository. Also statt \TYPO3\CMS\Extbase\Persistence\Repository zu erweitern. Nehmen wir:
<syntaxhighlight lang="php">
class RmaUser extends TYPO3\CMS\Extbase\Domain\Model\FrontendUser {
}
</syntaxhighlight>

=== Mapping für die fe_user ===
Wir haben in unserer Extension jetzt das Datenmodell und die Datenrepository also das Behältnis. Extbase weiß aber noch nicht welche Tabelle es nehmen soll, wenn eine Anfrage unserer Extension kommt. Deshalb mappen wir unser Model auf die Tabelle fe_user. Das erledigen wir mit TypoScript:
<syntaxhighlight lang="typoscript">
config.tx_extbase.persistence.classes {
Geobit/Gbrma/Domain/Model/RmaUser {
mapping {
tableName = fe_users
}
}
}
</syntaxhighlight>

=== Erweiterte Felder der fe_users nutzen ===
Jetzt können wir unser Model nutzen um alle Standard Felder zu nutzen. Jetzt müssen wir aber noch Zugriff auf Felder bekommen, die z.B. andere Extensions angelegt haben. Wir legen dazu die passenden Getter und Setter in unserem Model an. Im Beispiel gehen wir von einem Feld "comment" aus, das wir nutzen wollen.

<syntaxhighlight lang="php">
class Tx_Testext1_Domain_Model_FrontendUser extends Tx_Extbase_Domain_Model_FrontendUser {

/**
* Comment
*
* @var string
*/
protected $comment;

/**
* Setter for comment
*
* @param string $comment
* @return void
*/
public function setComment ($comment) {
$this->comment = $comment;
}

/**
* Getter for comment
*
* @return string
*/
public function getComment () {
return $this->comment;
}
}
</pre>
=== Eigene Felder erweitern ===
Todo

== Fallstricke ==
=== SQL Exeption - falsche Tabelle ===
Hier liegt meist ein falsches Mapping vor. Je nachdem wie das UserModel erzeugt wurde muß man beim Mapping darauf achten das das Plugin Model nochmal auf die fe_users gemappt wird (und nicht das Extbase Model)
Bei ältern Typo3 Versionen wird das Mapping Setup nur in der ext_typoscript_setup.txt erkannt.

Siehe auch: http://wiki.zone30.info/wikizone/index.php/Extbase_-_Zugriff_auf_Tabellen_anderer_Extbase_Extensions#Tabelle_mappen
=== Extbase Model ab 6.0 ===
TYPO3\CMS\Extbase\Domain\Model\FrontendUser

Im Seiten TS der Rootseite habe ich folgenden Eintrag:
TCAdefaults.fe_users.tx_extbase_type = TYPO3\CMS\Extbase\Domain\Model\FrontendUser
TCAdefaults.fe_groups.tx_extbase_type = TYPO3\CMS\Extbase\Domain\Model\FrontendUserGroup

=== FE-User müssen einer Gruppe zugeordnet sein ===

Extbase - Zugriff auf die fe user Tabelle

2015-10-23T18:17:54Z

87.165.0.123: /* Beispiel: FE User durch erweitern von Extbase in eigener Extension nutzen */

http://wiki.zone30.info/wikizone/index.php/Extbase_Extensions_-_Snippets_und_Glossar#Auf_Daten_andererer_Modelle_.2F_Repositorys_im_Controller_zugreifen._.28verkn.C3.BCpfte_Daten_auflisten.29

http://www.derhansen.de/2012/06/zugriff-auf-frontend-user-tabelle-aus.html

http://www.derhansen.de/2012/12/typo3-extbase-mapping-existing-fields.html

== Einleitung ==
=== Wie kriege ich die Daten ===
Wir möchten die Daten der fe_users Tabelle, also die Frontenduser in unserer eigenen Extension verwenden. Extbase hat ein eigenes Domain Model und ein eigenes Repository vorbereitet um auf die Standard Felder der fe_users Tabelle zuzugreifen. Das bedeutet man kann die Daten einfach nutzen, wenn man sein eigenes Model erweitert. Ich brauche keine Getter und Setter Methoden etc. mehr. Zu definieren.
=== fe_users extended ===
Allerdings wird gerade die Tabelle fe_users oftmals von anderen Extensions um weitere Felder erweitert (z.B. sr_feuser_register). Diese Felder sind natürlich nicht im Model von extbase enthalten. Deshalb muß man sie nochmal separat behandeln. Man erweitert einfach sein eigenes Datenmodell um diese Felder. So funktioniert das ganze.

Zu guter letzt möchten wir vielleicht auch noch die fe_users um eigene Felder erweitern.

=== Hinweise ===
* Nicht verwechseln: ''$user=$GLOBALS['TSFE']->fe_user->user;'' gibt den aktuell angemeldeten User zurück.
* findAll() soll laut einem Forumseintrag nicht funktionieren. $user = $this->userRepository->findByUid($uid); schon.

== Beispiel: Einfacher Zugriff auf fe_users Daten in eigener Extension ==
Wenn man einfach nur ein paar Daten aus fe_users braucht, kann man das Standard Repository einfach injecten.
=== Übersicht ===
# fe_users-Repository per Dependency Injection zu Verfügung stellen
# Auslesen der Userdaten
# Mapping beachten

=== fe_user Tabelle Injecten ===
Im Controller deiner Extension
Ab 6.0
<syntaxhighlight lang="php">
/**
* @var \TYPO3\CMS\Extbase\Domain\Repository\FrontendUserRepository
* @inject
*/
protected $frontendUserRepository;
</syntaxhighlight>

Old School (<4.7)
<syntaxhighlight lang="php">
/**
* @var Tx_Extbase_Domain_Repository_FrontendUserRepository
*/
protected $userRepository;

/**
* Inject the user repository
*
* @param Tx_Extbase_Domain_Repository_FrontendUserRepository $userRepository
* @return void
*/
public function injectFrontendUserRepository(Tx_Extbase_Domain_Repository_FrontendUserRepository $userRepository) {
$this->userRepository = $userRepository;
}
</syntaxhighlight>

=== Userdaten holen ===
Z.B. im Controller:
$user = $this->userRepository->findByUid($uid);

=== Problem: User werden nicht ausgegeben weil record type nicht gesetzt ist ===
Hinweis: In neueren Versionen von Extbase ist das Mapping anders definiert -> nur bei alten Versionen wichtig (nicht verifiziert)

Achtung: Extbase erweitert die fe_users und fe_groups um '''das Feld tx_extbase_type (Record Type) Ist dies nicht vorhanden gibt es nichts zurück.'''
Im TypoScript definiert Extbase
<pre>
config.tx_extbase.persistence.classes {
Tx_Extbase_Domain_Model_FrontendUser {
mapping.recordType = Tx_Extbase_Domain_Model_FrontendUser
}
}
</pre>
Im Mapping ist der recordType gesetzt d.h. es sucht nur fe_user mit dem recordType Tx_Extbase_Domain_Model_FrontendUser

Lösung:
* Recordtype setzen
* oder Mapping löschen
<pre>
config.tx_extbase.persistence.classes {
Tx_Extbase_Domain_Model_FrontendUser {
mapping.recordType >
}
}
</pre>
* zusätzlich evtl. Recordtype automatisch vorbelegen -> im PageTS
<pre>
TCAdefaults.fe_users.tx_extbase_type = Tx_Extbase_Domain_Model_FrontendUser
TCAdefaults.fe_groups.tx_extbase_type = Tx_Extbase_Domain_Model_FrontendUserGroup
</pre>

== Beispiel: FE User in eigener Extension speichern ==
Am Beispiel der Extension gbrma. Der aktuell angemeldete User soll im Feld rma_user gespeichert werden. Dieses gehört zum Model 'Rma'
=== Vorgehen ===
* Feld in ext_tables.sql anlegen -> Datenbank
* Feld in TCA anlegen -> Backend
* Feld in Model anlegen und Controller bearbeiten:
** mit Getter und Setter ergänzen-> Extbase Handling
** aktuell angemeldeter User abfragen
** User speichern (in create Action)
* Templates anpassen (wird hier nicht gezeigt)
=== ext_tables.sql ===
<syntaxhighlight lang="sql">
...
rma_user int(11) unsigned DEFAULT '0' NOT NULL,
...
</syntaxhighlight>

=== TCA ===
Configuration/TCA/Rma.php
<syntaxhighlight lang="php">
...
'rma_user' => array(
'exclude' => 1,
'label' => 'LLL:EXT:gbrma/Resources/Private/Language/locallang_db.xlf:tx_gbrma_domain_model_rna.rma_user',
'config' => array(
'type' => 'select',
'items' => array (
array('',0),
),
'foreign_table' => 'fe_users',
'foreign_class' => '\TYPO3\CMS\Extbase\Domain\Model\FrontendUser',
'minitems' => 0,
'maxitems' => 1,
'size' => 1,
'appearance' => array(
'collapseAll' => 0,
'levelLinksPosition' => 'top',
'showSynchronizationLink' => 1,
'showPossibleLocalizationRecords' => 1,
'showAllLocalizationLink' => 1
),
),
),
...
</syntaxhighlight>
=== Model ===
'''Geobit\Gbrma\Domain\Model Rma.php'''
<syntaxhighlight lang="php">
...
/**
* rmaUser
*
* @var integer
*/
protected $rmaUser = 0;

...
/**
* Returns the rmaUser
*
* @return integer $rmaUser
*/
public function getRmaUser() {
return $this->rmaUser;
}

/**
* Sets the rmaUser
*
* @param integer $rmaUser
* @return void
*/
public function setRmaUser($rmaUser) {
$this->rmaUser = $rmaUser;
}
...
</syntaxhighlight>

=== Controller ===
FrontendUser Repository bereitstellen (wir erweitern das von Extbase vorbereitete FrontendUser Repository, damit stehen uns dessen Objekte zur Verfügung:

'''Geobit\Gbrma\Controller RmaController.php'''
<syntaxhighlight lang="php">
...
/**
* FrontendUser Repository
*
* @var \TYPO3\CMS\Extbase\Domain\Repository\FrontendUserRepository
* @inject
*/
protected $userRepository;
...
</syntaxhighlight>
Testen ob die fe_user jetzt zur Verfügung stehen kann man das z.B. in der List Action:
<syntaxhighlight lang="php">
$user = $this->userRepository->findByUid(1);
print \TYPO3\CMS\Extbase\Utility\DebuggerUtility::var_dump( $user );
</syntaxhighlight>
Achtung: findAll() geht nicht !

Jetzt wollen beim anlegen eines Datensatzes den aktuell angemeldeten User hinterlegen.

Auch in der Listenansicht möchten wir nur die Datensätze des aktuellen Users anzeige.

== Beispiel: Einfacher Zugriff auf fe_users Daten über ID ==
Wir möchten in unserer Extension in einem Feld die ID eines Users speichern und später auf die Daten des Users zugreifen.
Um die Daten eines Users zu nutzen müssen wir:

Einfach das bereits in der Extbase Extension vorhandene Repository in unseren Controller injecten

Controller
<syntaxhighlight lang="php">
/**
* FrontendUser Repository
*
* @var \TYPO3\CMS\Extbase\Domain\Repository\FrontendUserRepository
* @inject
*/
protected $userRepository;

//... Zugriff z.B. um das Userobjekt des aktuellen Users zu holen
/**
* Get current user obj
*
* @return \TYPO3\CMS\Extbase\Domain\Repository\FrontendUserRepository
*/
private function getCurrentUser() {
if ($GLOBALS['TSFE']->fe_user->user['uid'] > 0) {
$userId = $GLOBALS['TSFE']->fe_user->user['uid'];
$this->currentUser = $this->userRepository->findByUid($userId);
return $this->currentUser;
}else return false;
}
</syntaxhighlight>

== Beispiel: Erweitern der fe_user um eigene Felder ==
FE-users um eigene Felder erweitern (http://t3-developer.com/extbase-fluid/cheats-extbase/model/verwendung-der-fe-users-in-extbase/ 2015-06)

Soll die Tabelle FE-Users um eigene Felder erweitert werden, sind folgende Dateien anzupassen:

* '''MeineExtension/extension_tables.sql''' -> SQL Anweisung um die Tabellle FE-Users in der Datenbank um eigene Felder zu ergänzen
* '''MeineExtension/extension_tables.php''' -> Neue Felder im Backend verfügbar machen
* '''MeineExtension/Configuration/TypoScript/setup.txt''' -> Mapping der eigenen Tabellenfelder für Extbase
* '''MeineExtension/Classes/Domain/Model/MeinFeUserModel.php''' -> Objekte initialisieren und Setter/Getter setzen

In den nachfolgenden Beispiellistings wird die fe-users Tabelle um ein Textfeld "Meinfeld" ergänzt.

'''Datei: MeineExtension/extension_tables.sql'''
<syntaxhighlight lang="sql">
CREATE TABLE fe_users {
mein_feld varchar(255) DEFAULT '' NOT NULL,
};
</syntaxhighlight>

'''Datei: MeineExtension/ext_tables.php'''
<syntaxhighlight lang="php">
...
//**************************************************//
// USER | Erweiterung fe_users um Feld MeinFeld
//**************************************************//
t3lib_div::loadTCA('fe_users');
$addColumnArray = array(
'mein_feld' => array(
'exclude' => 0,
'label' => 'Feldbeschriftung:',
'config' => array(
'type' => 'input',
'size' => 20,
'eval' => 'trim',
)
),
);
t3lib_extMgm::addTCAcolumns('fe_users', $addColumnArray);
t3lib_extMgm::addToAllTCAtypes('fe_users', '--div--;NeuerReiter , mein_feld');

</syntaxhighlight>

== Beispiel: Erweiterte FE_User Felder in eigener Extension nutzen ==
Siehe auch http://www.derhansen.de/2012/12/typo3-extbase-mapping-existing-fields.html (2015-06) dort wird noch die alte Schreibweise statt der Namespace Schreibweise genutzt.

Wenn wir von anderen Extension erweiterte Felder aus fe_users nutzen, oder Felder selbst erweitern wollen, können wir nciht wie oben vorgehen und direkt in den Controller injecten. Wir müssen wir für unsere User in unserer Extension ein '''eigenes Model''' und ein '''eigenes Repository''' einbauen. Und '''dieses injecten'''. Zum Glück ist in Extbase für fe_users einiges bereitgestellt, das wir durch erweitern direkt übernehmen können.
=== Model für die fe_user ===
In der eigenen Extension zuerst ein '''Model anlegen'''. Normalerweise wird dazu Abstract Entity erweitert. Wir '''erweitern''' diesmal das bereits von Extbase angelegte Model, somit haben wir dessen Eigenschaften bereits (kann man schön in der extbase extension im Quelltext sehen.)
<syntaxhighlight lang="php">
class RmaUser extends TYPO3\CMS\Extbase\Domain\Model\FrontendUser {

}
</syntaxhighlight>

Hinweis: Um nur die Standardfelder der fe_users zu benutzen und die Daten zu holen, brauchen wir diese Datei nicht anzulegen Siehe Beispiel oben.

=== Repository für die fe_user ===
Auch hier erweitern wir das bereits vorhandene Repository. Also statt \TYPO3\CMS\Extbase\Persistence\Repository zu erweitern. Nehmen wir:
<syntaxhighlight lang="php">
class RmaUser extends TYPO3\CMS\Extbase\Domain\Model\FrontendUser {
}
</syntaxhighlight>

=== Mapping für die fe_user ===
Wir haben in unserer Extension jetzt das Datenmodell und die Datenrepository also das Behältnis. Extbase weiß aber noch nicht welche Tabelle es nehmen soll, wenn eine Anfrage unserer Extension kommt. Deshalb mappen wir unser Model auf die Tabelle fe_user. Das erledigen wir mit TypoScript:
<syntaxhighlight lang="typoscript">
config.tx_extbase.persistence.classes {
Geobit/Gbrma/Domain/Model/RmaUser {
mapping {
tableName = fe_users
}
}
}
</syntaxhighlight>
=== Erweiterte Felder der fe_users nutzen ===
ToDo
* Im Prinzip einfach getter und setter im Model definieren
=== Eigene Felder erweitern ===
Todo

== Fallstricke ==
=== SQL Exeption - falsche Tabelle ===
Hier liegt meist ein falsches Mapping vor. Je nachdem wie das UserModel erzeugt wurde muß man beim Mapping darauf achten das das Plugin Model nochmal auf die fe_users gemappt wird (und nicht das Extbase Model)
Bei ältern Typo3 Versionen wird das Mapping Setup nur in der ext_typoscript_setup.txt erkannt.

Siehe auch: http://wiki.zone30.info/wikizone/index.php/Extbase_-_Zugriff_auf_Tabellen_anderer_Extbase_Extensions#Tabelle_mappen
=== Extbase Model ab 6.0 ===
TYPO3\CMS\Extbase\Domain\Model\FrontendUser

Im Seiten TS der Rootseite habe ich folgenden Eintrag:
TCAdefaults.fe_users.tx_extbase_type = TYPO3\CMS\Extbase\Domain\Model\FrontendUser
TCAdefaults.fe_groups.tx_extbase_type = TYPO3\CMS\Extbase\Domain\Model\FrontendUserGroup

=== FE-User müssen einer Gruppe zugeordnet sein ===

Extbase Extensions - Snippets und Glossar

2015-10-23T18:02:42Z

87.165.0.123: /* Zugriff auf fe_user */

Beinhaltet z.T. auch Fluid

== Siehe auch ==
[[Extbase - Nützliche Funktionen und Libraries]]
== Hinweis neue Namespace Regelung für Klassen ==
[[Extbase Änderungen ab TYPO3 V6]]

== Glossar ==
[[Extbase - Glossar]]

== Snippets Links ==
http://typo3.org/documentation/snippets/
== Mehrere Models in einem Formular / einer Action steuern ==
== Rendering des Views steuern ==
=== Timestamp - crdate und tstamp nutzen ===
[[Extbase - Timestamp nutzen]]

=== Rendering verhindern ===
Am Ende der Action wird implizit immer
return $this->view->render();
ausgeführt (auch wenn man es nicht schreibt). Will man das verhindern muß man
return false;
zurückgeben

== Objekt-Datenbank-Abfragen steuern ==
Das Ergebnis der findAll() Funktion im Controller läßt sich mit dem QueryInterface steuern.
Z.B. kann man im Repository die Standardsortierung festlegen.

[[Extbase - Query Objekt]]

[[Extbase - Sortierung und Abfrage von Objekten]]

== Objekte erstellen, löschen, bearbeiten ==
[[Extbase - Objekte handeln]]

== TypoScript Konfiguration im Controller nutzen ==
=== Hinweis zu Settings in TypoScript ===
Im Action Controller und im Fluid Template sind nur die Objekte über $this->settings bzw. settings.objektname sichtbar die in '''plugin.tx_extname.settings''' liegen.

TypoScript
<pre>
plugin.tx_some-extname.settings {
myXsetting = XXXX
}
</pre>
PHP
$valX = $this->settings['myXsetting'];

== Property Mapper ==
Ein Property Mapper hat die Aufgabe, die Daten, die von Formularen an den Webserver gesendet werden in die korrekten Variablentypen zu konvertieren.

Er sorgt auch dafür das die Propertys auf die richtigen Modelle und Tabellen gemappt werden.

http://www.typo3lexikon.de/typo3-tutorials/extensions/extbase/property-mapper.html

== E-Mails mit Extbase ==
http://t3-developer.com/extbase-fluid/extensions-erweitern/e-mail-versand-aus-extensions/mailversand/

http://www.benny-vs-web.de/typo3/extbase-fluid-zum-rendern-von-e-mail-templates-verwenden/

[[Extbase - E-Mail / MailMessage]]

== Lokalisierung - Language Files ==

=== Im Extbase Controller lokalisieren ===
Z.B. bei Fehlermeldungen. flashMessages oder speziellen Ausgaben

Tx_Extbase_Utility_Localization::translate($langkey,$extensionName)
$extensionName = Extbase name (UpperCammelCase ohen Unterstriche)

$langkey muss der locallang.xml datei bzw. xlf hinzugefügen.

<label index="tx_t3easyplugins_domain_model_plugin.createdSuccessful">Your new Plugin was created.</label>

Unten ein kleines Beispiel.
Tx_Extbase_Utility_Localization::translate

<pre>/**
* action create
*
* @param $newEntry
* @return void
*/
public function createAction(Tx_T3easyPlugins_Domain_Model_Plugin $newEntry) {
$this->entryRepository->add($newEntry);
$this->flashMessageContainer->add(Tx_Extbase_Utility_Localization::translate('tx_t3easyplugins_domain_model_Plugin.createdSuccessful', 'T3easyPlugins'));
$this->redirect('list');
}
</pre>
locallang.xml
<pre>
...
<label index="tx_t3easyplugins_domain_model_plugin.createdSuccessful">Your new Plugin was created.</label>
...
</pre>

== Actions ==
=== Controller und Actions Basics ===
http://docs.typo3.org/typo3cms/ExtbaseFluidBook/7-Controllers/1-Creating-Controllers-and-Actions.html
=== Neue Action realisieren ===
# Action registrieren (localconf.php)
# Methode für die Action schreiben (im Controller des Objektes)
# Auf gewünschten View weiterleiten (z.B. ''$this->redirect('list');'' )

=== Requestdaten verarbeiten ===
==== Get / Post Vars ====
$this->request->getArguments()
$this->request->getArgument('variable')

$args = $this->request->getArguments();
$showUid = $args['show'];

// Test if Argument is available
$this->request->hasArgument('variable')

==== cObject ====
//$cObjData = $this->request->getContentObjectData(); // deprecated
$this->configurationManager->getContentObject()
==== Redirect ====
$this->redirect('show','Blog',NULL,array('blog'=>$blog));
$this->redirect('nameOfAction','NameOfDomainModel',NULLorOtherExtName,array('objectNameToSend'=>$objectToSend));

=== Auf Daten von anderen Models / Repositorys im Controller zugreifen. Dependency Injection ===
Will man auf Daten anderer Extensions zugreifen oder verknüpfte Daten komplett ohne ein Objekt des Aggregate Root (also die Haupttabelle) ausgeben muß man die Datenstruktur Injecten. Grundsätzlich kann man mit der Inject Methode aus jeder Extension heraus '''auf Daten anderer Extensions zugreifen'''.

'''Beispiel:'''
Im Controller steht wegen der strikten '''Trennung der Modelle''' erstmal das Repository (Die Datenstruktur) des Models zur Verfügung. Die verknüpften Daten (hier im Beispiels die Genres, gibt der View zwar über die Verknüpfung aus, das sind aber nur die mit dem jeweiligen Datensatz '''verknüpften Daten'''. Z.B. die Genres einer Band. Will man z.B. '''alle Genres im Listview der Bands''' ausgeben braucht man ein '''Repository der Genres und muß den Genre Controller in den Band Controller injecten'''. Dann kann man auf alle Funktionen des Genre Controllers auch aus dem Band Controller zugreifen. So bleibt auch alles sauber getrennt.

* eigenes '''Repository''' für verknüpfte Daten '''erstellen''' (z.B. Genre)
<syntaxhighlight lang="php">
/**
* genreRepository
*
* @var \Geobit\Gbbandpass\Domain\Repository\GenreRepository
* @inject
*/
protected $genreRepository = NULL;
</syntaxhighlight>
*Im Controller (Hauptcontroller) deiner Extension injectest du das gewünschte Repository. Allerdings gibt es unterschiedliche Methoden je nachdem welche Typo3 Version du verwendest.

====Dependency Injection 'TYPO3 ab 6.0====
<syntaxhighlight lang="php">
/**
* @var \Vendor\Extension\Domain\Repository\SomeRepository
* @inject
*/
protected $someRepository;
</syntaxhighlight>

====Dependency Injection TYPO3 = 4.7 ====

<syntaxhighlight lang="php">
/**
* @var Tx_MyExtension_Domain_Repository_SomeRepository
* @inject
*/
protected $someRepository;
</syntaxhighlight>

==== Dependency Injection TYPO3 vor 4.7 ====
<syntaxhighlight lang="php">
/**
* @var Tx_MyExtension_Domain_Repository_SomeRepository
*/
protected $someRepository;

/**
* Inject SomeRepository
* @param Tx_MyExtension_Domain_Repository_SomeRepository $someRepository
* @return void
*/
public function injectSomeRepository(Tx_MyExtension_Domain_Repository_SomeRepository $someRepository) {
$this->someRepository = $someRepository;
}
</syntaxhighlight>
Jetzt kann man $this->someRepository mit all seinen Methoden auch in diesem Controller nutzen.

'''Hinweis:''' Nach Änderung System Cache löschen !

=== Controller-Action Kombinationen für Frontend-Plugins definieren ===
http://docs.typo3.org/typo3cms/ExtbaseFluidBook/b-ExtbaseReference/Index.html

In ext_localconf.php sind '''erlaubte Actions''' hinterlegt. Der '''erste Eintrag ist die Default-Action'''.
<pre>
\TYPO3\CMS\Extbase\Utility\ExtensionUtility::configurePlugin(
'Geobit.' . $_EXTKEY,
'Mailformtest',
array(
'Mailform' => 'list, show, new, create',

),
// non-cacheable actions
array(
'Mailform' => 'create, ',

)
);
</pre>
Zu diesem Beispiel gehört der Controller unter
Classes/Controller/MailformController.php

==Domainmodel Beispiele ==
=== M:N Verbindung komplett===
[[Extbase - m:n Verknüpfung]]

== Diverse ==
=== Actions anlegen ===
Im Controller:
<pre>
/**
* action list
*
* @return void
*/
public function listAction() {
$myextname = $this->myextRepository->findAll();
$this->view->assign('myextname', $myextname);
}
</pre>

=== addFlashMessage ===
Im Controller
<pre>
$this->addFlashMessage('This is a simple success message');
$this->addFlashMessage('The message body', 'Message title', \TYPO3\CMS\Core\Messaging\AbstractMessage::OK, TRUE);
$this->addFlashMessage('<strong>HTML-Messageplement</strong>', '', \TYPO3\CMS\Core\Messaging\AbstractMessage::ERROR);
</pre>

=== Existierende Extbase Klassen erweitern ===
( Früher XCLASS ) - http://blog.sebastiaandejonge.com/articles/2013/june/11/class-extension-in-extbase/

== Default Sortierung in Extbase ==

=== Beispiel aus Slidercalc ===
<pre>
/**
* The repository for Sliders
*/
class SliderRepository extends \TYPO3\CMS\Extbase\Persistence\Repository {
protected $defaultOrderings = array(
'category.sorting' => \TYPO3\CMS\Extbase\Persistence\QueryInterface::ORDER_ASCENDING,
'sorting' => \TYPO3\CMS\Extbase\Persistence\QueryInterface::ORDER_ASCENDING
//'date' => \TYPO3\CMS\Extbase\Persistence\QueryInterface::ORDER_DESCENDING
);

}
</pre>
Quelle: http://t3n.de/magazin/zehn-tipps-tricks-extbase-fluid-227639/2/ (11/2014)

Default-Sortierung im Repository

Nicht unbedingt unbekannt, aber weitestgehend ungenutzt ist ein Feature, welches in Extbase 1.3 hinzugekommen ist: Im '''Repository''' besteht die Möglichkeit, das Ergebnis nach bestimmten Feldern aufsteigend oder absteigend zu sortieren. Dies wird beispielsweise mittels „
$query->setOrderings(array('name' => Tx_Extbase_Persistence_QueryInterface::ORDER_DESCENDING));
erledigt.

Um dies nicht für jede einzelne Repository-Funktion einstellen zu müssen, gibt es die '''Eigenschaft defaultOrderings''':

Im Repository
protected $defaultOrderings = array ('name' => Tx_Extbase_Persistence_QueryInterface::ORDER_DESCENDING);

== Debugging ==
=== Fehlermeldung class_parents(): object or string expected ===
Nachdem man neue Properties hinzugefügt hat kommt obige Fehlermeldung. Dies ist ein Bug in Extbase. Nur Truncating cf_extbase_reflection works. (Bei 4.5 die Extbase Cachetabellen leeren)
=== Debugging im Controller ===

==== Beispiel ====
print \TYPO3\CMS\Extbase\Utility\DebuggerUtility::var_dump( $this );

==== Beispiel ====
<pre>
t3lib_utility_Debug::debug($var, 'Debug: ' . __FILE__ . ' in Line: ' . __LINE__);

# namespaces
\TYPO3\CMS\Core\Utility\DebugUtility::debug($var, 'Debug: ' . __FILE__ . ' in Line: ' . __LINE__);
</pre>
==== Beispiel ====
<pre>
Tx_Extbase_Utility_Debugger::var_dump($var);

# namespaces
\TYPO3\CMS\Extbase\Utility\DebuggerUtility::var_dump($var);
</pre>

=== Debugging wenn keine Datensätze gefunden werden ===
Im Repository kann man das Queryinterface überschreiben und so z.B. die Abfrage der storage Page unterbinden (alle werden ausgegeben). Auch Fehler im sql werden sichtbar.

<syntaxhighlight lang="php">
/**
* @return QueryInterface
*/
public function createQuery(){
$query = parent::createQuery();
$query->getQuerySettings()->setRespectStoragePage(FALSE);
return $query;
}
</syntaxhighlight>

== Zugriff auf TypoScript ==
Auf die TypoScript Einstellungen unter:
<syntaxhighlight lang="typoscript">
plugin.tx_myextname {
settings{
meinWert = 123
}
}
</syntaxhighlight>
Kann man einfach im Controller mittels $this->settings['meinWert']; zugreifen. Beispiel
$adminmail = $this->settings['adminMail'];

Man kann mit dem Configuration Manager auch auf andere Einstellungen zugreifen:

https://typo3.org/api/typo3cms/class_t_y_p_o3_1_1_c_m_s_1_1_extbase_1_1_configuration_1_1_configuration_manager.html#ac6b6323862565409eddac516dca08c10
<pre>
getConfiguration (
$configurationType,
$extensionName = NULL,
$pluginName = NULL
)
</pre>

== Daten aus anderen Extensions ==
=== Zugriff auf Frontend User (feuser) ===
[[Extbase - Zugriff auf die fe_user Tabelle]]

=== Zugriff auf andere Extensions ===
[[Extbase - Zugriff auf Tabellen anderer Extbase Extensions]]

== AJAX mit Extbase ==
=== AJAX über neuen Page Type ===
Quelle: http://t3-developer.com/extbase-fluid/extensions-erweitern/ajax-in-extensions/ajaxcalls-mit-pagetype/ (2014/12)

Die Verwendung eines eigenen page Types für Ajax Calls ist relativ simpel. Zunächst müsst ihr euer Extensionsetup um einen neuen '''PageType erweitern'''. Die PageType Nummer muss einmalig in der Installation sein, also ggf. bereits vergebene PageTypes für RSS, Sitemaps, Print & Co beachten.

==== Extensionsetup ====

Bitte beachtet das ihr in der letzten Zeile eure den Extensionnamen ohne 'tx_' Prefix angeben müsst!

'''TypoScript'''
<pre>
ajaxCall = PAGE
ajaxCall {
typeNum = 999
config.disableAllHeaderCode = 1
config.metaCharset = UTF-8
10 = COA
10 < tt_content.list.20.myextension_myplugin
}
</pre>
'''Der AjaxCall in jQuery'''
<pre>
$('#jq-send').click(function(e) {
$.ajax({
var controller = tx_myExt_myplugin[controller]= blabla;
var action = tx_myExt_myplugin[action]= meineControllerFunction; // ohne Action am Ende
var pagetype = 999;
var path = $(location).attr('href');

url: path + '/?' + controller + '&' + action + '&type=' + pagetype
//optionale Parameter
data: 'useruid=' + useruid,

success: function(result) {
console.log(result);
//hier kommen eure Anweisungen rein
},
error: function(error) {
console.log(error);
}
});
});
</pre>
Ein Beispiel findet ihr auch in meiner Blogextension "multiblog" auf Github: ajaxCall in Blogextension

====Ajax Function im Controller====

Die Controllerfunction muss natürlich wie jede Action in der '''ext_localconf.php registriert''' sein. Innerhalb dieser Action steht euch die ganz '''normale Extbase Umgebung''' zur Verfügung, also alles das was ihr in 'normalen' Funktionen auch habt (injected Repositories, mapped Tables, settings etc.) Genau das ist der '''Unterschied zu einem AjaxCall über eID''', das komplette TSFE ist geladen.

Am Ende der Funktion müsst Ihr euch nur entscheiden, was Ihr zurückgeben wollt:

'''Rückgabe eine json strings (z.B. Ergebnisarray):'''

return json_encode($myArray);

'''Rückgabe eines kompletten Views als html string'''. Am Ende der Ajax Funktion im Controller setzt Ihr ganz normal euren View (Template muss vorhanden sein):

$this->view->assign('myAjaxAction, $values);

'''Keinerlei Rückgabe''' z.B wenn Ihr nur Daten nur für einen Counter speichert:

exit;

Innerhalb von der jQuery Funktion ''success:function(result) { }'' wird dann das Ergebnis ausgewertet. Die vom Controller zurückgegebenen Werte stehen in der '''Variablen result''' zur Verfügung.

=== AJAX Call über eid Mechanismus ===
Quelle: http://t3-developer.com/extbase-fluid/extensions-erweitern/ajax-in-extensions/ajax-dispatcher-eid-in-typo3-61/ (2014/12)

Ajax Dispatcher für TYPO3 6.2 - wichtige Hinweise!

Damit das nachfolgende Script auch unter TYPO3 6.2.3 funktioniert, müssen folgende Zeilen geändert werden:

Zeile 101:

\TYPO3\CMS\Core\Core\Bootstrap::getInstance();
Siehe auch forge.typo3.org/issues/59070.

Ajax Dispaytcher für TYPO3 6.1 und Namespaces. Die Datei ist getestet und läuft auch ;). Ihr müsst in '''Zeile 82 + 83 den von Euch benutzen Vendor und Extension Namen einsetzten'''.

Siehe auch alle weiteren Angaben im Kommentarbereich des Dispatchers.
<pre>
<?php
/** *************************************************************
*
* Extbase Dispatcher for Ajax Calls TYPO3 6.1 namespaces
*
* IMPORTANT Use this script only in Extensions with namespaces
*
* Klaus Heuer <klaus.heuer@t3-developer.com>
*
* This script is part of the TYPO3 project. The TYPO3 project is
* free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 2 of the License, or
* (at your option) any later version.
*
* The GNU General Public License can be found at
* http://www.gnu.org/copyleft/gpl.html.
*
* This script is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* This copyright notice MUST APPEAR in all copies of the script!
* ************************************************************* */
/** ************************************************************
* Usage of this script:
*
* - Copy this script in your Extension Dir in the Folder Classes
* - Set the Vendor and Extension Name in Line 82 + 83
* - Include the next line in the ext_localconf.php, change the ext name!
* - $TYPO3_CONF_VARS['FE']['eID_include']['ajaxDispatcher'] = \TYPO3\CMS\Core\Utility\ExtensionManagementUtility::extPath('myExtension').'Classes/EidDispatcher.php';
*
* Use for Ajax Calls in your jQuery Code:
*
* $('.jqAjax').click(function(e) {
* var uid = $(this).find('.uid').html();
* var storagePid = '11';
*
* $.ajax({
* async: 'true',
* url: 'index.php',
* type: 'POST',
*
* data: {
* eID: "ajaxDispatcher",
* request: {
* pluginName: 'patsystem',
* controller: 'Todo',
* action: 'findTodoByAjax',
* arguments: {
* 'uid': uid,
* 'storagePid': storagePid
* }
* }
* },
* dataType: "json",
*
* success: function(result) {
* console.log(result);
* },
* error: function(error) {
* console.log(error);
* }
* });
*************************************************************** */
/**
* Gets the Ajax Call Parameters
*/
$ajax = \TYPO3\CMS\Core\Utility\GeneralUtility::_GP('request');
/**
* Set Vendor and Extension Name
*
* Vendor Name like your Vendor Name in namespaces
* ExtensionName in upperCamelCase
*/
$ajax['vendor'] = 'T3Developer';
$ajax['extensionName'] = 'ProjectsAndTasks';
/**
* @var $TSFE \TYPO3\CMS\Frontend\Controller\TypoScriptFrontendController
*/
$TSFE = \TYPO3\CMS\Core\Utility\GeneralUtility::makeInstance('TYPO3\CMS\Frontend\Controller\TypoScriptFrontendController', $TYPO3_CONF_VARS, 0, 0);
\TYPO3\CMS\Frontend\Utility\EidUtility::initLanguage();
// Get FE User Information
$TSFE->initFEuser();
// Important: no Cache for Ajax stuff
$TSFE->set_no_cache();
//$TSFE->checkAlternativCoreMethods();
$TSFE->checkAlternativeIdMethods();
$TSFE->determineId();
$TSFE->initTemplate();
$TSFE->getConfigArray();
\TYPO3\CMS\Core\Core\Bootstrap::getInstance()->loadConfigurationAndInitialize();
$TSFE->cObj = \TYPO3\CMS\Core\Utility\GeneralUtility::makeInstance('TYPO3\CMS\Frontend\ContentObject\ContentObjectRenderer');
$TSFE->settingLanguage();
$TSFE->settingLocale();
/**
* Initialize Database
*/
\TYPO3\CMS\Frontend\Utility\EidUtility::connectDB();
/**
* @var $objectManager \TYPO3\CMS\Extbase\Object\ObjectManager
*/
$objectManager = \TYPO3\CMS\Core\Utility\GeneralUtility::makeInstance('TYPO3\CMS\Extbase\Object\ObjectManager');
/**
* Initialize Extbase bootstap
*/
$bootstrapConf['extensionName'] = $ajax['extensionName'];
$bootstrapConf['pluginName'] = $ajax['pluginName'];
$bootstrap = new TYPO3\CMS\Extbase\Core\Bootstrap();
$bootstrap->initialize($bootstrapConf);
$bootstrap->cObj = \TYPO3\CMS\Core\Utility\GeneralUtility::makeInstance('tslib_cObj');
/**
* Build the request
*/
$request = $objectManager->get('TYPO3\CMS\Extbase\Mvc\Request');
$request->setControllerVendorName($ajax['vendor']);
$request->setcontrollerExtensionName($ajax['extensionName']);
$request->setPluginName($ajax['pluginName']);
$request->setControllerName($ajax['controller']);
$request->setControllerActionName($ajax['action']);
$request->setArguments($ajax['arguments']);
$response = $objectManager->create('TYPO3\CMS\Extbase\Mvc\ResponseInterface');
$dispatcher = $objectManager->get('TYPO3\CMS\Extbase\Mvc\Dispatcher');
$dispatcher->dispatch($request, $response);
echo $response->getContent();
//die();
?>
</pre>

== Mehrere Modelle in einem View ==
=== Übergabe mehrerer Objekte aus einem View ===
In Fluid
<f:link.action action="newMetadevice" arguments="{rma : rma, device : device}">add</f:link.action>
Im Controller
1. Direkt im Header
public function createDeviceAction(\Geobit\Gbrma\Domain\Model\Rma $rma,\Geobit\Gbrma\Domain\Model\Device $device){...}
Hier können auch komplette Objekte übergeben werden
2. Im Controller mit getArgument()
$deviceClassUid = intval($this->request->getArgument('deviceClassUid'));
Hier werden nur Get-Post Variablen ausgelesen wie früher die piVars.

=== Datenübergabe in Sessions ===
In diesem Beispiel werden Datenobjekte als serialisierter String in einer Session gespeichert.

http://stackoverflow.com/questions/27821750/multiple-objects-in-one-fluid-form (2015-03)

In order to '''pass non persistent objects between multiple actions''', I would suggest that you store the objects serialized in a TYPO3 session variable. Doing so, you can restore the objects in the target action.

Below you find a working example which can also be found here. https://github.com/derhansen/extbase_validation_new_pm/blob/master/Classes/Controller/MultipleStepsController.php

<syntaxhighlight lang="php">
<?php
namespace derhansen\ValidationExamplesNew\Controller;

/***************************************************************
* Copyright notice
*
* (c) 2013 Torben Hansen <derhansen@gmail.com>
*
* All rights reserved
*
* This script is part of the TYPO3 project. The TYPO3 project is
* free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 3 of the License, or
* (at your option) any later version.
*
* The GNU General Public License can be found at
* http://www.gnu.org/copyleft/gpl.html.
*
* This script is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* This copyright notice MUST APPEAR in all copies of the script!
***************************************************************/

/**
* Multiple Steps Controller
*
* @package validation_examples_new
* @license http://www.gnu.org/licenses/gpl.html GNU General Public License, version 3 or later
*
*/
class MultipleStepsController extends \TYPO3\CMS\Extbase\Mvc\Controller\ActionController {

/**
* addressdataRepository
*
* @var \derhansen\ValidationExamplesNew\Domain\Repository\AddressdataRepository
* @inject
*/
protected $addressdataRepository;

/**
* API Service
*
* @var \derhansen\ValidationExamplesNew\Service\ExternalApiService
* @inject
*/
protected $apiService;

/**
* Step1
*
* @param \derhansen\ValidationExamplesNew\Domain\Model\Step1Data $step1data
* @dontvalidate $step1data
*/
public function step1Action(\derhansen\ValidationExamplesNew\Domain\Model\Step1Data $step1data = NULL) {
/* Check if step1data is available in session */
if ($GLOBALS['TSFE']->fe_user->getKey('ses', 'step1data') && $step1data == NULL) {
$step1data = unserialize($GLOBALS['TSFE']->fe_user->getKey('ses', 'step1data'));
}

$this->view->assign('step1data', $step1data);
}

/**
* Step1 redirect action
*
* @param \derhansen\ValidationExamplesNew\Domain\Model\Step1Data $step1data
*/
public function step1redirectAction(\derhansen\ValidationExamplesNew\Domain\Model\Step1Data $step1data) {
$GLOBALS['TSFE']->fe_user->setKey('ses', 'step1data', serialize($step1data));
$GLOBALS['TSFE']->fe_user->storeSessionData();

$this->redirect('step2');
}

/**
* Step2
*
* @param \derhansen\ValidationExamplesNew\Domain\Model\Step2Data $step2data
* @dontvalidate $step2data
*/
public function step2Action(\derhansen\ValidationExamplesNew\Domain\Model\Step2Data $step2data = NULL) {
/* Check if step2data is available in session */
if ($GLOBALS['TSFE']->fe_user->getKey('ses', 'step2data') && $step2data == NULL) {
$step2data = unserialize($GLOBALS['TSFE']->fe_user->getKey('ses', 'step2data'));
}

/* Set external validations errors if available */
$this->setApiValidationErrors('step2');

$this->view->assign('step2data', $step2data);
}

/**
* Step2 redirect action
*
* @param \derhansen\ValidationExamplesNew\Domain\Model\Step2Data $step2data
*/
public function step2redirectAction(\derhansen\ValidationExamplesNew\Domain\Model\Step2Data $step2data) {
$GLOBALS['TSFE']->fe_user->setKey('ses', 'step2data', serialize($step2data));
$GLOBALS['TSFE']->fe_user->storeSessionData();

$this->redirect('step3');
}

/**
* Step3
*
* @param \derhansen\ValidationExamplesNew\Domain\Model\Step3Data $step3data
* @dontvalidate $step3data
*/
public function step3Action(\derhansen\ValidationExamplesNew\Domain\Model\Step3Data $step3data = NULL) {
/* Check if step3data is available in session */
if ($GLOBALS['TSFE']->fe_user->getKey('ses', 'step3data') && $step3data == NULL) {
$step3data = unserialize($GLOBALS['TSFE']->fe_user->getKey('ses', 'step3data'));
}

/* Set external validations errors if available */
$this->setApiValidationErrors('step3');

$this->view->assign('step3data', $step3data);
}

/**
* Step3 redirect action
*
* @param \derhansen\ValidationExamplesNew\Domain\Model\Step3Data $step3data
*/
public function step3redirectAction(\derhansen\ValidationExamplesNew\Domain\Model\Step3Data $step3data) {
$GLOBALS['TSFE']->fe_user->setKey('ses', 'step3data', serialize($step3data));
$GLOBALS['TSFE']->fe_user->storeSessionData();

$this->redirect('create');
}

/**
* Create Action
*
* @return void
*/
public function createAction() {
$addressdata = $this->getAddressdataFromSession();

/* get validation results from API */
$apiresults = $this->apiService->validateMultipleSteps($addressdata);
if (count($apiresults) > 0) {
/* Save results to a session variable */
$GLOBALS['TSFE']->fe_user->setKey('ses', 'apiresults', $apiresults);
$GLOBALS['TSFE']->fe_user->storeSessionData();

/* Redirect to step with validation errors */
if (array_key_exists('step2', $apiresults)) {
$this->redirect('step2');
}
if (array_key_exists('step3', $apiresults)) {
$this->redirect('step3');
}
}

$this->addressdataRepository->add($addressdata);
$this->cleanUpSessionData();

$this->view->assign('message', 'Addressdata has been created');
}

/**
* Collects the addressdata from the multiple steps form stored in session variables
* and returns an addressdata object.
*
* @return \derhansen\ValidationExamplesNew\Domain\Model\Addressdata
*/
protected function getAddressdataFromSession() {
/** @var \derhansen\ValidationExamplesNew\Domain\Model\Step1Data $step1data */
$step1data = unserialize($GLOBALS['TSFE']->fe_user->getKey('ses', 'step1data'));

/** @var \derhansen\ValidationExamplesNew\Domain\Model\Step2Data $step2data */
$step2data = unserialize($GLOBALS['TSFE']->fe_user->getKey('ses', 'step2data'));

/** @var \derhansen\ValidationExamplesNew\Domain\Model\Step3Data $step3data */
$step3data = unserialize($GLOBALS['TSFE']->fe_user->getKey('ses', 'step3data'));

/** @var \derhansen\ValidationExamplesNew\Domain\Model\Addressdata $addressData */
$addressData = $this->objectManager->get('derhansen\ValidationExamplesNew\Domain\Model\Addressdata');
$addressData->setFirstname($step1data->getFirstname());
$addressData->setLastname($step1data->getLastname());
$addressData->setStreet($step2data->getStreet());
$addressData->setStreetnr($step2data->getStreetnr());
$addressData->setZip($step3data->getZip());
$addressData->setCity($step3data->getCity());

return $addressData;
}

/**
* Removes all session variables from the multiple steps form
*
* @return void
*/
protected function cleanUpSessionData() {
$GLOBALS['TSFE']->fe_user->setKey('ses', 'step1data', '');
$GLOBALS['TSFE']->fe_user->setKey('ses', 'step2data', '');
$GLOBALS['TSFE']->fe_user->setKey('ses', 'step3data', '');
$GLOBALS['TSFE']->fe_user->setKey('ses', 'apiresults', '');
$GLOBALS['TSFE']->fe_user->storeSessionData();
}

/**
* Sets validation errors for fields in the given step
*
* @param string $step The step
* @return void
*/
protected function setApiValidationErrors($step) {
$apiresults = $GLOBALS['TSFE']->fe_user->getKey('ses', 'apiresults');
if (array_key_exists($step, $apiresults)) {
/* Set Form Errors manually - get results from property mapper and add new errors */
$result = $this->getControllerContext()->getRequest()->getOriginalRequestMappingResults();

/* Add validation errors */
foreach ($apiresults[$step] as $key => $value) {
$error = $this->objectManager->get('TYPO3\\CMS\\Extbase\\Validation\Error',
$apiresults[$step][$key], time());
$result->forProperty($step . 'data.' . $key)->addError($error);
}
$this->getControllerContext()->getRequest()->setOriginalRequestMappingResults($result);
}
}

}
?>
</syntaxhighlight>

Narda

2015-10-23T17:35:21Z

87.165.0.123: /* Änderungen */

== Überblick ==
RMA und ACC liegen auf Geo-bit Server und sind per iFrame eingebunden:
<pre>
<iframe width="940" height="1000" src="/1/RMA/rma_select_01.php?req_art=rep_cal"></iframe>
<iframe width="940" height="1000" src="/1/RMA/rma_select_01.php?req_art=warranty"></iframe>
<iframe width="940" height="1000" src="/1/acc-2/login.php"></iframe>
</pre>
direkt erreichbar über:

http://narda-sts.com.w00eb738.kasserver.com/1/RMA/rma_select_01.php?req_art=rep_cal
http://narda-sts.com.w00eb738.kasserver.com/1/RMA/rma_select_01.php?req_art=warranty
http://narda-sts.com.w00eb738.kasserver.com/1/acc-2/login.php

== TYPO3 RMA Extension ==
=== Dokumentation ===
Narda RMA Prozess [[Dokumentation gbrma]]

=== Zus. Leistungen ===
<pre>
Mail an Admin 6h / Mailtemplates
pdf Generierung
Vorfilterung nach Geräteklasse + Auswahlkontrolle
Admin Ansicht benötigt ???
Zusätzliche States
Geräteliste zum Aufklappen ab 5 Zeilen
Templatevarianten für
SRM / IDA
NBM
Detailansicht für beendete RMA
Express Calibration
fpdf Integration für acc
Bespr. Narda 2h
Setting up Testing Area
Klassen müssen ebenfalls einer Familie zugeordnet werden
Checkboxen (calib, mod/upgr., repair, no service, nur dann anzeigen, wenn sinnvoll
Checkboxen komplett weg für ACC
Regel für mehrere Basedevices erlaubt (Radman)
Clientnr. in fe_user
Zeige Rmas by Client nr.
Modification ausblenden wenn keine vorhanden
Auslagerung von Texten in Lokalisierungstextfiles
Möglichkeit zur Auswahl von Texten je nach Geräteklasse
Erklärungstexte für Status
ACC Filterung auf Geräteklassenebene
Mail an Admin bei Delete
Mapping des ERP Exports und checken der RMAs
Test Scheduler einrichten
</pre>

=== Änderungen ===
* Client ID Mode -> Speichern der Client ID implementieren - '''ToDo'''
* Fehler beim '''Import''' wenn Leerzeilen enthalten - '''OK'''
* Feature: Statt RMA Date immer '''Datum der letzten Status Aktualisierung'''. 1. Angelegt in T3 2. Datum der letzten Bearbeitung aus ERP Datei - '''OK'''
** Model erweitern (tstamp) - '''OK'''
** Templates auf tstamp statt cdate - '''OK'''
** Anpassen im Code - '''OK'''
* F: '''Datatables''' Skript für Listenansicht - '''OK'''
* '''Validierungen'''
** Keine Beschreibung bei Repair eingegeben - '''OK'''
** Kein Service Request gewählt - '''OK'''
** Inspection Repair und No Service nicht gemeinsam anwählbar - '''OK'''
** F: Wenn Repair dann keine Kalibrierung (ist beinhaltet) -> Änderung Calib und Repair möglich - '''OK'''
** F: Wenn Kalibrierung dann kein Repair -> ist doch möglich - '''OK'''
* F: Am Ende Auswahlfeld Expresskalibrierung aber nur wenn Kalibrierung ausgewählt ist '''Todo'''
* F: + Textfeld (Additional information) -> '''OK''' wird immer angezeigt auch wenn keine Expresskalib. ''' Evtl. anpassen (nach Rücksprache)'''
* '''Beispielbilder''' "Wo finde ich die Seriennummer" in Add Metadevice - '''ToDo'''
* Bug: Add Main Device, Add 2.Device, Zurück auf Main Device Tab => '''Tabs''' werden nicht mehr richtig dargestellt - '''OK'''
* Nichtssagende '''Fehlermeldung''' in AddMetadevice wenn die Validierung scheitert (Seite wird erneut angezeigt) - '''OK'''
* Feature: NewFormFields soll Auswahl für Acc nur anbieten wenn Userrecht vorliegt (Safety) - '''OK'''
* '''RMA Doku''' -> z.T. aus E-Mails übernehmen - '''TODO'''
* '''Fehlermeldungen von Extbase''' verhindern bei Browserbedienung (vor und zurück Buttons) - '''ToDo'''
** Wenn '''RMA nicht vorhanden''' (z.B. gelöscht) dann aussagekräftige Fehlermeldung) ''' ToDo '''
* Feature: '''RMA gelöscht Mail''' nur dann wenn Status 2 erreicht (also wenn schon eine Info bei Narda ankam) - '''OK'''
* '''RMA Nummern''' werden nur als gelöscht markiert bzw. eine Nummer wird nie mehrfach vergeben. - '''OK'''
* '''ACC'''
** '''PDF''' muß auch an Kunden (FE-User) gesendet werden - '''OK'''
* '''RMA löschen Bestätigung''' (JS) - '''OK'''
* SRM Auswahl der Geräte -> richtige Tabs aktiv -> bei SRM 3 Tabs "rf-cable" - '''OK'''
* E-Mail RMA Type weg, RMA Prominent oben, evtl. im Betreff - '''OK'''
* Zuerst Device Title dann SN - '''OK'''
* Umbenennungen
** Express Order -> Express Calibration Service - '''OK'''
** Factory Calibration / Repair -> ohne Warranty Request - '''OK'''
** Modification Texte 5 und 6 - '''OK'''
* F: ClientID Mode -> User mit der selben Client ID können RMAs anderer User sehen - '''ToDo'''
** Client Id als Merkmal im User - ''' ToDo '''
** Client ID muß beim abspreichern vorliegen und mit abgespeichert werden.

== Internet Präsenz Narda ==

Mischung aus verschiedenen Systemen

Hauptdomain: www.narda-sts.de

=== Content Management System ===
Frontend ist TYPO3 allerdings werden einige Download-Listen über ein php-Skript generiert.
Diese Inhalte werden über ein eigenes Tool realisiert.

=== FTP-Zugänge ===

Die Seite würd über vodafone gehostet. Vodafone der Zugriff erfolgt Zentral über
ftp.vodafone-ip.de

Im Admin Bereich von Vodafone kann man FTP Benutzer anlegen.
Der Zugriff erfolgt dann über [benutzername]%[domainname]
Also z.B. aszwei%narda-sts.de

=== Server Verwaltung ===
Hier kann man FTP Zugänge anlegen, auf phpMyAdmin zugreifen etc.
Login unter: https://webadmin.arcor.net/Secure/

=== phpMyAdmin ===
Direkt zu erreichen unter:

== Eigenes Admin System ==
Zur Verwaltung von downloads, etc.
http://www.narda-sts.de/admin/

Greift auf eine separate Datenbank zu, in der die Daten abgelegt sind.

==== Anpassen eines Software Downloads ====
Um einen Download anzupassen spielt man die Datei per FTP unterhalb des Verzeichnisses
/download/software/

Als nächstes öffnet man das Admin Tool und geht in den Menüpunkt
SoftwareUpdate (beta)
Dort kann man die Release Nummer anpassen (z.B. 2011) und aus dem Dropdownfeld die passende Datei auswählen.

==== Anlegen eines neuen Downloads ====
Hierbei muß man beachten daß in TYPO3 ein php Schnipsel eingebunden wird.
<pre>
<?php
include("fileadmin/user_upload/scripts/db_func.inc");
print (get_software_information("EFC_HF_Demo_EN"));
?>
</pre>

gibt einen Download Block inkl. Link und Beschreibung aus.
Wobei als Parameter der Name im Datenbankfeld re_call übergeben wird. Dieser wird beim Anlegen der Software manuell Vergeben

== Sales Partner Extranet ==
www.narda-sts.de/sp (oder /vp)

== RMA Garantie und Rücklaufgeräte ==
Dies wird über Vertragspartner erledigt, und es gibt ein weiteres Tool. Der User holt sich ein RMA Ticket (Online Formular) Je nach Region wird dann an den Vertriebspartner eine E-Mail versendet. Außerdem an Narda.

Auf dem Serverl liegt es im Ordner /1/RMA/

Im Quelltext sind auch etliche E-Mail Adressen hinterlegt die auf Mails zu Aichele und dem Programmierer hinweisen. Das müßte mal ausgemistet werden.

=== Kontaktdaten der Vertriebspartner ===
Diese sind in der Datenbank in der Tabelle ''' rma_requests''' hinterlegt.
Es gibt auch eine Tabelle Vertriebspartner. Ist aber nicht ganz klar wann diese benutzt werden.
Ich habe noch kein Administrationstool gefunden. Die Änderung kann aber direkt in der Datenbank erfolgen.

Edit:

Vertriebspartner in der Tabelle vertriebspartner werden vom RMA Prozess Tool (und vom neuen acc Tool) genutzt.

Es gibt außerdem eine Ausgabe der Vertriebspartner Adressen. Dabei werden über das Admin Tool (Narda Tool -> Partner Update) html Dateien geschrieben, die dann im Typo eingebunden sind. (Total umständlich). Es wird die Tabelle ??? genutzt.

=== Funktionsweise technische Realisierung (PHP-Skripte) ===
Siehe MindMap

Einstieg für den RMA Prozess ist der Link:

http://www.narda-sts.de/1/RMA/rma_select_01.php?req_art=rep_cal

In diesem Schritt wird die Länderauswahl angezeigt und die Art der Anfrege übergeben.
Nach der Länderauswahl sieht der link dann ungefähr so aus:

https://ssl.arcor-secure.de/narda-sts.de/1/RMA/rma_persData_02.php?req_art=rep_cal&req_id=P20110214_gF164223&req_reg=2

Es wird also eine req_id und req_reg Übergeben. Und die Persönlichen Daten abgefragt.

RMA/rma_reCall.php

== ACC Prozess ==
Für den ACC (Accredited Callbration) wurde das Tool komplett überarbeitet und entschlackt. Im Moment läuft es nicht auf dem Narda Server, sondern auf dem Geo-bit Server.

=== Hinweise zur Datenbank ===
Die Partner sind hier in der Tabelle Vertriebspartner hinterlegt. Sie Loggen sich mit ihrer ID und einem Passwort ein. Die Tabelle wurde ursprünglich kopiert und um einige Felder erweitert.

Es können sich nur Partner anmelden die im Feld

== Weitere Skripte ==

Es sind einige weitere Skripte im Einsatz:

=== Funktionsübersicht von Produkten ===
/doc/fileadmin/user_upload/scripts/func_overview.inc.php

Wird in Typo3 so aufgerufen:

<pre>
<?php
include("fileadmin/user_upload/scripts/func_overview.inc.php");
$config_file = "typo3conf/localconf.php";
$image_path = "fileadmin/user_upload/products/personal_protection";
$page_id = 70; // ID DER UEBERGEORDNETEN SEITE
print get_overview($page_id,$image_path,"Personal Monitor");
?>

</pre>

Funktion:

* Liest die aktuelle Sprache aus dem L Parameter oder der RealURL Adresse
* Liest die pid der untergeordneten Seiten aus.

=== Mailfunktion RMA / ACC ===
==== RMA ====
Es werden mehrere Mails generiert.

1. Schritt User Registrierung => Mail mit dem Ticket. Dieses enthält einen Link. Für die Geräteeingabe
Mailversand in '''rma_persData_02.php'''

2. Schritt Versand der RMA Daten
$html_mail_versand = send_html_mail($req_number,$req_ident_number,$req_art);
kommt aus '''mail_html_function.inc.php'''

==== ACC ====
Das Formular zur Eingabe liegt in '''acc_form.ph'''p Nach Absenden wird '''acc_form_send.php''' aufgerufen. In diesem wird die Mail über die Funktion
$success = send_acc_mail($rma_num,$arrForm,$arrPartner);
versendet. Die Funktion wird in '''lib/acal_functions.php''' zur Verfügung gestellt.
<pre>
FORMULAR MAILVERSAND / FEEDBACK
acc_form.php -> acc_form_send.php <- includes acal_functions.php (send_acc_mail)

</pre>

MySQL - Tips und Tricks

2015-10-23T17:28:18Z

87.165.0.123:

== Text in Zahlen umwandeln ==
http://stackoverflow.com/questions/11808573/sql-order-string-as-number (2015-10)

Cast your column value to an integer '''explicitly''' with

select col from yourtable
order by cast(col as unsigned)

or '''implicitly''' for instance with a mathematical operation which forces a conversion to number

select col from yourtable
order by col * 1

== Joins und GroupBy ==
Mit Joins kann man verknüpfte Tabellen abfragen. Mit groupby bündelt man doppelte Einträge. Mit group_concat kann man mehrere Werte aus den verknüpften Tabellen (z.B. bei mehrerern Kategorien) zusammenfassen.
=== Beispiel News ===
Quelle: http://www.typo-script.de/mysql-script/mysql-typo3-beispiel-zu-group_concat-mit-join (2013-10)

Folgende Abfrage soll umgesetzt werden: Zeige mir alle Datensätze, die zu einer Kategorie gehören. Konkret in diesem Fall, alle Newsbeiträge zu allen Newskategorien.
<pre>
SELECT
tt_news_cat.uid AS cat_id,
GROUP_CONCAT(DISTINCT tt_news.uid ORDER BY tt_news.uid DESC SEPARATOR ',') AS news_id

FROM tt_news
LEFT OUTER JOIN tt_news_cat_mm ON tt_news.uid = tt_news_cat_mm.uid_local
LEFT OUTER JOIN tt_news_cat ON tt_news_cat.uid = tt_news_cat_mm.uid_foreign

GROUP BY tt_news_cat.uid
</pre>
<pre>
+----+----------------+
| cat_id | news_id |
+----+----------------+
| 1 | 1,2,3,4 |
| 2 | 5,6 |
| 3 | 7,8,9,10 |
| 4 | 11,12 |
+--------+------------+
</pre>
Die Syntax der GROUP_CONCAT Funktion ist folgendermaßen aufgebaut:
GROUP_CONCAT([DISTINCT] expr [,expr ...]
[ORDER BY {unsigned_integer | col_name | expr}
[ASC | DESC] [,col_name ...]]
[SEPARATOR str_val])
Desweiteren sollte beachtet werden, das die maximale Zeichenanzahl der GROUP_CONCAT - Spalte auf eine Länge von 1024 Zeichen begrenzt ist. Sollte dies nicht ausreichen, kann man in der mysql.conf die Systemvariable group_concat_max_len an seine Bedürfnisse anpassen.

== Abfragen mit Pivot Tabellen ==
http://stackoverflow.com/questions/12808189/setting-column-values-as-column-names-in-the-sql-query-result

Pivot Abfragen kommen zum Einsatz, wenn Tabellen so aufgebaut sind, daß die Spaltennamen in der Tabelle drin sind. Eigentlich sollte man so etwas vermeiden, kommt aber z.B. beim Wordpress mit den Customfields vor. Es gibt keine Pivot Funktion in mySQL daher braucht man einen Workaround.
<pre>

Beispiel: Tabelle:
id col1 col2
----------------------
0 name ax
0 name2 bx
0 name3 cx
1 name dx
1 name2 ex
1 name2 fx
</pre>
Das Ergebnis sollte so aussehen:
<pre>
id name name2 name3
0 ax bx cx
1 dx ex fx
</pre>
So gehts:
<pre>
SELECT
id,
/* if col1 matches the name string of this CASE, return col2, otherwise return NULL */
/* Then, the outer MAX() aggregate will eliminate all NULLs and collapse it down to one row per id */
MAX(CASE WHEN (col1 = 'name') THEN col2 ELSE NULL END) AS name,
MAX(CASE WHEN (col1 = 'name2') THEN col2 ELSE NULL END) AS name2,
MAX(CASE WHEN (col1 = 'name3') THEN col2 ELSE NULL END) AS name3
FROM
yourtable
GROUP BY id
ORDER BY id
</pre>

Erklärung: Es wird nach id gruppiert (GROUP BY) Über Case wird geschaut ob der Wert da ist. Wenn nicht NULL zurückgegeben. MAX schmeißt alle NULLer raus und sorgt dafür daß es nur eine Zeile pro id gibt.

Das geht nur wenn man die gewünschten Spalten kennt. Die Spalten sind quasi statisch (hartcodiert). Wenn man die Spalten nicht kennt muß man das Statement dynamisch generieren:

<pre>
SET @sql = NULL;
SELECT
GROUP_CONCAT(DISTINCT
CONCAT(
'max(case when col1 = ''',
col1,
''' then col2 end) AS ',
col1
)
) INTO @sql
FROM yourtable;

SET @sql = CONCAT('SELECT id, ', @sql, '
FROM yourtable
GROUP BY id');

PREPARE stmt FROM @sql;
EXECUTE stmt;
DEALLOCATE PREPARE stmt;
</pre>

== Wert mit Werten aus einer Komma separierten Liste vergleichen==

Gerade bei Typo3 hat man oft das Problem, das man eine id mit einem Datenbank Textfeld mit einer Liste von Werten die mit Komma getrennt vorliegen vergleichen will. Die Typo funktionen sind Performancefresser. Eleganter geht es mit einer geschickten MySQL Abfrage.
Beispiel finde den Wert 7 in der Liste des Feldes usergroup (da steht z.B. 3,5,7,8,9 drin)

WHERE CONCAT(',',usergroup,',') LIKE '%,7,%'

oder:
WHERE FIND_IN_SET('7',usergroup)>0
== UPDATE mit Werten aus anderer Tabelle ==

aus: http://www.tutorials.de/forum/relationale-datenbanken-sql-mysql-oracle-db2-mssql/174881-mysql-update-mit-werten-aus-anderer-tabelle.html

Datum des Zugriffs: 4.4.2008

zunächst mal: Updates über mehrere Tabellen sind grundsätzlich "tricky" (siehe dazu die MySQL-Doku, speziell die Kommentare).

Dann: Der Tabellen-Name "order" ist nicht sehr empfehlenswert, da der Interpreter diesen Namen gerne mit dem ORDER BY verwechselt, ergo muss der Tabellenname order immer als `order` geschrieben werden, sonst droht Syntax-Error.

Ein weiteres Problem ist die Gruppen-Funktion MIN() ohne GROUP BY.

So, jetzt 2 Lösungsvorschläge, einmal mit SubQuery (ab MySQL 4.1):
Code:
<pre>
UPDATE
user AS u
LEFT JOIN
(SELECT uid, MIN(datum) AS mindatum FROM `order` GROUP BY uid) AS o ON u.id = o.uid
SET
u.createDate = o.mindatum
</pre>
und einmal mit temporärer Tabelle (MySQL 4.0 und früher):
Code:
<pre>
DROP TABLE IF EXISTS tmp_order;

CREATE TEMPORARY TABLE tmp_order TYPE = HEAP
SELECT uid, MIN(datum) AS mindatum FROM `order` GROUP BY uid;

UPDATE
user
LEFT JOIN
tmp_order ON user.id = tmp_order.uid
SET
user.createDate = tmp_order.mindatum;

DROP TABLE IF EXISTS tmp_order;
</pre>

Narda

2015-10-23T17:25:51Z

87.165.0.123: /* Zus. Leistungen */

== Überblick ==
RMA und ACC liegen auf Geo-bit Server und sind per iFrame eingebunden:
<pre>
<iframe width="940" height="1000" src="/1/RMA/rma_select_01.php?req_art=rep_cal"></iframe>
<iframe width="940" height="1000" src="/1/RMA/rma_select_01.php?req_art=warranty"></iframe>
<iframe width="940" height="1000" src="/1/acc-2/login.php"></iframe>
</pre>
direkt erreichbar über:

http://narda-sts.com.w00eb738.kasserver.com/1/RMA/rma_select_01.php?req_art=rep_cal
http://narda-sts.com.w00eb738.kasserver.com/1/RMA/rma_select_01.php?req_art=warranty
http://narda-sts.com.w00eb738.kasserver.com/1/acc-2/login.php

== TYPO3 RMA Extension ==
=== Dokumentation ===
Narda RMA Prozess [[Dokumentation gbrma]]

=== Zus. Leistungen ===
<pre>
Mail an Admin 6h / Mailtemplates
pdf Generierung
Vorfilterung nach Geräteklasse + Auswahlkontrolle
Admin Ansicht benötigt ???
Zusätzliche States
Geräteliste zum Aufklappen ab 5 Zeilen
Templatevarianten für
SRM / IDA
NBM
Detailansicht für beendete RMA
Express Calibration
fpdf Integration für acc
Bespr. Narda 2h
Setting up Testing Area
Klassen müssen ebenfalls einer Familie zugeordnet werden
Checkboxen (calib, mod/upgr., repair, no service, nur dann anzeigen, wenn sinnvoll
Checkboxen komplett weg für ACC
Regel für mehrere Basedevices erlaubt (Radman)
Clientnr. in fe_user
Zeige Rmas by Client nr.
Modification ausblenden wenn keine vorhanden
Auslagerung von Texten in Lokalisierungstextfiles
Möglichkeit zur Auswahl von Texten je nach Geräteklasse
Erklärungstexte für Status
ACC Filterung auf Geräteklassenebene
Mail an Admin bei Delete
Mapping des ERP Exports und checken der RMAs
Test Scheduler einrichten
</pre>

=== Änderungen ===
* Fehler beim '''Import''' wenn Leerzeilen enthalten - '''OK'''
* Feature: Statt RMA Date immer '''Datum der letzten Status Aktualisierung'''. 1. Angelegt in T3 2. Datum der letzten Bearbeitung aus ERP Datei - '''OK'''
** Model erweitern (tstamp) - '''OK'''
** Templates auf tstamp statt cdate - '''OK'''
** Anpassen im Code - '''OK'''
* F: '''Datatables''' Skript für Listenansicht - '''OK'''
* '''Validierungen'''
** Keine Beschreibung bei Repair eingegeben - '''OK'''
** Kein Service Request gewählt - '''OK'''
** Inspection Repair und No Service nicht gemeinsam anwählbar - '''OK'''
** F: Wenn Repair dann keine Kalibrierung (ist beinhaltet) -> Änderung Calib und Repair möglich - '''OK'''
** F: Wenn Kalibrierung dann kein Repair -> ist doch möglich - '''OK'''
* F: Am Ende Auswahlfeld Expresskalibrierung aber nur wenn Kalibrierung ausgewählt ist '''Todo'''
* F: + Textfeld (Additional information) -> '''OK''' wird immer angezeigt auch wenn keine Expresskalib. ''' Evtl. anpassen (nach Rücksprache)'''
* '''Beispielbilder''' "Wo finde ich die Seriennummer" in Add Metadevice - '''ToDo'''
* Bug: Add Main Device, Add 2.Device, Zurück auf Main Device Tab => '''Tabs''' werden nicht mehr richtig dargestellt - '''OK'''
* Nichtssagende '''Fehlermeldung''' in AddMetadevice wenn die Validierung scheitert (Seite wird erneut angezeigt) - '''OK'''
* Feature: NewFormFields soll Auswahl für Acc nur anbieten wenn Userrecht vorliegt (Safety) - '''OK'''
* '''RMA Doku''' -> z.T. aus E-Mails übernehmen - '''TODO'''
* '''Fehlermeldungen von Extbase''' verhindern bei Browserbedienung (vor und zurück Buttons) - '''ToDo'''
** Wenn '''RMA nicht vorhanden''' (z.B. gelöscht) dann aussagekräftige Fehlermeldung) ''' ToDo '''
* Feature: '''RMA gelöscht Mail''' nur dann wenn Status 2 erreicht (also wenn schon eine Info bei Narda ankam) - '''OK'''
* '''RMA Nummern''' werden nur als gelöscht markiert bzw. eine Nummer wird nie mehrfach vergeben. - '''OK'''
* '''ACC'''
** '''PDF''' muß auch an Kunden (FE-User) gesendet werden - '''OK'''
* '''RMA löschen Bestätigung''' (JS) - '''OK'''
* SRM Auswahl der Geräte -> richtige Tabs aktiv -> bei SRM 3 Tabs "rf-cable" - '''OK'''
* E-Mail RMA Type weg, RMA Prominent oben, evtl. im Betreff - '''OK'''
* Zuerst Device Title dann SN - '''OK'''
* Umbenennungen
** Express Order -> Express Calibration Service - '''OK'''
** Factory Calibration / Repair -> ohne Warranty Request - '''OK'''
** Modification Texte 5 und 6 - '''OK'''
* F: ClientID Mode -> User mit der selben Client ID können RMAs anderer User sehen - '''ToDo'''
** Client Id als Merkmal im User - ''' ToDo '''
** Client ID muß beim abspreichern vorliegen und mit abgespeichert werden.

== Internet Präsenz Narda ==

Mischung aus verschiedenen Systemen

Hauptdomain: www.narda-sts.de

=== Content Management System ===
Frontend ist TYPO3 allerdings werden einige Download-Listen über ein php-Skript generiert.
Diese Inhalte werden über ein eigenes Tool realisiert.

=== FTP-Zugänge ===

Die Seite würd über vodafone gehostet. Vodafone der Zugriff erfolgt Zentral über
ftp.vodafone-ip.de

Im Admin Bereich von Vodafone kann man FTP Benutzer anlegen.
Der Zugriff erfolgt dann über [benutzername]%[domainname]
Also z.B. aszwei%narda-sts.de

=== Server Verwaltung ===
Hier kann man FTP Zugänge anlegen, auf phpMyAdmin zugreifen etc.
Login unter: https://webadmin.arcor.net/Secure/

=== phpMyAdmin ===
Direkt zu erreichen unter:

== Eigenes Admin System ==
Zur Verwaltung von downloads, etc.
http://www.narda-sts.de/admin/

Greift auf eine separate Datenbank zu, in der die Daten abgelegt sind.

==== Anpassen eines Software Downloads ====
Um einen Download anzupassen spielt man die Datei per FTP unterhalb des Verzeichnisses
/download/software/

Als nächstes öffnet man das Admin Tool und geht in den Menüpunkt
SoftwareUpdate (beta)
Dort kann man die Release Nummer anpassen (z.B. 2011) und aus dem Dropdownfeld die passende Datei auswählen.

==== Anlegen eines neuen Downloads ====
Hierbei muß man beachten daß in TYPO3 ein php Schnipsel eingebunden wird.
<pre>
<?php
include("fileadmin/user_upload/scripts/db_func.inc");
print (get_software_information("EFC_HF_Demo_EN"));
?>
</pre>

gibt einen Download Block inkl. Link und Beschreibung aus.
Wobei als Parameter der Name im Datenbankfeld re_call übergeben wird. Dieser wird beim Anlegen der Software manuell Vergeben

== Sales Partner Extranet ==
www.narda-sts.de/sp (oder /vp)

== RMA Garantie und Rücklaufgeräte ==
Dies wird über Vertragspartner erledigt, und es gibt ein weiteres Tool. Der User holt sich ein RMA Ticket (Online Formular) Je nach Region wird dann an den Vertriebspartner eine E-Mail versendet. Außerdem an Narda.

Auf dem Serverl liegt es im Ordner /1/RMA/

Im Quelltext sind auch etliche E-Mail Adressen hinterlegt die auf Mails zu Aichele und dem Programmierer hinweisen. Das müßte mal ausgemistet werden.

=== Kontaktdaten der Vertriebspartner ===
Diese sind in der Datenbank in der Tabelle ''' rma_requests''' hinterlegt.
Es gibt auch eine Tabelle Vertriebspartner. Ist aber nicht ganz klar wann diese benutzt werden.
Ich habe noch kein Administrationstool gefunden. Die Änderung kann aber direkt in der Datenbank erfolgen.

Edit:

Vertriebspartner in der Tabelle vertriebspartner werden vom RMA Prozess Tool (und vom neuen acc Tool) genutzt.

Es gibt außerdem eine Ausgabe der Vertriebspartner Adressen. Dabei werden über das Admin Tool (Narda Tool -> Partner Update) html Dateien geschrieben, die dann im Typo eingebunden sind. (Total umständlich). Es wird die Tabelle ??? genutzt.

=== Funktionsweise technische Realisierung (PHP-Skripte) ===
Siehe MindMap

Einstieg für den RMA Prozess ist der Link:

http://www.narda-sts.de/1/RMA/rma_select_01.php?req_art=rep_cal

In diesem Schritt wird die Länderauswahl angezeigt und die Art der Anfrege übergeben.
Nach der Länderauswahl sieht der link dann ungefähr so aus:

https://ssl.arcor-secure.de/narda-sts.de/1/RMA/rma_persData_02.php?req_art=rep_cal&req_id=P20110214_gF164223&req_reg=2

Es wird also eine req_id und req_reg Übergeben. Und die Persönlichen Daten abgefragt.

RMA/rma_reCall.php

== ACC Prozess ==
Für den ACC (Accredited Callbration) wurde das Tool komplett überarbeitet und entschlackt. Im Moment läuft es nicht auf dem Narda Server, sondern auf dem Geo-bit Server.

=== Hinweise zur Datenbank ===
Die Partner sind hier in der Tabelle Vertriebspartner hinterlegt. Sie Loggen sich mit ihrer ID und einem Passwort ein. Die Tabelle wurde ursprünglich kopiert und um einige Felder erweitert.

Es können sich nur Partner anmelden die im Feld

== Weitere Skripte ==

Es sind einige weitere Skripte im Einsatz:

=== Funktionsübersicht von Produkten ===
/doc/fileadmin/user_upload/scripts/func_overview.inc.php

Wird in Typo3 so aufgerufen:

<pre>
<?php
include("fileadmin/user_upload/scripts/func_overview.inc.php");
$config_file = "typo3conf/localconf.php";
$image_path = "fileadmin/user_upload/products/personal_protection";
$page_id = 70; // ID DER UEBERGEORDNETEN SEITE
print get_overview($page_id,$image_path,"Personal Monitor");
?>

</pre>

Funktion:

* Liest die aktuelle Sprache aus dem L Parameter oder der RealURL Adresse
* Liest die pid der untergeordneten Seiten aus.

=== Mailfunktion RMA / ACC ===
==== RMA ====
Es werden mehrere Mails generiert.

1. Schritt User Registrierung => Mail mit dem Ticket. Dieses enthält einen Link. Für die Geräteeingabe
Mailversand in '''rma_persData_02.php'''

2. Schritt Versand der RMA Daten
$html_mail_versand = send_html_mail($req_number,$req_ident_number,$req_art);
kommt aus '''mail_html_function.inc.php'''

==== ACC ====
Das Formular zur Eingabe liegt in '''acc_form.ph'''p Nach Absenden wird '''acc_form_send.php''' aufgerufen. In diesem wird die Mail über die Funktion
$success = send_acc_mail($rma_num,$arrForm,$arrPartner);
versendet. Die Funktion wird in '''lib/acal_functions.php''' zur Verfügung gestellt.
<pre>
FORMULAR MAILVERSAND / FEEDBACK
acc_form.php -> acc_form_send.php <- includes acal_functions.php (send_acc_mail)

</pre>