tableapi

package
v1.5.0 Latest Latest
Warning

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

 Go to latest Published: Mar 2, 2024 License: MIT Imports: 9 Imported by: 0

README

Table API

The Table API provides endpoints that allow you to perform create, read, update, and delete (CRUD) operations on existing tables.

[DELETE] /now/table/{tableName}/{sys_id}

Deletes the specified record from the specified table.

package main

import (
    tableapi "github.com/michaeldcanady/servicenow-sdk-go/table-api"
)

func main() {
    
    //Implement credential and client.
    pathParameters := {
        "baseurl":"https://www.{instance}.service-now.com/api/now",
        "table": "incident",
        "sysId": "INC00000000",
    }

    // Instantiate new TableItemRequestBuilder.
    requestBuilder := tableapi.NewTableItemRequestBuilder(client, pathParameters)

    // Call the delete method, with or without TableItemRequestBuilderDeleteQueryParameters.
    err := requestBuilder.Delete(nil)

    // Since there is no record, the delete method only returns an error.
    if err != nil {
        panic(err)
    }
}

[GET] /now/table/{tableName}

Retrieves multiple records for the specified table.

package main

import (
    tableapi "github.com/michaeldcanady/servicenow-sdk-go/table-api"
)

func main() {
    
    //Implement credential and client.
    pathParameters := {
        "baseurl":"https://www.{instance}.service-now.com/api/now",
        "table": "incident",
    }

    // Instantiate new TableItemRequestBuilder.
    requestBuilder := tableapi.NewTableRequestBuilder(client, pathParameters)

    // Call the get method, with or without TableRequestBuilderGetQueryParameters.
    // Response is a TableCollectionResponse.
    response, err := requestBuilder.Get(nil)

    // Test err, should be nil
    if err != nil {
        panic(err)
    }
}

[GET] /now/table/{tableName}/{sys_id}

Retrieves the record identified by the specified sys_id from the specified table.

package main

import (
    tableapi "github.com/michaeldcanady/servicenow-sdk-go/table-api"
)

func main() {
    
    //Implement credential and client.
    pathParameters := {
        "baseurl":"https://www.{instance}.service-now.com/api/now",
        "table": "incident",
        "sysId": "INC00000000",
    }

    // Instantiate new TableItemRequestBuilder.
    requestBuilder := tableapi.NewTableItemRequestBuilder(client, pathParameters)

    // Call the get method, with or without TableItemRequestBuilderGetQueryParameters.
    // record is of type TableItemResponse
    record, err := requestBuilder.Get(nil)

    // evaluate err, should be nil
    if err != nil {
        panic(err)
    }
}

[POST] /now/table/{tableName}

Inserts one record in the specified table. Multiple record insertion is not supported by this method.

package main

import (
    tableapi "github.com/michaeldcanady/servicenow-sdk-go/table-api"
)

func main() {
    
    //Implement credential and client.
    pathParameters := {
        "baseurl":"https://www.{instance}.service-now.com/api/now",
        "table": "incident",
    }

    // data map of information you want to use for the new record
    data := map[string]string{
        "short_description": "example incident",
        "description": "incident created by servicenow-sdk-go",
    }

    // Instantiate new TableItemRequestBuilder.
    requestBuilder := tableapi.NewTableRequestBuilder(client, pathParameters)

    // Call the get method, with or without TableRequestBuilderPostQueryParamters.
    // Make sure you include the data paramter
    // Response is a TableItemResponse.
    response, err := requestBuilder.Post(data, nil)

    // Test err, should be nil
    if err != nil {
        panic(err)
    }
}

Documentation

Index

Constants

This section is empty.

Variables

View Source 
var (
	ErrNilClient         = errors.New("client can't be nil")
	ErrNilResponse       = errors.New("response can't be nil")
	ErrNilResult         = errors.New("result property missing in response object")
	ErrWrongResponseType = errors.New("incorrect Response Type")
	ErrParsing           = errors.New("parsing nextLink url failed")
	ErrEmptyURI          = errors.New("empty URI")
	ErrNilCallback       = errors.New("callback can't be nil")
)

Functions

This section is empty.

Types

type DisplayValue 

type DisplayValue string
const (
	TRUE  DisplayValue = "true"
	FALSE DisplayValue = "false"
	ALL   DisplayValue = "all"
)

type Entry added in v1.4.0 

