Dokumentation gbrma

Geräte verwalten

gbdevices

RMAs anlegen

gbrma

Status einer RMA

siehe Technische Dokumentation

Status Update über Uploadmodul und ERP Import Modul

Die Extension gbrma kann bestimmte Files einlesen und die enthaltenen Daten werden anschließend für den Statusupdate der RMAs genutzt. Das Importmodul kann auf fremde Server zugreifen. Es gibt aber auch ein Modul zum hochladen von Dateien.

rmaupload

Um ERP Dateien hochzuladen gibt es die kleine rmaupload Extension. Sie stellt im Prinzip ein Hochladeformular zur Verfügung.

Beispielkonfiguration

rmaupload in der Standardkonfiguration

rmaupload doku

Constants

plugin.tx_rmaupload {
	view {
		# cat=plugin.tx_rmaupload/file; type=string; label=Path to template root (FE)
		templateRootPath = EXT:rmaupload/Resources/Private/Templates/
		# cat=plugin.tx_rmaupload/file; type=string; label=Path to template partials (FE)
		partialRootPath = EXT:rmaupload/Resources/Private/Partials/
		# cat=plugin.tx_rmaupload/file; type=string; label=Path to template layouts (FE)
		layoutRootPath = EXT:rmaupload/Resources/Private/Layouts/
	}
	persistence {
		# cat=plugin.tx_rmaupload//a; type=string; label=Default storage PID
		storagePid =
	}
}

Setup

