diff --git a/content/en/Integrations/IntegrationBuilder/How to Guides/_index.md b/content/en/Integrations/IntegrationBuilder/How to Guides/_index.md index cd215ee0d..cbc2dc3a8 100644 --- a/content/en/Integrations/IntegrationBuilder/How to Guides/_index.md +++ b/content/en/Integrations/IntegrationBuilder/How to Guides/_index.md @@ -6,13 +6,14 @@ weight: 30 ## Application Specific Guides -| Application | Use Case | Guide Link | -|-------------------|---------------------------------|---------------------------------------| -| Jira Cloud | Create tickets for findings | [Click Here](./jira-cloud-migration) | -| GitHub | Create tickets for findings | [Click Here](./github) | -| GitLab | Create tickets for findings | [Click Here](./gitlab) | -| Microsoft Teams | Send notifications for findings | [Click Here](./microsoft-teams) | -| Microsoft Outlook | Send notifications for findings | [Click Here](./outlook-notifications) | +| Application | Use Case | Guide Link | +|-------------------|---------------------------------|--------------------------------------------------| +| Jira Cloud | Create tickets for findings | [Click Here](./jira-cloud-migration) | +| GitHub | Create tickets for findings | [Click Here](./github) | +| GitLab | Create tickets for findings | [Click Here](./gitlab) | +| Microsoft Teams | Send notifications for findings | [Click Here](./microsoft-teams) | +| Microsoft Outlook | Send notifications for findings | [Click Here](./outlook-notifications) | +| Google Sheets | Import assets | [Click Here](./import-assets-from-google-sheets) | ## Trigger filters diff --git a/content/en/Integrations/IntegrationBuilder/How to Guides/import-assets-from-google-sheets.md b/content/en/Integrations/IntegrationBuilder/How to Guides/import-assets-from-google-sheets.md new file mode 100644 index 000000000..9695fd410 --- /dev/null +++ b/content/en/Integrations/IntegrationBuilder/How to Guides/import-assets-from-google-sheets.md @@ -0,0 +1,127 @@ +--- +title: "Import Assets from Google Sheets" +linkTitle: "Import Assets from Google Sheets" +weight: 60 +--- + +{{% pageinfo %}} +How to use Integration Builder to import assets from Google Sheets. +{{% /pageinfo %}} + +## Import assets from Google Sheets + +To import assets from Google Sheets, follow these five general steps: + +1. Create a Spreadsheet in Google Sheets. +2. Create a Google Sheets Connection. +3. Find and Select the Recipe. +4. Copy and Customize the Recipe. +5. Start the Recipe. + +The following is a step-by-step guide to walk you through the configuration process. + +### 1. Create a Spreadsheet in Google Sheets + +To import assets from Google Sheets into the Cobalt platform, first create a spreadsheet with the following columns: `Title`, `Type`, `Description`. +`Title` and `Description` can be anything, but `Type` needs to be one of the following: +- `unknown` +- `web` +- `mobile` +- `external_network` +- `api` +- `cloud_config` +- `desktop_obsolete` +- `internal_network` +- `web_plus_api` +- `web_plus_external_network` +- `web_plus_mobile` +- `wireless_network` +- `iot` +- `desktop` +- `physical` +- `other` +- `web_plus_api_plus_external_network` +- `internal_network_plus_external_network` +- `mobile_plus_api` +- `web_plus_mobile_plus_api` + +Here's an example of what that could look like: +{{% image src="/integrations/integration_builder/how_to_guides/import-assets-from-google-sheets/spreadsheet-example.png" alt="Example spreadsheet" %}} + +Once ready, give the file a name (optionally, the specific sheet as well) and save it. + +### 2. Create a Google Sheets Connection + +The following is a quick guide on how to create a Workato connection for Google Sheets. +If you're looking for a more comprehensive and general guide on how to manage connections, check [here](/integrations/integrationbuilder/connect-your-applications/). + +Go to the `Integration Builder` > `Projects`. Select or create a project on the left side of the page. Then click on the "Create" button on the top-right and choose the "Connection" option. + +{{% image src="/integrations/integration_builder/how_to_guides/import-assets-from-google-sheets/00-create-connection.png" alt="Create a connection for your project" %}} + +A "New Connection" page will appear. Look for "Google Sheets" and select the corresponding tile. You can optionally use the search field to quickly find the connection. + +{{% image src="/integrations/integration_builder/how_to_guides/import-assets-from-google-sheets/01-select-connection-type.png" alt="Select connection type" %}} + +After selecting the connection type, a form will appear. Provide a name, select a location (we recommend `Cobalt` > `Connections`), and click on "Sign in with Google". + +{{% image src="/integrations/integration_builder/how_to_guides/import-assets-from-google-sheets/02-create-connection-form.png" alt="Create connection form" %}} + +Once signed in with Google, you should get a confirmation that the connection was successfully created. + +{{% image src="/integrations/integration_builder/how_to_guides/import-assets-from-google-sheets/03-connection-created.png" alt="Connection Created" %}} + +### 3. Find and Select the Recipe + +Go to the `Integration Builder` > `Library` and search for Google Sheets. + +{{% image src="/integrations/integration_builder/how_to_guides/import-assets-from-google-sheets/1-find-recipes.png" alt="Google Sheets tile" %}} + +Select the "[Cobalt > Google Sheets] Import assets from Google Sheets" recipe. + +{{% image src="/integrations/integration_builder/how_to_guides/import-assets-from-google-sheets/2-select-import-recipe.png" alt="Google Sheets tile" %}} + +### 4. Copy and Customize the Recipe + +Click on "Use this recipe". + +{{% image src="/integrations/integration_builder/how_to_guides/import-assets-from-google-sheets/3-click-use-recipe.png" alt="Use Recipe" %}} + +You will be prompted to copy the recipe. Choose a preferred location and click "Copy and save". + +{{% image src="/integrations/integration_builder/how_to_guides/import-assets-from-google-sheets/4-select-project.png" alt="Copy Google Sheets recipe" %}} + +There will be a prompt with a "Test recipe" button. Instead of testing, you will want to edit the recipe in order to set the Google Sheets connection. Click on "or edit your recipe before testing" below the button. + +{{% image src="/integrations/integration_builder/how_to_guides/import-assets-from-google-sheets/5-edit-recipe.png" alt="Edit recipe" %}} + +Select the first action from the flow chart (the one that gets the rows from Google Sheets). In the emerging sidebar on the right, select "Connection" at the top and then choose the connection created in [step 2 of this guide](#2-create-a-google-sheets-connection). + +{{% image src="/integrations/integration_builder/how_to_guides/import-assets-from-google-sheets/6-edit-connection-on-recipe.png" alt="Choose connection" %}} + +You will get a setup form in which you have to select the Google Drive where the spreadsheet created in [step 1](#1-create-a-spreadsheet-in-google-sheets) is stored. After that you can select the specific Spreadsheet and the Sheet (in case you renamed it). + +{{% image src="/integrations/integration_builder/how_to_guides/import-assets-from-google-sheets/7-configure-sheet-in-recipe.png" alt="Setup connection" %}} + +At this point, the configuration is ready. In the top-right corner, click on "Save" followed by "Exit". + +{{% image src="/integrations/integration_builder/how_to_guides/import-assets-from-google-sheets/8-save-and-exit.png" alt="Save and Exit" %}} + +### 5. Start the Recipe + +This recipe is a function call, which means it can be integrated and called within another recipe. However, since we want to trigger it directly, we have to use a test environment. +Click on the caret on the right of the "Start recipe" button, then on the "Test recipe" button. + +{{% image src="/integrations/integration_builder/how_to_guides/import-assets-from-google-sheets/9-test-recipe.png" alt="Test recipe" %}} + +Within the prompt, click "Test recipe" in the bottom right. + +{{% image src="/integrations/integration_builder/how_to_guides/import-assets-from-google-sheets/10-trigger-recipe.png" alt="Trigger the recipe" %}} + +You will see the "Jobs" tab confirming the successful execution of the test. + +{{% image src="/integrations/integration_builder/how_to_guides/import-assets-from-google-sheets/11-finished-run.png" alt="Jobs tab" %}} + +Finally, you can head over to the Cobalt platform and check the Assets page of your org. It should show the newly created assets. + +{{% image src="/integrations/integration_builder/how_to_guides/import-assets-from-google-sheets/asset-list.png" alt="Check result" %}} \ No newline at end of file diff --git a/static/integrations/integration_builder/how_to_guides/import-assets-from-google-sheets/00-create-connection.png b/static/integrations/integration_builder/how_to_guides/import-assets-from-google-sheets/00-create-connection.png new file mode 100644 index 000000000..01b9a4f6f Binary files /dev/null and b/static/integrations/integration_builder/how_to_guides/import-assets-from-google-sheets/00-create-connection.png differ diff --git a/static/integrations/integration_builder/how_to_guides/import-assets-from-google-sheets/01-select-connection-type.png b/static/integrations/integration_builder/how_to_guides/import-assets-from-google-sheets/01-select-connection-type.png new file mode 100644 index 000000000..9a47b0f4a Binary files /dev/null and b/static/integrations/integration_builder/how_to_guides/import-assets-from-google-sheets/01-select-connection-type.png differ diff --git a/static/integrations/integration_builder/how_to_guides/import-assets-from-google-sheets/02-create-connection-form.png b/static/integrations/integration_builder/how_to_guides/import-assets-from-google-sheets/02-create-connection-form.png new file mode 100644 index 000000000..65de103ec Binary files /dev/null and b/static/integrations/integration_builder/how_to_guides/import-assets-from-google-sheets/02-create-connection-form.png differ diff --git a/static/integrations/integration_builder/how_to_guides/import-assets-from-google-sheets/03-connection-created.png b/static/integrations/integration_builder/how_to_guides/import-assets-from-google-sheets/03-connection-created.png new file mode 100644 index 000000000..8b070e3b3 Binary files /dev/null and b/static/integrations/integration_builder/how_to_guides/import-assets-from-google-sheets/03-connection-created.png differ diff --git a/static/integrations/integration_builder/how_to_guides/import-assets-from-google-sheets/1-find-recipes.png b/static/integrations/integration_builder/how_to_guides/import-assets-from-google-sheets/1-find-recipes.png new file mode 100644 index 000000000..108ef9a2d Binary files /dev/null and b/static/integrations/integration_builder/how_to_guides/import-assets-from-google-sheets/1-find-recipes.png differ diff --git a/static/integrations/integration_builder/how_to_guides/import-assets-from-google-sheets/10-trigger-recipe.png b/static/integrations/integration_builder/how_to_guides/import-assets-from-google-sheets/10-trigger-recipe.png new file mode 100644 index 000000000..57e73757d Binary files /dev/null and b/static/integrations/integration_builder/how_to_guides/import-assets-from-google-sheets/10-trigger-recipe.png differ diff --git a/static/integrations/integration_builder/how_to_guides/import-assets-from-google-sheets/11-finished-run.png b/static/integrations/integration_builder/how_to_guides/import-assets-from-google-sheets/11-finished-run.png new file mode 100644 index 000000000..5b9ea4782 Binary files /dev/null and b/static/integrations/integration_builder/how_to_guides/import-assets-from-google-sheets/11-finished-run.png differ diff --git a/static/integrations/integration_builder/how_to_guides/import-assets-from-google-sheets/2-select-import-recipe.png b/static/integrations/integration_builder/how_to_guides/import-assets-from-google-sheets/2-select-import-recipe.png new file mode 100644 index 000000000..98d2662b1 Binary files /dev/null and b/static/integrations/integration_builder/how_to_guides/import-assets-from-google-sheets/2-select-import-recipe.png differ diff --git a/static/integrations/integration_builder/how_to_guides/import-assets-from-google-sheets/3-click-use-recipe.png b/static/integrations/integration_builder/how_to_guides/import-assets-from-google-sheets/3-click-use-recipe.png new file mode 100644 index 000000000..f6b5d6b0a Binary files /dev/null and b/static/integrations/integration_builder/how_to_guides/import-assets-from-google-sheets/3-click-use-recipe.png differ diff --git a/static/integrations/integration_builder/how_to_guides/import-assets-from-google-sheets/4-select-project.png b/static/integrations/integration_builder/how_to_guides/import-assets-from-google-sheets/4-select-project.png new file mode 100644 index 000000000..fcdfa3dc3 Binary files /dev/null and b/static/integrations/integration_builder/how_to_guides/import-assets-from-google-sheets/4-select-project.png differ diff --git a/static/integrations/integration_builder/how_to_guides/import-assets-from-google-sheets/5-edit-recipe.png b/static/integrations/integration_builder/how_to_guides/import-assets-from-google-sheets/5-edit-recipe.png new file mode 100644 index 000000000..85d26ae5e Binary files /dev/null and b/static/integrations/integration_builder/how_to_guides/import-assets-from-google-sheets/5-edit-recipe.png differ diff --git a/static/integrations/integration_builder/how_to_guides/import-assets-from-google-sheets/6-edit-connection-on-recipe.png b/static/integrations/integration_builder/how_to_guides/import-assets-from-google-sheets/6-edit-connection-on-recipe.png new file mode 100644 index 000000000..c64c25f13 Binary files /dev/null and b/static/integrations/integration_builder/how_to_guides/import-assets-from-google-sheets/6-edit-connection-on-recipe.png differ diff --git a/static/integrations/integration_builder/how_to_guides/import-assets-from-google-sheets/7-configure-sheet-in-recipe.png b/static/integrations/integration_builder/how_to_guides/import-assets-from-google-sheets/7-configure-sheet-in-recipe.png new file mode 100644 index 000000000..1e07ef874 Binary files /dev/null and b/static/integrations/integration_builder/how_to_guides/import-assets-from-google-sheets/7-configure-sheet-in-recipe.png differ diff --git a/static/integrations/integration_builder/how_to_guides/import-assets-from-google-sheets/8-save-and-exit.png b/static/integrations/integration_builder/how_to_guides/import-assets-from-google-sheets/8-save-and-exit.png new file mode 100644 index 000000000..7148bd38c Binary files /dev/null and b/static/integrations/integration_builder/how_to_guides/import-assets-from-google-sheets/8-save-and-exit.png differ diff --git a/static/integrations/integration_builder/how_to_guides/import-assets-from-google-sheets/9-test-recipe.png b/static/integrations/integration_builder/how_to_guides/import-assets-from-google-sheets/9-test-recipe.png new file mode 100644 index 000000000..dbc6815fd Binary files /dev/null and b/static/integrations/integration_builder/how_to_guides/import-assets-from-google-sheets/9-test-recipe.png differ diff --git a/static/integrations/integration_builder/how_to_guides/import-assets-from-google-sheets/asset-list.png b/static/integrations/integration_builder/how_to_guides/import-assets-from-google-sheets/asset-list.png new file mode 100644 index 000000000..4e04c175f Binary files /dev/null and b/static/integrations/integration_builder/how_to_guides/import-assets-from-google-sheets/asset-list.png differ diff --git a/static/integrations/integration_builder/how_to_guides/import-assets-from-google-sheets/spreadsheet-example.png b/static/integrations/integration_builder/how_to_guides/import-assets-from-google-sheets/spreadsheet-example.png new file mode 100644 index 000000000..990cd9e14 Binary files /dev/null and b/static/integrations/integration_builder/how_to_guides/import-assets-from-google-sheets/spreadsheet-example.png differ