AC5 Frequently Asked Questions
Table of Contents
- 1 1. AC5.X Deployment
- 2 2. Automations
- 3 2.1 Automation: IDP to JSON
- 4 2.2 Automation: App to App
- 5 2.2.1 FAQs for QuickBooks Online Integration
- 6 2.2.2 FAQs for Xero Management
- 7 2.2.3 FAQs for FreshBooks Management
- 8 2.2.4 FAQs for Salesforce App Management
- 9 2.2.5 FAQs for Zoho App Management
- 10 2.2.6 FAQs for BigCommerce App Management
- 10.1 General Information
- 10.2 Account Setup
- 10.3 Navigation and Features
- 10.4 Security and Compliance
- 10.5 Best Practices
- 10.6 Troubleshooting
- 10.7 Additional Resources
- 11 2.2.7 FAQs for Shopify App Management
- 11.1 Shopify App Credentials
- 11.2 AC5 Configuration
- 11.3 Adding Products
- 11.4 Adding Orders
- 11.5 Adding Customers
- 11.6 Shopify Partners Dashboard
- 12 2.2.8 FAQs for Service Now App Management
- 12.1 Purpose and Scope
- 12.2 Account Setup
- 12.3 Navigation Management
- 12.4 Security and Compliance
- 12.5 Customizations
- 12.6 Troubleshooting
- 12.7 Best Practices
- 12.8 Reports and Analytics
- 13 2.2.9 FAQs for Zendesk App Management
- 13.1 Purpose and Scope
- 13.2 Account Setup
- 13.3 Navigation Management
- 13.4 Customizations
- 13.5 Authentication
- 13.6 Security and Compliance
- 13.7 Best Practices
- 13.8 Troubleshooting
- 13.9 Analytics and Reporting
- 14 2.2.10 FAQs for Google Drive App Management
- 14.1 Overview
- 14.2 Setup
- 14.3 Navigation
- 14.4 File Management
- 14.5 Account Setup
- 14.6 Security
- 14.7 Collaboration
- 14.8 Best Practices
- 14.9 Troubleshooting
- 14.10 Storage
- 15 2.2.11 FAQs for Dropbox App Management
- 15.1 Purpose & Scope
- 15.2 Setup & Credentials
- 15.3 OAuth Configuration
- 15.4 Redirect URIs
- 15.5 Integration with AC5
- 15.6 File Management
- 15.7 General Tips
- 15.8 Sharing & Collaboration
- 15.9 Version Control
- 15.10 Search Optimization
- 16 2.2.12 FAQs for BambooHR App Management
- 16.1 Purpose & Scope
- 16.2 Account Setup
- 16.3 API Configuration
- 16.4 Navigation
- 16.5 Employee Management
- 16.6 Time-Off Management
- 16.7 Custom Fields
- 16.8 Authentication
- 16.9 Reports & Analytics
- 16.10 Security & Compliance
- 17 2.2.13 FAQs for Microsoft Sharepoint App Management
- 17.1 Prerequisites
- 17.2 Azure and AKS Access
- 17.3 Tools
- 17.4 Authentication
- 17.5 Security & Compliance
- 17.6 Integration
- 17.7 Troubleshooting
- 17.8 General
- 18 2.2.14 FAQ for Box App Management
- 18.1 Setup & Configuration
- 18.2 AC5 Configuration
- 18.3 Navigation
- 18.4 Tips & Best Practices
- 18.5 Troubleshooting
- 19 3. Marketplace
- 20 4. App Connectors
- 20.1 App Connectors Overview
- 20.2 App Connectors Functionality
- 20.3 Connectors Comparison
- 20.4 Data Handling in App Connectors
- 20.5 Supported Applications
- 20.6 Authentication and Security
- 20.7 OpenAPI Specification (OAS)
- 20.8 Custom Fields and Objects
- 20.9 Triggers and Actions
- 20.10 Runtime and Execution
- 20.11 Adding Custom Connectors
- 21 5. AI Map
- 21.1 Overview of AI Map
- 21.2 Confidence Levels
- 21.3 Handling Incorrect or Missing Mappings
- 21.4 AI Map Library
- 21.5 Design Time vs. Runtime
- 21.6 Complex Mapping Scenarios
- 21.7 Updates and Future Features
- 21.8 Common Issues and Challenges
- 21.9 Best Practices for Using AI Map
- 21.10 Field Naming Conventions
- 21.11 Custom Rules
- 21.12 Manual Review Necessity
- 21.13 Handling Unmapped Mandatory Fields
- 22 6. Layout Builder
- 22.1 General Overview
- 22.2 Creating a Layout
- 22.3 Field Customization
- 22.4 Advanced Features
- 22.5 Testing the Layout
- 22.6 Secure Files
- 22.7 Editing Predefined Layouts
- 22.8 Troubleshooting
- 22.9 Optimization and Best Practices
- 22.10 Miscellaneous
- 23 7. Reporting Dashboard
- 23.1 General Overview
- 23.2 Overview Section
- 23.3 Executions Section
- 23.4 Trigger Section
- 23.5 Global Search
- 23.6 IDP and EDI Automations
- 23.7 Data Management and Customization
- 24 8. AI Rule Engine
- 24.1 Purpose and Overview
- 24.2 Use Cases and Scenarios
- 24.3 Auto-Mapping Features
- 24.4 Platform Compatibility
- 24.5 Supported Versions
- 24.6 Responsibility and Usage
- 24.7 Limitations
- 24.8 Setup Requirements
- 24.9 Architecture and Design
- 24.10 UI and Storage
- 24.11 Functionality and Extensions
1. AC5.X Deployment
Category | Question | Answer |
Prerequisites and Setup | What are the prerequisites for deploying AC 5 on Azure? | Ensure Kubernetes service, backend and log databases, Azure AKS credentials, secure VPN connection, and admin rights are in place. |
How do I access Azure AKS credentials? | Obtain credentials from the infrastructure team, including Azure portal credentials and Jumphost credentials. | |
What applications are required for AC 5 deployment? | Azure CLI, kubectl CLI, and Helm CLI are required for managing Azure resources, Kubernetes clusters, and application deployment. | |
Installation and Configuration | How can I install the Azure CLI on Windows? | Download the installer, follow setup instructions, and verify installation with az --version. |
How is kubectl CLI installed on macOS? | Update Macports with sudo port selfupdate, install kubectl with sudo port install kubectl, and verify with kubectl version --client. | |
How do I create a Kubernetes namespace? | Use kubectl create ns <namespace name>. Example: kubectl create ns ac5tmt. Follow naming conventions. | |
How do I configure the database for AC 5? | Create two MySQL databases (backend and log), create a user, and grant full privileges. | |
How can I set up environment variables in values.yaml? | Open values.yaml, update fields like BACKEND_DB_USERNAME and BACKEND_DB_PASSWORD, and enable jobs as needed. | |
How do I install Adeptia Connect using Helm? | Navigate to Helm chart folder and run helm install <release name> <chart path> --timeout 10m --debug -n <namespace>. | |
Deployment Verification and Troubleshooting | How can I verify Adeptia Connect’s deployment status? | Use kubectl get pods -n <namespace>. If errors occur, use kubectl logs <pod-name> -n <namespace> to troubleshoot. |
What is the purpose of the values.yaml file in deployment? | Centralizes configuration details for easy management of environment-specific settings. | |
Networking and Accessibility | What is the function of Ingress in AC 5 deployment? | Ingress manages external HTTP/HTTPS access to Kubernetes services and enables secure routing of traffic. |
How can I set up Ingress for AC 5? | Modify ingress.yaml, create a TLS secret using kubectl create secret tls, and apply configuration with kubectl apply -f ingress.yaml. | |
How is the external IP for AC 5 obtained? | Assigned to the Ingress service, with DNS binding handled by the MST team for user-friendly access. | |
Key Components and Services | What is Helm, and why is it necessary for AC 5? | Helm simplifies deployment using pre-configured charts, streamlining Kubernetes manifest management. |
What role does RabbitMQ play in AC 5? | RabbitMQ facilitates asynchronous communication between services, supporting event-driven processing and task queuing. | |
What databases are required for AC 5’s backend and log data? | The backend database stores application data, and the log database captures system logs. Defined in values.yaml. | |
What are the main microservices in AC 5’s architecture? | Portal (user management), Webapp-gateway (request routing), and Event processor (managing triggers). | |
User Interaction and Operations | How do users interact with the AC 5 application? | Via a browser. Requests are routed through the web app gateway to backend services like the portal or event processor. |
How can I check existing namespaces in AKS? | Use kubectl get ns to list all namespaces and their statuses. |
2. Automations
Category | Question | Answer |
Overview and Basics | What is an Automation in AC5 Professional? | Automation is a defined workflow for automating ETL processes and ensuring efficient data flow between source and destination applications. |
What are the types of Automation in AC5? |
| |
| ||
What is the difference between App-to-App and IDP Automation? | App-to-App directly transfers data, while IDP processes unstructured data (e.g., PDFs) into structured formats before transferring. | |
Which applications can be used in Automations? | Supported apps include QuickBooks, Xero, Salesforce, Shopify, Google Drive, Zoho CRM, HubSpot, and more. | |
Creating and Configuring | How do I create an Automation with QuickBooks? | Navigate to Automation > Create New, define QuickBooks as source/destination, configure settings, save, and activate the Automation. |
What is a trigger in Automation? | A trigger is an event that starts an Automation, like "New Account" in QuickBooks. | |
How do I map source and destination elements? | Use the Data Mapper tool to drag/drop fields or apply mapping expressions; enable data splitting for large files if needed. | |
How can I configure triggers for execution? | Use POLLING for intervals or CRON EXPRESSION for exact schedules to define trigger execution timings. | |
What is a trigger condition? | A filter that retrieves data meeting specific criteria (e.g., date range or logical operators). | |
IDP Automation | What is IDP Automation, and how does it work? | Processes unstructured data (e.g., PDFs), extracts key info, converts it to structured formats (e.g., JSON), and transfers it. |
Can I customize data extraction in IDP? | Yes, you can define rules for precise data extraction based on business requirements. | |
What file formats are supported in IDP? | Formats like PDFs are supported, with extracted data converted into JSON or other structured formats. | |
Management and Operations | How can I manage an Automation? | View, edit, delete, activate/deactivate, or run Automations instantly as needed. |
What are the key aspects of Automation? | Data flow management, process automation, system integration, monitoring, configuration, and error handling. | |
Can Automations process data in parallel? | Yes, enable "Parallel Processing" and define the number of concurrent processes. | |
How can I apply filters to data? | Use logical conditions like AND/OR to filter data from the source application. | |
What happens if an error occurs? | AC5 logs errors, notifies contacts, and allows review/reprocessing of failed tasks. | |
Integration and Connectivity | What is the role of OAuth in QuickBooks integration? | OAuth provides secure authentication for data exchanges. Configure an OAuth Client with a callback URL for setup. |
How do I test the connection with QuickBooks? | After configuration, click the "Test" button to verify connectivity and resolve issues if any. |
2.1 Automation: IDP to JSON
Category | Question | Answer |
Document Processing | What types of documents can AC5 Professional process? | AC5 can process invoices, purchase orders, and receipts in PDF format. |
How does AC5 handle unstructured data in PDFs? | AC5 uses generative AI to extract key data fields (e.g., dates, amounts, customer details) from unstructured PDFs and converts them into structured JSON format. | |
Can I select specific pages of a PDF for processing? | Yes, on the IDP tab, choose Specific Pages and specify page numbers or ranges. | |
How do I specify a page range in AC5? | Use the format, e.g., "18-37" for a range or "1, 2, 7, 9" for individual pages. | |
Source Applications & Formats | What applications can I connect to with AC5 Professional? | You can connect AC5 to ERP, CRM, financial systems, Google Drive, Dropbox, and FTP servers. |
What source file formats are supported in AC5? | AC5 supports file sources such as JSON, with options for FTP, Google Drive, Dropbox, and File Upload. | |
How do I define Google Drive as the source application? | Follow the steps on the Create Automation using Google Drive page, defining Google Drive in the source application section. | |
Can I use Dropbox as the source for my automation? | Yes, you can use Dropbox by following steps in the Create Automation using Dropbox section. | |
What steps should I follow to set up FTP as the source application? | Follow the 15 steps outlined in the Create Automation using FTP page to set up FTP as the source. | |
Can AC5 be configured to process multiple types of source applications? | Yes, you can configure AC5 to use different sources like Google Drive, Dropbox, and FTP for processing. | |
JSON Layout & Data Review | How can I define a custom JSON layout in AC5? | On the Setup tab, select New JSON Layout, provide a name and description, upload a JSON file defining the desired data structure, and save it. |
Is there an option to preview the JSON data format before submission? | Yes, click Test on the JSON Layout screen to check and adjust the JSON format. | |
How can I review data before submission to the destination app? | Select Yes (Recommended) under the Review data option to verify the JSON format before submission. | |
Where can I view and update the JSON data format during execution? | Go to the Dashboard, select Executions, choose IDP, locate your automation, and update the JSON if necessary. | |
Can I apply custom validation rules to the extracted data? | Yes, you can apply validation rules by configuring them under the Data Validation Rules section. | |
What does the ‘Select CDM Source Schema’ field do? | It allows you to choose a schema for defining the JSON structure of the extracted data. | |
Can I test the automation configuration without sending data to the destination? | Yes, the Test button allows you to review the JSON data format before final submission. | |
How do I save changes after modifying JSON data during automation execution? | Click Save & Submit to execute the automation with the updated JSON. | |
Automation Setup & Execution | How do I define QuickBooks as the destination application? | Follow the steps on the Create Automation using QuickBooks page. |
Can I set Xero as the destination app? | Yes, refer to the Create Automation using Xero section for setup instructions. |
2.2 Automation: App to App
Category | Question | Answer |
Automation Basics | What is an Automation in AC5 Professional? | An Automation in AC5 Professional is a defined workflow that automates and manages data flow between applications, including extraction, transformation, and loading. |
What types of data formats can AC5 Professional handle in Automations? | It can handle both structured and unstructured data, converting unstructured data into a structured format using generative AI capabilities. | |
What are the types of Automations in AC5 Professional? | The types are App-to-App Automations, IDP (Intelligent Document Processing), and Partner-to-App Automations. | |
What is the key difference between App-to-App and IDP Automations? | App-to-App involves data exchange between business applications, while IDP processes data from a file-based application, extracting relevant information before transferring it. | |
Key Aspects of Automation | What are the key aspects of Automation in AC5? | They include data flow management, business process automation, integration, configuration, monitoring and tracking, and error handling. |
What is the role of a Trigger in Automation? | A Trigger initiates the data transfer process by fetching data from the source application. | |
What is the role of an Action in Automation? | An Action specifies the operations performed on the destination application to process the transferred data. | |
Integration and Compatibility | Can Automations in AC5 integrate with multiple applications? | Yes, they integrate seamlessly with applications like QuickBooks, Xero, Google Drive, Salesforce, Shopify, and more. |
Can Automations validate and transform data? | Yes, they can validate and transform data as part of predefined workflows. | |
Is it possible to use file-based applications as sources in Automations? | Yes, especially in IDP Automations where file-based data is processed intelligently. | |
Monitoring and Error Handling | What capabilities does AC5 offer for monitoring Automations? | It provides monitoring and tracking features to oversee data exchanges, identify issues, and ensure successful completion of processes. |
How does AC5 handle errors in Automations? | It includes mechanisms for error handling, logging issues, and addressing exceptions during data processing. | |
Business Applications | What business applications can serve as a destination in Automations? | Applications like QuickBooks, Xero, Salesforce, Zoho CRM, and ServiceNow, among others. |
Pre-built Automations | What is the benefit of using pre-built Automations? | Pre-built Automations saves time and ensures accuracy by providing predefined workflows for common use cases. |
Unstructured Data Processing | Can AC5 Automations manage unstructured data from file sources? | Yes, AC5 can process and structure unstructured data using AI before transferring it. |
What are some common use cases for IDP Automations? | IDP Automations are used for extracting information from invoices, contracts, and other file-based documents for integration into business applications. | |
Productivity and Efficiency | How does AC5 Professional ensure seamless integration between systems? | It defines data exchange and processing rules to create smooth connections between various applications and databases. |
What industries benefit from AC5 Automations? | Industries needing data exchange, integration, and process automation across applications, such as finance, retail, HR, and customer support. | |
How does AC5 enhance productivity with Automations? | By automating repetitive tasks, reducing manual errors, and ensuring efficient data handling across systems. |
2.2.1 FAQs for QuickBooks Online Integration
Category | Question | Answer |
Purpose and Overview | What is the purpose of this training document? | The document provides a structured guide for setting up OAuth credentials to integrate QuickBooks Online with applications, including creating and configuring a QuickBooks app, retrieving necessary credentials, defining OAuth scopes, and configuring Redirect URIs. |
OAuth Credentials | What credentials are required for the OAuth flow? |
|
| ||
| ||
| ||
Account and App Creation | How can I create an Intuit Developer Account? | Visit the Intuit Developer Portal, and either sign up for a new account or log in if you already have one. |
What steps are needed to create a QuickBooks Online app? | Navigate to the Intuit Developer Dashboard, click "Create an App," fill in the app details, and select QuickBooks Online and Payments as the platform. | |
Where can I find my Client ID and Client Secret after app creation? | These credentials are located on your app's details page in the Intuit Developer Portal. | |
OAuth Scopes and Configuration | What are common scopes used in QuickBooks OAuth integration? |
|
| ||
| ||
How do I configure Redirect URIs for testing? | Use a localhost URL (e.g., http://localhost:3000/callback) during development or the production URL for live apps. | |
OAuth Flow and Authentication | What is the OAuth 2.0 flow in QuickBooks? | It involves redirecting users to QuickBooks' OAuth consent screen, exchanging an authorization code for an access token, and using the token for API requests. |
How do I refresh an expired access token? | Send a POST request to the token endpoint (https://oauth.platform.intuit.com/oauth2/v1/tokens/bearer) with your refresh token, Client ID, and Client Secret. | |
What is the URL format for the authorization request? | ||
Testing and Troubleshooting | Can I test OAuth integration without a live app? | Yes, you can use the OAuth Playground in the Intuit Developer Portal or a localhost setup for testing. |
What is the lifespan of a QuickBooks access token? | Access tokens typically expire after one hour. | |
What steps should be followed after creating OAuth credentials? | Use the credentials to request access tokens and implement API calls to QuickBooks. | |
How do I retrieve the authentication code during login? | The code is sent to a predefined email. Contact the email owner for the code. |
2.2.2 FAQs for Xero Management
Category | Question | Answer |
Overview and Purpose | What is the purpose of this training document? | The document provides guidance on using Xero, a cloud-based accounting tool, focusing on account setup, navigation, and integration with other platforms like AC5.x. |
What is Xero? | Xero is a cloud-based accounting solution that automates financial tasks, provides real-time insights, and simplifies financial management for businesses. | |
Account Setup and Configuration | How can I set up a new account in Xero? | Visit Xero's website, click "Start Free Trial," fill in your details, verify your email, and set up your organization with business details like name, country, industry type, and currency. |
How do I verify my email during Xero account setup? | After signing up, you will receive an email with a verification link. Click the link to complete verification. | |
What details are needed during Xero organization setup? | Business name, country and industry type, and currency for transactions. | |
Customization and Integration | What are custom fields in Xero, and how are they used? | Custom fields allow users to add personalized information to records like invoices, bills, and transactions for better tracking and categorization. |
How do custom fields benefit businesses in Xero? | They allow businesses to track specific details, such as project codes or client references, for tailored reporting. | |
What is the scope of integrating Xero with other applications? | Integration allows seamless data exchange for invoices, bills, and financial records, enhancing workflow automation. | |
Authentication and Security | What authentication type is used for Xero in AC5.x integration? | OAuth is the authentication type used for securely connecting Xero with other platforms. |
How do I configure Xero in AC5.x? | Provide a name for the account, select "OAuth" as the authentication type, and enter the Client ID, Client Secret, and Redirect URI obtained from the Xero Developer Portal. | |
What are the prerequisites for setting up Xero in AC5.x? | Client ID and Client Secret from the Xero Developer Portal, properly configured Redirect URI, and OAuth authentication setup. | |
Developer Portal and Access | Where is the Xero Developer Portal located? | The portal is available at Xero’s official website, under the developer section for API integrations. |
What steps are involved in creating OAuth credentials for Xero? | Register your app in the Xero Developer Portal, obtain the Client ID and Client Secret, and configure scopes and Redirect URI. | |
How secure is the data exchange using App Keys? | App Keys ensure secure authentication between Xero and third-party applications, protecting user data. | |
Testing and Validation | How can I test a Xero integration? | Use test credentials and the Redirect URI to authenticate and validate data exchange between Xero and the integrated application. |
Multiple Organizations | Can I manage multiple organizations in Xero? | Yes, Xero allows users to set up and manage multiple organizations under a single account. |
Compliance and Reporting | How does Xero help with compliance and reporting? | Xero provides automated tax reporting, real-time financial insights, and customizable fields to meet compliance needs. |
2.2.3 FAQs for FreshBooks Management
Category | Question | Answer |
Purpose and Overview | What is the primary purpose of the FreshBooks App? | The FreshBooks App helps users manage business finances efficiently by enabling invoicing, expense tracking, financial reporting, and more to save time and improve decision-making. |
What is the scope of the FreshBooks App? | The app provides mobile access to essential accounting features, enhancing productivity, streamlining financial processes, and supporting small business owners, freelancers, and accountants. | |
Account Setup and Configuration | How do I set up an account on FreshBooks? | Visit the FreshBooks website, log in to the Developer Console, create a new app, enter required details, save the app, and retrieve OAuth credentials. |
What are the OAuth credentials in FreshBooks? |
| |
| ||
Where can I locate the Client ID and Client Secret? | These credentials are found in the settings of your app in the FreshBooks Developer Console. | |
Features and Functionality | What are the main features of the FreshBooks App? |
|
| ||
| ||
How does FreshBooks help with mobile financial management? | The app provides access to financial data and tools on mobile devices, allowing users to manage invoices, expenses, and reports on the go. | |
What is the role of custom fields in FreshBooks? | Custom fields allow the personalization of data in invoices, expenses, and reports to meet specific business needs. | |
Integration and Security | What are App Keys, and how are they used in FreshBooks? | App Keys authenticate and authorize third-party apps to access FreshBooks data securely. |
What is the role of OAuth in FreshBooks integration? | OAuth provides secure authentication for connecting FreshBooks with third-party apps and systems like AC5.x. | |
Configuration in AC5.x | How do I configure FreshBooks in AC5.x? | Add the FreshBooks account, configure OAuth details, including Client ID and Client Secret. |
What are the authentication types supported in FreshBooks? | FreshBooks supports OAuth authentication for secure access and data exchange. | |
Management and Productivity | What are some typical entities managed in FreshBooks? | Entities include invoices, expenses, time entries, and reports, with specific allowed operations for each. |
How can FreshBooks enhance productivity for businesses? | By automating financial tasks, providing real-time data access, and offering flexible tools for managing finances from any location. | |
Developer Console and Security | What is the importance of the FreshBooks Developer Console? | It allows users to create apps, manage credentials, and configure integrations for enhanced functionality. |
How secure is data managed through FreshBooks? | FreshBooks employs OAuth credentials and secure authentication methods to ensure data protection. | |
Account and Data Management | What details are required for account creation in FreshBooks? |
|
| ||
Integration with Other Tools | Can FreshBooks be integrated with other tools? | Yes, FreshBooks can integrate with platforms like AC5.x through OAuth configuration and API keys. |
Financial Reporting | What is the purpose of financial reporting in FreshBooks? | To provide users with insights into their financial health, enabling better planning and decision-making. |
2.2.4 FAQs for Salesforce App Management
Category | Question | Answer |
General Information | What is Salesforce? | Salesforce is a cloud-based CRM platform that helps businesses manage sales, marketing, and service. |
What are the primary features of Salesforce? | Key features include sales automation, analytics, AI-driven insights, custom integrations, and user-friendly dashboards. | |
Account Setup | How do I create a new Salesforce account? | Visit the Salesforce website, sign up for a free trial, provide business details, verify email, and set up your organization profile. |
What details are required during account setup? | Business name, industry, default currency, and administrator credentials. | |
How can I verify my Salesforce account? | Check your email for a verification link sent by Salesforce after signup. | |
Navigation and Features | How do I navigate Salesforce effectively? | Use intuitive dashboards and tools. Access administrative functions via the "Setup" menu. |
What are custom fields in Salesforce? | Additional fields created to store business-specific data, applicable to accounts, contacts, and opportunities. | |
API and Integration | How can I locate my API keys in Salesforce? | Go to the "Setup" menu, search "App Manager," find your app, and view API details in OAuth Settings. |
How do I generate new API credentials? | Click "Edit" in app settings, regenerate keys, and save changes. | |
Can Salesforce integrate with other applications? | Yes, through the AppExchange or custom integrations using API keys. | |
Security and Compliance | What are the best practices for securing my Salesforce account? | Use strong passwords, enable two-factor authentication, and review user permissions regularly. |
How does Salesforce ensure regulatory compliance? | By following organizational standards and implementing robust security measures. | |
Best Practices | How can I optimize Salesforce usage? | Regularly update records, use automation tools, and train your team for effective utilization. |
What automation tools are available in Salesforce? | Tools like workflows and process builders enhance efficiency by automating repetitive tasks. | |
Troubleshooting | What should I do if I can’t log in to my account? | Reset your password using "Forgot Password" or contact your administrator. |
How can I resolve data synchronization issues? | Check API settings, verify integration credentials, and review integration logs. | |
What steps can I take if Salesforce is slow? | Clear your browser cache and optimize dashboard or report usage. | |
Additional Resources | Where can I find more information about Salesforce? | Visit Salesforce's official training resources at Trailhead. |
2.2.5 FAQs for Zoho App Management
Category | Question | Answer |
General Information | What is Zoho? | Zoho is a cloud-based suite of applications for businesses, offering CRM, marketing, finance, HR, and more. |
Who typically uses Zoho? | Zoho is designed for businesses of all sizes, especially SMEs, to manage operations efficiently. | |
Account Setup | How do I create a Zoho account? | Visit Zoho's sign-up page, choose a method (email, Google, Microsoft), provide details, verify email, and log in. |
What details are needed for Zoho account creation? | An email address, password, full name, and optionally a phone number for recovery. | |
How can I verify my Zoho account? | Open the verification email sent by Zoho and click the provided link. | |
API and Integration | How do I create an OAuth client in Zoho? | Log in to the Developer Console, add a client, choose client type, fill details, and get the Client ID and Client Secret. |
What are Zoho API keys? | API keys authenticate third-party apps for secure integration with Zoho services. | |
What is the difference between internal and external keys? | Internal keys identify records in Zoho, while external keys link records between Zoho and other systems. | |
Navigation and Features | What are the key features of Zoho CRM’s dashboard? | It provides quick metrics like sales forecasts and activities, with customizable widgets. |
How can I locate entity-specific information in Zoho CRM? | Use the navigation menu to access modules, then search or filter records. | |
What views are available in Zoho CRM modules? | List View (tabular), Kanban View (sales stages), and Calendar View (tasks/activities). | |
Customizations | What are custom fields in Zoho CRM? | User-defined fields to capture business-specific data like "Preferred Contact Method." |
How can I create custom modules? | Define fields, relationships, and permissions via Zoho’s configuration settings. | |
Security and Compliance | What authentication methods does Zoho support? | OAuth 2.0 for secure access and Authtoken (legacy) for older integrations. |
What measures should I take to secure Zoho accounts? | Use strong passwords, enable two-factor authentication, and review permissions regularly. | |
Best Practices | How can I maximize Zoho’s utility? | Regularly update records, automate workflows, and train your team on features. |
What automation tools are available in Zoho? | Zoho Orchestly (process management) and Zoho Flow (workflow automation) enhance efficiency. | |
Troubleshooting | What should I do if I can't log in to my Zoho account? | Reset your password or contact Zoho support. |
How can I resolve data sync issues in Zoho? | Verify API configurations, check integration logs, and ensure correct credentials. | |
What steps can I take if Zoho CRM performs slowly? | Clear browser cache, optimize dashboards, and check connectivity. | |
Additional Resources | Where can I find more information about Zoho? | Visit Zoho’s official website or the Zoho Developer Console for resources. |
2.2.6 FAQs for BigCommerce App Management
Category | Question | Answer |
---|---|---|
General Information | What is BigCommerce? | BigCommerce is a SaaS eCommerce platform that empowers businesses to build and manage online stores. |
Who typically uses BigCommerce? | Businesses of all sizes, particularly those needing enterprise-grade eCommerce functionality. | |
Account Setup | How do I create a BigCommerce account? | Visit the BigCommerce website, sign up with your details, verify your email, and log in. |
What details are required for account setup? | First and last name, phone number, email address, company name, and region. | |
How do I set up an API key for my store? | Navigate to “Settings,” select Store-level API accounts, and create an API account. | |
How can I use my BigCommerce API credentials? | Use the API credentials (Client ID, Client Secret, Access Token) in your OAuth flow. | |
Navigation and Features | What does the BigCommerce dashboard offer? | It provides access to store performance, orders, products, customer data, and marketing tools. |
How can I locate specific entity information? | Use the navigation menu to explore modules like Orders, Products, Customers, and Reports. | |
What are custom fields in BigCommerce? | Custom fields allow additional data storage for products or entities to meet specific business needs. | |
Security and Compliance | How does BigCommerce ensure secure integration? | By adhering to industry standards, enforcing API token security, and implementing regulatory compliance. |
What measures should I take for security compliance? | Use strong credentials, secure API access, and comply with data protection regulations. | |
Best Practices | How can I optimize BigCommerce usage? | Regularly update product data, monitor performance metrics, and follow naming conventions for activities. |
What conventions should I follow in the app? | Define clear naming for activities, maintain consistent data entry, and automate workflows. | |
Troubleshooting | What should I do if I encounter app-related issues? | Check API credentials, review error logs, and verify network connectivity. |
How can I resolve OAuth issues with BigCommerce? | Recheck API credentials, ensure OAuth scopes match your use case, and regenerate tokens if needed. | |
What steps can I take if BigCommerce is running slow? | Optimize integrations, clear browser cache, and review the number of active requests. | |
Additional Resources | Where can I find more information about BigCommerce? |
2.2.7 FAQs for Shopify App Management
Category | Question | Answer |
Shopify App Credentials | What is the purpose of obtaining Shopify app credentials? | The purpose is to facilitate integration with the Shopify platform by obtaining key credentials like the API Key and Store Name. |
How do you access the API Key for your Shopify app? | Log in to the Shopify Partners Dashboard, access your app, and navigate to the API credentials tab to retrieve the API Key and Secret Key. | |
What is the Store Name, and how do you obtain it? | The Store Name is the unique Shopify store URL (e.g., {store-name}.myshopify.com). It can be retrieved from the Development Stores section or from the store owner. | |
AC5 Configuration | What details are needed to configure AC5 Automation? | You need the Store Name and the API Key. |
Adding Products | What are the steps to add a product to Shopify? | Log in to Shopify Admin Panel, navigate to Products, click "Add Product," fill in details (title, description, images, pricing, inventory, shipping), and save the product. |
Adding Orders | How do you create a manual order in Shopify? | Navigate to Orders, click "Create Order," add products, select or create a customer, apply discounts/taxes (optional), choose payment method, and save the order. |
Adding Customers | What is the process for adding a customer in Shopify? | Navigate to Customers, click "Add Customer," enter the customer details (name, email, phone, address), and save the customer profile. |
Shopify Partners Dashboard | What is the Shopify Partners Dashboard used for? | It is used to manage apps, development stores, and access credentials needed for Shopify integrations. |
Can you create a public app using the Shopify Partners Dashboard? | Yes, you can create a public app for distribution through the Shopify Partners Dashboard by following the app creation prompts. |
2.2.8 FAQs for Service Now App Management
Category | Question | Answer |
---|---|---|
Purpose and Scope | What is the purpose of ServiceNow? | ServiceNow provides a centralized platform for managing workflows, automating business processes, and integrating systems to improve productivity, reduce costs, and enhance collaboration. |
What functional areas does ServiceNow cover? | IT Service Management, IT Operations Management, HR Service Delivery, Customer Service Management, Security Operations, GRC, and more. | |
Account Setup | What are the steps to create a new account on ServiceNow? | Visit the ServiceNow website, sign up with required details (e.g., name, email, company), and navigate to the Developer page to configure user roles. |
How do you set up an API Key in ServiceNow? | Go to "Application Registry," create a new OAuth API endpoint, enter details (e.g., name, redirect URL), and submit. Copy the Client Key from the generated incident. | |
Navigation Management | How is navigation structured in ServiceNow? | Navigation is divided into Primary (core functionalities), Secondary (submenus), and aids like breadcrumbs, search bars, and shortcuts to enhance usability. |
What are best practices for navigation in ServiceNow? | Use consistent patterns, logically group items, and provide clear labels/icons. | |
Security and Compliance | What authentication types are supported in ServiceNow? | ServiceNow supports Basic Authentication, OAuth, JWT, and SAML. |
What are the key terms in authentication? |
| |
Customizations | What are custom fields in ServiceNow? | User-defined fields added to entities for capturing additional data not available in the default schema (e.g., "Preferred Language" for user profiles). |
What are App Keys, Internal Keys, and External Keys? |
| |
Troubleshooting | What are common troubleshooting steps for API configurations? | Verify the Client Secret, Identifier, Scope, and API credentials. Check the redirect URL and permissions in the Application Registry. |
Best Practices | How can you optimize ServiceNow usage? | Use real-time dashboards, customize workflows as per business needs, and ensure all security measures (like API Key storage) are followed. |
Reports and Analytics | How does ServiceNow handle reporting and analytics? | ServiceNow provides real-time dashboards, customizable reports, predictive analytics, and data-driven insights to aid decision-making. |
2.2.9 FAQs for Zendesk App Management
Category | Question | Answer |
---|---|---|
Purpose and Scope | What is the purpose of the Zendesk app? | Zendesk provides tools for helpdesk support, live chat, email marketing, sales, customer engagement, and more to enhance customer and employee interactions. |
What is the scope of Zendesk? | Zendesk supports omnichannel communication, ticketing systems, automation, analytics, collaboration tools, integrations, customization, knowledge base management, and more. | |
Account Setup | How do you create a new account on Zendesk? | Visit the Zendesk website, sign up with required details (e.g., email, name, phone number, job title, company), and complete the setup process. |
What credentials are required to set up a Zendesk account? | You need the domain name, username, and password. | |
How can you retrieve the API key in Zendesk? | Go to the Home Page, select "Apps and Integration," configure the required app, and retrieve the API key post-installation. | |
Navigation Management | How do you navigate in the Zendesk app? | Use the primary menus for core functionalities and search features to locate entity-specific details, like tickets, customers, or reports. |
Customizations | What are custom fields in Zendesk? | Custom fields allow businesses to add specific data fields to tickets or user profiles that are not part of the default schema. |
Authentication | What are the authentication methods in Zendesk? | Basic Authentication is used, requiring a domain name, username, and password for account access. |
What is the role of a private key in authentication? | A private key is used to sign tokens securely during API interactions and should never be shared publicly. | |
Security and Compliance | How does Zendesk ensure security in app integration? | By complying with industry standards, using secure authentication mechanisms, and following best practices for API key and credential management. |
Best Practices | What are the best practices for using Zendesk? | Use consistent ticket tagging, optimize workflows with automation, ensure timely response to customer queries, and utilize analytics to track performance. |
Troubleshooting | What common issues might arise in Zendesk, and how can they be resolved? | Common issues include authentication errors (fix by verifying credentials), API integration issues (recheck API key and permissions), and navigation confusion (utilize Zendesk support resources). |
Analytics and Reporting | What analytics features does Zendesk offer? | Zendesk provides real-time dashboards, custom reports, and CSAT tracking to evaluate customer support performance and user engagement. |
2.2.10 FAQs for Google Drive App Management
Category | Question | Answer |
---|---|---|
Overview | What is the purpose of Google Drive? | It provides a cloud-based storage solution for secure file storage, access, sharing, and collaboration across devices. |
Setup | How do you create credentials for Google Drive integration? | Visit the Google Cloud website, create a project, enable the Google Drive API, and configure OAuth client credentials. |
Navigation | What are the main navigation options in the Google Drive app? | Options include Home, Files, Shared, Search, and Library, accessible via a bottom navigation bar or a hamburger menu. |
File Management | How can users manage files in Google Drive? | Users can upload, move, delete, and share files using file actions available through long-pressing files or folders. |
Account Setup | What is needed for account setup in AC5.x? | You need the Client ID and Secret from Google Cloud and select OAuth as the authentication type. |
Security | What security considerations should be made when integrating Google Drive? | Ensure compliance with industry standards and use secure authentication like OAuth. |
Collaboration | How does Google Drive enable real-time collaboration? | It allows multiple users to edit documents simultaneously using integrated tools like Google Docs, Sheets, and Slides. |
Best Practices | What are some best practices for using Google Drive effectively? | Organize files systematically, use version history for changes, and set appropriate sharing permissions. |
Troubleshooting | What should you do if Google Drive isn’t syncing files? | Check internet connectivity, verify storage limits, and ensure the app is up-to-date. |
Storage | How much free storage does Google Drive offer, and how can it be expanded? | Google Drive offers 15 GB of free storage. Users can purchase additional space through Google One subscriptions. |
2.2.11 FAQs for Dropbox App Management
Category | Question | Answer |
---|---|---|
Purpose & Scope | What is the purpose of the Dropbox Connector Management guide? | It guides users in setting up OAuth credentials for Dropbox integration, including app creation, credentials retrieval, and configuration. |
Setup & Credentials | How do you create OAuth credentials for a Dropbox app? | Log in to the Dropbox Developer Console, create a new app, configure permissions, and retrieve the Client ID and Secret from the app settings. |
OAuth Configuration | What are OAuth scopes, and how do you configure them for Dropbox? | OAuth scopes define the app’s permissions. Configure them in the app settings by enabling specific permissions like files.metadata.read and files.content.read. |
Redirect URIs | When and how should Redirect URIs be set for Dropbox integration? | Redirect URIs are optional but necessary for certain OAuth flows. They should be set in the app’s settings to specify where users are redirected after authentication. |
Integration with AC5 | How do you configure Dropbox integration in AC5? | Log in to AC5, create a new automation, select Dropbox, configure the OAuth client, and set up the workflow trigger and action. |
File Management | What steps are involved in creating a folder in Dropbox? | Log in, navigate to the desired location, click "New Folder," name the folder, and save it. Files can be uploaded directly into the new folder. |
General Tips | How can you mark files or folders for quick access in Dropbox? | Mark frequently used files or folders as favorites/starred for easier and faster access. |
Sharing & Collaboration | How do you manage file sharing and permissions in Dropbox? | Use the "Share" option to invite collaborators or generate shareable links, and manage permissions for view or edit access. |
Version Control | Can you restore previous versions of files in Dropbox? | Yes, you can view and restore previous file versions from the file’s context menu under Version History. |
Search Optimization | What are some advanced search tips for Dropbox? | Use filters like type:pdf or modified:today to narrow down search results based on file type or modification date. |
2.2.12 FAQs for BambooHR App Management
Category | Question | Answer |
---|---|---|
Purpose & Scope | What is the primary purpose of the BambooHR app? | The app helps organizations manage employee information, payroll, benefits, and performance, streamlining HR processes. |
Account Setup | How do you set up an account in BambooHR? | Visit the BambooHR website, sign up with your details, generate an API key, and provide the domain name during setup. |
API Configuration | How can you generate an API key in BambooHR? | Go to "My Account," select "API Key," add a new key, and securely store the generated key as it is only visible once. |
Navigation | What are the main navigation features in BambooHR? | The dashboard includes quick links to employee records, reports, time-off management, and customizable search and filters. |
Employee Management | How do you manage employee records in BambooHR? | Use the Employee Directory to search, create, update, and delete employee profiles, including personal and job-related information. |
Time-Off Management | How can employees submit and track time-off requests in BambooHR? | Through the Time-Off module, employees can request leave, view their balances, and track the status of requests on an interactive calendar. |
Custom Fields | What are custom fields in BambooHR, and how are they used? | Custom fields capture additional employee data, such as certifications or performance ratings, tailored to organizational needs. |
Authentication | What types of authentication does BambooHR support? | It supports username/password, Single Sign-On (SSO) with providers like Okta, and API keys for secure integrations. |
Reports & Analytics | How can you generate reports in BambooHR? | Access pre-built or custom reports via the Reports section, applying filters for date ranges, employee groups, or metrics. |
Security & Compliance | What security measures should be followed when using BambooHR? | Implement strong password policies, use SSO, secure API keys, and configure session timeouts to enhance security and compliance. |
2.2.13 FAQs for Microsoft Sharepoint App Management
Category | Question | Answer |
Prerequisites | What are the prerequisites for deploying AC 5 on Azure? | Kubernetes service configured in Azure, backend/log databases, Azure AKS credentials, secure VPN, and admin rights on the local machine. |
What is required for account setup in AC5.x? | An active Azure AD tenant, admin access to Azure AD, and a SharePoint Online site within Office 365. | |
Azure and AKS Access | How do I access Azure AKS credentials? | Through Azure portal credentials and Jumphost credentials provided by the infrastructure team. |
Tools | What applications are required for AC 5 deployment? | Azure CLI, kubectl CLI, and Helm CLI. |
Authentication | How do I generate a Client Secret for SharePoint API access? | Go to Azure AD > Certificates & Secrets > New Client Secret, and copy the generated value. |
Security & Compliance | How can I ensure secure integration of the app? | Follow compliance guidelines and industry best practices, and configure secure connections. |
Integration | What permissions are required for integrating with SharePoint API? | Delegated permissions (e.g., Sites.Read.All) for user-based actions or application permissions for background services. |
Troubleshooting | What should I do if OAuth integration tests fail? | Verify client ID, client secret, scopes, and permissions in Azure, and ensure API endpoints are correctly configured. |
General | What is the purpose of the SharePoint App? | To enable users to access, view, and interact with SharePoint content from mobile devices. |
How does SharePoint support team collaboration? | By providing document management, content sharing, and workflow automation tools. |
2.2.14 FAQ for Box App Management
Category | Question | Answer |
---|---|---|
Setup & Configuration | What are the steps to create a Box app? | Log in to Box Developer Console, create a new app, select the API type and access level, name the app, and save. |
How do I get OAuth credentials for my Box app? | Go to the app's settings to retrieve the Client ID (App Key) and Client Secret (App Secret). | |
What are OAuth scopes, and how do I configure them? | OAuth scopes define permissions for the app, e.g., files.metadata.read. Configure these in the app settings. | |
How do I set up redirect URIs for my app? | In the app settings, add authorized URLs like https://acexpress-ist.adeptia.com/rest/connectors/oauth/account. | |
AC5 Configuration | How do I configure Box in AC5? | Login to AC5, select Box, provide connection details, choose the OAuth client, set date/time formats, and connect. |
What triggers can I set in Box integration for workflows? | Triggers like "New File in Folder" or "File Updated" can initiate workflows. | |
How can I define the target action in a Box integration workflow? | Choose the target app (e.g., FTP server) and configure required fields in AC5. | |
Navigation | How do I create a folder in Box? | Log in, navigate to the desired location, click "New Folder," name the folder, and save it. |
How do I upload files to a folder in Box? | Open the folder, use the "Upload" button, or drag and drop files directly into it. | |
Tips & Best Practices | What are some general tips for Box usage? | Use favorites for quick access, manage shared file permissions, and utilize advanced search filters like type:pdf. |
How can I track file changes in Box? | Use the "Version History" option from the file’s context menu to view or restore previous versions. | |
Troubleshooting | What should I do if the Box app integration doesn’t work? | Verify the OAuth credentials, check scope configurations, and ensure redirect URIs are correctly set. |
Why can’t I connect to Box from AC5? | Ensure the OAuth client is properly configured, and verify date/time formats and the selected time zone. |
3. Marketplace
Category | Question | Answer |
---|---|---|
Marketplace Overview | What is the Marketplace? | The Marketplace is a central hub where users can access and install pre-built Automations tailored to their needs. It streamlines integration by offering ready-made solutions. |
Tabs and Navigation | What tabs are available on the Marketplace? | The available tabs are: |
| ||
| ||
| ||
| ||
App Connectors | What are App Connectors? | App Connectors display a list of business applications. Selecting an app leads to the "All Automations" tab where pre-built Automations using that app can be viewed. |
Document Processing (IDP) | What types of documents can be processed using the Marketplace's Document (IDP) feature? | The Document (IDP) tab processes documents like: |
| ||
| ||
| ||
| ||
| ||
Using Pre-built Automations | How do I use a pre-built Automation? |
|
| ||
| ||
| ||
Document Type Selection | What happens after I select a document type from the Document (IDP) tab? | After selecting a document type (e.g., Purchase Orders), you are taken to "All Automations" where pre-built Automations process the unstructured file and write structured data to the destination application. |
All Automations | What is the 'All Automations' tab? | The "All Automations" tab displays all pre-built Automations available on the Marketplace, providing easy access for installation. |
Configuration of Automations | How do I configure an installed Automation? | After installing a pre-built Automation, configure it according to specific needs. Refer to the "Create Automation" section in the documentation for detailed instructions. |
Exploring Automations | Can I use multiple tabs to explore Automations? | Yes, you can explore Automations across multiple tabs (Partner Network, App Connectors, Document (IDP), All Automations) to find solutions suited to different needs. |
Business Applications | What types of business applications are available in App Connectors? | The App Connectors tab displays business applications like QuickBooks, which can be integrated into pre-built Automations available in the Marketplace. |
4. App Connectors
Category | Question | Answer |
---|---|---|
App Connectors Overview | What are app connectors? | App connectors are tools that enable different applications or systems to share data and communicate with each other, streamlining processes, improving efficiency, and automating tasks. |
App Connectors Functionality | What role do app connectors play in Adeptia Connect? | In Adeptia Connect, app connectors use triggers to start workflows in source apps and actions to perform specific tasks in target apps. They enable integration with external applications through pre-built or custom connectors. |
What is a custom app connector in Adeptia Connect? | A custom app connector is a user-defined integration created using an OpenAPI Specification (OAS) YAML file, enabling Adeptia Connect to work with applications lacking pre-built connectors. | |
What is the purpose of the connector's specification file? | The specification file, based on OpenAPI Specification (OAS 3.0), defines details for connecting to third-party applications, including API endpoints, operations, authentication, and request/response formats. | |
What features can be defined in the connector's specification file? | Features include authentication mechanisms, triggers, pagination, incremental data strategy, actions, batch processing, API-based filtering, and field references. | |
Connectors Comparison | What is the difference between app connectors and REST connectors? | REST connectors handle basic API interactions, while app connectors offer advanced features like incremental data sync, complex authentication, pagination, batch processing, and dynamic schemas. |
When should you use a REST connector instead of an app connector? | REST connectors are best for simple API operations without the need for advanced features like pagination, batch processing, or incremental data synchronization. | |
What is the advantage of app connectors over REST connectors? | App connectors support advanced features such as complex authentication, incremental data sync, pagination, batch operations, and custom field references, making them ideal for complex integrations. | |
Data Handling in App Connectors | What is incremental data synchronization in app connectors? | Incremental data synchronization ensures that only new or updated records are processed, improving efficiency by minimizing data exchange. |
What is pagination in app connectors? | Pagination divides large datasets into smaller, manageable chunks, allowing data to be retrieved in batches instead of all at once. | |
What is batch processing in-app connectors? | Batch processing allows multiple operations or requests to be executed collectively, improving efficiency during data transfers. | |
What is API-based data filtering? | API-based filtering specifies criteria for processing only relevant data fields, reducing unnecessary data transfer. | |
Supported Applications | What applications can be integrated using pre-built app connectors in Adeptia Connect? | Supported applications include QuickBooks, Salesforce, Dropbox, Google Drive, Zoho CRM, Shopify, ServiceNow, Microsoft Dynamics, Zendesk, and more. |
Authentication and Security | What is the role of authentication in app connectors? | Authentication ensures secure communication by managing credentials and access tokens between Adeptia Connect and third-party applications. |
OpenAPI Specification (OAS) | What is an OpenAPI Specification (OAS) file? | An OAS file is a machine-readable document that describes RESTful API details, including operations, endpoints, request formats, and authentication requirements. |
Custom Fields and Objects | How does Adeptia Connect support custom objects and fields? | App connectors support dynamic schemas and custom fields, allowing users to adapt integrations to unique application requirements. |
Triggers and Actions | What is a trigger in an app connector? | A trigger initiates workflows or tasks in the source application, such as detecting changes in data or events. |
What is the purpose of actions in app connectors? | Actions perform specific tasks in the target application, such as creating, updating, or deleting records. | |
Runtime and Execution | What is the runtime engine in the app connector framework? | The runtime engine executes operations defined in the connector's specification file, facilitating communication and data exchange between systems. |
Adding Custom Connectors | How can a custom app connector be added to Adeptia Connect? | A custom app connector can be added by uploading its OpenAPI Specification (OAS) YAML file to the Adeptia Connect user interface. |
5. AI Map
Category | Question | Answer |
---|---|---|
Overview of AI Map | What is AI Map, and how does it help in data mapping? | AI Map automates data mapping by using AI to suggest mappings with confidence levels (High, Medium, Low), reducing manual effort and speeding up integration tasks. The library feature allows users to save and reuse mappings for similar scenarios. |
Confidence Levels | What are the confidence levels, and how do they work? |
|
| ||
| ||
How can I apply mappings based on confidence levels? | Users can filter and apply mappings by confidence level. Use High Confidence mappings directly; review Medium and Low Confidence mappings before applying them. | |
Handling Incorrect or Missing Mappings | What should I do if a mapping is incorrect or missing? | Modify incorrect mappings in the layout. Reject unwanted suggestions. For missing mappings, manually create them and save to the library for future use. |
AI Map Library | How does the AI Map Library work? | The library stores manual mappings created by users. These are suggested as High Confidence when similar layouts are encountered in future projects, improving speed and accuracy. |
Design Time vs. Runtime | What are the key differences between Design Time and Runtime in AI Map? |
|
| ||
Complex Mapping Scenarios | Does AI Map support handling complex mapping scenarios? | Yes, AI Map can recognize different naming conventions and intelligently map them. Users can define custom mappings and rules for complex cases, saving them in the library. |
Updates and Future Features | Are there any planned updates to improve AI Map? | Planned features include: |
| ||
| ||
| ||
Common Issues and Challenges | What are the common issues users face with AI Map? |
|
| ||
Best Practices for Using AI Map | What are the best practices for using AI Map effectively? |
|
| ||
| ||
| ||
Field Naming Conventions | Can AI Map handle mismatched field naming conventions? | Yes, AI Map can recognize and map fields with equivalent meanings even if the naming conventions differ (e.g., "Last Name" vs "Surname"). |
Custom Rules | Can I define custom rules in AI Map? | Custom rules can currently be implemented manually. AI Map will soon allow rule definitions in plain language for automating complex mappings. |
Manual Review Necessity | Why is manual review necessary for some mappings? | Manual review ensures that Medium and Low Confidence mappings meet system requirements and prevents errors during data integration. |
Handling Unmapped Mandatory Fields | How do I handle unmapped mandatory fields? | Perform a manual check during the design phase to ensure all required fields are mapped. An automatic alert feature for unmapped mandatory fields is planned. |
6. Layout Builder
Category | Question | Answer |
---|---|---|
General Overview | What is the Layout Builder? | The Layout Builder is a tool for defining data structures (schemas) used in automation workflows. |
Why is the Layout Builder important? | It helps streamline data mapping and processing, ensuring accurate schema definitions for source and target data. | |
Creating a Layout | How do I select a data format for my layout? | Navigate to the Setup step in your automation and select either the "Text" or "Excel" data format. |
What is the process to add a new layout? | Click the "Add" button under the Format Type section, provide a name and description, and configure layout settings. | |
What settings can I define for text layouts? | Specify record separators, header presence, and either upload a sample file or manually enter field names. | |
How do I define a schema from a sample file? | Upload the file, choose a sheet and starting row for field extraction, and then select a row as the schema definition. | |
Field Customization | Can I rename fields in my schema? | Yes, you can modify field names directly in the schema definition view. |
How do I add additional fields to my layout? | Use the "Add Row" option in the Field Customization section. | |
What formats can I specify for date fields? | Define custom date and time formats based on your requirements. | |
Can I change the data types of fields? | Yes, field data types can be modified during customization. | |
Advanced Features | What is the Action Menu? | It is a feature that allows adding, removing, or editing fields within the schema. |
What are Advanced Settings? | Additional properties can be accessed via the settings button in the top-right corner. | |
Testing the Layout | How can I test a layout with default files? | The uploaded file is automatically tested and displayed in the Test View, flagging any errors. |
Is custom file testing possible? | Yes, you can upload a different file to test its compatibility with the layout. | |
Secure Files | Can I use password-protected Excel files? | Yes, during layout setup, provide the password to enable the file to be read and processed. |
Editing Predefined Layouts | What are predefined layouts? | These are layouts provided for common applications like BambooHR and Shopify. |
Can predefined layouts be edited? | Yes, you can edit and add child records to these predefined layouts. | |
Troubleshooting | What should I do if the layout fails to load my data? | Ensure the data format and settings match the file structure, and validate the schema. |
How do I resolve flagged errors during testing? | Review the flagged data rows in the Test View and adjust your layout settings accordingly. | |
Can I test layouts without uploading a file? | No, a file is required for layout testing to validate compatibility. | |
Optimization and Best Practices | What is the best way to start with complex schemas? | Begin with a sample file and incrementally define fields, testing compatibility at each step. |
How often should I test a layout? | Test after every major change to ensure compatibility and data integrity. | |
Can I reuse layouts for multiple automation workflows? | Yes, layouts are reusable across workflows with similar data structures. | |
Miscellaneous | Is Layout Builder only for schema definition? | Primarily, but it also helps test and troubleshoot data compatibility issues. |
7. Reporting Dashboard
Category | Question | Answer |
---|---|---|
General Overview | What is the AC5 Professional Dashboard? | The AC5 Professional Dashboard is a tool for monitoring and managing Automations, providing insights into execution metrics and trigger details. |
How do I access the Dashboard page? | Click on the "Dashboard" option in the left panel of AC5 Professional to open the Dashboard page. | |
What sections are included in the Dashboard? | The Dashboard includes Overview, Executions, and Trigger sections. | |
Overview Section | What is displayed in the Overview section? | The Overview section shows a snapshot of Automation processes, graphical execution trends, and access to IDP Automation logs. |
What does the Run Trend section show? | Run Trend provides a graphical view of the total count of Automation executions, Partner creations, and data usage. | |
How can I filter the Run Trend graph? | Use buttons to include/exclude specific categories, indicated by colors like green (Automation count), blue (Partner count), and red (data usage). | |
What does the Current Executions section display? | It shows the Automation count for the current day by status: successful, running, queued, and failed. | |
How do I add a gadget to the Dashboard Overview? | Click "Add" on the Overview page, select a gadget from the list or use the search box, and click "Add." | |
What is Non-EDI Inbound? | Non-EDI Inbound shows the number of non-EDI inbound Automations over a specified period, displaying successful and failed Automations in green and red. | |
How can I view the acknowledgment summary of a Partner’s Outbound Automations? | Use the Outbound Acknowledgements gadget and select the Partner from the drop-down list. | |
How do I minimize or delete a gadget? | Click "Minimize" or "Delete" on the respective gadget. | |
What actions can I perform on a gadget in the Overview section? | Actions include Refresh, Download, Zoom in, and Minimize. | |
Executions Section | What is displayed in the Executions section? | It shows details of successfully triggered Automations with options to filter by Automation Type, Log status, and Error status. |
What is the function of the Automation Type filter in Executions? | It allows viewing details for all Automations or specific types, such as Automation, AIDocs, EDI X12 Interchanges, etc. | |
What does the Status column in the Executions page indicate? | It shows the Automation's status, including states like Fetching, No Data, Queued, Running, Success, or Abort. | |
How can I view the execution details of an Automation? | Click "More" in the ACTION column to see execution details and related information. | |
Can I sort Automations on the Executions page? | Yes, sort alphabetically by the AUTOMATION column or by date/time using the STARTED column. | |
How do I customize the columns displayed in the Executions page? | Use "Column Actions" to choose "Show all columns" or "Hide column." | |
Trigger Section | What information is displayed in the Trigger section? | It shows details of Automations fetching data, queued, or those that encountered errors. |
What does the Previous Fire Time column indicate in Triggers? | It shows the date and time when the Automation was last executed. | |
How can I locate a specific Automation in the Trigger section? | Use the search functionality to locate the required Automation. | |
Global Search | How can I use the Global Search feature? | Enter a keyword in the Search bar at the top-right corner, select a category if needed, or press enter for a broad search across categories. |
What entities does the Global Search scan for? | Global Search can locate Automations, Executions, Networks, Partners, and Marketplace entities. | |
Are there any special characters allowed in Global Search? | Yes, Global Search accepts special characters like underscores, hyphens, periods, and others. | |
IDP and EDI Automations | What does the AIDocs Executions section display? | It shows details of IDP Automations that have been successfully triggered. |
What are EDI Inbound and EDI Outbound gadgets? | These gadgets display the total number of EDI Automations (successful and failed) over a specified period. | |
What is displayed in the Top 5 Partners By Volume section? | It shows the top five Partners with the highest number of Automations. | |
Data Management and Customization | How do I download data from a gadget? | Click "Download" on the gadget to download its charts or reports. |
What does the ID field in the Executions page represent? | The ID field represents the unique identifier of the Automation. | |
Can I modify the output of an IDP Automation? | Yes, click "Review" on the IDP Automation, modify the output JSON if needed, and then click "Save & Submit" to execute, or "Reject & Close" to abort. |
8. AI Rule Engine
Category | Question | Answer |
Purpose and Overview | What is the purpose of the AI Rules Engine? | The AI Rules Engine automates code generation for workflows driven by specific business rules or logic, streamlining large-scale data transformations and improving efficiency. |
Use Cases and Scenarios | What use cases and scenarios are better suited for AI Rules Engine, and which for Traditional Mapping Rules? | AI Rules Engine is suited for complex scenarios with dynamic rule generation, large datasets, and scalability needs. Traditional Mapping Rules are ideal for simple, repetitive mappings. |
Auto-Mapping Features | What is the difference between AI Rules Engine Auto-Mapper (Local) and Auto-Mapper (AI-Based)? | Auto-Mapper (Local) uses predefined rules and static logic, while Auto-Mapper (AI-Based) leverages AI to predict and create mappings based on data patterns. |
Platform Compatibility | Will the AI Rules Engine run on both Windows and Linux Adeptia environments? | Yes, the AI Rules Engine is compatible with both Windows and Linux environments within Adeptia. |
Supported Versions | What version of AC supports AI Rules Engine? | The AI Rules Engine is supported in AC 4.3 and above. |
Can AI Rules Engine be added to previous AC version deployments? | No, the AI Rules Engine is suited for AC 4.4 and above and does not support older versions. | |
Responsibility and Usage | Which Adeptia team is responsible for maintaining the AI Rules Engine? | The R&D team handles new enhancements, while the MST team manages support-related responsibilities. |
Can AI Rules Engine be used externally from any other application as a service? | Yes, it can be used externally, but it is primarily embedded within Adeptia for internal use. | |
Limitations | What are the limitations of the AI Rules Engine? | Key limitations include supported formats (e.g., JSON), Azure OpenAI Services dependency, and suitability for only complex workflows. |
Setup Requirements | What are the infrastructure, configuration, and access prerequisites for Azure OpenAI communication? | These include specific ports, IP whitelisting, and certificates for secure connections. |
Is AI Rules Engine deployed as part of the AC Installer? | As per the latest updates, the AI Rules Engine is deployed separately after AC installation. | |
What Azure subscription is used for AI Rules Engine? | The Azure subscription depends on the customer’s setup, and customers may need to provide their own subscription for control and cost management. | |
Does the customer need to provide their own Azure Account for AI Rules Engine in AC Cloud or OnPrem? | Yes, customers must provide their own Azure account for both AC Cloud and OnPrem environments. | |
Architecture and Design | What is the role of AI in the AI Rules Engine? | AI automates rule and code generation by leveraging machine learning models to interpret complex data patterns. |
What AI technology is used for code generation? | Azure OpenAI services with Generative AI models like GPT assist in code generation and rule automation. | |
How does the AI Rules Engine fit into process flows or transactions? | It is represented as an activity within workflows, dynamically generating rules and automating tasks based on data inputs. | |
What software language does the AI Rules Engine generate code in? | Python is the primary language used for rule execution. | |
Is Python the only code option supported? | Currently, Python is the default language, though support for other languages may be added in the future. | |
Can the AI Rules Engine be used at both design time and runtime? | Yes, it can generate rules during configuration (design time) and execute them during workflows (runtime). | |
Does the AI Rules Engine use Azure OpenAI Services during design time and runtime? | Yes, Azure OpenAI Services are utilized at both design and runtime stages. | |
UI and Storage | What UI framework is used for implementing the AI Rules Engine? | The AI Rules Engine UI is implemented using ReactJS. |
Where is the AI Python code stored? | The AI Python code is stored in Adeptia metadata tables such as AI_RULE_EXECUTIONS, AI_RULESET, and others. | |
Where is the AI Python code executed? | The Python code is executed within Adeptia Connect (AC). | |
Where does the generated code reside? | The code resides within Adeptia but may also reside in external cloud environments like Azure, depending on the deployment. | |
What input/output schema formats are supported by the AI Rules Engine? | JSON is the primary supported format, though additional formats may be supported based on configuration. | |
Functionality and Extensions | What is the AI Rules Engine Live Option? | It enables real-time operation, dynamically generating and executing rules during live workflow execution. |
Can the AI Rules Engine be extended with custom extensions? | Yes, it supports custom extensions for added functionality. | |
How is the AI Rules Engine invoked? | It can be invoked via REST Webservices, enabling interaction with external applications. | |
Is there a feature to copy an existing rule set? | Yes, users can create a copy of an existing rule set and save it under a different name for reuse or modification. |