Benutzerdefinierte Felder und Importe
Benutzerdefinierte Felder ergänzen unterstützte Datensätze um strukturierte Werte. Sie unterscheiden sich von benutzerdefinierten Tabellen, die eigene Datensätze und Spalten definieren.
Ein Feld definieren
- Öffne Betriebsstudio → Benutzerdefinierte Felder mit der benötigten Verwaltungsberechtigung.
- Erstelle eine Definition mit verständlichem Namen, stabilem Schlüssel, Typ und unterstützter Zielentität beziehungsweise Objekttyp.
- Wähle Text, mehrzeiligen Text, Zahl, Wahrheitswert, Datum, Auswahl, Liste oder Matrix.
- Lege Auswahloptionen fest. Für Listen definierst du benannte Spalten und gegebenenfalls Zeilengrenzen; für Matrizen feste Zeilen und Spalten.
- Konfiguriere verfügbare Standardwerte, Reihenfolge, Sichtbarkeit und Weitergaberegeln.
- Speichere und veröffentliche im Lebenszyklus der Definition. Öffne einen passenden Datensatz und prüfe Darstellung und Validierung.
Der Erstellungsdialog akzeptiert Kleinbuchstaben, Zahlen und Unterstriche im Schlüssel. Ein geänderter Anzeigename macht Schlüssel in Integrationen nicht austauschbar. Typ- und Strukturänderungen können vorhandene Werte, Formulare und Berichte beeinflussen. Prüfe zuerst Verwendungen und repräsentative Datensätze.
Werte erfassen und verwenden
Nutze den Feldeditor im passenden Datensatz. Pflichtspalten und Auswahloptionen gelten auch in strukturierten Werten. Bewahre bestehende Werte bei Teiländerungen. Eine Felddefinition bindet das Feld nicht automatisch in jede App oder jeden Bericht ein. Der Ersteller muss die Daten zuordnen.
Daten importieren
Nutze den Importablauf des Zielmoduls. Produktionsaufträge unterstützen CSV- und XLSX-Vorschau mit anschließender Ausführung. Arbeitsplätze haben einen eigenen Import. Es gibt keinen universellen Import für sämtliche Entitäten.
- Prüfe Bereich und Berechtigung und nutze die aktuelle Vorlage oder Feldanleitung des Moduls.
- Bewahre Kennungen als Text einschließlich führender Nullen. Nutze UTF-8-CSV, ausdrückliche Einheiten, eindeutige Datumsangaben und Dezimalpunkte, wenn die Zahlenverarbeitung sie erwartet.
- Lade die Datei hoch und prüfe Spalten, erkannte Werte, neue beziehungsweise vorhandene Zeilen und Fehler.
- Korrigiere fehlende Referenzen und ungültige Zeilen. Eine Vorschau erzeugt noch keine Aufträge.
- Führe nur die geprüften Zeilen aus. Prüfe Rückmeldungen und gespeicherte Datensätze.
- Gleiche bei teilweisem oder unklarem Ergebnis erfolgreiche Kennungen vor einem erneuten Versuch ab. Lade nicht blind die gesamte Datei erneut hoch.
Erforderliche Vorschau-Spalten für Produktionsaufträge sind plannedStart, plannedEnd und quantityPlanned. Standardfelder und eigene Feldschlüssel müssen zum unterstützten Schema passen. Die Erstellungsanleitung erläutert Material, Arbeitsplan, Elternauftrag und Lebenszyklus.
Für Importe und veröffentlichte Feldänderungen gibt es kein universelles Rückgängigmachen. Bewahre Quelldatei und geprüfte Zuordnung auf, dokumentiere Ergebnisse und plane Korrekturen mit dem Prozessverantwortlichen.
Siehe Formulare, Berichte und ERP-Integrationen.
Dateireferenz für Produktionsaufträge
Lade das CSV-Beispiel oder entsprechende XLSX-Beispiel. Beide enthalten einen fiktiven geplanten manuellen Auftrag DOCS-IMPORT-001 für zehn Einheiten. Ersetze die Termine durch deinen Schulungszeitraum. Prüfe vorher, dass die Nummer frei ist; eine vorhandene Nummer wird als Aktualisierung behandelt.
Das Beispiel hat keine Material-/Arbeitsplatzreferenz und kann ohne angenommene Datenbankkennungen geprüft werden. Es erstellt geplante manuelle Arbeit und kann Hinweise zur fehlenden Fertigungseinrichtung zeigen. Für ausführbare Fertigung brauchst du ein veröffentlichtes Material mit Standardarbeitsplan oder zulässige Arbeitsplatzcodes sowie die Prüfung der entstandenen Arbeitsgänge. Dein erster Produktionsauftrag beschreibt die Schulungseinrichtung.
Unterstützt sind .csv und .xlsx. CSV verwendet UTF-8, Kommas und eine Kopfzeile; Werte mit Komma müssen in Anführungszeichen stehen. XLSX liest das erste Blatt mit denselben Schlüsseln in Zeile eins. Nutze feste Werte statt Formeln. Behalte ISO-Zeitstempel als Text, wenn die Zeitzonenbedeutung genau erhalten bleiben soll.
| Spalte | Pflicht | Wert und Verhalten |
|---|---|---|
plannedStart | Ja | Lesbares Datum/Zeit; vorzugsweise ISO 8601 mit Z oder ausdrücklichem Offset. |
plannedEnd | Ja | Gleiches Format, nicht vor Beginn. |
quantityPlanned | Ja | Positive Zahl mit Dezimalpunkt, ohne Einheit/Tausendertrennzeichen. |
orderNumber | Nein | Stabile Textkennung. Eine vorhandene Mandantennummer wird in der Vorschau als Aktualisierung markiert; gewählten Bereich vor Ausführung prüfen. Leer fordert eine neue Nummer an. |
description | Nein | Text; Vorgabe leer. Bei Aktualisierungen den vollständigen gewünschten Text angeben. |
priority | Nein | low, normal, high, critical; Vorgabe normal. |
status | Nein | draft, planned, released, in_progress, completed, cancelled; Vorgabe planned. Statusregeln gelten weiter. Neue Schulungsaufträge mit planned erstellen. |
materialId | Nein | Fachlicher Code eines veröffentlichten Materials, bei Erstellung aufgelöst. |
materialRefId | Nein | Vorhandene Datenbankreferenz des Materials aus berechtigtem Lesezugriff. Nicht raten oder mit materialId verwechseln. |
explosionMode | Nein | none, singleLevel, multiLevel; Vorgabe none. |
parentOrderNumber | Nein | Vorhandene Elternauftragsnummer. Die Vorschau löst keinen Elternauftrag auf, der nur eine neue Zeile derselben Datei ist. |
possibleWorkCenterIds | Nein | Kommagetrennte fachliche Arbeitsplatzcodes in einer zitierten CSV-Zelle. Neue manuelle Aufträge verwenden sie für einen Arbeitsgang Production. |
| Andere Spalte | Nein | Schlüssel eines benutzerdefinierten Produktionsauftragsfelds. Vorhandene Definitionen bestimmen die Bedeutung. Unbekannte Spalten erzeugen bei Ausführung aktive Text-Definitionen. Jede Zusatzspalte vorher prüfen. |
Dieser Browserimport hat keine allgemeine Spalte unit, quantityProduced, Arbeitsplan-JSON oder beliebige Objektstruktur. Ein Material liefert Einheit und veröffentlichte Fertigungsdefinitionen. Nutze bei konfigurierbaren Produkten bestehende Feldschlüssel und prüfe die aufgelöste Vorschau; Dateiname oder unbekannte Spalte erzeugen keine fachliche Zuordnung.
Beispiel prüfen und ausführen
- Öffne die Importaktion der Produktionsaufträge und lade eine Beispieldatei. Prüfe den Bereich vor dem Hochladen.
- Erwartet werden eine Zeile, Menge
10, Prioritätnormal, Statusplannedund Neu, wennDOCS-IMPORT-001fehlt. Nach erfolgreicher Erstellung muss erneutes Hochladen Aktualisierung zeigen. - Prüfe alle Spalten/Zeilen. Entferne versehentliche Zusatzspalten und behebe Fehler. Die Vorschau prüft Grunddaten, Mengen, Prioritäten, Status und vorhandene Elternnummern; Material-/Arbeitsplan-/Pflichtfeldprüfung findet zusätzlich bei Ausführung statt.
- Führe die geprüfte Datei aus und lies das Ergebnis. Öffne
DOCS-IMPORT-001im selben Bereich und vergleiche gespeicherte Termine, Menge und Beschreibung. - Führe das Beispiel nur erneut aus, wenn du eine Aktualisierung beabsichtigst. Leere Nummern eignen sich nicht zur wiederholbaren Wiederherstellung, weil sie eine neue Nummer anfordern.
Eine Aktualisierung ist keine Teiländerung: Die Ausführung schreibt Termine, Planmenge, Priorität, Beschreibung und gelieferte Zusatzwerte und fordert den Status an. Fehlende optionale Werte können Vorgaben werden oder die bisherige Feldwertliste ersetzen. Sichere aktuelle Werte und liefere die vollständige gewünschte Zeile. Material, Elternauftrag, Auflösung und Arbeitsplatzcodes gelten für Erstellung; sie bauen bestehende Arbeitsgänge bei Aktualisierung nicht neu auf.
Die Ausführung verarbeitet Zeilen nacheinander ohne gemeinsame Transaktion. Ein späterer Fehler kann frühere Zeilen gespeichert lassen; unbekannte Felddefinitionen können bereits existieren. Die Fehlerantwort bietet kein vollständiges Belegregister je Zeile. Gleiche Nummern und gespeicherte Werte ab, bevor du eine Korrekturdatei erstellst. Wiederhole nicht blind die gesamte Datei. Doppelte Nummern innerhalb einer Datei sind vorher zu korrigieren.
| Fehler oder unerwartetes Ergebnis | Korrektur |
|---|---|
| Pflichtspalten fehlen | Groß-/Kleinschreibung von plannedStart, plannedEnd, quantityPlanned wiederherstellen. |
| Datum ungültig / Ende vor Beginn | Ausdrückliche ISO-Zeitstempel und richtige Reihenfolge verwenden. |
| Menge ungültig | Positive Zahl ohne Einheit und regionale Trennzeichen verwenden. |
| Unerwartetes Zusatzfeld | Spalte vor Ausführung entfernen/umbenennen; bereits erzeugte Textdefinition prüfen. |
| Elternauftrag fehlt | Erst Elternauftrag erstellen/abgleichen, danach Kinder neu prüfen. |
| Fertigungs-/Statusanforderung fehlt | Veröffentlichte Einrichtung oder Pflichtwerte korrigieren; frühere gespeicherte Zeilen prüfen. |
| Vorhandener Auftrag unerwartet als Aktualisierung | Mandant, Bereich und genaue Kennung prüfen; vor Überschreiben stoppen. |