force

package
v0.0.15 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Dec 14, 2023 License: MIT Imports: 14 Imported by: 0

Documentation

Overview

A Go package that provides bindings to the force.com REST API

See http://www.salesforce.com/us/developer/docs/api_rest/

Index

Constants

View Source 
const (
	BaseQueryString = "SELECT %v FROM %v"
)

Variables

This section is empty.

Functions

func BuildQuery 

func BuildQuery(fields, table string, constraints []string) string

Types

type ApiError 

type ApiError struct {
	Fields           []string `json:"fields,omitempty" force:"fields,omitempty"`
	Message          string   `json:"message,omitempty" force:"message,omitempty"`
	ErrorCode        string   `json:"errorCode,omitempty" force:"errorCode,omitempty"`
	ErrorName        string   `json:"error,omitempty" force:"error,omitempty"`
	ErrorDescription string   `json:"error_description,omitempty" force:"error_description,omitempty"`
}

func (ApiError) Error 

func (e ApiError) Error() string

func (ApiError) String 

func (e ApiError) String() string

func (ApiError) Validate 

func (e ApiError) Validate() bool

type ApiErrors 

type ApiErrors []*ApiError

Custom Error to handle salesforce api responses.

func (ApiErrors) Error 

func (e ApiErrors) Error() string

func (ApiErrors) String 

func (e ApiErrors) String() string

func (ApiErrors) Validate 

func (e ApiErrors) Validate() bool

type ChildRelationship 

type ChildRelationship struct {
	Field               string `json:"field"`
	ChildSObject        string `json:"childSObject"`
	DeprecatedAndHidden bool   `json:"deprecatedAndHidden"`
	CascadeDelete       bool   `json:"cascadeDelete"`
	RestrictedDelete    bool   `json:"restrictedDelete"`
	RelationshipName    string `json:"relationshipName"`
}

type CompositeRequest added in v0.0.11 

type CompositeRequest struct {
	SubRequests []CompositeSubRequest `json:"compositeRequest"`
}

type CompositeResponse added in v0.0.11 

type CompositeResponse struct {
	Response []Subvalue `json:"compositeResponse"`
}

type CompositeSubRequest added in v0.0.11 

type CompositeSubRequest struct {
	Method       string          `json:"method"`
	Url          string          `json:"url"`
	ReferencedID string          `json:"referenceId"`
	HttpHeaders  http.Header     `json:"httpHeaders,omitempty"`
	Body         json.RawMessage `json:"body,omitempty"`
}

type ForceApi 

type ForceApi struct {
	InstanceURL string
	// contains filtered or unexported fields
}

func Create 

func Create(ctx context.Context, config *jwt.Config, version, instanceURL string) (*ForceApi, error)

func (*ForceApi) Delete 

func (forceApi *ForceApi) Delete(ctx context.Context, path string, params url.Values) error

Delete issues a DELETE to the specified path with the given payload

func (*ForceApi) DeleteSObject 

func (forceApi *ForceApi) DeleteSObject(ctx context.Context, id string, in SObject) (err error)

func (*ForceApi) DeleteSObjectByExternalId 

func (forceApi *ForceApi) DeleteSObjectByExternalId(ctx context.Context, id string, in SObject) (err error)

func (*ForceApi) DescribeSObject 

func (forceApi *ForceApi) DescribeSObject(ctx context.Context, in SObject) (resp *SObjectDescription, err error)

func (*ForceApi) DescribeSObjects 

func (forceAPI *ForceApi) DescribeSObjects(ctx context.Context) (map[string]*SObjectMetaData, error)

func (*ForceApi) Get 

func (forceApi *ForceApi) Get(ctx context.Context, path string, params url.Values, out interface{}) error

Get issues a GET to the specified path with the given params and put the umarshalled (json) result in the third parameter

func (*ForceApi) GetLimits 

func (forceApi *ForceApi) GetLimits(ctx context.Context) (limits *Limits, err error)

func (*ForceApi) GetSObject 

func (forceApi *ForceApi) GetSObject(ctx context.Context, id string, fields []string, out SObject) (err error)

func (*ForceApi) GetSObjectByExternalId 

func (forceApi *ForceApi) GetSObjectByExternalId(ctx context.Context, id string, fields []string, out SObject) (err error)

func (*ForceApi) InsertSObject 

func (forceApi *ForceApi) InsertSObject(ctx context.Context, in SObject) (resp *SObjectResponse, err error)

func (*ForceApi) Patch 

func (forceApi *ForceApi) Patch(ctx context.Context, path string, params url.Values, payload, out interface{}) error

Patch issues a PATCH to the specified path with the given params and payload and put the unmarshalled (json) result in the third parameter

func (*ForceApi) Post 

func (forceApi *ForceApi) Post(ctx context.Context, path string, params url.Values, payload, out interface{}) error