type Entry interface {
	Value(string) *TableValue
	Set(string, interface{})
	Keys() []string
	Len() int
}

type Fragment deprecated added in v1.1.0 

type Fragment = core.Fragment

Fragment represents a query fragment with a field, operator, and value.

Deprecated: deprecated since 1.4.0. Please use core.Fragment instead.

func NewFragment deprecated added in v1.1.0 

func NewFragment(field string, operator RelationalOperator, value interface{}) *Fragment

NewFragment creates a new query fragment with the specified field, operator, and value.

Deprecated: deprecated since 1.4.0. Please use core.NewFragment instead.

type LogicalOperator deprecated added in v1.1.0 

type LogicalOperator = core.LogicalOperator

LogicalOperator ...

Deprecated: deprecated since 1.4.0. Please use core.LogicalOperator instead. 

const (
	// And ...
	//
	// Deprecated: deprecated since 1.4.0. Please use core.And instead.
	And LogicalOperator = core.And
	// Or ...
	//
	// Deprecated: deprecated since 1.4.0. Please use core.Or instead.
	Or LogicalOperator = core.Or
)

type OrderBy deprecated added in v1.1.0 

type OrderBy = core.OrderBy

OrderBy represents an order-by clause.

Deprecated: deprecated since 1.4.0. Please use core.OrderBy instead.

func NewOrderBy deprecated added in v1.1.0 

func NewOrderBy() *OrderBy

NewOrderBy Creates new order by.

Deprecated: deprecated since 1.4.0. Please use core.NewOrderBy instead.

type OrderDirection deprecated added in v1.1.0 

type OrderDirection = core.OrderDirection

OrderDirection represents the order direction for sorting.

Deprecated: deprecated since 1.4.0. Please use core.OrderDirection instead. 

const (
	// Unset ...
	//
	// Deprecated: deprecated since 1.4.0. Please use core.Unset instead.
	Unset OrderDirection = core.Unset
	// Asc ...
	//
	// Deprecated: deprecated since 1.4.0. Please use core.Asc instead.
	Asc OrderDirection = core.Asc
	// Desc ...
	//
	// Deprecated: deprecated since 1.4.0. Please use core.Desc instead.
	Desc OrderDirection = core.Desc
)

type PageIterator deprecated 

type PageIterator struct {
	// contains filtered or unexported fields
}

Deprecated: deprecated in v{unreleased}. Use TablePageIterator[T] instead. PageIterator represents an iterator for paginated results from a table.

func NewPageIterator deprecated 

func NewPageIterator(currentPage interface{}, client core.Client) (*PageIterator, error)

Deprecated: deprecated in v{unreleased}. Use NewTablePageIterator[T] instead. NewPageIterator creates a new PageIterator instance.

func (*PageIterator) Iterate 

func (pI *PageIterator) Iterate(callback func(pageItem *TableEntry) bool) error

Iterate iterates through pages and invokes the provided callback for each page item.

func (*PageIterator) Last added in v1.4.0 

func (pI *PageIterator) Last() (PageResult, error)

Last fetches the last page of results.

type PageResult 

type PageResult struct {
	Result           []*TableEntry
	NextPageLink     string
	PreviousPageLink string
	FirstPageLink    string
	LastPageLink     string
}

PageResult represents a single page of results from a table.

type Query deprecated added in v1.1.0 

type Query = core.Query

Query represents a ServiceNow query and its conditions.

Deprecated: deprecated since 1.4.0. Please use core.Query instead.

func NewQuery deprecated added in v1.1.0 

func NewQuery() *Query

NewQuery returns a new Query with no conditions.

Deprecated: deprecated since 1.4.0. Please use core.NewQuery instead.

type RelationalOperator deprecated added in v1.1.0 

type RelationalOperator = core.RelationalOperator

Deprecated: deprecated since 1.4.0. Please use core.RelationalOperator instead.

RelationalOperator ... 

