OrganizationServiceContextExtensions Class

 

Applies To: Dynamics CRM 2013

Extensions for the core OrganizationServiceContext class. (Developer Extensions)

Namespace:   Microsoft.Xrm.Client.Messages
Assembly:  Microsoft.Xrm.Client (in Microsoft.Xrm.Client.dll)

Inheritance Hierarchy

System.Object
  Microsoft.Xrm.Client.Messages.OrganizationServiceContextExtensions

Syntax

public static class OrganizationServiceContextExtensions
[ExtensionAttribute]
public ref class OrganizationServiceContextExtensions abstract sealed 
[<AbstractClass>]
[<Sealed>]
type OrganizationServiceContextExtensions = class end
<ExtensionAttribute>
Public NotInheritable Class OrganizationServiceContextExtensions

Methods

Name Description
System_CAPS_pubmethodSystem_CAPS_static AddItemCampaign(OrganizationServiceContext, Guid, Guid, String)

Adds an item to a campaign. The item added must be one of the following entity types: campaign, list, product, or salesliterature. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static AddItemCampaignActivity(OrganizationServiceContext, Guid, Guid, String)

Adds an item to a campaign activity. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static AddListMembersList(OrganizationServiceContext, Guid, Guid[])

Adds a list of members to a list. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static AddMemberList(OrganizationServiceContext, Guid, Guid)

Adds a member to a list. The member added must be one of the following entity types: account, contact, or lead. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static AddMembersTeam(OrganizationServiceContext, Guid, Guid[])

Adds members to a team. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static AddPrivilegesRole(OrganizationServiceContext, Guid, Object)

Adds a set of existing privileges to an existing role. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static AddProductToKit(OrganizationServiceContext, Guid, Guid)

Adds a product to a kit. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static AddRecurrence(OrganizationServiceContext, Entity, Guid)

Adds recurrence information to an existing appointment to make it a recurring appointment master. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static AddSolutionComponent(OrganizationServiceContext, Guid, Int32, String, Boolean)

Adds a solution component to an unmanaged solution. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static AddSubstituteProduct(OrganizationServiceContext, Guid, Guid)

Deprecated. Establishes an association between a product and a substitute product. Use Associate. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static AddToQueue(OrganizationServiceContext, EntityReference, Guid, Guid, Entity)

Moves a record from a source queue to a destination queue. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static Assign(OrganizationServiceContext, EntityReference, EntityReference)

Assigns the specified record to a new security principal (user). This changes the ownerid attribute of the instance. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static AssociateEntities(OrganizationServiceContext, EntityReference, EntityReference, String)

Deprecated. Adds a link between two records in a many-to-many relationship. Use Associate. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static AutoMapEntity(OrganizationServiceContext, Guid)

Creates the attribute mappings between two entities. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static BackgroundSendEmail<TResponse>(OrganizationServiceContext, QueryBase)

Sends an email asynchronously. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static Book<TResult>(OrganizationServiceContext, Entity)

Schedules or "books" an appointment. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static BulkDelete(OrganizationServiceContext, QueryExpression[], String, Boolean, Guid[], Guid[], String, DateTime, Nullable<Guid>)

Submits an asynchronous bulk delete job. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static BulkDetectDuplicates(OrganizationServiceContext, QueryBase, String, Boolean, Guid, Guid[], Guid[], String, DateTime)

Submits an asynchronous duplicates detection job. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static BulkOperationStatusClose(OrganizationServiceContext, Guid, Int32, Int32, Int32, Int32)

For internal use only. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static CalculateActualValueOpportunity(OrganizationServiceContext, Guid)

Calculates the value of an opportunity that is in the "Won" state. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static CalculateTotalTimeIncident(OrganizationServiceContext, Guid)

