Differences

This shows you the differences between two versions of the page.

--- newdevs:code:add-fields [2021/07/29 18:27] – [3. Create an upgrade script] tmccanna
+++ newdevs:code:add-fields [2024/03/28 22:15] (current) – [3. Edit seed data and create an upgrade script] sandbergja
@@ Line 12: / Line 12: @@
 Add the fields in the "class id="aou"" section:
-''<nowiki><field name="fscskey" reporter:label="FSCSKEY" reporter:datatype="text"/></nowiki>''\\
+''<field reporter:label="Hours of Operation" name="hours_of_operation" oils_persist:virtual="true" reporter:datatype="link"/>''\\
-''<nowiki><field name="fscs_seq" reporter:label="FSCS_SEQ" reporter:datatype="text"/></nowiki>''
+**''<field name="fscskey" reporter:label="FSCSKEY" reporter:datatype="text"/>''**\\
+**''<field name="fscs_seq" reporter:label="FSCS_SEQ" reporter:datatype="text"/>''**\\
+''</fields>''
 The field name must match the column name that you add to the database table. The 'reporter:label' text is what will appear in the list when you are building report templates.
@@ Line 19: / Line 21: @@
 ===== 2. Update the schema =====
-New installations of Evergreen will use this code when the database tables are created.
+New installations of Evergreen will use the code in the Pg folder when the database tables are created. If you are creating a new table for a brand new feature, you'll most likely need to create a new schema file, but in this case we are updating an existing table in the actor schema.
 File location: Open-ILS\src\sql\Pg\005.schema.actors.sql
@@ Line 32: / Line 34: @@
-===== 3. Create an upgrade script =====
+===== 3. Edit seed data and create an upgrade script =====
-Upgrade scripts are required for any changes to the schema or seed data - these are used when a server is being upgraded rather than installed fresh.
+Updates to the seed data files as well as upgrade scripts are required for any changes to the schema or seed data. (The seed data files are used for fresh installs and the upgrade scripts are used by existing installations that are upgrading.)
 File location: Open-ILS\src\sql\Pg\upgrade\XXXX.federal_codes.sql
 ''BEGIN;''\\
-''ALTER TABLE actor.org unit ADD COLUMN fscskey TEXT, ADD COLUMN fscs_seq TEXT;''\\
+''ALTER TABLE actor.org_unit ADD COLUMN fscskey TEXT, ADD COLUMN fscs_seq TEXT;''\\
 ''COMMIT;''
-If you are developing an upgrade script to submit to the Evergreen community, the new upgrade script you create will likely be more complicated. See other examples in the upgrade folder.
+If you are developing an upgrade script to submit to the Evergreen community, the new upgrade script you create will likely be more complicated. See other examples in the upgrade folder. The "XXXX" in the file name is a placeholder - when the core committers add it to man, they will assign it a number.
+For more information on upgrade scripts, see [[newdevs:db:upgrade_scripts|Database upgrade scripts]]