const (
	// Deprecated: deprecated since 1.4.0. Please use core.Null instead.
	//
	// Null ...
	Null RelationalOperator = core.Null
	// Deprecated: deprecated since 1.4.0. Please use core.Is instead.
	//
	// Is ...
	Is RelationalOperator = core.Is
	// Deprecated: deprecated since 1.4.0. Please use core.IsNot instead.
	//
	// IsNot ...
	IsNot RelationalOperator = core.IsNot
	// Deprecated: deprecated since 1.4.0. Please use core.GreaterThan instead.
	//
	// GreaterThan ...
	GreaterThan RelationalOperator = core.GreaterThan
	// Deprecated: deprecated since 1.4.0. Please use core.GreaterOrEqual instead.
	//
	// GreaterOrEqual ...
	GreaterOrEqual RelationalOperator = core.GreaterOrEqual
	// Deprecated: deprecated since 1.4.0. Please use core.LessThan instead.
	//
	// LessThan ...
	LessThan RelationalOperator = core.LessOrEqual
	// Deprecated: deprecated since 1.4.0. Please use core.LessOrEqual instead.
	//
	// LessOrEqual ...
	LessOrEqual RelationalOperator = core.LessOrEqual
	// Deprecated: deprecated since 1.4.0. Please use core.Contains instead.
	//
	// Contains ...
	Contains RelationalOperator = core.Contains
	// Deprecated: deprecated since 1.4.0. Please use core.NotContains instead.
	//
	// NotContains ...
	NotContains RelationalOperator = core.NotContains
	// Deprecated: deprecated since 1.4.0. Please use core.StartsWith instead.
	//
	// StartsWith ...
	StartsWith RelationalOperator = core.StartsWith
	// Deprecated: deprecated since 1.4.0. Please use core.EndsWith instead.
	//
	// EndsWith ...
	EndsWith RelationalOperator = core.EndsWith
	// Deprecated: deprecated since 1.4.0. Please use core.Between instead.
	//
	// Between ...
	Between RelationalOperator = core.Between
	// Deprecated: deprecated since 1.4.0. Please use core.IsSame instead.
	//
	// IsSame ...
	IsSame RelationalOperator = core.IsSame
	// Deprecated: deprecated since 1.4.0. Please use core.IsDifferent instead.
	//
	// IsDifferent ...
	IsDifferent RelationalOperator = core.IsDifferent
	// Deprecated: deprecated since 1.4.0. Please use core.IsEmpty instead.
	//
	// IsEmpty ...
	IsEmpty RelationalOperator = core.IsEmpty
)

type TableCollectionResponse 

type TableCollectionResponse = TableCollectionResponse2[TableEntry]

Deprecacted: deprecated since v1.4.0. Use "TableCollectionResponse2[T]" instead.

TableCollectionResponse represents a collection of table entries.

type TableCollectionResponse2 added in v1.4.0 

type TableCollectionResponse2[T Entry] struct {
	// Result is a slice of pointers to table entries.
	Result []*T
	// NextPageLink is the URL to the next page of results.
	NextPageLink string
	// PreviousPageLink is the URL to the previous page of results.
	PreviousPageLink string
	// FirstPageLink is the URL to the first page of results.
	FirstPageLink string
	// LastPageLink is the URL to the last page of results.
	LastPageLink string
}

TableCollectionResponse2 represents a collection of table entries.

func (*TableCollectionResponse2[T]) ParseHeaders added in v1.4.0 

func (cR *TableCollectionResponse2[T]) ParseHeaders(headers http.Header)

ParseHeaders parses the needed headers from the response.

func (*TableCollectionResponse2[T]) ToPage added in v1.5.0 

func (cR *TableCollectionResponse2[T]) ToPage() core.PageResult[T]

ToPage converts a TableCollectionResponse2 to a PageResult

type TableEntry 

type TableEntry map[string]interface{}

TableEntry represents a single Service-Now Table Entry.

func NewTableEntry added in v1.4.0 

func NewTableEntry() TableEntry

NewTableEntry creates a new table entry instance.

func (TableEntry) Keys added in v1.2.1 

func (tE TableEntry) Keys() []string

Keys returns a slice of the tE's keys.

func (TableEntry) Len added in v1.4.0 

func (tE TableEntry) Len() int

Len returns the length of the tE.

func (TableEntry) Set added in v1.4.0 

func (tE TableEntry) Set(key string, value interface{})

Set sets the specified key to the provided value.

func (TableEntry) Value 

func (tE TableEntry) Value(key string) *TableValue

Value returns a tE if a valid key is provided.

type TableGetRequestConfiguration deprecated added in v1.2.2 

type TableGetRequestConfiguration struct {
	Header          interface{}
	QueryParameters *TableRequestBuilderGetQueryParameters
	Data            interface{}
	ErrorMapping    core.ErrorMapping
	// contains filtered or unexported fields
}

