Field Notes
Design judgment from real Appian builds — document security, integration failure modes, and SAIL traps that documentation doesn't cover. Generalized, no client or employer specifics.
Document management and the security-domain boundary
Record-level security in Appian is only a query filter — it never touches the document itself. Folder ACLs, organized per security domain, are the only real enforcement layer.
IntegrationsIntegrations — schema-constrained API responses
A provider's supported JSON Schema subset is narrower than JSON Schema itself, and Appian surfaces the gap as an opaque integration error.
IntegrationsIntegrations — truncated responses and the auto-conversion trap
A large API response comes back truncated and parsing throws. The cause is usually Appian's own JSON-to-value conversion step, not the provider.
SAIL / interfacesSAIL — Any Type inputs, index(), and the silent empty
SAIL almost never throws on bad data — it returns {} and renders a confidently wrong UI. Five rules for the failure modes that cost days instead of minutes.