Sometimes, you may wish to keep track of information that currently does not exist in the stock apps or in QuickBooks. For example, you may wish to keep track of the birthday of a Contact.

Method:CRM allows you to do this through the use of custom fields. This will require customization of the stock Method Apps. Having a good understanding of Tables and Fields will be beneficial while you go through these steps.

In this document, we want to add a birthday to the contact, so we will need a new custom birthday field. To fully implement this, you will need to:

  • Add a custom field to the Contacts Table.
  • Customize the View Contact screen.
  • Customize the Edit Contact screen.
  • Customize the New Contact screen.

Add a Custom Field to the Contacts Table

Fortunately, we have an article for this: Add custom field to existing table. Follow the steps in this document, except use the following:

  • Field Name: Birthday
  • Field Type: DateTime

You may notice an existing field called BirthDate. We can't use this because it is linked to a customer, and we want individual birthdays for multiple contacts who may be part of the same customer.

Customize View Contact Screen

1. Go to the Contacts List and view any contact. Make sure you are viewing the contact and not editing.

2. From the heading dropdown menu, Customize Screen to enter design mode for the View Contact screen.

3. When prompted View as Read-Only or Create a copy, choose the latter: Create a copy.

4. Where to put the birthday is up to you, however, we'll put it above the tags list. Find secContactDetailRight, right-click, select Row, and then select Insert Below. Do this twice to get two more rows.

5. The second row holds a text label. the icon. Drag in a text object and change it's text to "Birthay". Also change the Caption Font Weight to Bold.

6. The third row holds the actual birthdate itself by using the Birthday field. From the fields, drag in the Birthday field into the third row. (There are two fields starting with "birthday", so make sure you drag in the one you created.)

11. By default, it displays as an editable field but we need to change that because this is a View Contact screen. You can only view the contact, not edit it. So select the Birthday field and change Display As setting to Text

12. Make sure the Text itself is empty. 

13. Under Display Format, change Format as: to Short Date.

14. Click Save to save the screen, and then click Close to exit Design Mode.

When you view the View Contact page, you will see your Birthday caption, but no birthday because none has been put in. Let's customize the Edit Contact screen.

Customize Edit Contact Screen

1. Edit any Contact to go to the Edit Contact screen.

2. From the heading dropdown menu, Customize Screen to enter Design Mode for the Edit Contact screen.

3. When prompted View as Read-Only or Create a copy, choose the latter: Create a copy.

4. We can enter this anywhere, but to be consistent with the View Contact screen, we should put the field for the Birthday above the taglist. Find secDetailsColumn4 and right-click the row with the TagList field. Insert a row above this row.

5. In this row: Drag in the Birthday field. Make sure you drag in the correct field, and not the Birthdate field.

6. With the Birthday field still selected, under Display Format, change Format as: to Short Date.

7. With the Birthday field still selected, change its Caption Font Weight to Bold.

8. Click Save to save the screen, and then click Close to exit Design Mode.

We're almost done! Now that we can now view the birthday and edit the birthday. One more screen left.

Customize New Contact Screen

Creating a new record for another app is normally a simple process, however the relationship between Contacts and Customers makes customization of the Contacts App more involved.

In the New Contact screen, when a contact is created, the screen creates the Entity first. In other words, it creates either the Lead, the Customer, or the Vendor first because a contact cannot exist without an entity.

However, when Method creates an entity, it automatically creates a contact behind the scenes. 

So if you want to save a custom field, you will have to update the contact which was created. These steps will cover how to do that. 

1. Click New on the Contacts App.

2. From the heading dropdown menu, Customize Screen to enter Design Mode.

3. When prompted View as Read-Only or Create a copy, choose the latter: Create a copy.

4. Find the secContactAddInfo section and insert another row at the top above the TagList field. Then drag in the Birthday field and select it.

5. Under Display Format change Format as: to Short Date and change its Caption Font Weight to Bold.

6. At the bottom of the screen, within the secFooterButtons, you will find a control called SaveBASE. Click the down arrow to open up its contextual menu and then select the Click event.

The SaveBase control contains the main actions used for saving the new contact and customer. It is called by all the other save buttons.

7. In the action set, within the IF condition "If Create was chosen then" conditional, find and select the Update Fields in Table action. Make sure it is the correct action embedded in the IF condition. It will have the internal note: "Update the Contact record that was automatically created by the Entity insert."

8. Add Another Field to this action.

  • Field(s) to update: Birthday
  • Update using this value: Birthday (within the dropdown, you'll find it under Control)

9. Click Close at the top of the screen to close the action set.

10. Save the screen and then Close the Design Mode.

And that's it! You have successfully added a custom field to be displayed and edited for the Contacts App!

Did this answer your question?