Deprecated: deprecated since v1.4.0. Removed from public API.

TableGetRequestConfiguration represents request configurations GET request.

type TableItemDeleteRequestConfiguration deprecated added in v1.2.2 

type TableItemDeleteRequestConfiguration struct {
	Header          interface{}
	QueryParameters *TableItemRequestBuilderDeleteQueryParameters
	Data            interface{}
	ErrorMapping    core.ErrorMapping
	// contains filtered or unexported fields
}

Deprecated: deprecated since v1.4.0. Removed from public API.

TableItemDeleteRequestConfiguration represents request configurations DELETE request.

type TableItemGetRequestConfiguration deprecated added in v1.2.2 

type TableItemGetRequestConfiguration struct {
	Header          interface{}
	QueryParameters *TableItemRequestBuilderGetQueryParameters
	Data            interface{}
	ErrorMapping    core.ErrorMapping
	// contains filtered or unexported fields
}

Deprecated: deprecated since v1.4.0. Removed from public API.

TableItemGetRequestConfiguration represents request configurations GET request.

type TableItemPutRequestConfiguration deprecated added in v1.2.2 

type TableItemPutRequestConfiguration struct {
	Header          interface{}
	QueryParameters *TableItemRequestBuilderPutQueryParameters
	Data            interface{}
	ErrorMapping    core.ErrorMapping
	// contains filtered or unexported fields
}

Deprecated: deprecated since v1.4.0. Removed from public API.

TableItemPutRequestConfiguration represents request configurations GET request.

type TableItemRequestBuilder 

type TableItemRequestBuilder struct {
	core.RequestBuilder
}

func NewTableItemRequestBuilder 

func NewTableItemRequestBuilder(client core.Client, pathParameters map[string]string) *TableItemRequestBuilder

NewTableItemRequestBuilder creates a new instance of the TableItemRequestBuilder associated with the given URL and Client. It accepts the URL and Client as parameters and returns a pointer to the created TableItemRequestBuilder.

func (*TableItemRequestBuilder) Delete 

func (rB *TableItemRequestBuilder) Delete(params *TableItemRequestBuilderDeleteQueryParameters) error

Delete sends an HTTP DELETE request using the specified query parameters and returns an error if the request or response encounters any issues.

Parameters:

  • params: An instance of TableItemRequestBuilderDeleteQueryParameters to include in the DELETE request.

Returns:

  • error: An error if there was an issue with the request or response, or nil if the request was successful.

func (*TableItemRequestBuilder) Get 

func (rB *TableItemRequestBuilder) Get(params *TableItemRequestBuilderGetQueryParameters) (*TableItemResponse, error)

Get sends an HTTP GET request using the specified query parameters and returns a TableItemResponse.

Parameters:

  • params: An instance of TableItemRequestBuilderGetQueryParameters to include in the GET request.

Returns:

  • *TableItemResponse: The response data as a TableItemResponse.
  • error: An error if there was an issue with the request or response.

func (*TableItemRequestBuilder) Put deprecated 

func (rB *TableItemRequestBuilder) Put(tableEntry map[string]string, params *TableItemRequestBuilderPutQueryParameters) (*TableItemResponse, error)

Deprecated: deprecated since v1.4.0. Use `Put2` instead.

Put updates a table item using an HTTP PUT request. It takes a map of table entry data and optional query parameters to send in the request. The method returns a TableItemResponse representing the updated item or an error if the request fails.

Parameters:

  • tableEntry: A map containing the data to update the table item.
  • params: An optional pointer to TableItemRequestBuilderPutQueryParameters, which can be used to specify query parameters for the request.

Returns:

  • *TableItemResponse: A TableItemResponse containing the updated item data.
  • error: An error, if the request fails at any point, such as request information creation or JSON deserialization.

func (*TableItemRequestBuilder) Put2 added in v1.4.0 

func (rB *TableItemRequestBuilder) Put2(tableEntry interface{}, params *TableItemRequestBuilderPutQueryParameters) (*TableItemResponse, error)

Put2 updates a table item using an HTTP PUT request. It takes a map of table entry data and optional query parameters to send in the request. The method returns a TableItemResponse representing the updated item or an error if the request fails.

