Zum Hauptinhalt springen

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​

  1. Öffne Betriebsstudio → Benutzerdefinierte Felder mit der benötigten Verwaltungsberechtigung.
  2. Erstelle eine Definition mit verständlichem Namen, stabilem Schlüssel, Typ und unterstützter Zielentität beziehungsweise Objekttyp.
  3. Wähle Text, mehrzeiligen Text, Zahl, Wahrheitswert, Datum, Auswahl, Liste oder Matrix.
  4. Lege Auswahloptionen fest. Für Listen definierst du benannte Spalten und gegebenenfalls Zeilengrenzen; für Matrizen feste Zeilen und Spalten.
  5. Konfiguriere verfügbare Standardwerte, Reihenfolge, Sichtbarkeit und Weitergaberegeln.
  6. 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.

  1. Prüfe Bereich und Berechtigung und nutze die aktuelle Vorlage oder Feldanleitung des Moduls.
  2. 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.
  3. Lade die Datei hoch und prüfe Spalten, erkannte Werte, neue beziehungsweise vorhandene Zeilen und Fehler.
  4. Korrigiere fehlende Referenzen und ungültige Zeilen. Eine Vorschau erzeugt noch keine Aufträge.
  5. Führe nur die geprüften Zeilen aus. Prüfe Rückmeldungen und gespeicherte Datensätze.
  6. 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.

SpaltePflichtWert und Verhalten
plannedStartJaLesbares Datum/Zeit; vorzugsweise ISO 8601 mit Z oder ausdrücklichem Offset.
plannedEndJaGleiches Format, nicht vor Beginn.
quantityPlannedJaPositive Zahl mit Dezimalpunkt, ohne Einheit/Tausendertrennzeichen.
orderNumberNeinStabile 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.
descriptionNeinText; Vorgabe leer. Bei Aktualisierungen den vollständigen gewünschten Text angeben.
priorityNeinlow, normal, high, critical; Vorgabe normal.
statusNeindraft, planned, released, in_progress, completed, cancelled; Vorgabe planned. Statusregeln gelten weiter. Neue Schulungsaufträge mit planned erstellen.
materialIdNeinFachlicher Code eines veröffentlichten Materials, bei Erstellung aufgelöst.
materialRefIdNeinVorhandene Datenbankreferenz des Materials aus berechtigtem Lesezugriff. Nicht raten oder mit materialId verwechseln.
explosionModeNeinnone, singleLevel, multiLevel; Vorgabe none.
parentOrderNumberNeinVorhandene Elternauftragsnummer. Die Vorschau löst keinen Elternauftrag auf, der nur eine neue Zeile derselben Datei ist.
possibleWorkCenterIdsNeinKommagetrennte fachliche Arbeitsplatzcodes in einer zitierten CSV-Zelle. Neue manuelle Aufträge verwenden sie für einen Arbeitsgang Production.
Andere SpalteNeinSchlü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​

  1. Öffne die Importaktion der Produktionsaufträge und lade eine Beispieldatei. Prüfe den Bereich vor dem Hochladen.
  2. Erwartet werden eine Zeile, Menge 10, Priorität normal, Status planned und Neu, wenn DOCS-IMPORT-001 fehlt. Nach erfolgreicher Erstellung muss erneutes Hochladen Aktualisierung zeigen.
  3. 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.
  4. Führe die geprüfte Datei aus und lies das Ergebnis. Öffne DOCS-IMPORT-001 im selben Bereich und vergleiche gespeicherte Termine, Menge und Beschreibung.
  5. 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 ErgebnisKorrektur
Pflichtspalten fehlenGroß-/Kleinschreibung von plannedStart, plannedEnd, quantityPlanned wiederherstellen.
Datum ungültig / Ende vor BeginnAusdrückliche ISO-Zeitstempel und richtige Reihenfolge verwenden.
Menge ungültigPositive Zahl ohne Einheit und regionale Trennzeichen verwenden.
Unerwartetes ZusatzfeldSpalte vor Ausführung entfernen/umbenennen; bereits erzeugte Textdefinition prüfen.
Elternauftrag fehltErst Elternauftrag erstellen/abgleichen, danach Kinder neu prüfen.
Fertigungs-/Statusanforderung fehltVeröffentlichte Einrichtung oder Pflichtwerte korrigieren; frühere gespeicherte Zeilen prüfen.
Vorhandener Auftrag unerwartet als AktualisierungMandant, Bereich und genaue Kennung prüfen; vor Überschreiben stoppen.