content: /**
   * Copyright 2020 Alexander Herzog
   *
   * Licensed under the Apache License, Version 2.0 (the "License");
   * you may not use this file except in compliance with the License.
   * You may obtain a copy of the License at
   *
   * http://www.apache.org/licenses/LICENSE-2.0
   *
   * Unless required by applicable law or agreed to in writing, software
   * distributed under the License is distributed on an "AS IS" BASIS,
   * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
   * See the License for the specific language governing permissions and
   * limitations under the License.
   */
  package ui.modeleditor.elements;
  
  import java.awt.Color;
  import java.awt.Component;
  import java.awt.Point;
  import java.util.ArrayList;
  import java.util.List;
  import java.util.Objects;
  import java.util.function.Consumer;
  
  import javax.swing.Icon;
  import javax.swing.JMenu;
  import javax.swing.JMenuItem;
  import javax.swing.JPopupMenu;
  
  import org.w3c.dom.Document;
  import org.w3c.dom.Element;
  
  import language.Language;
  import mathtools.NumberTools;
  import simulator.editmodel.EditModel;
  import simulator.editmodel.FullTextSearch;
  import ui.images.Images;
  import ui.modeleditor.ModelClientData;
  import ui.modeleditor.ModelSequences;
  import ui.modeleditor.ModelSurface;
  import ui.modeleditor.ModelSurfacePanel;
  import ui.modeleditor.coreelements.ModelElement;
  import ui.modeleditor.coreelements.ModelElementBox;
  import ui.modeleditor.coreelements.ModelElementEdgeMultiIn;
  import ui.modeleditor.coreelements.ModelElementEdgeOut;
  import ui.modeleditor.coreelements.ModelElementPosition;
  import ui.modeleditor.descriptionbuilder.ModelDescriptionBuilder;
  import ui.modeleditor.elements.BatchRecord.DataTransferMode;
  import ui.modeleditor.fastpaint.Shapes;
  
  /**
   * Wartet bis an jedem Eingang der Station ein Kunde wartet
   * und leitet sie dann entweder gleichzeitig einzeln oder
   * als temporren oder permanenten Batch weiter.
   * @author Alexander Herzog
   */
  public class ModelElementMatch extends ModelElementBox implements ElementWithNewClientNames, ModelElementEdgeMultiIn, ModelElementEdgeOut, ModelElementAnimationForceMove {
  	/**
  	 * Art der Batch-Bildung
  	 * @author Alexander Herzog
  	 * @see ModelElementMatch#getMatchMode()
  	 * @see ModelElementMatch#setMatchMode(MatchMode)
  	 */
  	public enum MatchMode {
  		/** Sammelt die Kunden und leitet sie dann gemeinsam weiter (kein Batching im engeren Sinne). */
  		MATCH_MODE_COLLECT,
  
  		/** Fasst die Kunden zu einem temporren Batch zusammen. */
  		MATCH_MODE_TEMPORARY,
  
  		/** Fasst die Kunden zu einem neuen Kunden zusammen (permanentes Batching). */
  		MATCH_MODE_PERMANENT
  	}
  
  	/**
  	 * Von welcher Art ist die Eigenschaft, die zwischen
  	 * den wartenden Kunden abgeglichen werden soll?
  	 * @author Alexander Herzog
  	 * @see ModelElementMatch#getMatchPropertyMode()
  	 * @see ModelElementMatch#setMatchPropertyMode(MatchPropertyMode)
  	 */
  	public enum MatchPropertyMode {
  		/** Kein Abgleich von Eigenschaften */
  		NONE,
  
  		/** Eine Zahlen-Eigenschaft zum Abgleich verwenden */
  		NUMBER,
  
  		/** Eine Text-Eigenschaft zum Abgleich verwenden */
  		TEXT,
  	}
  
  	/**
  	 * Liste der einlaufenden Kanten
  	 */
  	protected final List<ModelElementEdge> connectionsIn;
  
  	/**
  	 * Auslaufende Kante
  	 */
  	protected ModelElementEdge connectionOut;
  
  	/**
  	 * Modus wie Eigenschaften der Kunden beim Zusammenfhren abgeglichen werden sollen
  	 * @see #getMatchMode()
  	 * @see #setMatchMode(MatchMode)
  	 * @see MatchPropertyMode
  	 */
  	private MatchPropertyMode matchPropertyMode;
  
  	/**
  	 * Index der Kundendateneigenschaft, die beim Zusammenfhren bercksichtigt werden soll
  	 * @see #getMatchPropertyNumber()
  	 * @see #setMatchPropertyNumber(int)
  	 * @see #matchPropertyString
  	 */
  	private int matchPropertyNumber;
  
  	/**
  	 * Schlssel der Kundendaten-Texteigenschaft, die beim Zusammenfhren bercksichtigt werden soll
  	 * @see #getMatchPropertyString()
  	 * @see #setMatchPropertyString(String)
  	 * @see #matchPropertyNumber
  	 */
  	private String matchPropertyString;
  
  	/**
  	 * Match-Modus
  	 * @see #getMatchMode()
  	 * @see #setMatchMode(MatchMode)
  	 */
  	private MatchMode matchMode;
  
  	/**
  	 * Neuer Kundentyp (wenn die Kunden nicht einfach einzeln weitergeleitet werden)
  	 * @see #getNewClientType()
  	 * @see #setNewClientType(String)
  	 */
  	private String newClientType;
  
  	/**
  	 * Bedingung, die fr eine Weitergabe der Kunden erfllt sein muss
  	 * @see #getCondition()
  	 * @see #setCondition(String)
  	 */
  	private String condition;
  
  	/**
  	 * Wie sollen die Zeiten der Einzelkunden bei der Batch-Bildung auf den neuen Batch-Kunden bertragen werden?
  	 * @see #getTransferTimes()
  	 * @see #setTransferTimes(DataTransferMode)
  	 */
  	private DataTransferMode transferTimes;
  
  	/**
  	 * Wie sollen die numerischen Datenfelder der Einzelkunden bei der Batch-Bildung auf den neuen Batch-Kunden bertragen werden?
  	 * @see #getTransferNumbers()
  	 * @see #setTransferNumbers(DataTransferMode)
  	 */
  	private DataTransferMode transferNumbers;
  
  	/** IDs der einlaufenden Kanten (Wird nur beim Laden und Clonen verwendet.) */
  	private List<Integer> connectionsInIds=null;
  	/** ID der auflaufenden Kante (Wird nur beim Laden und Clonen verwendet.) */
  	private int connectionOutId=-1;
  
  	/**
  	 * Konstruktor der Klasse <code>ModelElementMatch</code>
  	 * @param model	Modell zu dem dieses Element gehren soll (kann spter nicht mehr gendert werden)
  	 * @param surface	Zeichenflche zu dem dieses Element gehren soll (kann spter nicht mehr gendert werden)
  	 */
  	public ModelElementMatch(final EditModel model, final ModelSurface surface) {
  		super(model,surface,Shapes.ShapeType.SHAPE_WEDGE_ARROW_RIGHT);
  		connectionsIn=new ArrayList<>();
  
  		matchPropertyMode=MatchPropertyMode.NONE;
  		matchPropertyNumber=0;
  		matchPropertyString="";
  
  		matchMode=MatchMode.MATCH_MODE_COLLECT;
  		newClientType="";
  
  		condition="";
  
  		transferTimes=DataTransferMode.OFF;
  		transferNumbers=DataTransferMode.OFF;
  	}
  
  	/**
  	 * Icon, welches im "Element hinzufgen"-Dropdown-Men angezeigt werden soll.
  	 * @return	Icon fr das Dropdown-Men
  	 */
  	@Override
  	public Icon getAddElementIcon() {
  		return Images.MODELEDITOR_ELEMENT_MATCH.getIcon();
  	}
  
  	/**
  	 * Tooltip fr den "Element hinzufgen"-Dropdown-Men-Eintrag.
  	 * @return Tooltip fr den "Element hinzufgen"-Dropdown-Meneintrag
  	 */
  	@Override
  	public String getToolTip() {
  		return Language.tr("Surface.Match.Tooltip");
  	}
  
  	/**
  	 * Muss aufgerufen werden, wenn sich eine Eigenschaft des Elements ndert.
  	 */
  	@Override
  	public void fireChanged() {
  		updateEdgeLabel();
  		updateIcon();
  		super.fireChanged();
  	}
  
  	/**
  	 * Aktualisiert die Darstellung des zustzlichen Icons auf der Station.
  	 * @see #fireChanged()
  	 */
  	private void updateIcon() {
  		if (matchMode!=null) switch (matchMode) {
  		case MATCH_MODE_COLLECT:
  			setAdditionalClientIconFromName(null);
  			break;
  		case MATCH_MODE_PERMANENT:
  			setAdditionalClientIconFromName(newClientType);
  			break;
  		case MATCH_MODE_TEMPORARY:
  			setAdditionalClientIconFromName(newClientType);
  			break;
  		}
  	}
  
  	/**
  	 * Aktualisiert die Beschriftung der auslaufenden Kante
  	 * @see #fireChanged()
  	 */
  	private void updateEdgeLabel() {
  		final String s=newClientType;
  		if (connectionOut!=null) connectionOut.setName(s.isEmpty()?"":(Language.tr("Surface.Match.NewClientType")+" \""+s+"\""));
  	}
  
  	/**
  	 * Liefert den aktuellen Modus wie Eigenschaften der Kunden beim Zusammenfhren abgeglichen werden sollen.
  	 * @return	Aktueller Modus wie Eigenschaften der Kunden beim Zusammenfhren abgeglichen werden sollen
  	 */
  	public MatchPropertyMode getMatchPropertyMode() {
  		return matchPropertyMode;
  	}
  
  	/**
  	 * Stellt einen neuen Modus wie Eigenschaften der Kunden beim Zusammenfhren abgeglichen werden sollen ein.
  	 * @param newMatchPropertyMode	Neuer Modus wie Eigenschaften der Kunden beim Zusammenfhren abgeglichen werden sollen
  	 */
  	public void setMatchPropertyMode(final MatchPropertyMode newMatchPropertyMode) {
  		if (newMatchPropertyMode!=null) matchPropertyMode=newMatchPropertyMode;
  	}
  
  	/**
  	 * Liefert, wenn beim Zusammenfhren ein Eigenschaftsabgleich auf Basis eines Zahlenwertes erfolgen soll, den Index der Kundendateneigenschaft.
  	 * @return	Index der Kundendateneigenschaft
  	 */
  	public int getMatchPropertyNumber() {
  		return matchPropertyNumber;
  	}
  
  	/**
  	 * Stellt fr den Fall, dass beim Zusammenfhren ein Eigenschaftsabgleich auf Basis eines Zahlenwertes erfolgen soll, den Index der Kundendateneigenschaft ein.
  	 * @param newMatchPropertyNumber	Index der Kundendateneigenschaft
  	 */
  	public void setMatchPropertyNumber(final int newMatchPropertyNumber) {
  		matchPropertyMode=MatchPropertyMode.NUMBER;
  		matchPropertyNumber=newMatchPropertyNumber;
  	}
  
  	/**
  	 * Liefert, wenn beim Zusammenfhren ein Eigenschaftsabgleich auf Basis einer Zeichenkette erfolgen soll, den Schlssel der Kundendaten-Texteigenschaft.
  	 * @return	Schlssel der Kundendaten-Texteigenschaft
  	 */
  	public String getMatchPropertyString() {
  		if (matchPropertyString==null) return ""; else return matchPropertyString;
  	}
  
  	/**
  	 * Stellt fr den Fall, dass beim Zusammenfhren ein Eigenschaftsabgleich auf Basis einer Zeichenkette erfolgen soll, den Schlssel der Kundendaten-Texteigenschaft ein.
  	 * @param newMatchPropertyString	Schlssel der Kundendaten-Texteigenschaft.
  	 */
  	public void setMatchPropertyString(final String newMatchPropertyString) {
  		matchPropertyMode=MatchPropertyMode.TEXT;
  		matchPropertyString=(newMatchPropertyString==null)?"":newMatchPropertyString;
  	}
  
  	/**
  	 * Liefert den aktuell gewhlten Match-Modus.
  	 * @return	Aktueller Match-Modus
  	 * @see MatchMode
  	 */
  	public MatchMode getMatchMode() {
  		return matchMode;
  	}
  
  	/**
  	 * Stellt den Match-Modus ein.
  	 * @param matchMode	Neuer Match-Modus
  	 * @see MatchMode
  	 */
  	public void setMatchMode(MatchMode matchMode) {
  		switch (matchMode) {
  		case MATCH_MODE_COLLECT:
  			this.matchMode=MatchMode.MATCH_MODE_COLLECT;
  			newClientType="";
  			break;
  		case MATCH_MODE_TEMPORARY:
  			this.matchMode=MatchMode.MATCH_MODE_TEMPORARY;
  			break;
  		case MATCH_MODE_PERMANENT:
  			this.matchMode=MatchMode.MATCH_MODE_PERMANENT;
  			break;
  		}
  	}
  
  	/**
  	 * Liefert den Kundentyp, unter dem die zusammengefhrten Kunden weitergeleitet werden sollen.
  	 * @return	Neuer Kundentyp oder leerer String, wenn die Kunden einzeln weitergeleitet werden sollen
  	 */
  	public String getNewClientType() {
  		return newClientType;
  	}
  
  	/**
  	 * Stellt den Kundentyp ein, unter dem die zusammengefhrten Kunden weitergeleitet werden sollen.
  	 * @param newClientType	Neuer Kundentyp oder leerer String, wenn die Kunden einzeln weitergeleitet werden sollen
  	 */
  	public void setNewClientType(final String newClientType) {
  		if (newClientType==null || newClientType.isBlank()) {
  			this.newClientType="";
  			matchMode=MatchMode.MATCH_MODE_COLLECT;
  		} else {
  			this.newClientType=newClientType;
  			if (matchMode==MatchMode.MATCH_MODE_COLLECT) matchMode=MatchMode.MATCH_MODE_PERMANENT;
  		}
  	}
  
  	/**
  	 * Liefert die Bedingung, die erfllt sein muss, damit Kunden weitergeleitet werden.
  	 * @return Bedingung, die fr eine Weitergabe der Kunden erfllt sein muss
  	 */
  	public String getCondition() {
  		return condition;
  	}
  
  	/**
  	 * Stellt die Bedingung ein, die erfllt sein muss, damit Kunden weitergeleitet werden.
  	 * @param newCondition	Neue zu erfllende Bedingung
  	 */
  	public void setCondition(final String newCondition) {
  		if (newCondition!=null) condition=newCondition;
  	}
  
  	/**
  	 * Wie sollen die Zeiten der Einzelkunden bei der Batch-Bildung auf den neuen Batch-Kunden bertragen werden?
  	 * @return	Wie sollen die Zeiten der Einzelkunden bei der Batch-Bildung auf den neuen Batch-Kunden bertragen werden?
  	 */
  	public DataTransferMode getTransferTimes() {
  		return transferTimes;
  	}
  
  	/**
  	 * Stellt ein, wie die Zeiten der Einzelkunden bei der Batch-Bildung auf den neuen Batch-Kunden bertragen werden sollen.
  	 * @param transferTimes	Wie sollen die Zeiten der Einzelkunden bei der Batch-Bildung auf den neuen Batch-Kunden bertragen werden?
  	 */
  	public void setTransferTimes(final DataTransferMode transferTimes) {
  		this.transferTimes=(transferTimes==null)?DataTransferMode.OFF:transferTimes;
  	}
  
  	/**
  	 * Wie sollen die numerischen Datenfelder der Einzelkunden bei der Batch-Bildung auf den neuen Batch-Kunden bertragen werden?
  	 * @return	Wie sollen die numerischen Datenfelder der Einzelkunden bei der Batch-Bildung auf den neuen Batch-Kunden bertragen werden?
  	 */
  	public DataTransferMode getTransferNumbers() {
  		return transferNumbers;
  	}
  
  	/**
  	 * Stellt ein, wie die numerischen Datenfelder der Einzelkunden bei der Batch-Bildung auf den neuen Batch-Kunden bertragen werden sollen.
  	 * @param transferNumbers	Wie sollen die numerischen Datenfelder der Einzelkunden bei der Batch-Bildung auf den neuen Batch-Kunden bertragen werden?
  	 */
  	public void setTransferNumbers(final DataTransferMode transferNumbers) {
  		this.transferNumbers=(transferNumbers==null)?DataTransferMode.OFF:transferNumbers;
  	}
  
  	/**
  	 * berprft, ob das Element mit dem angegebenen Element inhaltlich identisch ist.
  	 * @param element	Element mit dem dieses Element verglichen werden soll.
  	 * @return	Gibt <code>true</code> zurck, wenn die beiden Elemente identisch sind.
  	 */
  	@Override
  	public boolean equalsModelElement(ModelElement element) {
  		if (!super.equalsModelElement(element)) return false;
  		if (!(element instanceof ModelElementMatch)) return false;
  
  		final ModelElementMatch otherMatch=(ModelElementMatch)element;
  
  		if (matchPropertyMode!=otherMatch.matchPropertyMode) return false;
  		if (matchPropertyMode==MatchPropertyMode.NUMBER) {
  			if (matchPropertyNumber!=otherMatch.matchPropertyNumber) return false;
  		}
  		if (matchPropertyMode==MatchPropertyMode.TEXT) {
  			if (!Objects.deepEquals(matchPropertyString,otherMatch.matchPropertyString)) return false;
  		}
  
  		if (matchMode!=otherMatch.matchMode) return false;
  		if (matchMode==MatchMode.MATCH_MODE_TEMPORARY || matchMode==MatchMode.MATCH_MODE_PERMANENT) {
  			if (!otherMatch.newClientType.equals(newClientType)) return false;
  		}
  
  		if (connectionOut==null) {
  			if (otherMatch.connectionOut!=null) return false;
  		} else {
  			if (otherMatch.connectionOut==null) return false;
  			if (connectionOut.getId()!=otherMatch.connectionOut.getId()) return false;
  		}
  
  		if (!otherMatch.condition.equalsIgnoreCase(condition)) return false;
  
  		if (transferTimes!=otherMatch.transferTimes) return false;
  		if (transferNumbers!=otherMatch.transferNumbers) return false;
  
  		final List<ModelElementEdge> connectionsIn2=otherMatch.connectionsIn;
  		if (connectionsIn==null || connectionsIn2==null || connectionsIn.size()!=connectionsIn2.size()) return false;
  		for (int i=0;i<connectionsIn.size();i++) if (connectionsIn.get(i).getId()!=connectionsIn2.get(i).getId()) return false;
  
  		return true;
  	}
  
  	/**
  	 * bertrgt die Einstellungen von dem angegebenen Element auf dieses.
  	 * @param element	Element, von dem alle Einstellungen bernommen werden sollen
  	 */
  	@Override
  	public void copyDataFrom(ModelElement element) {
  		super.copyDataFrom(element);
  		if (element instanceof ModelElementMatch) {
  			final ModelElementMatch source=(ModelElementMatch)element;
  
  			matchPropertyMode=source.matchPropertyMode;
  			matchPropertyNumber=source.matchPropertyNumber;
  			matchPropertyString=source.matchPropertyString;
  
  			matchMode=source.matchMode;
  			if (matchMode==MatchMode.MATCH_MODE_TEMPORARY || matchMode==MatchMode.MATCH_MODE_PERMANENT) {
  				newClientType=source.newClientType;
  			} else {
  				newClientType="";
  			}
  
  			condition=source.condition;
  
  			transferTimes=source.transferTimes;
  			transferNumbers=source.transferNumbers;
  
  			connectionsIn.clear();
  			final List<ModelElementEdge> connectionsIn2=source.connectionsIn;
  			if (connectionsIn2!=null) {
  				connectionsInIds=new ArrayList<>();
  				for (int i=0;i<connectionsIn2.size();i++) connectionsInIds.add(connectionsIn2.get(i).getId());
  			}
  
  			if (source.connectionOut!=null) connectionOutId=source.connectionOut.getId();
  		}
  	}
  
  	/**
  	 * Erstellt eine Kopie des Elements
  	 * @param model	Modell zu dem das kopierte Element gehren soll.
  	 * @param surface	Zeichenflche zu der das kopierte Element gehren soll.
  	 * @return	Kopiertes Element
  	 */
  	@Override
  	public ModelElementMatch clone(final EditModel model, final ModelSurface surface) {
  		final ModelElementMatch element=new ModelElementMatch(model,surface);
  		element.copyDataFrom(this);
  		return element;
  	}
  
  	/**
  	 * Optionale Initialisierungen nach dem Laden bzw. Clonen.
  	 */
  	@Override
  	public void initAfterLoadOrClone() {
  		super.initAfterLoadOrClone();
  
  		ModelElement element;
  
  		if (connectionsInIds!=null) {
  			for (int i=0;i<connectionsInIds.size();i++) {
  				element=surface.getById(connectionsInIds.get(i));
  				if (element instanceof ModelElementEdge) connectionsIn.add((ModelElementEdge)element);
  			}
  			connectionsInIds=null;
  		}
  
  		if (connectionOutId>=0) {
  			element=surface.getById(connectionOutId);
  			if (element instanceof ModelElementEdge) connectionOut=(ModelElementEdge)element;
  			connectionOutId=-1;
  			updateEdgeLabel();
  		}
  	}
  
  	/**
  	 * Name des Elementtyps fr die Anzeige im Kontextmen
  	 * @return	Name des Elementtyps
  	 */
  	@Override
  	public String getContextMenuElementName() {
  		return Language.tr("Surface.Match.Name");
  	}
  
  	/**
  	 * Liefert die Bezeichnung des Typs des Elemente (zur Anzeige in der Element-Box)
  	 * @return	Name des Typs
  	 */
  	@Override
  	public String getTypeName() {
  		return Language.tr("Surface.Match.Name.Short");
  	}
  
  	/**
  	 * Vorgabe-Hintergrundfarbe fr die Box
  	 * @see #getTypeDefaultBackgroundColor()
  	 */
  	private static final Color defaultBackgroundColor=new Color(180,225,255);
  
  	/**
  	 * Liefert die Vorgabe-Hintergrundfarbe fr die Box
  	 * @return	Vorgabe-Hintergrundfarbe fr die Box
  	 */
  	@Override
  	public Color getTypeDefaultBackgroundColor() {
  		return defaultBackgroundColor;
  	}
  
  	/**
  	 * Fgt Menpunkte zum Hinzufgen von einlaufenden und auslaufender Kante zum Kontextmen
  	 * @param popupMenu	Kontextmen zu dem die Eintrge hinzugefgt werden sollen
  	 * @param readOnly	Wird dieser Parameter auf <code>true</code> gesetzt, so knnen ber das Kontextmen keine nderungen an dem Modell vorgenommen werden
  	 * @return	Gibt <code>true</code> zurck, wenn Elemente in das Kontextmen eingefgt wurden (und ggf. ein Separator vor dem nchsten Abschnitt gesetzt werden sollte)
  	 */
  	protected final boolean addRemoveEdgesContextMenuItems(final JPopupMenu popupMenu, final boolean readOnly) {
  		JMenuItem item;
  		final Icon icon=Images.EDIT_EDGES_DELETE.getIcon();
  		boolean needSeparator=false;
  
  		needSeparator=needSeparator || addEdgesInContextMenu(popupMenu,surface,readOnly);
  
  		if (connectionOut!=null) {
  			popupMenu.add(item=new JMenuItem(Language.tr("Surface.PopupMenu.RemoveEdgeOut")));
  			item.addActionListener(e->surface.remove(connectionOut));
  			if (icon!=null) item.setIcon(icon);
  			item.setEnabled(!readOnly);
  			needSeparator=true;
  		}
  
  		return needSeparator;
  	}
  
  	/**
  	 * Liefert ein <code>Runnable</code>-Objekt zurck, welches aufgerufen werden kann, wenn die Eigenschaften des Elements verndert werden sollen.
  	 * @param owner	bergeordnetes Fenster
  	 * @param readOnly	Wird dieser Parameter auf <code>true</code> gesetzt, so wird die "Ok"-Schaltflche deaktiviert
  	 * @param clientData	Kundendaten-Objekt
  	 * @param sequences	Fertigungsplne-Liste
  	 * @return	<code>Runnable</code>-Objekt zur Einstellung der Eigenschaften oder <code>null</code>, wenn das Element keine Eigenschaften besitzt
  	 */
  	@Override
  	public Runnable getProperties(final Component owner, final boolean readOnly, final ModelClientData clientData, final ModelSequences sequences) {
  		return ()->{
  			new ModelElementMatchDialog(owner,ModelElementMatch.this,readOnly);
  		};
  	}
  
  	/**
  	 * Fgt optionale Menpunkte zu einem "Visualisierungen hinzufgen"-Untermen hinzu, welche
  	 * es ermglichen zu dem aktuellen Element direkt passende Animationselemente hinzuzufgen.
  	 * @param parentMenu	Untermen des Popupmens, welches die Eintrge aufnimmt
  	 * @param addElements	Callback, das aufgerufen werden kann, wenn Elemente zur Zeichenflche hinzugefgt werden sollen
  	 */
  	@Override
  	protected void addVisualizationContextMenuItems(final JMenu parentMenu, final Consumer<ModelElementPosition[]> addElements) {
  		if (connectionsIn.size()>0) {
  			addVisualizationMenuItem(parentMenu,addElements,VisualizationType.TEXT_NQ_CURRENT_1);
  			addVisualizationMenuItem(parentMenu,addElements,VisualizationType.LCD_NQ_CURRENT_1);
  			addVisualizationMenuItem(parentMenu,addElements,VisualizationType.SCALE_NQ_CURRENT_1);
  			addVisualizationMenuItem(parentMenu,addElements,VisualizationType.TEXT_NQ_AVERAGE_1);
  			addVisualizationMenuItem(parentMenu,addElements,VisualizationType.LCD_NQ_AVERAGE_1);
  			addVisualizationMenuItem(parentMenu,addElements,VisualizationType.SCALE_NQ_AVERAGE_1);
  			addVisualizationMenuItem(parentMenu,addElements,VisualizationType.BAR_NQ_CURRENT_1);
  			addVisualizationMenuItem(parentMenu,addElements,VisualizationType.BAR_NQ_AVERAGE_1);
  		}
  		if (connectionsIn.size()>1) {
  			addVisualizationMenuItem(parentMenu,addElements,VisualizationType.TEXT_NQ_CURRENT_2);
  			addVisualizationMenuItem(parentMenu,addElements,VisualizationType.LCD_NQ_CURRENT_2);
  			addVisualizationMenuItem(parentMenu,addElements,VisualizationType.SCALE_NQ_CURRENT_2);
  			addVisualizationMenuItem(parentMenu,addElements,VisualizationType.TEXT_NQ_AVERAGE_2);
  			addVisualizationMenuItem(parentMenu,addElements,VisualizationType.LCD_NQ_AVERAGE_2);
  			addVisualizationMenuItem(parentMenu,addElements,VisualizationType.SCALE_NQ_AVERAGE_2);
  			addVisualizationMenuItem(parentMenu,addElements,VisualizationType.BAR_NQ_CURRENT_2);
  			addVisualizationMenuItem(parentMenu,addElements,VisualizationType.BAR_NQ_AVERAGE_2);
  		}
  		if (connectionsIn.size()>2) {
  			addVisualizationMenuItem(parentMenu,addElements,VisualizationType.TEXT_NQ_CURRENT_3);
  			addVisualizationMenuItem(parentMenu,addElements,VisualizationType.LCD_NQ_CURRENT_3);
  			addVisualizationMenuItem(parentMenu,addElements,VisualizationType.SCALE_NQ_CURRENT_3);
  			addVisualizationMenuItem(parentMenu,addElements,VisualizationType.TEXT_NQ_AVERAGE_3);
  			addVisualizationMenuItem(parentMenu,addElements,VisualizationType.LCD_NQ_AVERAGE_3);
  			addVisualizationMenuItem(parentMenu,addElements,VisualizationType.SCALE_NQ_AVERAGE_3);
  			addVisualizationMenuItem(parentMenu,addElements,VisualizationType.BAR_NQ_CURRENT_3);
  			addVisualizationMenuItem(parentMenu,addElements,VisualizationType.BAR_NQ_AVERAGE_3);
  		}
  		if (!condition.isBlank()) {
  			addVisualizationTrafficLightsMenuItem("!("+condition+")",parentMenu,addElements);
  		}
  	}
  
  	/**
  	 * Fgt optionale Menpunkte zu einem "Folgestation hinzufgen"-Untermen hinzu, welche
  	 * es ermglichen, zu dem aktuellen Element passende Folgestationen hinzuzufgen.
  	 * @param parentMenu	Untermen des Kontextmens, welches die Eintrge aufnimmt
  	 * @param addNextStation	Callback, das aufgerufen werden kann, wenn ein Element zur Zeichenflche hinzugefgt werden soll
  	 */
  	@Override
  	protected void addNextStationContextMenuItems(final JMenu parentMenu, final Consumer<ModelElementBox> addNextStation) {
  		NextStationHelper.nextStationsBatch(this,parentMenu,addNextStation);
  	}
  
  	/**
  	 * Fgt optional weitere Eintrge zum Kontextmen hinzu
  	 * @param owner	bergeordnetes Element
  	 * @param popupMenu	Kontextmen zu dem die Eintrge hinzugefgt werden sollen
  	 * @param surfacePanel	Zeichenflche
  	 * @param point	Punkt auf den geklickt wurde
  	 * @param readOnly	Wird dieser Parameter auf <code>true</code> gesetzt, so knnen ber das Kontextmen keine nderungen an dem Modell vorgenommen werden
  	 */
  	@Override
  	protected void addContextMenuItems(final Component owner, final JPopupMenu popupMenu, final ModelSurfacePanel surfacePanel, final Point point, final boolean readOnly) {
  		if (addRemoveEdgesContextMenuItems(popupMenu,readOnly)) popupMenu.addSeparator();
  	}
  
  	/**
  	 * Benachrichtigt das Element, dass es aus der Surface-Liste ausgetragen wurde.
  	 */
  	@Override
  	public void removeNotify() {
  		if (connectionsIn!=null) {
  			while (connectionsIn.size()>0) {
  				ModelElement element=connectionsIn.remove(0);
  				surface.remove(element);
  			}
  		}
  		if (connectionOut!=null) surface.remove(connectionOut);
  	}
  
  	/**
  	 * Benachrichtigt das Element, dass ein mit ihm in Verbindung stehendes Element entfernt wurde.
  	 */
  	@Override
  	public void removeConnectionNotify(final ModelElement element) {
  		if (connectionsIn!=null && connectionsIn.indexOf(element)>=0) {connectionsIn.remove(element); fireChanged();}
  		if (connectionOut==element) {connectionOut=null; fireChanged();}
  	}
  
  	/**
  	 * Liefert den jeweiligen xml-Element-Namen fr das Modell-Element
  	 * @return	xml-Element-Namen, der diesem Modell-Element zugeordnet werden soll
  	 */
  	@Override
  	public String[] getXMLNodeNames() {
  		return Language.trAll("Surface.Match.XML.Root");
  	}
  
  	/**
  	 * Speichert die Eigenschaften des Modell-Elements als Untereintrge eines xml-Knotens
  	 * @param doc	bergeordnetes xml-Dokument
  	 * @param node	bergeordneter xml-Knoten, in dessen Kindelementen die Daten des Objekts gespeichert werden sollen
  	 */
  	@Override
  	protected void addPropertiesDataToXML(final Document doc, final Element node) {
  		super.addPropertiesDataToXML(doc,node);
  
  		Element sub;
  
  		if (connectionsIn!=null) for (ModelElementEdge element: connectionsIn) {
  			node.appendChild(sub=doc.createElement(Language.trPrimary("Surface.XML.Connection")));
  			sub.setAttribute(Language.trPrimary("Surface.XML.Connection.Element"),""+element.getId());
  			sub.setAttribute(Language.trPrimary("Surface.XML.Connection.Type"),Language.trPrimary("Surface.XML.Connection.Type.In"));
  		}
  
  		if (connectionOut!=null) {
  			node.appendChild(sub=doc.createElement(Language.trPrimary("Surface.XML.Connection")));
  			sub.setAttribute(Language.trPrimary("Surface.XML.Connection.Element"),""+connectionOut.getId());
  			sub.setAttribute(Language.trPrimary("Surface.XML.Connection.Type"),Language.trPrimary("Surface.XML.Connection.Type.Out"));
  		}
  
  		switch (matchPropertyMode) {
  		case NUMBER:
  			node.appendChild(sub=doc.createElement(Language.trPrimary("Surface.Match.XML.MatchPropertyMode")));
  			sub.setAttribute(Language.trPrimary("Surface.Match.XML.MatchPropertyMode.Mode"),Language.trPrimary("Surface.Match.XML.MatchPropertyMode.Mode.Number"));
  			sub.setTextContent(""+matchPropertyNumber);
  			break;
  		case TEXT:
  			node.appendChild(sub=doc.createElement(Language.trPrimary("Surface.Match.XML.MatchPropertyMode")));
  			sub.setAttribute(Language.trPrimary("Surface.Match.XML.MatchPropertyMode.Mode"),Language.trPrimary("Surface.Match.XML.MatchPropertyMode.Mode.Text"));
  			sub.setTextContent(matchPropertyString);
  			break;
  		case NONE:
  			/* Hier gibt's nichts zu speichern. */
  			break;
  		}
  
  		switch (matchMode) {
  		case MATCH_MODE_COLLECT:
  			node.appendChild(sub=doc.createElement(Language.trPrimary("Surface.Match.XML.MatchMode")));
  			sub.setTextContent(Language.trPrimary("Surface.Match.XML.MatchMode.Collect"));
  			break;
  		case MATCH_MODE_TEMPORARY:
  			if (!newClientType.isEmpty()) {
  				node.appendChild(sub=doc.createElement(Language.trPrimary("Surface.Match.XML.MatchMode")));
  				sub.setTextContent(Language.trPrimary("Surface.Match.XML.MatchMode.Temporary"));
  				node.appendChild(sub=doc.createElement(Language.trPrimary("Surface.Match.XML.ClientType")));
  				sub.setTextContent(newClientType);
  			} else {
  				node.appendChild(sub=doc.createElement(Language.trPrimary("Surface.Match.XML.MatchMode")));
  				sub.setTextContent(Language.trPrimary("Surface.Match.XML.MatchMode.Collect"));
  			}
  			break;
  		case MATCH_MODE_PERMANENT:
  			if (!newClientType.isEmpty()) {
  				node.appendChild(sub=doc.createElement(Language.trPrimary("Surface.Match.XML.MatchMode")));
  				sub.setTextContent(Language.trPrimary("Surface.Match.XML.MatchMode.Permanent"));
  				node.appendChild(sub=doc.createElement(Language.trPrimary("Surface.Match.XML.ClientType")));
  				sub.setTextContent(newClientType);
  			} else {
  				node.appendChild(sub=doc.createElement(Language.trPrimary("Surface.Match.XML.MatchMode")));
  				sub.setTextContent(Language.trPrimary("Surface.Match.XML.MatchMode.Collect"));
  			}
  			break;
  		}
  
  		if (!condition.isBlank()) {
  			node.appendChild(sub=doc.createElement(Language.trPrimary("Surface.Match.XML.Condition")));
  			sub.setTextContent(condition);
  		}
  
  		if (transferTimes!=DataTransferMode.OFF) {
  			node.appendChild(sub=doc.createElement(Language.trPrimary("Surface.Match.XML.TransferTimes")));
  			sub.setTextContent(transferTimes.getName());
  		}
  
  		if (transferNumbers!=DataTransferMode.OFF) {
  			node.appendChild(sub=doc.createElement(Language.trPrimary("Surface.Match.XML.TransferNumbers")));
  			sub.setTextContent(transferNumbers.getName());
  		}
  	}
  
  	/**
  	 * Ldt eine einzelne Einstellung des Modell-Elements aus einem einzelnen xml-Element.
  	 * @param name	Name des xml-Elements
  	 * @param content	Inhalt des xml-Elements als Text
  	 * @param node	xml-Element, aus dem das Datum geladen werden soll
  	 * @return	Tritt ein Fehler auf, so wird die Fehlermeldung als String zurckgegeben. Im Erfolgsfall wird <code>null</code> zurckgegeben.
  	 */
  	@Override
  	protected String loadProperty(final String name, final String content, final Element node) {
  		String error=super.loadProperty(name,content,node);
  		if (error!=null) return error;
  
  		if (Language.trAll("Surface.XML.Connection",name)) {
  			Integer I;
  			I=NumberTools.getNotNegativeInteger(Language.trAllAttribute("Surface.XML.Connection.Element",node));
  			if (I==null) return String.format(Language.tr("Surface.XML.AttributeSubError"),Language.trPrimary("Surface.XML.Connection.Element"),name,node.getParentNode().getNodeName());
  			final String s=Language.trAllAttribute("Surface.XML.Connection.Type",node);
  			if (Language.trAll("Surface.XML.Connection.Type.In",s)) {
  				if (connectionsInIds==null) connectionsInIds=new ArrayList<>();
  				connectionsInIds.add(I);
  			}
  			if (Language.trAll("Surface.XML.Connection.Type.Out",s)) {
  				connectionOutId=I;
  			}
  			return null;
  		}
  
  		if (Language.trAll("Surface.Match.XML.MatchPropertyMode",name)) {
  			final String mode=Language.trAllAttribute("Surface.Match.XML.MatchPropertyMode.Mode",node);
  			if (Language.trAll("Surface.Match.XML.MatchPropertyMode.Mode.Number",mode)) {
  				matchPropertyMode=MatchPropertyMode.NUMBER;
  				final Integer I=NumberTools.getNotNegativeInteger(content);
  				if (I==null) return String.format(Language.tr("Surface.XML.ElementSubError"),name,node.getParentNode().getNodeName());
  				matchPropertyNumber=I;
  			}
  			if (Language.trAll("Surface.Match.XML.MatchPropertyMode.Mode.Text",mode)) {
  				matchPropertyMode=MatchPropertyMode.TEXT;
  				matchPropertyString=content;
  			}
  			return null;
  		}
  
  		if (Language.trAll("Surface.Match.XML.MatchMode",name)) {
  			if (Language.trAll("Surface.Match.XML.MatchMode.Collect",content)) matchMode=MatchMode.MATCH_MODE_COLLECT;
  			if (Language.trAll("Surface.Match.XML.MatchMode.Temporary",content)) matchMode=MatchMode.MATCH_MODE_TEMPORARY;
  			if (Language.trAll("Surface.Match.XML.MatchMode.Permanent",content)) matchMode=MatchMode.MATCH_MODE_PERMANENT;
  			return null;
  		}
  
  		if (Language.trAll("Surface.Match.XML.ClientType",name)) {
  			newClientType=content;
  			if (!content.isBlank() && matchMode==MatchMode.MATCH_MODE_COLLECT) matchMode=MatchMode.MATCH_MODE_PERMANENT;
  			return null;
  		}
  
  		if (Language.trAll("Surface.Match.XML.Condition",name)) {
  			condition=node.getTextContent();
  			return null;
  		}
  
  		if (Language.trAll("Surface.Match.XML.TransferTimes",name)) {
  			transferTimes=DataTransferMode.byName(content);
  			return null;
  		}
  
  		if (Language.trAll("Surface.Match.XML.TransferNumbers",name)) {
  			transferNumbers=DataTransferMode.byName(content);
  			return null;
  		}
  
  		return null;
  	}
  
  	/**
  	 * Gibt an, ob das Element momentan eine (weitere) einlaufende Kante annehmen kann.
  	 * @return	Gibt <code>true</code> zurck, wenn eine (weitere) einlaufende Kante angenommen werden kann.
  	 */
  	@Override
  	public boolean canAddEdgeIn() {
  		return true;
  	}
  
  	/**
  	 * Fgt eine einlaufende Kante hinzu.
  	 * @param edge	Hinzuzufgende Kante
  	 * @return	Gibt <code>true</code> zurck, wenn die einlaufende Kante hinzugefgt werden konnte.
  	 */
  	@Override
  	public boolean addEdgeIn(ModelElementEdge edge) {
  		if (edge!=null && connectionsIn.indexOf(edge)<0) {
  			connectionsIn.add(edge);
  			fireChanged();
  			return true;
  		}
  		return false;
  	}
  
  	/**
  	 * Gibt an, ob das Element momentan eine (weitere) auslaufende Kante annehmen kann.
  	 * @return	Gibt <code>true</code> zurck, wenn eine (weitere) auslaufende Kante angenommen werden kann.
  	 */
  	@Override
  	public boolean canAddEdgeOut() {
  		return connectionOut==null;
  	}
  
  	/**
  	 * Fgt eine auslaufende Kante hinzu.
  	 * @param edge	Hinzuzufgende Kante
  	 * @return	Gibt <code>true</code> zurck, wenn die auslaufende Kante hinzugefgt werden konnte.
  	 */
  	@Override
  	public boolean addEdgeOut(ModelElementEdge edge) {
  		if (connectionOut!=null) return false;
  		if (edge==null || connectionsIn.indexOf(edge)>=0) return false;
  		connectionOut=edge;
  		connectionOutId=-1;
  		fireChanged();
  		return true;
  	}
  
  	/**
  	 * Liste der einlaufenden Kanten
  	 * @return	Einlaufende Kanten
  	 */
  	@Override
  	public ModelElementEdge[] getEdgesIn() {
  		if (connectionsIn==null) return new ModelElementEdge[0]; else return connectionsIn.toArray(ModelElementEdge[]::new);
  	}
  
  	/**
  	 * Auslaufende Kante
  	 * @return	Auslaufende Kante
  	 */
  	@Override
  	public ModelElementEdge getEdgeOut() {
  		return connectionOut;
  	}
  
  	@Override
  	public String[] getNewClientTypes() {
  		return new String[]{getNewClientType()};
  	}
  
  	/**
  	 * Gibt an, ob es in das Element einlaufende Kanten gibt.<br><br>
  	 * Wenn nicht, kann es in der Simulation berhaupt nicht erreicht werden und kann daher
  	 * bei der Initialisierung bersprungen werden, d.h. in diesem Fall ist es dann egal,
  	 * ob das Element in Bezug auf die Konfiguration fehlerhaft ist, z.B. keine auslaufenden
  	 * Kanten hat.<br><br>
  	 * Bei Variablenzuweisungen wird die Liste der Zuweisungen dennoch bei der Initialisierung
  	 * der Simulation bercksichtigt: Es wird so ermittelt, welche Variablennamen in im Modell
  	 * vorkommen (d.h. auf diese Variablen kann an anderer Stelle zugegriffen werden, ohne dass
  	 * sie noch einmal deklariert werden mssten).
  	 * @return	Gibt <code>true</code> zurck, wenn es mindestens eine in das Element einlaufende
  	 * Kante gibt.
  	 */
  	@Override
  	public boolean inputConnected() {
  		return connectionsIn.size()>0;
  	}
  
  	/**
  	 * Gibt an, ob nur die Anzahl an Kunden, die diese Station passiert haben
  	 * oder aber zustzlich auch die aktuelle Anzahl an Kunden an der Station
  	 * whrend der Animation angezeigt werden sollen.
  	 * @return	Nur Gesamtanzahl (<code>false</code>) oder Gesamtanzahl und aktueller Wert (<code>true</code>)
  	 */
  	@Override
  	public boolean showFullAnimationRunData() {
  		return true;
  	}
  
  	@Override
  	public boolean hasQueue() {
  		return true;
  	}
  
  	@Override
  	public String getHelpPageName() {
  		return "ModelElementMatch";
  	}
  
  	/**
  	 * Erstellt eine Beschreibung fr das aktuelle Element
  	 * @param descriptionBuilder	Description-Builder, der die Beschreibungsdaten zusammenfasst
  	 */
  	@Override
  	public void buildDescription(final ModelDescriptionBuilder descriptionBuilder) {
  		super.buildDescription(descriptionBuilder);
  
  		/* Properties abgleichen */
  		switch (matchPropertyMode) {
  		case NONE:
  			/* Keine Ausgabe */
  			break;
  		case NUMBER:
  			descriptionBuilder.addProperty(Language.tr("ModelDescription.Match.PropertyMode"),String.format(Language.tr("ModelDescription.Match.PropertyMode.Number"),matchPropertyNumber),1000);
  			break;
  		case TEXT:
  			descriptionBuilder.addProperty(Language.tr("ModelDescription.Match.PropertyMode"),String.format(Language.tr("ModelDescription.Match.PropertyMode.Text"),matchPropertyString),1000);
  			break;
  		default:
  			break;
  		}
  
  		/* Batching Modus */
  		switch (matchMode) {
  		case MATCH_MODE_COLLECT:
  			descriptionBuilder.addProperty(Language.tr("ModelDescription.Match.Mode"),Language.tr("ModelDescription.Match.Mode.Collect"),2000);
  			break;
  		case MATCH_MODE_TEMPORARY:
  			descriptionBuilder.addProperty(Language.tr("ModelDescription.Match.Mode"),Language.tr("ModelDescription.Match.Mode.Temporary"),2000);
  			break;
  		case MATCH_MODE_PERMANENT:
  			descriptionBuilder.addProperty(Language.tr("ModelDescription.Match.Mode"),Language.tr("ModelDescription.Match.Mode.Permanent"),2000);
  			break;
  		}
  
  		/* Neuer Kundentyp */
  		if ((matchMode==MatchMode.MATCH_MODE_TEMPORARY || matchMode==MatchMode.MATCH_MODE_PERMANENT) && !newClientType.isBlank()) {
  			descriptionBuilder.addProperty(Language.tr("ModelDescription.Match.NewClientType"),newClientType,3000);
  		}
  
  		/* Bedingung */
  		if (!condition.isBlank()) {
  			descriptionBuilder.addProperty(Language.tr("ModelDescription.Match.Condition"),condition,4000);
  		}
  
  		/* bertragung von Kundendaten */
  		if (transferTimes!=DataTransferMode.OFF) {
  			final String mode;
  			switch(transferTimes) {
  			case OFF: mode=null; break;
  			case MIN: mode=Language.tr("Surface.Match.Dialog.TransferData.Mode.Min"); break;
  			case MAX: mode=Language.tr("Surface.Match.Dialog.TransferData.Mode.Max"); break;
  			case MEAN: mode=Language.tr("Surface.Match.Dialog.TransferData.Mode.Mean"); break;
  			case SUM: mode=Language.tr("Surface.Match.Dialog.TransferData.Mode.Sum"); break;
  			case MULTIPLY: mode=Language.tr("Surface.Match.Dialog.TransferData.Mode.Multiply"); break;
  			default: mode=null; break;
  			}
  			if (mode!=null) descriptionBuilder.addProperty(Language.tr("Surface.Match.Dialog.TransferData.Times"),mode,5000);
  		}
  		if (transferNumbers!=DataTransferMode.OFF) {
  			final String mode;
  			switch(transferNumbers) {
  			case OFF: mode=null; break;
  			case MIN: mode=Language.tr("Surface.Match.Dialog.TransferData.Mode.Min"); break;
  			case MAX: mode=Language.tr("Surface.Match.Dialog.TransferData.Mode.Max"); break;
  			case MEAN: mode=Language.tr("Surface.Match.Dialog.TransferData.Mode.Mean"); break;
  			case SUM: mode=Language.tr("Surface.Match.Dialog.TransferData.Mode.Sum"); break;
  			case MULTIPLY: mode=Language.tr("Surface.Match.Dialog.TransferData.Mode.Multiply"); break;
  			default: mode=null; break;
  			}
  			if (mode!=null) descriptionBuilder.addProperty(Language.tr("Surface.Match.Dialog.TransferData.Numbers"),mode,5000);
  		}
  
  		/* Auslaufende Kante */
  		descriptionBuilder.addEdgeOut(connectionOut);
  	}
  
  	@Override
  	public boolean setReferenceEdges(List<ModelElementEdge> connectionsIn, List<ModelElementEdge> connectionsOut) {
  		if (connectionsOut.size()!=1) return false;
  
  		this.connectionsIn.clear();
  		this.connectionsIn.addAll(connectionsIn);
  
  		this.connectionOut=connectionsOut.get(0);
  
  		return true;
  	}
  
  	@Override
  	public void search(final FullTextSearch searcher) {
  		super.search(searcher);
  
  		/* Abzugleichende Eigenschaft */
  		switch (matchPropertyMode) {
  		case NONE:
  			/* Keine zu prfenden Daten */
  			break;
  		case NUMBER:
  			searcher.testInteger(this,Language.tr("Surface.Match.Dialog.OptionProperty.Number"),matchPropertyNumber,newMatchPropertyNumber->{if (newMatchPropertyNumber>=0) matchPropertyNumber=newMatchPropertyNumber;});
  			break;
  		case TEXT:
  			searcher.testString(this,Language.tr("Surface.Match.Dialog.OptionProperty.Text"),matchPropertyString,newMatchPropertyString->{matchPropertyString=newMatchPropertyString;});
  			break;
  		}
  
  		/* Neuer Kundentyp */
  		if (matchMode!=MatchMode.MATCH_MODE_COLLECT) {
  			searcher.testString(this,Language.tr("Editor.DialogBase.Search.NewClientType"),newClientType,newNewClientType->{newClientType=newNewClientType;});
  		}
  
  		/* Bedingung */
  		searcher.testString(this,Language.tr("Surface.Match.Dialog.Condition"),condition,newCondition->{condition=newCondition;});
  
  	}
  }