Parameters:

  • tableEntry: A map[string]string or TableEntry containing the data to update the table item.
  • params: An optional pointer to TableItemRequestBuilderPutQueryParameters, which can be used to specify query parameters for the request.

Returns:

  • *TableItemResponse: A TableItemResponse containing the updated item data.
  • error: An error, if the request fails at any point, such as request information creation or JSON deserialization.

type TableItemRequestBuilderDeleteQueryParameters 

type TableItemRequestBuilderDeleteQueryParameters struct {
	// QueryNoDomain flag that indicates whether to restrict the record search to only the domains for which the logged in user is configured.
	//
	//Valid values:
	//
	//- false: Exclude the record if it is in a domain that the currently logged in user is not configured to access.
	//
	//- true: Include the record even if it is in a domain that the currently logged in user is not configured to access.
	QueryNoDomain bool `url:"sysparm_query_no_domain"`
}

TableItemRequestBuilderDeleteQueryParameters represents DELETE query parameters for a Table Item Request.

type TableItemRequestBuilderGetQueryParameters 

type TableItemRequestBuilderGetQueryParameters struct {
	//DisplayValue determines the type of data returned, either the actual values from the database or the display values of the fields.
	//Display values are manipulated based on the actual value in the database and user or system settings and preferences.
	//If returning display values, the value that is returned is dependent on the field type.
	//- Choice fields: The database value may be a number, but the display value will be more descriptive.
	//
	//- Date fields: The database value is in UTC format, while the display value is based on the user's time zone.
	//
	//- Encrypted text: The database value is encrypted, while the displayed value is unencrypted based on the user's encryption context.
	//
	//- Reference fields: The database value is sys_id, but the display value is a display field of the referenced record.
	DisplayValue DisplayValue `url:"sysparm_display_value"`
	//ExcludeReferenceLink flag that indicates whether to exclude Table API links for reference fields.
	//
	//Valid values:
	//
	//- true: Exclude Table API links for reference fields.
	//
	//- false: Include Table API links for reference fields.
	ExcludeReferenceLink bool `url:"sysparm_exclude_reference_link"`
	// Fields list of fields to return in the response.
	Fields []string `url:"sysparm_fields"`
	//Flag that indicates whether to restrict the record search to only the domains for which the logged in user is configured.
	//
	//Valid values:
	//
	//- false: Exclude the record if it is in a domain that the currently logged in user is not configured to access.
	//
	//- true: Include the record even if it is in a domain that the currently logged in user is not configured to access.
	QueryNoDomain bool `url:"sysparm_query_no_domain"`
	// View	UI view for which to render the data. Determines the fields returned in the response.
	//
	//Valid values:
	//
	//- desktop
	//- mobile
	//- both
	//If you also specify the sysparm_fields parameter, it takes precedent.
	View View `url:"sysparm_view"`
}

TableItemRequestBuilderGetQueryParameters represents GET query parameters for a Table Item Request.

type TableItemRequestBuilderPutQueryParameters 

type TableItemRequestBuilderPutQueryParameters struct {
	//DisplayValue determines the type of data returned, either the actual values from the database or the display values of the fields.
	//Display values are manipulated based on the actual value in the database and user or system settings and preferences.
	//If returning display values, the value that is returned is dependent on the field type.
	//- Choice fields: The database value may be a number, but the display value will be more descriptive.
	//
	//- Date fields: The database value is in UTC format, while the display value is based on the user's time zone.
	//
	//- Encrypted text: The database value is encrypted, while the displayed value is unencrypted based on the user's encryption context.
	//
	//- Reference fields: The database value is sys_id, but the display value is a display field of the referenced record.
	DisplayValue DisplayValue `url:"sysparm_display_value"`
	//ExcludeReferenceLink flag that indicates whether to exclude Table API links for reference fields.
	//
	//Valid values:
	//
	//- true: Exclude Table API links for reference fields.
	//
	//- false: Include Table API links for reference fields.
	ExcludeReferenceLink bool `url:"sysparm_exclude_reference_link"`
	// Fields list of fields to return in the response.
	Fields            []string `url:"sysparm_fields"`
	InputDisplayValue bool     `url:"sysparm_input_display_value"`
	// QueryNoDomain flag that indicates whether to restrict the record search to only the domains for which the logged in user is configured.
	//
	//Valid values:
	//
	//- false: Exclude the record if it is in a domain that the currently logged in user is not configured to access.
	//
	//- true: Include the record even if it is in a domain that the currently logged in user is not configured to access.
	QueryNoDomain bool `url:"sysparm_query_no_domain"`
	// View	UI view for which to render the data. Determines the fields returned in the response.
	//
	//Valid values:
	//
	//- desktop
	//- mobile
	//- both
	//If you also specify the sysparm_fields parameter, it takes precedent.
	View View `url:"sysparm_view"`
}