Post issues a POST to the specified path with the given params and payload and put the unmarshalled (json) result in the third parameter

func (*ForceApi) Put 

func (forceApi *ForceApi) Put(ctx context.Context, path string, params url.Values, payload, out interface{}) error

Put issues a PUT to the specified path with the given params and payload and put the unmarshalled (json) result in the third parameter

func (*ForceApi) Query 

func (forceApi *ForceApi) Query(ctx context.Context, query string, out interface{}) (err error)

Use the Query resource to execute a SOQL query that returns all the results in a single response, or if needed, returns part of the results and an identifier used to retrieve the remaining results.

func (*ForceApi) QueryAll 

func (forceApi *ForceApi) QueryAll(ctx context.Context, query string, out interface{}) (err error)

Use the QueryAll resource to execute a SOQL query that includes information about records that have been deleted because of a merge or delete. Use QueryAll rather than Query, because the Query resource will automatically filter out items that have been deleted.

func (*ForceApi) QueryNext 

func (forceApi *ForceApi) QueryNext(ctx context.Context, uri string, out interface{}) (err error)

func (*ForceApi) SetClient added in v0.0.2 

func (f *ForceApi) SetClient(client *http.Client)

func (*ForceApi) SetDisableForceAutoAssign 

func (forceApi *ForceApi) SetDisableForceAutoAssign(value bool)

func (*ForceApi) TraceOff 

func (forceApi *ForceApi) TraceOff()

TraceOff turns off tracing. It is idempotent.

func (*ForceApi) TraceOn 

func (forceApi *ForceApi) TraceOn(prefix string, logger ForceApiLogger)

TraceOn turns on logging for this ForceApi. After this is called, all requests, responses, and raw response bodies will be sent to the logger. If prefix is a non-empty string, it will be written to the front of all logged strings, which can aid in filtering log lines.

Use TraceOn if you want to spy on the ForceApi requests and responses.

Note that the base log.Logger type satisfies ForceApiLogger, but adapters can easily be written for other logging packages (e.g., the golang-sanctioned glog framework).

func (*ForceApi) UpdateSObject 

func (forceApi *ForceApi) UpdateSObject(ctx context.Context, id string, in SObject) (err error)

func (*ForceApi) UpsertSObjectByExternalId 

func (forceApi *ForceApi) UpsertSObjectByExternalId(ctx context.Context, id string, in SObject) (resp *SObjectResponse, err error)

type ForceApiLogger 

type ForceApiLogger interface {
	Printf(format string, v ...interface{})
}

type Limit 

type Limit struct {
	Remaining float64
	Max       float64
}

type Limits 

type Limits map[string]Limit

type PicklistValue 

type PicklistValue struct {
	Value       string `json:"value"`
	DefaulValue bool   `json:"defaultValue"`
	ValidFor    string `json:"validFor"`
	Active      bool   `json:"active"`
	Label       string `json:"label"`
}

type RecordTypeInfo 

type RecordTypeInfo struct {
	Name                     string            `json:"name"`
	Available                bool              `json:"available"`
	RecordTypeId             string            `json:"recordTypeId"`
	URLs                     map[string]string `json:"urls"`
	DefaultRecordTypeMapping bool              `json:"defaultRecordTypeMapping"`
}

type SObject 

type SObject interface {
	ApiName() string
	ExternalIdApiName() string
}

Interface all standard and custom objects must implement. Needed for uri generation.

type SObjectApiResponse 

type SObjectApiResponse struct {
	Encoding     string             `json:"encoding"`
	MaxBatchSize int64              `json:"maxBatchSize"`
	SObjects     []*SObjectMetaData `json:"sobjects"`
}

type SObjectDescription 

type SObjectDescription struct {
	Name                string               `json:"name"`
	Fields              []*SObjectField      `json:"fields"`
	KeyPrefix           string               `json:"keyPrefix"`
	Layoutable          bool                 `json:"layoutable"`
	Activateable        bool                 `json:"activateable"`
	LabelPlural         string               `json:"labelPlural"`
	Custom              bool                 `json:"custom"`
	CompactLayoutable   bool                 `json:"compactLayoutable"`
	Label               string               `json:"label"`
	Searchable          bool                 `json:"searchable"`
	URLs                map[string]string    `json:"urls"`
	Queryable           bool                 `json:"queryable"`
	Deletable           bool                 `json:"deletable"`
	Updateable          bool                 `json:"updateable"`
	Createable          bool                 `json:"createable"`
	CustomSetting       bool                 `json:"customSetting"`
	Undeletable         bool                 `json:"undeletable"`
	Mergeable           bool                 `json:"mergeable"`
	Replicateable       bool                 `json:"replicateable"`
	Triggerable         bool                 `json:"triggerable"`
	FeedEnabled         bool                 `json:"feedEnabled"`
	Retrievable         bool                 `json:"retrieveable"`
	SearchLayoutable    bool                 `json:"searchLayoutable"`
	LookupLayoutable    bool                 `json:"lookupLayoutable"`
	Listviewable        bool                 `json:"listviewable"`
	DeprecatedAndHidden bool                 `json:"deprecatedAndHidden"`
	RecordTypeInfos     []*RecordTypeInfo    `json:"recordTypeInfos"`
	ChildRelationsips   []*ChildRelationship `json:"childRelationships"`

	AllFields string `json:"-"` // Not from force.com API. Used to generate SELECT * queries.
}

