Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/kdcllc/CometD.NetCore

CometD for use with Salesforce Platform Events
https://github.com/kdcllc/CometD.NetCore

bayeux bayeux-protocol cometd dotnet-core dotnetcore netcore platform-events salesforce salesforce-api salesforce-developers workbench

Last synced: about 2 months ago
JSON representation

CometD for use with Salesforce Platform Events

Awesome Lists containing this project

README

        

# CometD for Salesforce Platform events

[![GitHub license](https://img.shields.io/badge/license-MIT-blue.svg?style=flat-square)](https://raw.githubusercontent.com/kdcllc/cometd-netcore/master/LICENSE)
[![Build status](https://ci.appveyor.com/api/projects/status/6t0kmjpr6ckvhrxe?svg=true)](https://ci.appveyor.com/project/kdcllc/cometd-netcore)
[![NuGet](https://img.shields.io/nuget/v/CometD.NetCore2.svg)](https://www.nuget.org/packages?q=CometD.NetCore2)
![Nuget](https://img.shields.io/nuget/dt/CometD.NetCore2)
[![feedz.io](https://img.shields.io/badge/endpoint.svg?url=https://f.feedz.io/kdcllc/kdcllc/shield/CometD.NetCore2/latest)](https://f.feedz.io/kdcllc/kdcllc/packages/CometD.NetCore2/latest/download)

_Note: Pre-release packages are distributed via [feedz.io](https://f.feedz.io/kdcllc/kcllc/nuget/index.json)._

## Summary

This repo contains the CometD .NET Core implementation of the Java ported code.

- `CometD.NetCore2` - [CometD.org](CometD.org) implementation, supports replay id.
- [CometD.NetCore.Salesforce project](https://github.com/kdcllc/CometD.NetCore.Salesforce) - provides with implementation of this library.

[![buymeacoffee](https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png)](https://www.buymeacoffee.com/vyve0og)

## Give a Star! :star:

If you like or are using this project to learn or start your solution, please give it a star. Thanks!

## Install

```bash
dotnet add package CometD.NetCore2
```

## Projects that utilize this library

- [CometD.NetCore.Salesforce](https://github.com/kdcllc/CometD.NetCore.Salesforce) - contais Saleforce Auth utility and implementation for relay id.
- [Bet.BuildingBlocks.SalesforceEventBus](https://github.com/kdcllc/Bet.BuildingBlocks.SalesforceEventBus) - reusable EvenBus for Salesforce.

## Configure Salesforce Developer instance

[Watch: Salesforce Platform Events - Video](https://www.youtube.com/watch?v=L6OWyCfQD6U)

1. Sing up for development sandbox with Saleforce: [https://developer.salesforce.com/signup](https://developer.salesforce.com/signup).
2. Create Connected App in Salesforce.
3. Create a Platform Event.

### Create Connected App in Salesforce

1. Setup -> Quick Find -> manage -> App Manager -> New Connected App.
2. Basic Info:

![info](./img/new-app-basic-info.jpg)

3. API (Enable OAuth Settings):

![settings](./img/new-app-api-auth.jpg)

4. Retrieve `Consumer Key` and `Consumer Secret` to be used within the Test App

### Create a Platform Event

1. Setup -> Quick Find -> Events -> Platform Events -> New Platform Event:

![event](./img/new-platform-event.jpg)

2. Add Custom Field

![event](./img/new-platform-event-field.jpg)

(note: use sandbox custom domain for the login to workbench in order to install this app within your production)

Use workbench to test the Event [workbench](https://workbench.developerforce.com/login.php?startUrl=%2Finsert.php)

## OAuth Apps

[Use login instead of test](https://github.com/developerforce/Force.com-Toolkit-for-NET/wiki/Web-Server-OAuth-Flow-Sample#am-i-using-the-test-environment)

## Special thanks to our contributors

- [Martin Podlubny](https://github.com/martin-podlubny)
- [jesbacon](https://github.com/jesbacon)
- [Chris Woolum](https://github.com/cwoolum)

## Related projects

- [Oyatel/CometD.NET](https://github.com/Oyatel/CometD.NET)
- [nthachus/CometD.NET](https://github.com/nthachus/CometD.NET)
- [tdawgy/CometD.NetCore](https://github.com/tdawgy/CometD.NetCore)
- [anthonyreilly/NetCoreForce](https://github.com/anthonyreilly/NetCoreForce)
- [eShopOnContainers](https://github.com/dotnet-architecture/eShopOnContainers)