Skip to main content

Get data from Salesforce reports with python

Project description

# Salesforce Reporting
Get data straight from your Salesforce reports via python using the Analytics API.

## Install

pip install salesforce-reporting

## Examples

### Authentication
Connect to the Salesforce Analytics API and request data from a report.
```python
import salesforce_reporting

my_sf = salesforce_reporting.Connection('your_id', 'your_secret', 'your_username',
'your_password', 'your_instance')
my_sf.get_report('report_id', includeDetails=True)
```

### Get records from report
Use the ReportParser to access all the records included in a report.
```python
report = my_sf.get_report('report_id', includeDetails=True)
parser = salesforce_reporting.ReportParser(report)

parser.records()
```

### Extract series from matrix report
Easily return a specified series from a Matrix Report.

![Alt text](examples/matrix_report.jpg)

For this report doing this:
```python
report = my_sf.get_report('report_id')
matrix_parser = salesforce_reporting.MatrixParser(report)

matrix_parser.series_down('May 2012')
```
Returns:
```python
{'Prospecting': 14000, 'Needs Analysis': 18000, 'Qualification': 0,
'Proposal/Price Quote': 20000, 'Negotiation/Review': 2000}
```

## Coming Soon
- Simplified Authentication process
- Access to Dashboards

## Author & License
MIT License. Created by Chris Hall.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

salesforce-reporting-0.1.1.tar.gz (5.3 kB view hashes)

Uploaded Source

Built Distribution

salesforce_reporting-0.1.1-py2.py3-none-any.whl (5.5 kB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page