Copy ProofChat into Your File
Step-by-step guide for integrating ProofChat by copying all components into your existing FileMaker solution
Overview
This guide walks you through the process of copying all ProofChat components into your existing FileMaker file. This approach allows you to maintain your current file structure while adding ProofChat's AI capabilities directly to your solution.
License Key Ready
Make sure you have your ProofChat license key available. You'll need it when you first open the chat after integration. Get your free license from our Pricing Page.
Important Prerequisites
Before starting this process, ensure you have: - A complete backup of your existing FileMaker file - Access to the ProofChat demo file - Administrative privileges in both files - Understanding of FileMaker's relationship graph and layout design
Integration Steps
Step 1: Copy Custom Functions
First, you need to copy all custom functions from the ProofChat file into your target file.
- Open both files: Have both your target file and the ProofChat file open in FileMaker Pro
- Access custom functions: In the ProofChat file, go to
File > Manage > Custom Functions...
- Copy custom functions: Select all ProofChat custom functions and copy them
- Paste in target file: In your target file, go to
File > Manage > Custom Functions...
and paste the copied functions - Verify functions: Ensure all custom functions are present and accessible
Custom Function Dependencies
ProofChat's custom functions may have dependencies on each other. Make sure to copy/paste all of them to avoid broken references.
Step 2: Copy ProofChat Data Tables
Next, copy all data tables that begin with pc_
from the ProofChat file to your target file.
- Identify PC tables: In the ProofChat file, go to
File > Manage > Database...
and note all tables with thepc_
prefix - Copy table structures:
- Select each
pc_
table in the ProofChat file - Copy the table structure (fields, field types, validation, auto-enter options)
- Select each
- Create tables in target file: In your target file, create new tables with identical structures
- Maintain the exact
pc_
naming convention - Preserve all field definitions, types, and options
- Ensure validation rules and auto-enter calculations are identical
- Maintain the exact
Table Structure Precision
It's crucial that the table structures match exactly. Any differences in field types, validation, or auto-enter settings could cause ProofChat's AI functions to malfunction.
Step 3: Recreate PC Table Relationships
Recreate the relationships between the PC tables in your target file's relationship graph.
- Study ProofChat relationships: In the ProofChat file, examine the relationship graph to identify connections between
pc_
tables - Add table occurrences: In your target file's relationship graph, add table occurrences for all
pc_
tables - Recreate relationships: Connect the table occurrences using the same relationship criteria as in the ProofChat file
- Verify relationship settings: Ensure all relationship options (allow creation, deletion, sorting) match exactly
Relationship Complexity
Based on the current ProofChat structure, there should be minimal relationships between PC tables. However, verify this by carefully examining the ProofChat relationship graph.
Step 4: Create ProofChat Layouts
Create the basic layout structures for all ProofChat layouts in your target file.
- Identify ProofChat layouts: In the ProofChat file, locate all layouts in the "ProofChat" folder (should be 7 layouts)
- Create layout folder: In your target file, create a "ProofChat" folder in the layout list
- Create basic layouts: For each ProofChat layout, create a new layout in your target file with:
- The same name
- The same base table occurrence
- The same layout type (form, list, table, etc.)
- Initial setup only: At this stage, just create the basic layout structure - don't worry about layout objects yet
ProofChat Layouts to Create:
📁 pc_ProofChat Layouts
├── 📄 pc_ProofChat
├── 📄 pc_ai_accounts_api
├── 📄 pc_chat_threads_api
├── 📄 pc_model_assignment_api
├── 📄 pc_model_assignment_account_api
├── 📄 pc_systems
└── 📄 pc_tools_api
Step 5: Copy ProofChat Scripts
Copy all scripts in the two specified folders from the ProofChat file to your target file.
Understanding Script Folder Ownership
The two folders you're copying have different purposes: ProofChat Integration
contains configuration scripts that you'll own and customize,
while ProofChat
contains the core application scripts that remain
ProofChat-owned. See Configuration Scripts
Ownership for details on what
you can safely edit after integration.
- Access scripts: In the ProofChat file, go to
Scripts > Script Workspace
. - Select the folders: Locate the folders named
ProofChat Integration
andProofChat
— these contain all ProofChat scripts. - Copy: Select both folders and copy them.
- Paste: In your target file's Script Workspace, paste the copied folders.
- Keep folder structure: Preserve the folder names
ProofChat Integration
andProofChat
to maintain organization.
Script References
Scripts may contain references to layouts, table occurrences, or custom functions. We'll address any broken references in a later step.
Step 6: Copy Layout Contents
Now copy all layout objects and design elements from ProofChat layouts to your target file layouts.
- Work layout by layout: For each of the 7 ProofChat layouts:
- Copy layout parts:
- Ensure header, body, footer, and any other parts match exactly
- Copy part sizing and formatting
- Copy all layout objects: Select all objects on the ProofChat layout and copy them
- Paste to target layout: Paste all objects to the corresponding layout in your target file
- Verify object properties: Check that all layout objects retain their:
- Field assignments
- Button actions and scripts
- Formatting and styling
- Conditional formatting
- Object states and behaviors
Layout Precision
Pay special attention to button scripts, field assignments, and conditional formatting. These elements are crucial for ProofChat's functionality.
Step 7: Import ProofChat Data
Import all data from the pc_
tables in the ProofChat file to your target file.
- Prepare for import: Ensure your target file's
pc_
tables are empty and ready for data import - Import data table by table: For each
pc_
table:- Set up import from the ProofChat file
- Map fields carefully to ensure data aligns correctly
- Perform the import
- Verify data integrity: After each import, verify that:
- Record counts match
- Data appears correctly in fields
- Relationships function properly
- Test related data: Ensure imported data maintains proper relationships between tables
Data Mapping
Carefully map fields during import to ensure data lands in the correct fields. Misaligned data could break ProofChat's functionality.
Step 8: Review Field References
Check for any broken references in field definitions.
- Review auto-enter calculations: Check all fields in
pc_
tables for auto-enter calculations - Verify calculation fields: Ensure all calculation fields reference correct table occurrences and fields
- Check validation: Verify field validation rules reference appropriate data
- Test field functionality: Create test records to ensure all field behaviors work correctly
Step 9: Review Script References
Check for and fix any broken references in scripts.
- Test script functionality: Run each ProofChat script to identify broken references
- Fix layout references: Update any script steps that reference layouts to point to your newly created layouts
- Verify table occurrence references: Ensure scripts reference the correct table occurrences in your file
- Update navigation: Modify any navigation scripts to work within your file structure
Script Testing
Systematically test each script to ensure it functions correctly in your target file environment.
Verification Checklist
After completing all steps, verify your integration:
- All custom functions copied and accessible
- All
pc_
tables created with identical structures - Relationships between
pc_
tables recreated correctly - All 7 ProofChat layouts created and populated
- All ProofChat scripts copied and functional
- All
pc_
table data imported correctly - No broken field references
- No broken script references
- ProofChat functionality accessible and working
Next Steps
Once you've completed this integration process:
- Connect your app: Follow the Add an "Open Chat" button guide to connect your app to the chat
- Test thoroughly: Create comprehensive tests to ensure all ProofChat features work correctly
- Train users: Prepare training materials for users who will interact with ProofChat
This integration method requires careful attention to detail but results in a fully integrated solution with ProofChat capabilities built directly into your existing file.