Help

Help

Getting Started with KatManDo

Quick setup guide to get you started with KatManDo, the powerful Google Sheets Add-On for Salesforce data management.

📌 Installing the Add-On

Follow these steps to install KatManDo:

  • Open Google Sheets from your Google Workspace.
  • Navigate to Extensions → Add-ons → Get add-ons.
  • Search for KatManDo and click Install.
  • Accept permissions and complete the installation.
  • KatManDo will now be visible under Extensions in your toolbar.

🚀 Starting KatManDo

To begin using KatManDo after installation:

  • Go to Extensions → KatManDo → Start.
  • A Task Pane will appear on the right side of your sheet.
  • Initially, only the Login to Salesforce button is available for secure connection.

🔒 Authenticating with Salesforce

Connect securely to your Salesforce organization:

  • Click Login to Salesforce in the Task Pane.
  • Authenticate with your Salesforce credentials and allow access.
  • On success, the Task Pane will display more options:

Available Options After Login

  • Export from Salesforce → Fetch data from Salesforce directly into your Google Sheet.
  • Import into Salesforce → Upload data from your Google Sheet into Salesforce.
  • Logout → Disconnect your current Salesforce session.
  • Go to Org → Opens your connected Salesforce Org in a new browser tab for easy navigation.

📤 Export from Salesforce

Retrieve data from Salesforce into your Google Sheet:

Export Steps

  • Select the Salesforce Object you want to export (e.g., Product, Account).
  • Choose the Fields you want to retrieve.
  • Optionally set a Limit for the number of records.
  • Advanced users can access the Query Editor for SOQL queries.
  • Click Export to fetch data directly into Google Sheets.

📥 Import into Salesforce

Send data from your Google Sheet to Salesforce:

Import Steps

  • Prepare your Google Sheet with headers representing Salesforce fields.
  • Select the Object in the Task Pane.
  • Map your column headers to Salesforce fields.
  • Click Import to send data to Salesforce.
  • Successful imports will display a confirmation message.

Managing Sessions

Efficiently manage your KatManDo sessions:

  • Logout → Instantly disconnect from Salesforce.
  • Go to Org → Opens the connected Salesforce Org in a new tab.
  • Export from Salesforce → Retrieve data from Salesforce objects.
  • Import into Salesforce → Upload data to Salesforce objects.

🌐 Need Help?

Get support for KatManDo:

  • Check our documentation for detailed instructions.
  • Visit community forums for best practices.
  • Contact our support team for assistance.

Contact Support

support@katmando.com

Now you're ready to efficiently manage your Salesforce Product Catalog directly from Google Sheets using KatManDo! 🚀✨

""

Post-Install Tips for KatManDo

Congratulations on installing KatManDo! Here are some important tips and best practices to ensure you get the most out of your integration between Google Sheets and Salesforce.

🔄 Reconnect After Installation

If you installed KatManDo for the first time or performed an update, make sure to:

  1. Open Google Sheets.
  2. Navigate to Extensions → KatManDo → Start.
  3. Click Login to Salesforce to authenticate your Salesforce session.
  4. Ensure that the Task Pane refreshes to show all available options:
  • Export from Salesforce → Fetch data from Salesforce directly into your Google Sheet.
  • Import into Salesforce → Upload data from your Google Sheet into Salesforce.
  • Logout → Disconnect your current Salesforce session.
  • Go to Org → Opens your connected Salesforce Org in a new browser tab for easy navigation.

📌 Check Permissions

KatManDo requires specific permissions to function properly. Ensure these are accepted during installation for a smooth experience.

Non-Sensitive Scopes (No Additional Approval Needed)

API Scope User-facing Description
.../auth/spreadsheets.currentonly View and manage spreadsheets that this application has been installed in
.../auth/userinfo.email See your primary Google Account email address

Sensitive Scopes (Approval Required)

API Scope User-facing Description
.../auth/script.external_request Connect to an external service
.../auth/script.container.ui Display and run third-party web content in prompts and sidebars inside Google applications

Why Are These Permissions Needed?

  • Spreadsheet Access → To read from and write to your Google Sheets.
  • Email Access → To link your Google Account to your Salesforce Org.
  • External Service Connection → To authenticate and sync data between Google Sheets and Salesforce.
  • Container UI Access → To display the KatManDo Task Pane and interact with UI elements seamlessly.

🚀 Customize Your Experience

KatManDo allows for various customizations to improve your workflow:

  1. Navigate to Settings → Customize KatManDo within the Task Pane to set:
  • Default Export Limits → Control the number of records fetched during export.
  • Field Mappings → Save frequently used mappings for quicker imports.
  • Theme Options → Switch between light and dark modes for better visibility.
  1. You can also:
  • Save Query Editor Configurations → Reuse complex SOQL queries for future exports.
  • Auto-map Fields → KatManDo can auto-map Google Sheet headers to Salesforce fields when importing.

🔒 Managing Sessions

To keep your data secure and sessions organized:

  • Logout → Instantly disconnects your Salesforce session. You will need to log in again for access.
  • Go to Org → Click to open your connected Salesforce Org in a new browser tab for quick navigation.
  • Session Timeout → If your session times out, simply click Login to Salesforce again to re-authenticate.

📤 Post Install Actions

1. Data Validation

  • After the first install, perform a quick Export to ensure connection with Salesforce is working.
  • Verify the data in Google Sheets matches what you see in Salesforce.

2. Sandbox vs Production

  • Ensure you are logged into the correct Salesforce environment (Sandbox or Production).
  • You can verify this in the Task Pane header where your Org Name is displayed.

3. Field Mappings

  • Perform a test import with sample data to verify field mappings are correctly set.

🛠️ Troubleshooting Common Issues

1. Authentication Issues:

If you face problems during login, try:

  • Clearing your browser cache.
  • 🌐 Need Help?

    Visit the KatManDo Support Page or contact us directly for:

    • Step-by-step video tutorials.
    • Community forums for best practices.
    • FAQs and troubleshooting guides.

    Contact Support

    support@katmando.io

    Now you're fully set to use KatManDo like a pro. Manage your Salesforce data directly from Google Sheets, faster and easier than ever! 🚀✨