{{tag>Index Action Action_List Business_Object Process UI}}
====== ENTER NEW ======

This action is similar to the ''CREATE'' action in that it creates a new instance of a business object. Unlike the ''CREATE'' action it lets the user fill in the initial values of the business object. The action displays a form for the specified business object and waits for the user to provide the initial values of the attributes and submit them to the system. 

===== Syntax =====

''ENTER NEW'' Id ()

where Id() is the name of the business object to create. For example,

<code aim>ENTER NEW Account </code>

<callout type="primary" icon="true" title="note"> If the name of the business object group is specified in the action, //**Aware IM**// will first display a list of all members of the group and when the user selects the name of the required business object, //**Aware IM**// will display a form for this object.</callout>

<callout type="primary" icon="true" title="note"> It is possible to optionally indicate initial values of the attributes using the ''WITH'' keyword. The syntax is the same as for the ''CREATE'' action. The form will be pre-populated with the supplied values (this initialization though is not available for groups – see previous note). For example:

<code aim>ENTER NEW Account WITH Account.Name='John Smith' </code></callout>

<callout type="primary" icon="true" title="note"> It is possible to optionally indicate the name of the specific form of the business object that will be used when entering the object, for example:

<code aim>ENTER NEW Account USING 'Form for administrators' </code>

where 'Form for administrators' is the name of the form that must be configured with the Account object.</callout>

<callout type="primary" icon="true" title="note"> It is possible to optionally indicate the name of the specific section of the business object that will be displayed first, for example:

<code aim>ENTER NEW Account USING 'Form for administrators' FORM_SECTION 'Personal details' </code></callout>

<callout type="primary" icon="true" title="note"> By default the form of the object will be displayed in a pop-up window (unless a process runs in the Single Tab mode). If the process finishes immediately after the user enters form values, you can designate the form to be displayed in the current window or in a new tab. For example:

<code aim>ENTER NEW Account AND VIEW </code>

<code aim>ENTER NEW Account AND VIEW IN TAB </code></callout>

<callout type="primary" icon="true" title="note"> If a process runs in a "single tab mode" the action is not displayed in a popup window unless the FORCE POPUP keyword is specified. This keywords allows to override the single tab mode. For example:
<code aim>ENTER NEW Account FORCE POPUP</code></callout>