Calculates the total number of minutes spent on an incident (case). (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static CancelContract(OrganizationServiceContext, Guid, DateTime, OptionSetValue)

Cancels a contract. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static CancelSalesOrder(OrganizationServiceContext, Entity, OptionSetValue)

Cancels a sales order. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static CheckIncomingEmail<TResponse>(OrganizationServiceContext, String, String, String, String, String, String)

Checks whether the incoming email message is relevant to the Microsoft Dynamics CRM system. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static CheckPromoteEmail<TResponse>(OrganizationServiceContext, String, String)

Checks whether the incoming email message should be promoted to the Microsoft Dynamics CRM system. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static CleanUpBulkOperation(OrganizationServiceContext, Guid, Int32)

For internal use only. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static CloneContract(OrganizationServiceContext, Guid, Boolean)

Copies an existing contract and its line items. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static CloseIncident(OrganizationServiceContext, Entity, Int32)

Closes an incident (case). (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static CloseIncident(OrganizationServiceContext, Entity, OptionSetValue)

Closes an incident (case). (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static CloseQuote(OrganizationServiceContext, Entity, OptionSetValue)

Closes a quote. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static CompoundCreate(OrganizationServiceContext, Entity, EntityCollection)

Deprecated. Creates a compound entity (salesorder, invoice, quote, or duplicaterule) and its related entity (salesorderdetail, invoicedetail, quotedetail, or duplicaterulecondition). Use Create. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static CompoundUpdate(OrganizationServiceContext, Entity, EntityCollection)

Deprecated. Updates a compound record (salesorder, invoice, quote or duplicaterule) and its related detail record (salesorderdetail, invoicedetail, quotedetail or duplicaterulecondition). Use Update. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static CompoundUpdateDuplicateDetectionRule(OrganizationServiceContext, Entity, EntityCollection)

Updates a duplicate rule (duplicate detection rule) and its related duplicate rule conditions. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static ConvertKitToProduct(OrganizationServiceContext, Guid)

Converts a kit to a product. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static ConvertProductToKit(OrganizationServiceContext, Guid)

Converts a product to a kit. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static ConvertQuoteToSalesOrder(OrganizationServiceContext, Guid, ColumnSet)

Converts a quote to a sales order. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static ConvertSalesOrderToInvoice(OrganizationServiceContext, Guid, ColumnSet)

Converts a sales order to an invoice. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static CopyCampaign(OrganizationServiceContext, Guid, Boolean)

Copies a campaign. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static CopyCampaignResponse(OrganizationServiceContext, EntityReference)

Copies the information from one campaign response to another, and optionally creates a campaign response template. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static CopyDynamicListToStatic(OrganizationServiceContext, Guid)

Creates a static list from the specified dynamic list and adds the members that satisfy the dynamic list query criteria to the static list. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static CopyMembersList(OrganizationServiceContext, Guid, Guid)

Copies the members from the source list to the target list without creating duplicates. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static CopySystemForm(OrganizationServiceContext, Entity, Guid)

Creates a new entity form that is based on an existing entity form. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static CreateActivitiesList(OrganizationServiceContext, Guid, String, Entity, Guid, Boolean, Object, EntityReference, Boolean, Boolean, Guid)

Creates the activities for a list. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static CreateException(OrganizationServiceContext, Entity, DateTime, Boolean)

Creates an exception for the recurring appointment instance. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static CreateInstance(OrganizationServiceContext, Entity, Int32)

Creates future unexpanded instances of a recurring appointment master. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static CreateWorkflowFromTemplate(OrganizationServiceContext, String, Guid)

Creates a workflow from a workflow template. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static DeleteAuditData(OrganizationServiceContext, DateTime)

Deletes all partitions containing audit data created before a given end date. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static DeleteOpenInstances(OrganizationServiceContext, Entity, DateTime, Int32)

Deletes instances of a recurring appointment master that have an Open state. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static DeliverIncomingEmail(OrganizationServiceContext, String, String, String, String, String, String, DateTime, String, String, String, EntityCollection)

Creates an email activity record from an incoming email message. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static DeliverPromoteEmail(OrganizationServiceContext, Guid, String, String, String, String, String, String, DateTime, String, String, String, EntityCollection, Entity)

Creates an email activity instance from the specified email message (Track in CRM). (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static DeprovisionLanguage(OrganizationServiceContext, Int32)

Deprovisions a language. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static DisassociateEntities(OrganizationServiceContext, EntityReference, EntityReference, String)

Deprecated. Removes a link between two records in a many to many relationship. Use Disassociate. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static DistributeCampaignActivity(OrganizationServiceContext, Guid, Boolean, Entity, Guid, Object, EntityReference, Boolean, Guid)

Creates a bulk operation to distribute the activity, creating the appropriate activity for each member in the list for the specified campaign activity. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static DownloadReportDefinition(OrganizationServiceContext, Guid)

Downloads a report definition. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static ExecuteByIdSavedQuery(OrganizationServiceContext, Guid)

Executes a saved query (view) that has the specified ID. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static ExecuteByIdUserQuery(OrganizationServiceContext, EntityReference)

Executes the user query (saved view) that has the specified ID. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static ExecuteFetch(OrganizationServiceContext, String)

Deprecated. Executes the specified Fetch XML query. Use RetrieveMultiple. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static ExecuteWorkflow(OrganizationServiceContext, Guid, Guid)

Executes a workflow. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static ExpandCalendar<TResult>(OrganizationServiceContext, Guid, DateTime, DateTime)

Converts the calendar rules to an array of available time blocks for the specified period. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static ExportSolution(OrganizationServiceContext, String, Boolean, Boolean, Boolean, Boolean, Boolean, Boolean, Boolean, Boolean, Boolean, Boolean)

Exports a managed or unmanaged solution. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static ExportTranslation(OrganizationServiceContext, String)

Exports all translations for a specific solution to a compressed file. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static FetchXmlToQueryExpression(OrganizationServiceContext, String)

Converts a query in Fetch XML to a QueryExpression. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static FindParentResourceGroup(OrganizationServiceContext, Guid, Guid[])

Finds a parent resource group (scheduling group) for the specified resource groups (scheduling groups). (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static FulfillSalesOrder(OrganizationServiceContext, Entity, OptionSetValue)

Fulfills a sales order (order). (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static GenerateInvoiceFromOpportunity(OrganizationServiceContext, Guid, ColumnSet)

Generates an invoice from an opportunity. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static GenerateQuoteFromOpportunity(OrganizationServiceContext, Guid, ColumnSet)

Generates a quote from an opportunity. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static GenerateSalesOrderFromOpportunity(OrganizationServiceContext, Guid, ColumnSet)

Generates a sales order from an opportunity. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static GetAllTimeZonesWithDisplayName(OrganizationServiceContext, Int32)

Retrieves all the time-zone definitions for the specified locale returning only the display name attribute. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static GetDecryptionKey(OrganizationServiceContext)

Gets a decryption key. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static GetDistinctValuesImportFile(OrganizationServiceContext, Guid, Int32, Int32, Int32)

Returns distinct values for a column in the source file that contains list values. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static GetHeaderColumnsImportFile(OrganizationServiceContext, Guid)

Retrieves the source-file column headings, or system-generated column headings, if the source file does not contain column headings. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static GetInvoiceProductsFromOpportunity(OrganizationServiceContext, Guid, Guid)

Retrieves the products from an opportunity and copies them to the specified invoice. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static GetQuantityDecimal(OrganizationServiceContext, EntityReference, Guid, Guid)

Gets the quantity decimal value for a product. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static GetQuoteProductsFromOpportunity(OrganizationServiceContext, Guid, Guid)

Retrieves the products from an opportunity and copies them to the quote. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static GetReportHistoryLimit(OrganizationServiceContext, Guid)

Gets the history limit for a report. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static GetSalesOrderProductsFromOpportunity(OrganizationServiceContext, Guid, Guid)

Retrieves the products from an opportunity and copies them to the sales order. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static GetTimeZoneCodeByLocalizedName(OrganizationServiceContext, String, Int32)

Retrieves the time-zone code for the specified localized time-zone name. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static GetTrackingTokenEmail(OrganizationServiceContext, String)

Returns a tracking token that can be then passed in as a parameter to the SendEmail method. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static GrantAccess(OrganizationServiceContext, EntityReference, Object)

Grants a security principal (user or team) access to the specified record. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static ImportRecordsImport(OrganizationServiceContext, Guid)

Imports XML mappings and creates an import data map. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static ImportSolution(OrganizationServiceContext, Boolean, Boolean, Byte[], Guid)

Imports a managed or unmanaged solution. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static ImportTranslation(OrganizationServiceContext, Byte[], Guid)

Imports all translations from a compressed file. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static InitializeFrom(OrganizationServiceContext, EntityReference, String, Object)

Initializes a new record from an existing record. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static InstallSampleData(OrganizationServiceContext)

Installs sample data for an organization. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static InstantiateFilters(OrganizationServiceContext, EntityReferenceCollection, Guid)

Instantiates a filter. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static InstantiateTemplate(OrganizationServiceContext, Guid, String, Guid)

Creates an email message from a template. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static IsBackOfficeInstalled(OrganizationServiceContext)

Deprecated. Checks if Microsoft Great Plains is installed. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static IsComponentCustomizable(OrganizationServiceContext, Guid, Int32)

Determines whether a solution component is customizable. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static IsValidStateTransition(OrganizationServiceContext, EntityReference, String, Int32)

Checks to see if the state transition is valid. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static LocalTimeFromUtcTime(OrganizationServiceContext, Int32, DateTime)

Retrieves the local time for the specified Universal Time Coordinate (UTC) time. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static LockInvoicePricing(OrganizationServiceContext, Guid)

Locks the total price of products and services specified in the invoice. When the invoice pricing is locked, changes to underlying price lists (price levels) do not affect the prices for an invoice. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static LockSalesOrderPricing(OrganizationServiceContext, Guid)

Locks the total price of products and services specified in the sales order (order). When the sales order pricing is locked, changes to underlying price lists (price levels) do not affect the prices for a sales order (order). (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static LogFailureBulkOperation(OrganizationServiceContext, Guid, Guid, Int32, Int32, String, String)

For internal use only. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static LogSuccessBulkOperation(OrganizationServiceContext, Guid, Guid, Int32, Guid, Int32, String)

For internal use only. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static LoseOpportunity(OrganizationServiceContext, Entity, Int32)

Sets the state of an opportunity to Lost. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static LoseOpportunity(OrganizationServiceContext, Entity, OptionSetValue)

Sets the state of an opportunity to Lost. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static MakeAvailableToOrganizationReport(OrganizationServiceContext, Guid)

Deprecated. Makes the report available to all users in the organization. Use Update. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static MakeAvailableToOrganizationTemplate(OrganizationServiceContext, Guid)

Deprecated. Makes the specified email template available to the entire organization. Use Update. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static MakeUnavailableToOrganizationReport(OrganizationServiceContext, Guid)

Deprecated. Makes the report unavailable to all users in the organization. Use Update. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static MakeUnavailableToOrganizationTemplate(OrganizationServiceContext, Guid)

Deprecated. Makes the specified email template no longer available to the entire organization. Use Update. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static Merge(OrganizationServiceContext, EntityReference, Guid, Entity, Boolean)

Merges the information from two records of the same type. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static ModifyAccess(OrganizationServiceContext, EntityReference, Object)

Replaces the access rights on the target record for the specified security principal (user or team). (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static ParseImport(OrganizationServiceContext, Guid)

Submits an asynchronous job that parses all import files associated with the specified data import (import). (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static ProcessInboundEmail(OrganizationServiceContext, Guid)

Processes marketing campaign email responses. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static ProcessOneMemberBulkOperation(OrganizationServiceContext, Guid, Entity, Int32)

For internal use only. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static PropagateByExpression(OrganizationServiceContext, QueryBase, String, Boolean, Entity, Guid, Object, Boolean, EntityReference, Boolean, Guid)

Distributes an activity to a quick campaign. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static ProvisionLanguage(OrganizationServiceContext, Int32)

Provisions a language. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static PublishAllXml(OrganizationServiceContext)

Publishes all customizations. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static PublishDuplicateRule(OrganizationServiceContext, Guid)

Submits an asynchronous job to publish a duplicate rule. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static PublishXml(OrganizationServiceContext, String)

Publishes the customizations for the specified entities. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static QualifyLead(OrganizationServiceContext, EntityReference, Boolean, Boolean, Boolean, EntityReference, EntityReference, EntityReference, OptionSetValue)

Qualifies a lead and creates an account, contact, or opportunity records that are linked to the originating lead. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static QualifyMemberList(OrganizationServiceContext, Guid, Guid[], Boolean)

Qualifies the specified member list and either overrides the list members or removes them according to the specified option. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static QueryExpressionToFetchXml(OrganizationServiceContext, QueryBase)

Converts a query represented as a QueryExpression class to the equivalent query represented as FetchXML. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static QueryMultipleSchedules<TResult>(OrganizationServiceContext, Guid[], DateTime, DateTime, Object)

Searches multiple resources for an available time slot matching the specified parameters. This is similar to the QuerySchedule<TResult> method but it works for multiple resources at one time. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static QuerySchedule<TResult>(OrganizationServiceContext, Guid, DateTime, DateTime, Object)

Searches the specified resource for an available time slot matching the specified parameters. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static ReassignObjectsOwner(OrganizationServiceContext, EntityReference, EntityReference)

Reassigns all records that are owned by the security principal (user or team) to another security principal (user or team). (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static ReassignObjectsSystemUser(OrganizationServiceContext, Guid, EntityReference)

Reassigns all records that are owned by the user to another security principal (user or team). (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static Recalculate(OrganizationServiceContext, EntityReference)

Recalculates the rollup attribute values for all goals in the goal hierarchy that contain a specified goal. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static RemoveItemCampaign(OrganizationServiceContext, Guid, Guid)

Removes an item from a campaign. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static RemoveItemCampaignActivity(OrganizationServiceContext, Guid, Guid)

Removes an item from a campaign activity. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static RemoveMemberList(OrganizationServiceContext, Guid, Guid)

Removes a member from a list. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static RemoveMembersTeam(OrganizationServiceContext, Guid, Guid[])

Removes members from a team. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static RemoveParent(OrganizationServiceContext, EntityReference)

Removes the parent for a record. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static RemovePrivilegeRole(OrganizationServiceContext, Guid, Guid)

Removes a privilege from an existing role. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static RemoveProductFromKit(OrganizationServiceContext, Guid, Guid)

Removes a product from a kit. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static RemoveRelated(OrganizationServiceContext, EntityReference[])

Deprecated. Removes the relationship between two records as defined by the target classes listed below. For example, remove the relationship between an invoice and a contact. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static RemoveSolutionComponent(OrganizationServiceContext, Guid, Int32, String)

Removes a solution component to an unmanaged solution. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static RemoveSubstituteProduct(OrganizationServiceContext, Guid, Guid)

Deprecated. Removes the association between a product and a substitute product. Use Disassociate. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static RenewContract(OrganizationServiceContext, Guid, Int32, Boolean)

Renews a contract. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static ReplacePrivilegesRole(OrganizationServiceContext, Guid, Object)

Replaces the privilege set of an existing role. This effectively deletes all existing privileges from the role and adds the new specified privileges. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static Reschedule<TResult>(OrganizationServiceContext, Entity)

Reschedules an appointment, service appointment or recurring appointment. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static ResetUserFilters(OrganizationServiceContext, Int32)

Resets the offline data filters for the calling user to the default filters for the organization. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static RetrieveAbsoluteAndSiteCollectionUrl<TResponse>(OrganizationServiceContext, EntityReference)

Retrieves the absolute (complete) URL and the site collection URL of a SharePoint document location or SharePoint site. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static RetrieveAllChildUsersSystemUser(OrganizationServiceContext, Guid, ColumnSet)

Retrieves a collection of system users who report to the specified system user. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static RetrieveAllEntities(OrganizationServiceContext, EntityFilters, Boolean)

Retrieves the metadata for all entities. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static RetrieveApplicationRibbon(OrganizationServiceContext)

Retrieves the core application ribbons including the entity template. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static RetrieveAttribute(OrganizationServiceContext, String, String, Boolean)

Retrieves the metadata for the specified attribute. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static RetrieveAttributeChangeHistory<TResult>(OrganizationServiceContext, EntityReference, String, PagingInfo)

Retrieves all changes to a specific attribute. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static RetrieveAuditDetails<TResult>(OrganizationServiceContext, Guid)

Retrieves the full audit details of a particular audit record. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static RetrieveAuditPartitionList<TResult>(OrganizationServiceContext)

Retrieves the list of auditing partitions. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static RetrieveAvailableLanguages(OrganizationServiceContext)

Retrieves the list of available languages. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static RetrieveBusinessHierarchyBusinessUnit(OrganizationServiceContext, Guid, ColumnSet)

Retrieves all the business units in the business unit hierarchy. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static RetrieveByGroupResource(OrganizationServiceContext, Guid, QueryBase)

Retrieves all the resource groups to which the specified resource belongs. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static RetrieveByResourceResourceGroup(OrganizationServiceContext, Guid, QueryBase)

Retrieves the resource groups that contain the specified resource. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static RetrieveByResourcesService(OrganizationServiceContext, Guid[], QueryBase)

Retrieves a collection of services related to the specified set of services. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static RetrieveByTopIncidentProductKbArticle(OrganizationServiceContext, Guid)

Retrieves the top ten knowledge base articles for the product specified. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static RetrieveByTopIncidentSubjectKbArticle(OrganizationServiceContext, Guid)

Retrieves the top ten knowledge base articles for the subject specified. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static RetrieveDependenciesForDelete(OrganizationServiceContext, Guid, Int32)

Retrieves the dependencies for solution components that will prevent a solution component from being deleted. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static RetrieveDependenciesForUninstall(OrganizationServiceContext, String)

Retrieves the dependencies for solution components that could prevent uninstalling a managed solution. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static RetrieveDependentComponents(OrganizationServiceContext, Guid, Int32)

Retrieves all components that depend on the specified component. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static RetrieveDeploymentLicenseType(OrganizationServiceContext)

Retrieves the type of license for a deployment of Microsoft Dynamics CRM. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static RetrieveDeprovisionedLanguages(OrganizationServiceContext)

Retrieves the list of language packs installed on the server that have been disabled. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static RetrieveDuplicates(OrganizationServiceContext, Entity, String, PagingInfo)

Detects and retrieves duplicate records for the specified record, provided duplicate detection is enabled and there are published duplicate detection rules for the entity. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static RetrieveEntity(OrganizationServiceContext, String, EntityFilters, Boolean)

Retrieves the metadata for the specified entity. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static RetrieveEntityRibbon(OrganizationServiceContext, String, Object)

Retrieves the ribbon definition used for a specific entity. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static RetrieveExchangeRate(OrganizationServiceContext, Guid)

Retrieves the exchange rate. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static RetrieveFilteredForms(OrganizationServiceContext, String, OptionSetValue, Guid)

Retrieves the system forms for the specified user. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static RetrieveFormattedImportJobResults(OrganizationServiceContext, Guid)

Retrieves the formatted results from an import job. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static RetrieveFormXml<TResponse>(OrganizationServiceContext, String)

For internal use only. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static RetrieveInstalledLanguagePacks(OrganizationServiceContext)

Retrieves the list of language packs installed on the server. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static RetrieveInstalledLanguagePackVersion(OrganizationServiceContext, Int32)

Retrieves the version of an installed language pack. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static RetrieveLicenseInfo<TResponse>(OrganizationServiceContext, Int32)

Retrieves the number of licenses for a deployment of Microsoft Dynamics CRM. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static RetrieveLocLabels(OrganizationServiceContext, EntityReference, String, Boolean)

Retrieves the localized labels for the specified attribute. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static RetrieveMembersBulkOperation(OrganizationServiceContext, Guid, Int32, Int32, QueryBase)

Retrieves the members of a bulk operation. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static RetrieveMembersTeam(OrganizationServiceContext, Guid, ColumnSet)

Deprecated. Retrieves the members of a team. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static RetrieveMissingComponents<TResult>(OrganizationServiceContext, Byte[])

Retrieves a list of missing components for the target organization. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static RetrieveMissingDependencies(OrganizationServiceContext, String)

Verifies whether any solution components are not included in the solution but possibly should be for a complete solution to be exported. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static RetrieveMultiple(OrganizationServiceContext, QueryBase)

Retrieves a collection of records. The query can be specified using a query expression or a FetchXML query. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static RetrieveMultiple(OrganizationServiceContext, RetrieveMultipleRequest)

Retrieves a collection of records. The query can be specified using a query expression or a FetchXML query. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static RetrieveOrganizationResources<TResult>(OrganizationServiceContext)

Retrieves the resources used by an organization. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static RetrieveParentGroupsResourceGroup(OrganizationServiceContext, Guid, QueryBase)

Retrieves a collection of the parent resource groups of the specified resource group (scheduling group). (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static RetrieveParsedDataImportFile(OrganizationServiceContext, Guid, PagingInfo)

Retrieves the data from the parse table. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static RetrievePrincipalAccess<TResult>(OrganizationServiceContext, EntityReference, EntityReference)

Retrieves the access rights the specified security principal (user or team) has to a record. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static RetrievePrincipalAttributePrivileges(OrganizationServiceContext, EntityReference)

Retrieves all the secured attribute privileges a user or team has through direct or indirect (through team membership) associations with the FieldSecurityProfile entity. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static RetrievePrivilegeSet(OrganizationServiceContext)

Retrieves the set of privileges defined in the system. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static RetrieveProvisionedLanguagePackVersion(OrganizationServiceContext, Int32)

Retrieves the version of the language packs installed on the server. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static RetrieveProvisionedLanguages(OrganizationServiceContext)

Retrieves the list of language packs installed on the server that are enabled. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static RetrieveRecordChangeHistory<TResult>(OrganizationServiceContext, EntityReference, PagingInfo)

Retrieves all changes to a specific entity. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static RetrieveRequiredComponents(OrganizationServiceContext, Guid, Int32)

Retrieves all components that this component requires. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static RetrieveRolePrivilegesRole<TResult>(OrganizationServiceContext, Guid)

Retrieves the privileges that are assigned to the specified role. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static RetrieveSharedPrincipalsAndAccess<TResult>(OrganizationServiceContext, EntityReference)

Retrieves all the security principals (users or teams) that have access to a record, together with their access rights to the record. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static RetrieveSubGroupsResourceGroup(OrganizationServiceContext, Guid, QueryBase)

Retrieves a collection of the child resource groups of the specified resource group (scheduling group). (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static RetrieveSubsidiaryTeamsBusinessUnit(OrganizationServiceContext, Guid, ColumnSet)

Deprecated. Retrieves all the team information for child business units of the specified business unit. Use RetrieveMultiple. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static RetrieveSubsidiaryUsersBusinessUnit(OrganizationServiceContext, Guid, ColumnSet)

Deprecated. Retrieves all system users for the child business units of the specified business unit. Use RetrieveMultiple. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static RetrieveTeamPrivileges<TResult>(OrganizationServiceContext, Guid)

Retrieves the privileges for a team. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static RetrieveTeamsSystemUser(OrganizationServiceContext, Guid, ColumnSet)

Deprecated. Retrieves a collection of teams of which the specified system user is a member. Use RetrieveMultiple. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static RetrieveUnpublished(OrganizationServiceContext, EntityReference, ColumnSet)

Retrieves the current saved definition of a Web resource, organization-owned chart, or organization-owned dashboard, whether it has been published or not. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static RetrieveUnpublishedMultiple(OrganizationServiceContext, QueryBase)

Retrieves the current saved definitions of Web resources, organization-owned charts, or organization-owned dashboards, whether they have been published or not. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static RetrieveUserPrivileges<TResult>(OrganizationServiceContext, Guid)

Retrieves all the privileges a system user (user) has through his or her roles in the specified business unit. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static RetrieveUserSettingsSystemUser(OrganizationServiceContext, Guid, ColumnSet)

Deprecated. Retrieves the system user settings for the specified system user. Use RetrieveMultiple. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static RetrieveVersion(OrganizationServiceContext)

Retrieves the version number of the Microsoft Dynamics CRM server. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static ReviseQuote(OrganizationServiceContext, Guid, ColumnSet)

Sets the state of a quote to Draft. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static RevokeAccess(OrganizationServiceContext, EntityReference, EntityReference)

Removes all access to a record for the specified security principal (user or team). (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static Rollup(OrganizationServiceContext, EntityReference, QueryBase, Object)

Retrieves all the records related to the specified record (account or contact). This applies to all activity entities, annotation (note), contract, incident (case), invoice, opportunity, quote and sales order (order) entities. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static Search<TResult>(OrganizationServiceContext, Object)

Searches for available time slots that fulfill the specified appointment request. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static SearchByBodyKbArticle(OrganizationServiceContext, String, Guid, Boolean, QueryBase)

Finds all the document indexes that contain the specified text in the body. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static SearchByKeywordsKbArticle(OrganizationServiceContext, String, Guid, Boolean, QueryBase)

Finds all the document indexes that contain the specified keywords. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static SearchByTitleKbArticle(OrganizationServiceContext, String, Guid, Boolean, QueryBase)

Finds all the document indexes that contain the specified text in the title. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static SendBulkMail(OrganizationServiceContext, EntityReference, Guid, String, Guid, QueryBase)

Sends bulk email messages. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static SendEmail(OrganizationServiceContext, Guid, Boolean, String)

Sends an email message. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static SendEmailFromTemplate(OrganizationServiceContext, Guid, String, Guid, Entity)

Sends an email message using a template. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static SendFax(OrganizationServiceContext, Guid, Boolean)

Sends a fax. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static SendTemplate(OrganizationServiceContext, Guid, EntityReference, String, Guid[], String, Guid)

Sends a bulk email message that is created from a template. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static SetBusinessEquipment(OrganizationServiceContext, Guid, Guid)

Sets the business that owns the equipment. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static SetBusinessSystemUser(OrganizationServiceContext, Guid, Guid, EntityReference)

Sets the business unit for the specified system user. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static SetLocLabels(OrganizationServiceContext, EntityReference, String, LocalizedLabel[])

Sets the localized labels for the specified attribute. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static SetParentBusinessUnit(OrganizationServiceContext, Guid, Guid)

Sets the parent (manager) for the specified business unit. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static SetParentSystemUser(OrganizationServiceContext, Guid, Guid, Boolean)

Sets the parent (manager) for the specified system user. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static SetParentTeam(OrganizationServiceContext, Guid, Guid)

Sets the parent (manager) for the specified team. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static SetRelated(OrganizationServiceContext, EntityReference[])

Deprecated. Creates a link between an opportunity and an account, contact, or competitor. Use Associate. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static SetReportRelated(OrganizationServiceContext, Guid, Int32[], Int32[], Int32[])

Specifies in which areas of Microsoft Dynamics CRM the report can be run and viewed. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static SetState(OrganizationServiceContext, EntityReference, OptionSetValue, OptionSetValue)

Sets the state of a record. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static SetState(OrganizationServiceContext, Int32, Int32, Entity)

Sets the state of a record. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static SetState(OrganizationServiceContext, Int32, Int32, EntityReference)

Sets the state of a record. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static StatusUpdateBulkOperation(OrganizationServiceContext, Guid, Int32, Int32)

For internal use only. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static TransformImport(OrganizationServiceContext, Guid)

Submits an asynchronous job to transform the parsed data. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static TriggerServiceEndpointCheck(OrganizationServiceContext, EntityReference)

Validates the configuration of a Windows Azure platform AppFabric solution’s service endpoint. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static UninstallSampleData(OrganizationServiceContext)

Uninstalls sample data for an organization. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static UnlockInvoicePricing(OrganizationServiceContext, Guid)

Unlocks the price per unit for the products in the specified invoice. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static UnlockSalesOrderPricing(OrganizationServiceContext, Guid)

Unlocks the price per unit for the products in the specified sales order (order). (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static UnpublishDuplicateRule(OrganizationServiceContext, Guid)

Unpublishes a duplicate rule. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static UpdateUserSettingsSystemUser(OrganizationServiceContext, Guid, Entity)

Deprecated. Updates the user settings for a system user. Use Update. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static UtcTimeFromLocalTime(OrganizationServiceContext, Int32, DateTime)

Retrieves the UTC time for the specified local time. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static Validate<TResult>(OrganizationServiceContext, EntityCollection)

Validates that all the constraints of an appointment or service appointment are met. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static ValidateRecurrenceRule(OrganizationServiceContext, Entity)

Validates a recurrence rule for a recurring appointment. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static ValidateSavedQuery(OrganizationServiceContext, String, Int32)

Validates a saved query. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static VerifyProcessStateData(OrganizationServiceContext, EntityReference, String)

For internal use only. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static WhoAmI<TResponse>(OrganizationServiceContext)

Retrieves the user information for the logged on user. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static WinOpportunity(OrganizationServiceContext, Entity, Int32)

Changes the state of an opportunity to Won. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static WinOpportunity(OrganizationServiceContext, Entity, OptionSetValue)

Changes the state of an opportunity to Won. (Developer Extensions)

System_CAPS_pubmethodSystem_CAPS_static WinQuote(OrganizationServiceContext, Entity, OptionSetValue)

Changes the state of a quote to Won. (Developer Extensions)

Remarks

Extensions for the core OrganizationServiceContext class.

Thread Safety

Any public static ( Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

See Also

Microsoft.Xrm.Client.Messages Namespace
Developer extensions for Microsoft Dynamics CRM 2013

Return to top