Step-by-Step Guide: Modeling Data with Appian Record Types



In our previous post, we discussed how crucial it is to plan out your Appian Record Types. Now, let’s roll up our sleeves and dive into Appian Designer! Using our fictional company, Acme Auto, we are going to model the data for a new vehicle fleet management app.

In this walkthrough, we'll cover two common scenarios developers face: connecting to an existing database table and generating a completely new one from scratch.

Scenario 1: Connecting Existing Data (The Vehicle Record)

Acme Auto already has a database filled with vehicle information, so our first task is to bring that into Appian.

  1. Create and Secure the Object: In Appian Designer, we start by creating a new Record Type named "Vehicle". We give it a clear description and configure the object security. As a best practice, always use groups to assign Viewer, Editor, or Administrator privileges so you can control exactly who can view or modify the record type.
  2. Connect to the Database: Because the data already exists, we select Database as our data model source (assuming the connection to the source is already established). We select the existing "AA Vehicle" table and keep data sync enabled to take advantage of Appian's powerful record type features.
  3. Apply Source Filters: If you are dealing with millions of rows of data, source filters are your best friend. You can use them to split data by region or filter out irrelevant data based on timeframes. For Acme Auto, we set a source filter to exclude any vehicles older than the year 2000.
  4. Format the Fields: Finally, we review our table fields. We make sure the primary key is set (which acts as the unique identifier for each row) and change the data type of any user-related fields to the "User" data type. We rename and reorder the fields logically, and save our changes.

Scenario 2: Generating a New Data Model (The Maintenance Record)

Unlike vehicles, Acme Auto doesn't have an existing database for maintenance requests. We have to build this one from the ground up!

  1. Start a New Data Model: After creating the "Maintenance" record type and setting up its security, we configure the data source by clicking New Data Model.
  2. Add Your Fields: Thinking back to our planning stage and the business processes involved, we add the necessary fields. We include fields for the issue, the mechanic, and audit data like "modified on" and "modified by". When creating these, be sure to use camel casing for the field names. You can easily add these by clicking "New Field" or choosing from a list of commonly used fields.
  3. Utilize Choice Lists for Lookups: For standard sets of values—like priority levels, request statuses, or review statuses—Appian makes it easy to create choice lists. When we define the different statuses in a new choice list, Appian automatically creates a new record type behind the scenes to look up those specific values.

Tying It All Together: Relationships

A data model isn't complete without relationships, which allow you to connect related data and reference it throughout your application.

  • System Relationships: Remember how we set certain fields to the "User" data type? Appian automatically relates those fields to the system's User record type, giving us instant access to the user's name or email.
  • Custom Relationships: To link our two core record types, we create a many-to-one relationship from Maintenance to Vehicle. This perfectly models our business reality: multiple maintenance requests can be tied to a single vehicle, and this relationship lets us easily pull vehicle details directly from a maintenance record.

Deploying the Database

Once the data model looks good, clicking "Finish" prompts Appian to actually create the backend database tables for the Maintenance records and the new statuses. Appian will even provide a downloadable database script, making it incredibly easy to deploy these table changes when you eventually move your app to different environments.

And just like that, you've successfully modeled your core business data in Appian!

Comments

Popular posts from this blog

The Generative AI Boom: Moving from "Vibe Coding" to Agentic AI in 2026

The Ultimate Guide to GPT-3: What It Is, How It Works, and Mind-Blowing Applications

How to Actually Learn AI in 2026: A 30-Day Evidence-Based Roadmap