TableItemRequestBuilderPutQueryParameters represents PUT query parameters for a Table Item Request.

type TableItemResponse deprecated 

type TableItemResponse = TableItemResponse2[TableEntry]

Deprecated: deprecated since v1.4.0. Use `TableItemResponse2[T]` instead.

TableItemResponse represents a single table record response.

type TableItemResponse2 added in v1.4.0 

type TableItemResponse2[T Entry] struct {
	Result *T
}

TableItemResponse2[T] represents a T Entry single table record response.

func (*TableItemResponse2[T]) ParseHeaders added in v1.4.0 

func (r *TableItemResponse2[T]) ParseHeaders(headers http.Header)

ParseHeaders parses information from headers.

type TablePageIterator added in v1.5.0 

type TablePageIterator[T Entry] struct {
	// contains filtered or unexported fields
}

TablePageIterato2[T] is an iterator over pages of table entries.

func NewTablePageIterator added in v1.5.0 

func NewTablePageIterator[T Entry](collection *TableCollectionResponse2[T], client core.Client) (*TablePageIterator[T], error)

NewTablePageIterator[T] creates a new TablePageIterator2 instance.

type TablePostRequestConfiguration deprecated added in v1.2.2 

type TablePostRequestConfiguration struct {
	Header          interface{}
	QueryParameters *TableRequestBuilderPostQueryParameters
	Data            map[string]string
	ErrorMapping    core.ErrorMapping
	// contains filtered or unexported fields
}

Deprecated: deprecated since v1.4.0. removed from public API.

TablePostRequestConfiguration represents request configurations POST request.

type TableRequestBuilder 

type TableRequestBuilder struct {
	core.RequestBuilder
}

func NewTableRequestBuilder 

func NewTableRequestBuilder(client core.Client, pathParameters map[string]string) *TableRequestBuilder

NewTableRequestBuilder creates a new instance of the TableRequestBuilder associated with the given URL and Client. It accepts the URL and Client as parameters and returns a pointer to the created TableRequestBuilder.

func (*TableRequestBuilder) ById 

func (rB *TableRequestBuilder) ById(sysId string) *TableItemRequestBuilder

ById returns a TableItemRequestBuilder for a specific record in the table. It accepts the sysId of the record as a parameter and constructs the URL for the record. The returned TableItemRequestBuilder can be used to build and execute requests for the specific record.

func (*TableRequestBuilder) Count 

func (rB *TableRequestBuilder) Count() (int, error)

Count sends an HTTP HEAD request and retrieves the value of "X-Total-Count" from the response header, which represents the count of items.

Returns:

  • int: The count of items.
  • error: An error if there was an issue with the request or response.

func (*TableRequestBuilder) Get 

func (rB *TableRequestBuilder) Get(params *TableRequestBuilderGetQueryParameters) (*TableCollectionResponse, error)

Get sends an HTTP GET request using the specified query parameters and returns a TableCollectionResponse.

Parameters:

  • params: An instance of TableRequestBuilderGetQueryParameters to include in the GET request.

Returns:

  • *TableCollectionResponse: The response data as a TableCollectionResponse.
  • error: An error if there was an issue with the request or response.

func (*TableRequestBuilder) Post deprecated 

func (rB *TableRequestBuilder) Post(data map[string]string, params *TableRequestBuilderPostQueryParamters) (*TableItemResponse, error)

Deprecated: deprecated since v1.4.0. Use `Post2` instead. Post sends an HTTP Post request with the provided data and query parameters and returns an `TableItemResponse`.

Parameters:

  • data: A map[string]string representing data to be included in the request body.
  • params: An instance of `*TableRequestBuilderPostQueryParameters` for query parameters.

Returns:

  • *TableResponse: The response data as a TableResponse.
  • error: An error if there was an issue with the request or response.

func (*TableRequestBuilder) Post2 deprecated added in v1.2.2 

func (rB *TableRequestBuilder) Post2(data map[string]string, params *TableRequestBuilderPostQueryParameters) (*TableItemResponse, error)