type SObjectField 

type SObjectField struct {
	Length                   float64          `json:"length"`
	Name                     string           `json:"name"`
	Type                     string           `json:"type"`
	DefaultValue             string           `json:"defaultValue"`
	RestrictedPicklist       bool             `json:"restrictedPicklist"`
	NameField                bool             `json:"nameField"`
	ByteLength               float64          `json:"byteLength"`
	Precision                float64          `json:"precision"`
	Filterable               bool             `json:"filterable"`
	Sortable                 bool             `json:"sortable"`
	Unique                   bool             `json:"unique"`
	CaseSensitive            bool             `json:"caseSensitive"`
	Calculated               bool             `json:"calculated"`
	Scale                    float64          `json:"scale"`
	Label                    string           `json:"label"`
	NamePointing             bool             `json:"namePointing"`
	Custom                   bool             `json:"custom"`
	HtmlFormatted            bool             `json:"htmlFormatted"`
	DependentPicklist        bool             `json:"dependentPicklist"`
	Permissionable           bool             `json:"permissionable"`
	ReferenceTo              []string         `json:"referenceTo"`
	RelationshipOrder        float64          `json:"relationshipOrder"`
	SoapType                 string           `json:"soapType"`
	CalculatedValueFormula   string           `json:"calculatedValueFormula"`
	DefaultValueFormula      string           `json:"defaultValueFormula"`
	DefaultedOnCreate        bool             `json:"defaultedOnCreate"`
	Digits                   float64          `json:"digits"`
	Groupable                bool             `json:"groupable"`
	Nillable                 bool             `json:"nillable"`
	InlineHelpText           string           `json:"inlineHelpText"`
	WriteRequiresMasterRead  bool             `json:"writeRequiresMasterRead"`
	PicklistValues           []*PicklistValue `json:"picklistValues"`
	Updateable               bool             `json:"updateable"`
	Createable               bool             `json:"createable"`
	DeprecatedAndHidden      bool             `json:"deprecatedAndHidden"`
	DisplayLocationInDecimal bool             `json:"displayLocationInDecimal"`
	CascadeDelete            bool             `json:"cascasdeDelete"`
	RestrictedDelete         bool             `json:"restrictedDelete"`
	ControllerName           string           `json:"controllerName"`
	ExternalId               bool             `json:"externalId"`
	IdLookup                 bool             `json:"idLookup"`
	AutoNumber               bool             `json:"autoNumber"`
	RelationshipName         string           `json:"relationshipName"`
}

type SObjectMetaData 

type SObjectMetaData struct {
	Name                string            `json:"name"`
	Label               string            `json:"label"`
	KeyPrefix           string            `json:"keyPrefix"`
	LabelPlural         string            `json:"labelPlural"`
	Custom              bool              `json:"custom"`
	Layoutable          bool              `json:"layoutable"`
	Activateable        bool              `json:"activateable"`
	URLs                map[string]string `json:"urls"`
	Searchable          bool              `json:"searchable"`
	Updateable          bool              `json:"updateable"`
	Createable          bool              `json:"createable"`
	DeprecatedAndHidden bool              `json:"deprecatedAndHidden"`
	CustomSetting       bool              `json:"customSetting"`
	Deletable           bool              `json:"deletable"`
	FeedEnabled         bool              `json:"feedEnabled"`
	Mergeable           bool              `json:"mergeable"`
	Queryable           bool              `json:"queryable"`
	Replicateable       bool              `json:"replicateable"`
	Retrieveable        bool              `json:"retrieveable"`
	Undeletable         bool              `json:"undeletable"`
	Triggerable         bool              `json:"triggerable"`
}

type SObjectResponse 

type SObjectResponse struct {
	Id      string    `force:"id,omitempty"`
	Errors  ApiErrors `force:"error,omitempty"` //TODO: Not sure if ApiErrors is the right object
	Success bool      `force:"success,omitempty"`
}

Response received from force.com API after insert of an sobject.

type Subvalue added in v0.0.11 

type Subvalue struct {
	Body           json.RawMessage   `json:"body"`
	HTTPHeaders    map[string]string `json:"httpHeaders"`
	HTTPStatusCode int               `json:"httpStatusCode"`
	ReferenceID    string            `json:"referenceId"`
}

Subvalue is the subresponses to the composite API. Using the referende id, one will be able to match the response with the request.

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.