1.0.2 • Published 11 months ago
filemaker-data-api-client v1.0.2
FileMaker Data API Client
FileMaker Data API Client is a JavaScript wrapper module for the FileMaker Data API.
Please refer to the Claris Data API and FileMaker Data API Guide for more information.
Installation
To install this module, run the following command in your project directory:
npm install filemaker-data-api-client
Usage
Here is an example of how to use the FileMaker Data API Client:
const FileMakerDataAPIClient = require('filemaker-data-api-client');
async function main() {
// Create a new client
const client = new FileMakerDataAPIClient({
server: 'myserver.com',
database: 'mydatabase',
user: 'myuser',
password: 'mypassword',
layout: 'mylayout',
});
// Log in to the FileMaker server
await client.login();
// Retrieve a record by its ID
const record = await client.getRecord('12345');
// Update an existing record
await client.updateRecord('12345', { field1: 'updated value' });
// Create a new record
const newRecord = await client.createRecord({ field1: 'value1', field2: 'value2' });
// Delete a record
await client.deleteRecord('12345');
// Log out from the FileMaker server
await client.logout();
}
main().catch((error) => {
console.error('An error occurred:', error);
});
getLayoutURL()
: Returns the URL of the current layout.changeLayout(layoutName)
: Changes the current layout to the specified layout name.login()
: Logs in to the FileMaker server.logout()
: Logs out from the FileMaker server.getProductInfo()
: Retrieves information about the FileMaker server.getDatabases()
: Retrieves the list of databases available on the FileMaker server.getScripts()
: Retrieves the list of scripts available in the current database.getLayouts()
: Retrieves the list of layouts available in the current database.getLayoutMetadata(layoutName)
: Retrieves the metadata of the specified layout.createScriptParams(scriptName, paramValues)
: Creates the parameter object for executing a script.createRecord(data)
: Creates a new record with the provided data.updateRecord(recordId, data)
: Updates an existing record with the provided data.duplicateRecord(recordId)
: Duplicates an existing record.deleteRecord(recordId)
: Deletes a record by its ID.getRecord(recordId)
: Retrieves a record by its ID.getRecords(startingRecord, numberOfRecords)
: Retrieves multiple records starting from a specific record up to a specified number of records.uploadObjectData(recordId, fieldName, repetition, fileName, fileDataOrStream)
: Uploads object data to a record.findRecords(query)
: Searches for records based on the provided query.setGlobalFields(data)
: Sets the values of global fields with the provided data.executeScript(scriptName, scriptParam)
: Executes a script on the server.
Testing
To run the tests for the FileMaker Data API Client, you can use a testing framework such as Jest. Follow the steps below to set up and run the tests:
npm test
Contributing
Contributions to this project are welcome. Please open an issue or submit a pull request with your ideas or bug fixes.
License
This project is licensed under the MIT