You've meticulously built a powerful app in Syntasa, but what if you need it in another environment? No sweat! Syntasa's import and export features come to the rescue. Export your app and import it into any external environment, streamlining your workflow and ensuring consistency across projects.
This article will explain the following topics:
Exporting an App
Before you import an app, it is important to understand how the app can be exported. Let's understand more about the exporting feature. The export feature became available in the 7.2 version. With the export feature, you can download your development or production workflow in a zip file and then import it while creating a new app in any environment.
You can perform the following steps to export an app:
- Launch the app
- Go to the 'Overview' screen
- Click the 'Export' button.
- On clicking the 'Export' button, you will be taken to the 'Export' screen.
- Select the source workflow (Development or Production). (More details on this are shown below)
- Enable the optional toggle "Do you want to export notes"? (More details on this are shown below)
- Click the 'Export' button.
- A zip file containing the exported app will be automatically downloaded to your local machine. This file typically contains the app's configuration and setup in a compressed format.
- After the export and download process is complete, the application will automatically redirect you to the workspace page or another designated landing page within the Syntasa platform.
Source Workflow
This screen lets you choose which workflow (Development or Production) you want to export your app from. "Development" is selected by default. If your app is already deployed in Production, you'll see both "Development" and "Production" options available. If your app hasn't been deployed yet, only "Development" will be selectable.
Exporting Notes
You can also choose to export any notes associated with the workflow. If you enable the toggle 'Do you want to export notes?" The notes specific to the chosen workflow (Development or Production) will be included in the export.
Importing an App
Importing an app from another environment typically involves transferring or integrating functionalities, data, or design elements from one application into another. If you have a zip file of the exported app, then you can import the file into any environment.
You can perform the following steps to import an app.
- Go to the 'Create New App' page.
- Enable the toggle of 'Copy/Import App'.
- Select the option 'Import App'.
- Upload the .zip file from your local machine.
- Once the correct file is uploaded, a green checkmark indicates that the App has been successfully uploaded.
- Select the data store or connections for the app.
- Enter the unique name of the app.
- Click on the 'Save' button.
- After clicking on the Save button, the user will be automatically redirected to the development workflow page, where the app will be ready for data processing.
Let's delve into the importing feature:
- When you upload a zip file, it validates the file and uploads it if everything is correct. If there is an error, it will be displayed under validation.
- By default, the name and key prefix fields will be populated with the app name from the imported zip file. You can always update the app name. If the app name already exists, it will show an error message.
- Every app includes a datastore or connection. Since the imported app contains datastore and connection settings from the previous environment, you need to select a new datastore or connection for the app to function properly.
- Syntasa shows the names of the previously used datastore and connection so that you can see the initial configuration.
- If the imported app includes notes, the user name shown for the notes will be changed to the current app owner's name, as the original user who added the notes might not exist in the new environment.