Deprecated: deprecated since v1.4.0. Use `Post3` instead.

Post2 sends an HTTP Post request with the provided data and query parameters and returns an `TableItemResponse`.

Parameters:

  • data: A map[string]string representing data to be included in the request body.
  • params: An instance of `*TableRequestBuilderPostQueryParameters` for query parameters

func (*TableRequestBuilder) Post3 added in v1.4.0 

func (rB *TableRequestBuilder) Post3(data interface{}, params *TableRequestBuilderPostQueryParameters) (*TableItemResponse, error)

Post3 sends an HTTP Post request with the provided data and query parameters and returns an `TableItemResponse`.

Parameters:

  • data: A map[string]string or TableEntry representing data to be included in the request body.
  • params: An instance of `*TableRequestBuilderPostQueryParameters` for query parameters

type TableRequestBuilderGetQueryParameters 

type TableRequestBuilderGetQueryParameters struct {
	//Determines the type of data returned, either the actual values from the database or the display values of the fields.
	//Display values are manipulated based on the actual value in the database and user or system settings and preferences.
	//If returning display values, the value that is returned is dependent on the field type.
	//- Choice fields: The database value may be a number, but the display value will be more descriptive.
	//
	//- Date fields: The database value is in UTC format, while the display value is based on the user's time zone.
	//
	//- Encrypted text: The database value is encrypted, while the displayed value is unencrypted based on the user's encryption context.
	//
	//- Reference fields: The database value is sys_id, but the display value is a display field of the referenced record.
	DisplayValue DisplayValue `url:"sysparm_display_value,omitempty"`
	//Flag that indicates whether to exclude Table API links for reference fields.
	//
	//Valid values:
	//
	//- true: Exclude Table API links for reference fields.
	//
	//- false: Include Table API links for reference fields.
	ExcludeReferenceLink bool `url:"sysparm_exclude_reference_link,omitempty"`
	//list of fields to return in the response.
	Fields []string `url:"sysparm_fields,omitempty"`
	//Flag that indicates whether to restrict the record search to only the domains for which the logged in user is configured.
	//
	//Valid values:
	//
	//- false: Exclude the record if it is in a domain that the currently logged in user is not configured to access.
	//
	//- true: Include the record even if it is in a domain that the currently logged in user is not configured to access.
	QueryNoDomain bool `url:"sysparm_query_no_domain,omitempty"`
	//	UI view for which to render the data. Determines the fields returned in the response.
	//
	//Valid values:
	//
	//- desktop
	//- mobile
	//- both
	//If you also specify the sysparm_fields parameter, it takes precedent.
	View                     View   `url:"sysparm_view,omitempty"`
	Limit                    int    `url:"sysparm_limit,omitempty"`
	NoCount                  bool   `url:"sysparm_no_count,omitempty"`
	Offset                   int    `url:"sysparm_offset,omitempty"`
	Query                    string `url:"sysparm_query,omitempty"`
	QueryCategory            string `url:"sysparm_query_category,omitempty"`
	SuppressPaginationHeader bool   `url:"sysparm_suppress_pagination_header,omitempty"`
}

TableRequestBuilderGetQueryParameters represents GET query parameters for a Table Item Request.

type TableRequestBuilderPostQueryParameters added in v1.2.2 

type TableRequestBuilderPostQueryParameters struct {
	//Determines the type of data returned, either the actual values from the database or the display values of the fields.
	//Display values are manipulated based on the actual value in the database and user or system settings and preferences.
	//If returning display values, the value that is returned is dependent on the field type.
	//- Choice fields: The database value may be a number, but the display value will be more descriptive.
	//
	//- Date fields: The database value is in UTC format, while the display value is based on the user's time zone.
	//
	//- Encrypted text: The database value is encrypted, while the displayed value is unencrypted based on the user's encryption context.
	//
	//- Reference fields: The database value is sys_id, but the display value is a display field of the referenced record.
	DisplayValue DisplayValue `url:"sysparm_display_value"`
	//Flag that indicates whether to exclude Table API links for reference fields.
	//
	//Valid values:
	//
	//- true: Exclude Table API links for reference fields.
	//
	//- false: Include Table API links for reference fields.
	ExcludeReferenceLink bool `url:"sysparm_exclude_reference_link"`
	//list of fields to return in the response.
	Fields            []string `url:"sysparm_fields"`
	InputDisplayValue bool     `url:"sysparm_input_display_value"`
	//	UI view for which to render the data. Determines the fields returned in the response.
	//
	//Valid values:
	//
	//- desktop
	//- mobile
	//- both
	//If you also specify the sysparm_fields parameter, it takes precedent.
	View View `url:"sysparm_view"`
}

