View source for How To Change The Size of a Column

__FORCETOC__
{{RatingArticle}}
{{Languages | Documentation_Style_Guide}}
== Objective ==
The objective of this article is to show you how to change the size of a column inside the database.
It enables the user to have a certain amount of flexibility within his/her database.

== Recommended articles ==
Before reading this guide, it is necessary to have a proper understanding of Openbravo's [[Modularity]] concept and how to [[How_To_Create_and_Package_a_Module | create and package a module]],<br>as we take the knowledge from these articles as a given in this guide.

In case you are working with configuration scripts or templates on a regular basis, the following link to an article might be of interest to you, since it describes [[How_To_Create_a_Configuration_Script | how to create a configuration script]].

== Execution Steps ==
In Openbravo you are able to change the size of a column. To achieve this you must follow the following steps:

# Create a [[How_To_Create_a_Configuration_Script | template]] and set its status as '''''"In Development"'''''.
# Modify the column size within the database with the '''"ALTER TABLE"''' SQL command. 

<dl><dd>'''IMPORTANT''': The new value must be greater than the old one.<source lang = "sql">Postgres: ALTER TABLE <table_name> ALTER COLUMN <column_name> type <type>(<new_size>)
Oracle:   ALTER TABLE <table_name> MODIFY <column_name> <type>(<new_size>)
</source>
</dl>
<ol start = "3"><li>
Update the new column size in the '''Application Dictionary'''. For this, we go to the '''''"Tables and Columns"''''' window, find the column definition and specify the new size there</li>
<li>Export the database: '''''"ant export.database"''''' (with this you are exporting the template definitions)</li>
<li>Export the configuration script: '''''"ant export.config.script"''''' (with this you are exporting the core changes into the template)</li>
<li>Check the generated configuration script and verify that the change regarding the new column size appears in the first lines.
</li></ol>
{|width="75%"
|-|- valign="top"
|
{{(!)|'''Note:''' As a final remark with great importance: If the column that has been modified is being used by a database function by giving its value to another variable for example, you must check that this variable has an equal or greater size (at least the size of the new modified column). Because if not, the process would fail. This means, if the variable's size wasn't enough  to store the columns content, you have to modify the function as well, by adjusting the size of the variable in question and exporting this change into your template.

So please verify that your new column size does not affect you in any way (functions or triggers) working with your database. }}
|}

[[Category:HowTo]]