Docs Portal
Documentation
API ReferenceConsole

Famis360 Destination

Famis360 logo

The FAMIS360 Destination connector sends Work Orders from the Mapped graph into FAMIS360, a CMMS commonly used in higher-education and facilities-management environments. It reads existing Work Order context from Mapped, creates or updates the corresponding FAMIS360 record, and writes the FAMIS360 Work Order identity back to the same Mapped Work Order.

Use Cases

  • Centralized Work Order dispatch: Use Mapped as the hub for Work Orders from multiple systems and route them into FAMIS360 for execution.
  • Round-trip FAMIS360 workflows: Pair with source connectors so Work Orders can be created in Mapped, enriched with graph context, and then managed in FAMIS360.
  • Controlled migration and replay: Backfill historical Work Orders by date range or by specific IDs during rollout or remediation.

Configuration

Auth Requirements

The connector uses FAMIS360 username / password authentication.

FieldRequiredDescriptionWhere to Find
Base URLYesYour FAMIS360 instance URLYour FAMIS360 administrator (for example https://your-instance.famis360.com)
UsernameYesUsername used to create and update Work Orders in FAMIS360Your FAMIS360 administrator
PasswordYesPassword used to access the FAMIS360 APIYour FAMIS360 administrator

Use credentials with permission to create and update Work Orders.

Building Selection

The place-mapping step is used only to choose which FAMIS360 buildings are in scope for Work Order synchronization.

SelectionRequiredNotes
Selected buildingsYesOnly Work Orders related to these buildings are sent to FAMIS360

Notes

  • New Work Orders must be related to a Space that already has a FAMIS360 space ExternalIdentity.
  • Building selection acts as a safety boundary so only approved locations are synchronized.

Work Order Field Mapping

The connector provides field mapping for the main FAMIS360 Work Order classification fields.

Mapped Work Order fieldFAMIS360 field
Job PriorityRequest Priority
SectorRequest Type
Problem DescriptionRequest Sub Type
Job TypeWork Type
Job StatusStatus (updates only)

Each mapping supports these behaviors:

OptionDescription
Enable / disable mappingPass mapped values, or leave the original graph value unmapped
Default valueUse a fallback FAMIS360 value when no explicit mapping is found
Undefined-only modeApply the default only when a source value has no explicit mapping

The connector also refreshes FAMIS360 request-type / request-sub-type and building / request-type relationships so valid combinations can be reviewed before sync.

Advanced Options

Historical Data Backfill

The data backfill lets you re-send or re-sync Work Orders that might have had changes or corrections.

ModeDescription
Date rangeReprocess Work Orders created or updated during a selected time window
Specific IDsReprocess only the listed Mapped Work Order IDs. This must be the Mapped entity Id for the Work Order(s).

Backfill uses the same create / update rules as normal polling.

Mapped Concepts

API to Mapped Entities

FAMIS360 destination behaviorMapped entityExact typeNotes
Created or updated FAMIS360 Work OrderWorkOrderWORK_ORDERExisting Mapped Work Order remains in place; the connector adds or preserves the FAMIS360 identity
Synced FAMIS360 identityExternalIdentity on identitiesN/AWritten as urn:famis360:workorder:id:<id>

Polling & Syncing Behavior

FunctionFrequencyDescription
Work Order pollEvery 1 minuteProcesses new and updated Mapped Work Orders for the selected buildings. On the first run, it looks back 2 hours.
Historical backfillOn demandReplays Work Orders by date range or by specific Work Order IDs
Relationship refreshFirst poll and on demandRefreshes request-type, request-sub-type, and building relationship data used by the mapping workflow
DeprovisionOn connector removalClears connector action state

Syncing Requirements for Work Orders

  • A related Space with a FAMIS360 space identity
  • Requestor information from a related person on the Work Order
  • Related Building that matches one of the selected buildings

Sample Code

The below query shows the related Space and identifies for Famis360 Work Orders. Read more about Work Orders.

Request Response
Copy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
{
  workOrders(filter: {connectedDataSourceId: {eq: "your-connector-Id"}}) {
    id
    name
    jobPriority
    jobStatus
    jobType
    summary
    dateCreated
    mappingKey
    identities {
      ... on ExternalIdentity {
        __typename
        value
      }
    }
    relatesTo {
      ... on GenericPlace {
        id
        name
        exactType
        mappingKey
        identities {
          ... on ExternalIdentity {
            __typename
            value
          }
        }
      }
    }
  }
}