plugin.tx_rmaupload { view { templateRootPath = {$plugin.tx_rmaupload.view.templateRootPath} partialRootPath = {$plugin.tx_rmaupload.view.partialRootPath} layoutRootPath = {$plugin.tx_rmaupload.view.layoutRootPath} } persistence { storagePid = {$plugin.tx_rmaupload.persistence.storagePid} } features { # uncomment the following line to enable the new Property Mapper. # rewrittenPropertyMapper = 1 } settings{ uploadPath=fileadmin/user_upload/rma/ } }

Einrichtung

Installation

• Extensions installieren:
  • gbdevices
  • gbrma
  • rmaupload (wenn benötigt)

• Devices Datensätze falls vorhanden importieren
• Benutzergruppen anlegen:
  • RMA Gruppe für Generellen Zugang zu den Seiten
  • Allow xyz Family Access (wenn man den Zugang zu bestimmten Gerätefamilen restriktieren will.
• Konfiguration s.u.
• Speicherordner in Konstanten

plugin.tx_gbdevices.persistence.storagePid = 49
plugin.tx_gbrma.persistence.storagePid = 49

• Speicherordner in Seiten anlegen (für Verbundene Datensätze)
• Für jeden RMA Typ einen Eintrag mit Basis Nr.
• Scheduler

TS Configuration

Konstanten

plugin.tx_gbdevices.persistence.storagePid = 49 # gbdevices wird benötigt für gbrma
plugin.tx_gbrma.persistence.storagePid = 49 # Speicherort der RMA Daten

Setup

senderMail = test@example.com //na
senderMailName = Test Mailer //na
adminMail = email@example.com // Adresse für Admin Mails
adminMailName = Test Admin // Name des Admins in E-Mails
mailSubject = RMA Request // Betreffzeile der Admin Mails wenn nicht anders im Code definiert evtl. rauswerfen TODO
superuserId = 1 // na
nbmClassId = 7 // Geräteklassen ID für nbm Geräte (für Sonderregelung bei der Auswahl)
nbm520Id = 104 // Geräte ID für nbm 520 wegen Sonderregelung
nbm550Id = 103 // Geräte ID für nbm550 wegen Sonderregelung
multipleBaseDevicesAllowedClassIds = 
restrictFamilyAccessToFegroups = 0 // Schalter - beschränkt Zugriff auf bestimmte Gerätefamilien 
// Wenn an dann muß die Familie einer Usergruppe zugeordnet sein. Nur User dieser Gruppe stehen Geräten dieser Familie für RMAs zur Verfügung
#pdf_css = EXT:gbrma/Resources/Public/Css/pdf.css // Not used
#pdf_html = EXT:gbrma/Resources/Private/Templates/Pdf/pdf.html // Not used
retourRmaAllowedGroupId = 0

Zugriff auf RMA Plugin schützen

Das Plugin erlaubt generell jedem FE-User RMAs anzulegen. Welche Art von RMAs wird durch die weitere Konfiguration geregelt (s.u.). Wenn Nur bestimmte Benutzer das Plugin benutzen sollen kann man eine normale FE-User Gruppe (z.B. mit dem Namen RMA) anlegen und für die Seite auf der das Plugin liegt einen FE-User Zugriff einrichten.

Family Access

restrictFamilyAccessToFegroups = 1

Wenn dieser Wert im Setup gesetzt wird, dann kann der Benutzer nur noch bestimmte Gerätefamilien für RMAs auswählen. Wenn es nicht gesetzt ist können die Benutzer alle Familien nutzen.

Durch die Installation von gbrma wird gbdevices um ein Feld erweitert.

• GB Devices -> Familie auswählen und Benutzergruppe im Feld Allowed FE-User Group setzen
• Dem FE User diese Gruppe zuordnen.

Retour RMAs

Konfiguration

• Gruppe anlegen z.B. "Erlaube Retour RMAs"
• ID der Gruppe merken
• TypoScript konfigurieren

# Feature einschalten
restrictRetourAccessToFegroups = 1
# Gruppen ID eintragen (mehrere mit Komma trennen) 
retourRmaAllowedGroupIds = 4,5,6

• Gruppe dem gewünschten Benutzer zuordnen

Client Mode

In diesem Modus dient die Client ID (im User unter RMA hinterlegt) als Zugriffsmerkmal für die RMAs. D.h. mehrere User können auf die selben RMAs zugreifen

Modifications

Manche Geräte können modifiziert werden. Hartkodiert in gbdevices im Model und in den Sprachdateien

Model / Fields Dokumentation

Beispiel Array einer RMA mit untergeordneten Models für Metadevice, Device, DeviceClass, DeviceFamily

array(rma => Geobit\Gbrma\Domain\Model\Rmaprototypepersistent entity (uid=11, pid=53)
      rmaNumber => '8' (1 chars)
      rmaType => 1 (integer)
      locked => 0 (integer)
      state => 0 (integer)
      orderExpress => 0 (integer)
      additionalInformation => '' (0 chars)
      rmaUser => 1 (integer)
      crdate => 1443778492 (integer)
      tstamp => 1443783879 (integer)
      uid => 11 (integer)
      pid => 53 (integer)
      metadevice => TYPO3\CMS\Extbase\Persistence\ObjectStorageprototypeobject (2 items)
         0000000002d804830000000151a56f69 => Geobit\Gbrma\Domain\Model\Metadeviceprototypepersistent entity (uid=12, pid=53)
            uid => 12 (integer)
            pid => 53 (integer)
            serial => 'aewtqwer' (8 chars)
            description => '' (0 chars)
            jsondata => '{"none":"1"}' (12 chars)
            serviceRepair => 0 (integer)
            serviceCalibration => 0 (integer)
            serviceModification => 0 (integer)
            serviceNone => 1 (integer)
            device => Geobit\Gbdevices\Domain\Model\Deviceprototypepersistent entity (uid=3, pid=49)
               uid => 3 (integer)
               pid => 49 (integer)
               deviceTitle => '2138/01 EMD-100' (15 chars)
               deviceDescription => '' (0 chars)
               deviceType => 1 (integer)
               isBaseDevice => FALSE
               accPossible => FALSE
               repairDiscontinued => TRUE
               modification => 0 (integer)
               deviceImage => NULL
               deviceClass => Geobit\Gbdevices\Domain\Model\DeviceClassprototypepersistent entity (uid=2, pid=49)
                  classTitle => 'EMD Series' (10 chars)
                  classDescription => '' (0 chars)
                  classFamily => 0 (integer)
                  accPossible => FALSE
                  uid => 2 (integer)
                  pid => 49 (integer)
               deviceFamily => Geobit\Gbdevices\Domain\Model\DeviceFamilyprototypepersistent entity (uid=1, pid=49)
                  familyTitle => 'Safety' (6 chars)
                  familyDescription => 'NARDA Safety Product Family' (27 chars)
                  familyFegroupAccess => 2 (integer)
                  uid => 1 (integer)
                  pid => 49 (integer)
)

RMA Types

Code Hints

Definiert in:

• Template: ListRmas.html
• Template: NewFormFields.html
• Template: Mail.html

Fehler beheben

Scheduler Probleme

importFile gesetzt und vorhanden?