Documentation ¶
Index ¶
- Variables
- type AnalyticsState
- type AnalyticsStateDetails
- type AnalyticsViewWorkItemsDefinition
- type AreaPathFilter
- type Client
- type ClientImpl
- func (client *ClientImpl) CreateShard(ctx context.Context, args CreateShardArgs) (*StageProviderShardInfo, error)
- func (client *ClientImpl) DeleteShard(ctx context.Context, args DeleteShardArgs) error
- func (client *ClientImpl) GetShard(ctx context.Context, args GetShardArgs) (*StageProviderShardInfo, error)
- func (client *ClientImpl) GetState(ctx context.Context, args GetStateArgs) (*AnalyticsStateDetails, error)
- func (client *ClientImpl) GetTable(ctx context.Context, args GetTableArgs) (*StageTableInfo, error)
- func (client *ClientImpl) InvalidateShard(ctx context.Context, args InvalidateShardArgs) error
- func (client *ClientImpl) StageRecords(ctx context.Context, args StageRecordsArgs) (*IngestResult, error)
- type CreateShardArgs
- type DateRange
- type DeleteShardArgs
- type FieldFilter
- type FieldOperation
- type FieldSet
- type FieldType
- type FieldValuesOperator
- type FilterValues
- type GetShardArgs
- type GetStateArgs
- type GetTableArgs
- type HistoryConfiguration
- type HistoryType
- type IngestResult
- type InvalidateShardArgs
- type ProjectTeamFilter
- type StageProviderShardInfo
- type StageRecordsArgs
- type StageShardInvalid
- type StageStreamInfo
- type StageTableInfo
- type TrendGranularity
- type TrendGranularityType
- type ValueMode
Constants ¶
This section is empty.
Variables ¶
var AnalyticsStateValues = analyticsStateValuesType{
Disabled: "disabled",
Enabled: "enabled",
Paused: "paused",
Deleting: "deleting",
Preparing: "preparing",
}
var FieldOperationValues = fieldOperationValuesType{
Eq: "eq",
Ne: "ne",
Ge: "ge",
Le: "le",
Gt: "gt",
Lt: "lt",
Contains: "contains",
Notcontains: "notcontains",
Under: "under",
Notunder: "notunder",
}
var FieldTypeValues = fieldTypeValuesType{
Common: "common",
Custom: "custom",
}
var FieldValuesOperatorValues = fieldValuesOperatorValuesType{
And: "and",
Or: "or",
}
var HistoryTypeValues = historyTypeValuesType{
None: "none",
Rolling: "rolling",
Range: "range",
All: "all",
}
var TrendGranularityTypeValues = trendGranularityTypeValuesType{
Daily: "daily",
Weekly: "weekly",
Monthly: "monthly",
}
var ValueModeValues = valueModeValuesType{
Filter: "filter",
All: "all",
}
Functions ¶
This section is empty.
Types ¶
type AnalyticsState ¶
type AnalyticsState string
type AnalyticsStateDetails ¶
type AnalyticsStateDetails struct { // The Analytics feature state. AnalyticsState *AnalyticsState `json:"analyticsState,omitempty"` // When this state was set. ChangedDate *azuredevops.Time `json:"changedDate,omitempty"` }
type AnalyticsViewWorkItemsDefinition ¶
type AnalyticsViewWorkItemsDefinition struct { // List of area paths to filter by. AreaPathFilters *[]AreaPathFilter `json:"areaPathFilters,omitempty"` // List of backlog names to filter by. Backlogs *[]string `json:"backlogs,omitempty"` // List of field criteria to filter by. FieldFilters *[]FieldFilter `json:"fieldFilters,omitempty"` // Selection of fields for an analytics view. Field set may include common fields, or custom fields selected by the user. FieldSet *FieldSet `json:"fieldSet,omitempty"` // History/time-period constraints to filter an analytics view by. HistoryConfiguration *HistoryConfiguration `json:"historyConfiguration,omitempty"` // Defines the user-selected parameter by which an analytics view is filtered. True - filter by team. False -filter by area path. IsTeamFilterBySelectionMode *bool `json:"isTeamFilterBySelectionMode,omitempty"` // List of projects and teams to filter by. ProjectTeamFilters *[]ProjectTeamFilter `json:"projectTeamFilters,omitempty"` // List of work item types to filter by. WorkItemTypes interface{} `json:"workItemTypes,omitempty"` }
Definition Contract for Analytics Views.
type AreaPathFilter ¶
type AreaPathFilter struct { // Area Id to filter by. AreaId *string `json:"areaId,omitempty"` // Enumeration representing operations while filtering an analytics view by area path. Operation *FieldOperation `json:"operation,omitempty"` // Unique identifier (Guid) for a project. ProjectId *uuid.UUID `json:"projectId,omitempty"` }
Project and Area path filter metadata for analytics view definitions.
type Client ¶
type Client interface { // [Preview API] CreateShard(context.Context, CreateShardArgs) (*StageProviderShardInfo, error) // [Preview API] DeleteShard(context.Context, DeleteShardArgs) error // [Preview API] GetShard(context.Context, GetShardArgs) (*StageProviderShardInfo, error) // [Preview API] Gets the current state of the Analytics feature. GetState(context.Context, GetStateArgs) (*AnalyticsStateDetails, error) // [Preview API] GetTable(context.Context, GetTableArgs) (*StageTableInfo, error) // [Preview API] InvalidateShard(context.Context, InvalidateShardArgs) error // [Preview API] StageRecords(context.Context, StageRecordsArgs) (*IngestResult, error) }
type ClientImpl ¶
type ClientImpl struct {
Client azuredevops.Client
}
func (*ClientImpl) CreateShard ¶
func (client *ClientImpl) CreateShard(ctx context.Context, args CreateShardArgs) (*StageProviderShardInfo, error)
[Preview API]
func (*ClientImpl) DeleteShard ¶
func (client *ClientImpl) DeleteShard(ctx context.Context, args DeleteShardArgs) error
[Preview API]
func (*ClientImpl) GetShard ¶
func (client *ClientImpl) GetShard(ctx context.Context, args GetShardArgs) (*StageProviderShardInfo, error)
[Preview API]
func (*ClientImpl) GetState ¶
func (client *ClientImpl) GetState(ctx context.Context, args GetStateArgs) (*AnalyticsStateDetails, error)
[Preview API] Gets the current state of the Analytics feature.
func (*ClientImpl) GetTable ¶
func (client *ClientImpl) GetTable(ctx context.Context, args GetTableArgs) (*StageTableInfo, error)
[Preview API]
func (*ClientImpl) InvalidateShard ¶
func (client *ClientImpl) InvalidateShard(ctx context.Context, args InvalidateShardArgs) error
[Preview API]
func (*ClientImpl) StageRecords ¶
func (client *ClientImpl) StageRecords(ctx context.Context, args StageRecordsArgs) (*IngestResult, error)
[Preview API]
type CreateShardArgs ¶
Arguments for the CreateShard function
type DateRange ¶
type DateRange struct { // End date for date range interval. If null, data spans until current date. EndDate *azuredevops.Time `json:"endDate,omitempty"` // Start date for date range interval. StartDate *azuredevops.Time `json:"startDate,omitempty"` }
Date range to filter analytics view rows.
type DeleteShardArgs ¶
Arguments for the DeleteShard function
type FieldFilter ¶
type FieldFilter struct { // Name of work item field. FieldName *string `json:"fieldName,omitempty"` // Query comparison operator for selected field. FieldOperation *FieldOperation `json:"fieldOperation,omitempty"` // Deprecated: Use Values instead FieldValue *[]string `json:"fieldValue,omitempty"` // Deprecated: Use Values instead FieldValuesOperator *FieldValuesOperator `json:"fieldValuesOperator,omitempty"` // Value(s) of selected field. Value interface{} `json:"value,omitempty"` }
Field filter criteria metadata for analytics view definitions.
type FieldOperation ¶
type FieldOperation string
Enumeration representing operations while filtering field values an analytics view
type FieldSet ¶
type FieldSet struct { // List of fields in the analytics view field set. Fields *[]string `json:"fields,omitempty"` // Enumeration representing type of work item field set. FieldType *FieldType `json:"fieldType,omitempty"` }
Fields metadata for analytics view definitions.
type FieldValuesOperator ¶
type FieldValuesOperator string
Enumeration represanting multi-value operation for a single filter i.e. what is the condition that should be applied _between_ values
type FilterValues ¶
type FilterValues struct { // Enumeration to specify whether filtering is applied on an entity. Mode *ValueMode `json:"mode,omitempty"` // Value(s) of selected field. Operator *FieldValuesOperator `json:"operator,omitempty"` // List of entity values of a generic type. Values *[]interface{} `json:"values,omitempty"` }
Values of a generic type used for filtering information in an analytics view. Part of metadata for an analytics view definition.
type GetShardArgs ¶
Arguments for the GetShard function
type GetTableArgs ¶
type GetTableArgs struct { // (required) Table *string }
Arguments for the GetTable function
type HistoryConfiguration ¶
type HistoryConfiguration struct { // Date range to filter analytics view rows. DateRange *DateRange `json:"dateRange,omitempty"` // If true, then a clause will be added to filter out work items with a CompletedDateSK before OldCompletedItemsCutoffDate or the start of the rolling period when HistoryType is Rolling. When not present, the value is assumed to be false. This also achieves backwards compatibility. ExcludeOldCompletedWorkItems *bool `json:"excludeOldCompletedWorkItems,omitempty"` // Enumeration representing interval type for Analytics View History. HistoryType *HistoryType `json:"historyType,omitempty"` // When HistoryType is anything EXCEPT Rolling, and ExcludeOldCompletedWorkItems is true, this is the date to use to cutoff old completed work items. Work items closed on the cutoff date will not be filtered out. For HistoryType Rolling, it is always calculated to be the beginning of the rolling period instead of using this. OldCompletedItemsCutoffDate *azuredevops.Time `json:"oldCompletedItemsCutoffDate,omitempty"` // Rolling period interval by number of days. Null when history type is not set to rolling period. RollingDays *int `json:"rollingDays,omitempty"` // Trend Granularity for filtering an analytics view by history. TrendGranularity *TrendGranularity `json:"trendGranularity,omitempty"` }
History metadata for analytics view definitions.
type HistoryType ¶
type HistoryType string
Enumeration representing history interval type for Analytics View History.
type IngestResult ¶
type InvalidateShardArgs ¶
type InvalidateShardArgs struct { // (required) Shard *StageShardInvalid // (required) Table *string // (required) ProviderShard *int }
Arguments for the InvalidateShard function
type ProjectTeamFilter ¶
type ProjectTeamFilter struct { // Unique identifier (Guid) for a project. ProjectId *uuid.UUID `json:"projectId,omitempty"` // List of some or all teams under a project. Teams interface{} `json:"teams,omitempty"` }
Teams filter metadata for analytics view definitions.
type StageProviderShardInfo ¶
type StageProviderShardInfo struct { ProviderShardId *int `json:"providerShardId,omitempty"` Streams *[]StageStreamInfo `json:"streams,omitempty"` }
type StageRecordsArgs ¶
type StageRecordsArgs struct { // (required) Stream to upload UploadStream io.Reader // (required) Table *string // (required) ProviderShard *int // (required) Stream *int }
Arguments for the StageRecords function
type StageShardInvalid ¶
type StageStreamInfo ¶
type StageStreamInfo struct { CreatedTime *azuredevops.Time `json:"createdTime,omitempty"` Current *bool `json:"current,omitempty"` InitialContentVersion *int `json:"initialContentVersion,omitempty"` KeysOnly *bool `json:"keysOnly,omitempty"` LatestContentVersion *int `json:"latestContentVersion,omitempty"` Priority *int `json:"priority,omitempty"` StreamId *int `json:"streamId,omitempty"` Watermark *string `json:"watermark,omitempty"` }
type StageTableInfo ¶
type StageTableInfo struct { Shards *[]StageProviderShardInfo `json:"shards,omitempty"` StageVersion *int `json:"stageVersion,omitempty"` TableName *string `json:"tableName,omitempty"` }
type TrendGranularity ¶
type TrendGranularity struct { // Enumeration representing granularity of data being represented in an analytics view. Value is null when history type is 'None'. GranularityType *TrendGranularityType `json:"granularityType,omitempty"` // End day of week for weekly trend granularity. Value is null when trend granularity is daily or monthly. WeeklyEndDay *string `json:"weeklyEndDay,omitempty"` }
Trend Granularity for filtering an analytics view by history.
type TrendGranularityType ¶
type TrendGranularityType string
Enumeration representing granularity of data being represented in an analytics view.