====== offer-cube FAQ / Position anhand Ressource in Auftrag erstellen ======

Zurück zur [[offer-cube:howto|Anleitungen / HowTos]]

Siehe auch [[offer-cube:howto:resource|Ressource]] \\
Siehe auch [[offer-cube:howto:position|Positionen]] \\
Siehe auch [[offer-cube:howto:order|Auftrag]] \\
Siehe auch [[offer-cube:howto:syncsetting-hook-codes|Synchronisierungen Hook-Codes]] \\
Siehe auch [[offer-cube:howto:pdf-special-variables|PDF Power User Funktionen Variablen/Funktionen]] \\

===== Allgemeines / Zusammenfassung =====

Aufgrund des Hinzufügens einer [[offer-cube:howto:resource|Ressource]] zu einem [[offer-cube:howto:order|Auftrag]], kann automatisch eine [[offer-cube:howto:position|Position]] in einem [[offer-cube:howto:order|Auftrag]] angelegt werden und die Daten übernommen werden.

**Anwendungsbeispiel: Verwaltung von Kundenfahrzeugen**

   * Die Fahrzeuge können als [[offer-cube:howto:resource|Ressource]] vom Typ //Fahrzeug// angelegt werden.
   * Das Fahrzeug wird bei einem Service oder eine Reparatur mit dem [[offer-cube:howto:order|Auftrag]] verknüpft.
   * Es wird automatisch eine [[offer-cube:howto:position|Position]] im Auftrag angelegt und die Fahrzeugdaten übernommen

==== Schritt 1: Erstellen einer Synchronisierung mit Hook ====

Es muss eine [[offer-cube:howto:syncsetting|Synchronisierung]] mit dem entsprechenden [[offer-cube:howto:syncsetting-hook-codes|Hook Code]] "//global.resourceinstance.add.order//" angelegt werden.

Dies geschieht unter //Einstellungen// --> //Synchronisierung//:

	* Bezeichnung: **Ressource zu Auftrag hinzugefügt Position automatisch erstellen**
	* Hook-Code: **global.resourceinstance.add.order** (Ressource zu Auftrag hinzugefügt) \\ Siehe [[offer-cube:howto:syncsetting-hook-codes|Synchronisierungen Hook-Codes]]
	* Methodenname: **position::createnew**
	* Interne Konfiguration: \\ //<nowiki>"order": "[[$payload.targetid]]"</nowiki>// Enthält die interne Auftrags-ID \\ //<nowiki>"name": "[[getobject module='resource' by='id' id=$payload.resource assign='resource']][[$resource.type__name|escape]] [[$resource.licensenumber|escape]] / [[$resource.serialnr|escape]]"</nowiki>// holt die Ressource und setzt die Positions-Bezeichnung \\ //<nowiki>"description": "[[$resource.manufacturer|escape]]/[[$resource.model|escape]] EZ: [[$resource.firstreg_dt|ut2humandate]] Gewicht: [[$resource.maxmass]] kg" </nowiki>// Setzt die Positions-Beschreibung \\ //<nowiki>"_removeempty": 1</nowiki>// entfernt die leere automatisch erstellte Positionen aus dem Auftrag


<code>
{
"order": "[[$payload.targetid]]",
"name": "[[getobject module='resource' by='id' id=$payload.resource assign='resource']][[$resource.type__name|escape]] [[$resource.licensenumber|escape]] / [[$resource.serialnr|escape]]",
"description": "[[$resource.manufacturer|escape]]/[[$resource.model|escape]] EZ: [[$resource.firstreg_dt|ut2humandate]] Gewicht: [[$resource.maxmass]] kg",
"_removeempty": 1
}
</code>


{{offer-cube:faq:faq_position-in-auftrag-anhand-ressource-erstellen:faq_resourceadd_hook-11-create-syncsetting-hook.png|Synchronisierung mit Hook anlegen}}


==== Schritt 2a: Anlegen eines Fahrzeugs ====

Das Fahrzeug kann direkt im Auftrag angelegt werden.

{{offer-cube:faq:faq_position-in-auftrag-anhand-ressource-erstellen:faq_resourceadd_hook-01-add_resource.png|Fahrzeug direkt im Auftrag anlegen}}

==== Schritt 2b: Vorhandens Fahrzeug auswählen und zuordnen ====

Sollte das Fahrzeug bereits einmal als [[offer-cube:howto:resource|Ressource]] angelegt worden sein, so kann es direkt aus der Liste ausgewählt werden.

Es wird automatisch eine Position angelegt und mit den Fahrzeugdaten vorbefüllt.

{{offer-cube:faq:faq_position-in-auftrag-anhand-ressource-erstellen:faq_resourceadd_hook-02-select-existing-resource.png|Fahrzeug zu Auftrag hinzufügen - Position wird angelegt}}