The APPSeCONNECT portal is the webbased interface where you can access APPSeCONNECT application for integration, with the set of Functional modules. The APPSeCONNECT portal page is easily accessible. Once you have logged in, some elements of the APPSeCONNECT portal are common to all apps, accessible via the left side panel of the page. Of note, these also includes accessing your account, where you can update your information as well as changing your password.
The set of functional modules are easy to navigate and ease the method of integration via our Portal. The view of functional module(s) is given below:
Let us walkthrough the Functional Modules for understanding the usage and need of each menu.
|Dashboard||This page will show the details of the organisation, user logged in into. Project Basic Information, Configuration Completion Details etc|
|App||This section allows the user to choose or create apps that are required for the organisation|
|Connections||Users of APPSeCONNECT will be able to configure and create connection depending upon the apps chosen|
|APIs||This section talks about the API Management with APPSeCONNECT|
|Workflows||User will be able to design and execute workflows as per the business process and requirement|
|Manage||This section provides a simplified view of the modules that required to manage the integration process|
A. Accessing Organization Dashboard
Dashboard is the default page which you can view after logging in to the APPSeCONNECT portal. The dashboard can be seen automatically when a Project has been chosen. In this page you can see the snapshot of the project at a glance with respect to the activities of the user.
The dashboard view captures the following information-
- Project Basic Information
- Configuration Completion Details
- Subscription Details
- Execution Status
- Execution Counts
- Sync Errors
- Execution Logs
Click the dashboard widgets to expand and view the related functionality of the widgets in details.
1. Project Basic Information: This widget displays the basic information of the organisation.
The details displayed in the widget are:
a. Project Name: Shows the organisation name.
b. Main Contact Person: Displays the contact detail (Email Id only) of the project holder.
c. Implementation contact: Displays the email id of InSync implementation Team.
d. Sales Contact: Shows the Email details of InSync Sales Team.
e. Support Contact: Displays the Email Id of the InSync Support Team.
2. Configuration Completion Details: This widget displays the configuration informations related to the organisation project. This widget also has a progress bar that displays the progress status for the organisation.
3.Subscription Details: This widget will inform the user about the categories of applications subscribed for the organisation.
These are the following information that will be displayed in the widget.
a. Subscription Plan
b. Remaining Days
c. Subscription Expiry date
d. Application Categories Subscribed.
Note: The above three widgets initiate in minimized form by default. Users need to expand the widgets to view the widget details.
4.Execution Status: This widget displays the data synced wrt to an organization and is categorised based on the status: Success, Skipped & Failure.
The percentage is displayed on a pie chart irrespective of connections. Hovering over the section on the pie chart will display the exact number of data based on the statuses. Users can minimize, maximize the widget by click on the respective button available on the top right corner of the widget.
Note: The close button remains in disabled state.
5. Execution Counts: This widget displays the data counters with respect to each connection in form of a Bar chart.
This widget displays the status of each connection based on: Success, Skipped, Unprocessed & Failure.
Users can minimize, maximize the widget by click on the respective button available on the top right corner of the widget.
Note: The close button remains in disabled state
6.Sync Errors: This widget will display all the errors occurred, irrespective of the connections for the organisation.
For each error, the following details would be displayed.
a. The time of the error faced.
b. Error Faced
c. The source id of the item.
Note: Only the latest 100 errors would display in the widget.
Users can search the error based on the source id and the error name by click on the search icon available on the top right corner of the widget. Users can minimize, maximize the widget by click on the respective button available on the top right corner of the widget. Note: The close button remains in disabled state.
7. Execution Logs: This widget will display the execution logs of all the workflows & Realtime Time touchpoints executed through autosync. Every log would display these following details:
a. Connection Name
b. Touchpoint/Workflow name
c. Start time of the Execution
d. Finishing Time
e. Time taken to execute
Users can minimize, maximize the widget by click on the respective button available on the top right corner of the widget.
Note:(a) The close button remains in disabled state.
(b)Logs would be displayed only for autosync execution processes
B. Choosing App
APPSeCONNECT support large number of apps and you can find and choose the app from the prebuilt list. If you cannot find your App on the list, you might want to try out our App creation page to add a new App to our database. Any App once added is assigned to a particular category.
The organization-specific app screen page displays all the apps that are present in a specific organization.
Some of the predefined categories are :
- ERP - SAP Business One, Microsoft Dynamics NAV, Priority etc.
- ECommerce - Magento, Shopify, WooCommerce etc.
- CRM - Zoho CRM, Dynamics 365 CRM, Sugar CRM etc.
- Accounting - HubSpot, Salesforce Marketing Cloud etc.
Also, APPSeCONNECT supports both the Cloud and On Premise Based Application. Some of the examples are:
- Cloud Based Applications - Shopify, WooCommerce, Zoho CRM, Magento
- On Premise Application - MS Dynamics NAV, SAP Business One, Uniconta
- Both Cloud & On-Premise - SAP Business One
One has to search for the organization in the search box and the organization will open up. Go to the App menu. Here you will get two option - Choose App & Add New App
The Connection Page of the Portal enables creating the connection between two different Applications. You can also view the existing connection for a particular organization on this page.
API Management of APPSeCONNECT helps an organization to create, maintain and publish APIs for their various data sources such that the data can be easily accessed and maintained quickly without needing a separate development team. The API management platform provides an interface which any developer can access to create or configure services.
To know more about API Management, Click here.
Workflow management is group of instructions to the integration service in APPSeCONNECT.
APPSeCONNECT workflow application can be considered as a strong feature that uses the software to either partially or entirely automate a complex business process. Workflow is a concept that describes how process in business divides work activities into distinct roles, task, procedures and rules.
To know more about Workflow Management, Click here.
This section provides a simplified view of the modules that required to manage the integration process. These are the modules that are available under the Manage section.
You can see and track the non-transactional activities in form of recent feeds directly through the APPSeCONNECT portal after logging into your account. Traces of past activities of the user can be been viewed in the feed section.
- Login to your Organsiation.
- Navigate to Manage > Feeds.
- Here you can only see your non- transactional activities in your logged in profile.
- You can filter your search on the Feeds Page only by using keywords like
- For each feeds on the page, you will be provided with a hashtag that will define the activity area.
- On clicking over the hashtags, you will be listed with all the feeds whose activity was on that area.
Note: Whenever you schedule a workflow a message will get updated in the feeds after scheduling the time interval of workflow form the OP Agent.
ProTip: If you are a superadmin, any change(s) in the organization(s) done by you will be reflected in your feed section and the similar change will also get reflected in the specific organization feed section.
APPSeCONNECT Rule listing enables you to perform ACTIONS like (raising a support ticket or sending an email) based on the type of events encountered during agent execution such as -
Execution Failure, Execution Start, Execution End, via Rule Engine.
During Agent execution, if some events are encountered such as Application Crash, automatically the Rule which you have defined on Application Crash will be triggered and it will perform the associated Action with that Rule. You can also define additional criteria for triggering the Rule and performing the actions.
In that case whenever the event will occur it will also check if the additional criteria are matched or not. If the additional criteria are matched then only the Rule will be triggered.
Environment page lists the devices that have access to the project that the customer is working on.
APPSeCONNECT support tickets are meant of clients who can place a ticket and set priority level while facing any problem while working on APPSeCONNECT.and you need to resolve it as early as possible.
The implementers and the partners would be able to see the tickets and resolve them.
Users is one of the main feature of APPSeCONNECT portal as this control over the access that a user has. Depending on the role of the user, the menu panel of the portal is customized such that the user can use the functionalities depending on the role allotted to him.
- We can add multiple users to a particular project on the cloud portal by clicking on ‘Users’.
- Each user will have different levels to the portal depending on the role allotted to them.
- Depending on the role, different users have different levels of permission to access the various features.
- These roles are Organisation Admin, Implementer, Partner etc.
Protip According to the present scope of understanding, there you will encounter 2 main roles as given below:
(a) External Implementer: In APPSeCONNECT, an external implementer is a user who sets up the integration solution, depending on the customer’s requirement. An implementer can modify a project once it has been created by the Admin. He or she can edit the project and its status. An external implementer has access to specific projects.
(b) Organisation Admin: The access level of the customer is called the ‘Organisation Admin’. He or she can add/ choose apps. Create connections and setup workflows but he or she cannot setup roles, regulate the control of users, or bring about any configurational changes.
A company can have multiple user for an organisation in APPSeCONNECT project. Every project in APPSeCONNECT
has a single user
organisation owner by default, implementers/users of APPSeCONNECT can add multiple
users to an organisation for providing multiple access to its organisation users assigning different roles
The roles that can be provided to each user are:
a. Connection Manager
b. Organization Admin
Prerequisite for adding a User
- There should be an organisation present with APPSeCONNECT.
- User being added should not be a user for a different organisation.
Steps to add USER to an organisation
- Login to the APPSeCONNECT Portal and navigate to the USER module under Manage.
- By default, the interface would be of the tab Client Users. By default, APPSeCONNECT user would view the interface of the tab Client Users.
Note: The tab Partners will not have any view unless an organization has any requirements for partners.
For a fresh organisation, only the organisation owner will be displayed as the user in the user list. Click on the Add User button, to add more user to an organisation.
On clicking the button Add User, a sliding window opens with a form for adding a new user to the organisation.
Input the details and assign the role to the user that is being added. Specify the Role for the user that is being added.
Once all the mandatory fields are filled up, click on the Save button. The created user would be should in the list of users along with a success message.
The created user will have the following keys available for any modification. The list is provided below:
- Edit User: Only the details of the created user can be modified except the role.
- Revoke Permission: The delete button is for revoking the user from further use. The organisation owner and the Super Admin can only revoke the permission of an added user.
- Resend Activation Mail: User can resend the activation mail, if required. This button will be available only until the user has activated the account. Once activated, this button will not be visible.
- Change Role: Here, the default user can change the role for the created user
Note: * All the modification for the created user would be done by the organisation owner. The created user cannot modify any details. * Also, the organisation owner cannot modify any roles for its own user profile except the general details (exclusive of the email field). * Once a user is added to an organisation, the same email id provided previously cannot be used to for adding as a user for a different organisation.
Managing Customer Profile
This section enables you to quickly access your profile after logging into the application. This is where you will get the overview of your organization including assigned companies under you, your organization details and feeds
This section also enables you to change details like your personal information, changing avatar, changing password, privacy setting and security setting.
Let us dive in details about every section of customer profile information.
(a) My Profile
- Log in to the APPSeCONNECT portal with valid credentials.
- Click on your name, and you can view
- This section enables you to edit your profile details. Here You will see two tabs -
Overview & Change Details page.
- Here you can view your brief detail like your name, your registered e-mail, your role, phone number and IP address.
- In the
Summary sectionthe count of projects you handle/under organization is shown. You can also see your expired project counts and trials according to your Role and access level, you can see the companies.
Assigned Companieswill be shown on User Role basis. In My Company section, only your company details will be there.
My Feedssection is for seeing your recent activities. By Clicking Projects, Workflows, you will be redirected to that particular pages respectively.
ProTip: If you click on Change Details tab, you can edit all details
In the Personal Info tab, you can edit your name, mobile number.
- Click Change Avatar to change your Profile picture.
- Click Change Password to change the password and set your new password.
- The Security Setting enables you to handle all the security related settings like password expiry time set, account deactivation and updating encryption policy.
(b) My Subscription
Users of APPSeCONNECT can manage their subscription addons from this section. Navigating to this panel, user can perform these following actions:
User can view the organisation subscription plan and its expiry date.
Our Support team helps you in Selection of necessary addons and help you in updating subscription.
_Note: On Expiry of your organisation you will not be able to perform the following functionalities
You will not be able to perform the sync process of new data either through Auto-Sync or Manual Sync.
You will not be able to login either on the platform or the OP Agent.
On renewal of your subscription, new data will be taken for the sync process from following day onwards according to the expiry date.
For Pricing details click here
Scenario 1:Updating Addons for Generic REST Applications
- Login to the APPSeCONNECT Portal and Navigate to the My Subscription.
- For adding license addons to REST Based Applications you need to increase the Add On
Additional Custom Data Sources.
- You need to Update Subscription for the selected addon by clicking on the
- Now navigate to the On-Premise Agent. Do
Update Configurationin the agent followed by
- After the completion of Update Adapters, Close & Exit the On-Premise Agent from the taskbar.
- Restart the On-Premise Agent to reflect the subscription for REST Based Adapters.
(c) Lock Screen
Clicking on the lock screen will log off the user from the portal.
Click on the logout button will logout the user from the portal.
Bookmark Panel section
In the bookmark panel, user can also view the following buttons:
a. Bookmarks: For adding portal specific bookmarks
b. Notifications: For viewing portal specific notification.
c. Downloads: For downloading APPSeCONNECT tools like Agent, Plugins, Addons etc.
d. Full Screen: Users can also view the portal in full screen mode by clicking on the full screen button.
Steps to create portal specific Bookmark
- Clicking on the bookmarks link, user gets the option to Create Bookmark.
- User needs to name the bookmark which is to be created.
- Users can view the saved bookmarks by clicking on the bookmarks drop-down.
Note: Application specific Add-ons would be available as per the application chosen in the apps section of the organisation.
Organization Specific Notification for Users in AEC Portal
An User/Implementer can now view the notifications in the APPSeCONNECT Portal. Here you will get the knowhow of APPSeCONNECT Notification and its functionality.
Login with the valid AEC portal Credentials.
Click on the bell icon in the cloud portal.
The Notification Bar opens on clicking the bell icon.
You can view the full description by clicking on that notification.
Functional Aspects of Notification
- The notification will display all the organization specific notices and important updates.
- The notification detail window will display the notification Description, Priority Level, Severity Level and the Notification expiry date.
- The notification expiry date might vary from notification to notification.
User would be able to download APPSeCONNECT specific tools from this section. Clicking on the Downloads tab, user would be able to view the tools that are available for the organisation. The tools that would be available are:
- APPSeCONNECT On-Premise Agent
- APPSeCONNECT Plugins
- APPSeCONNECT Debugger
- Application specific Add-Ons
Steps to update an existing user
- Login to APPSeCONNECT
- Now Search/find the appropriate organization you want to change details for.
- Click on Users menu.
- Click on Edit link for an existing user.
In the edit user screen, you can change the username, email address, password etc for that particular user.
After completion, click save to save data. Now use the email id and password to login to cloud or agent.
Adding a Project in Recent Project Tab from Search Box
- You have logged in successfully as a user. Now you will be able to search all projects from the search box and from there you will be able to add projects to your recent organization tab list.
- Now the login page will be redirected to a homepage as shown below
- If you are an existing user, you can search for projects using the search box.
- Enter keyword in the search field.
- Now click on Add button and Search field will come up.
- There is a
- If you click on the cross button then already tagged project will be untagged from project tab.
- The pin will toggle on or off, where On means the project will not be removed automatically.
- After the pin is in on state that project will go to the first option.
- If you minimize the browser size then all project will show the bread button.
Add Newproject, will be added to the left side of last accessed unpinned project like this.
- For a new user, Account menu will only be available. For an end user, Administration menu will not be available
- When one project is added beyond the 5 projects, the last accessed project will be automatically removed.When already few project are added as pinned then after adding new project the new project will add to the left side of last unpinned added to project.
- If all 5 projects are pinned in the tab, thereafter if a new project is added it will be added but will not be visible in the tab.
- Project can be deleted from recent accessed tab by implementer/dev/ISV partner/Implementation partner [except new end customer/ user].
- Only projects where the user has access can be added.
For example: Let say you have logged in the portal with a user who doesn’t have permission more than two projects (e.g-solera) now if you would search with any keyword related “solera” it would not come in the search list like