TableRequestBuilderPostQueryParameters represents POST query parameters for a Table Item Request.

type TableRequestBuilderPostQueryParamters deprecated 

type TableRequestBuilderPostQueryParamters struct {
	//Determines the type of data returned, either the actual values from the database or the display values of the fields.
	//Display values are manipulated based on the actual value in the database and user or system settings and preferences.
	//If returning display values, the value that is returned is dependent on the field type.
	//- Choice fields: The database value may be a number, but the display value will be more descriptive.
	//
	//- Date fields: The database value is in UTC format, while the display value is based on the user's time zone.
	//
	//- Encrypted text: The database value is encrypted, while the displayed value is unencrypted based on the user's encryption context.
	//
	//- Reference fields: The database value is sys_id, but the display value is a display field of the referenced record.
	DisplayValue DisplayValue `url:"sysparm_display_value"`
	//Flag that indicates whether to exclude Table API links for reference fields.
	//
	//Valid values:
	//
	//- true: Exclude Table API links for reference fields.
	//
	//- false: Include Table API links for reference fields.
	ExcludeReferenceLink bool `url:"sysparm_exclude_reference_link"`
	//list of fields to return in the response.
	Fields            []string `url:"sysparm_fields"`
	InputDisplayValue bool     `url:"sysparm_input_display_value"`
	//	UI view for which to render the data. Determines the fields returned in the response.
	//
	//Valid values:
	//
	//- desktop
	//- mobile
	//- both
	//If you also specify the sysparm_fields parameter, it takes precedent.
	View View `url:"sysparm_view"`
}

Deprecated: deprecated as of v1.4.0. use `TableRequestBuilderPostQueryParameters` instead

TableRequestBuilderPostQueryParamters represents POST query parameters for a Table Item Request.

type TableResponse 

type TableResponse struct {
	Result TableEntry
}

type TableValue 

type TableValue struct {
	// contains filtered or unexported fields
}

TableValue is the reflection interface to a table value.

func (*TableValue) Bool added in v1.2.1 

func (tV *TableValue) Bool() (bool, error)

Bool returns tV's underlying value, as a bool.

func (*TableValue) Float added in v1.2.1 

func (tV *TableValue) Float() (float64, error)

Float returns tV's underlying value, as a float64.

func (*TableValue) GetType deprecated 

func (tV *TableValue) GetType() reflect.Type

Deprecated: deprecated as of 1.4.0 please utilize `Type`

GetType returns tV's underlying value type.

func (*TableValue) Int added in v1.2.1 

func (tV *TableValue) Int() (int64, error)

Int returns tV's underlying value, as an int64.

func (*TableValue) String added in v1.2.1 

func (tV *TableValue) String() (string, error)

String returns tV's underlying value, as a string.

func (*TableValue) ToBool deprecated 

func (tV *TableValue) ToBool() (bool, error)

Deprecated: deprecated as of 1.4.0 please utilize `Bool`

ToBool returns tV's underlying value, as a bool.

func (*TableValue) ToFloat64 deprecated 

func (tV *TableValue) ToFloat64() (float64, error)

Deprecated: deprecated as of 1.4.0 please utilize `ToFloat64`

ToFloat64 returns tV's underlying value, as a float64.

func (*TableValue) ToInt64 deprecated 

func (tV *TableValue) ToInt64() (int64, error)

Deprecated: deprecated as of 1.4.0 please utilize `ToInt64`

ToInt64 returns tV's underlying value, as an int64.

func (*TableValue) ToString deprecated 

func (tV *TableValue) ToString() (string, error)

Deprecated: deprecated as of 1.4.0 please utilize `String`

ToString returns tV's underlying value, as a string.

func (*TableValue) Type added in v1.2.1 

func (tV *TableValue) Type() reflect.Type

Type returns tV's underlying value type.

type View 

type View string
const (
	DESKTOP View = "desktop"
	MOBILE  View = "mobile"
	BOTH    View = "both"
)

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.