• Introduction
  • Web Service API
  • Callback service

    Show / Hide Table of Contents
    • Overview
    • Concepts
      • API functionality
      • Web Service technology
      • Security
      • Accessing the services
      • Error reporting
      • Synchronous and asynchronous API
      • Testing
      • Telemetry
    • Translation memory API
      • Overview
      • ITMService
      • Lookup, concordance
      • Import, export
      • API
        • ConcordanceRequest
        • GenericFault
        • HeavyResourceInfo
        • HeavyResourceUpdateInfo
        • ImportTMMetadataSchemeResultInfo
        • InlineTagStrictness
        • InvalidSessionIdFault
        • ITMService
        • LookupSegmentRequest
        • NoLicenseFault
        • RequestXmlFormatFault
        • ResourceInfo
        • ResourceListFilter
        • ResourceUpdateInfo
        • ResultInfo
        • TMEngineType
        • TMFault
        • TMInfo
        • TMListFilter
        • TMOptimizationPreference
        • TMUpdateInfo
        • TmxImportResult
        • TmxImportSettings
        • UnauthorizedAccessFault
        • UnexpectedFault
    • Term bases API
      • Overview
      • ITBService
      • Import, export
        • CSV
        • TBX
        • MultiTerm
      • API
        • CreateQTermTBFromTBXSettings
        • CreateQTermTBFromTBXTaskResult
        • CSVExportSettings
        • CSVExportTaskResult
        • CSVImportIntoExistingSettings
        • CSVImportIntoExistingTaskResult
        • CSVImportResult
        • CSVImportSettings
        • GenericFault
        • HeavyResourceInfo
        • HeavyResourceUpdateInfo
        • ITasksService
        • ITBService
        • QTermTBImportSettings
        • ResourceInfo
        • ResourceListFilter
        • ResourceUpdateInfo
        • ResultInfo
        • TaskDoesNotExistFault
        • TaskInfo
        • TaskNotFinishedFault
        • TaskResult
        • TaskStatus
        • TBCaseSensitivity
        • TBCloneInfo
        • TBFilter
        • TBFilterLangMode
        • TBInfo
        • TBMatching
        • TBNewTermDefaultForLanguage
        • TBUpdateInfo
        • TBXExportOptions
        • TBXExportTaskResult
        • TBXImportIntoExistingSettings
        • TBXImportResults
        • TBXImportSettings
        • TBXImportTaskResult
        • UnexpectedFault
    • LiveDocs API
      • Overview
      • ILiveDocsService
      • Alignment
      • API
        • AlignmentOptions
        • AlignmentResultInfo
        • CorpusIndexingOptions
        • CorpusIndexingSchedule
        • CorpusInfo
        • CorpusListFilter
        • CorpusUpdateInfo
        • DocumentForAlignment
        • GenericFault
        • HeavyResourceInfo
        • HeavyResourceUpdateInfo
        • ILiveDocsService
        • ImportBinaryFileIntoLiveDocsOptions
        • ImportFileIntoLiveDocsOptions
        • ImportFileIntoLiveDocsResultInfo
        • ImportLiveDocsXliffFileIntoLiveDocsOptions
        • ImportMonoOrBilingualFileIntoLiveDocsOptions
        • ResourceInfo
        • ResourceListFilter
        • ResourceUpdateInfo
        • ResultInfo
        • ResultStatus
        • UnexpectedFault
    • Light resources API
      • Overview
      • IResourceService
      • API
        • ExpectedFault
        • FilterConfigResourceInfo
        • FilterNames
        • GenericFault
        • IResourceService
        • LightResourceInfo
        • LightResourceInfoWithLang
        • LightResourceListFilter
        • PathRuleResourceInfo
        • PathRuleType
        • ProjectTemplateResourceInfo
        • ResourceInfo
        • ResourceType
        • ResourceUpdateInfo
        • UnexpectedFault
    • Server project API
      • Overview
      • User assignment
      • Omniscien Technologies services
      • IServerProjectService
      • API
        • AddProjectLanguageFault
        • AddProjectLanguageTBHandlingBehavior
        • AnalysisAsCSVResult
        • AnalysisAsCSVResultForLang
        • AnalysisOptions
        • AnalysisReportCounts
        • AnalysisReportForDocument
        • AnalysisReportInfo
        • AnalysisReportItem
        • AnalysisResultForLang
        • AnalysisResultInfo
        • AsiaOnlineBeginTranslationResultInfo
        • AsiaOnlineDomainCombination
        • AsiaOnlineGetDomainCombinationsResultInfo
        • AsiaOnlineGetLanguagePairCodeResultInfo
        • AsiaOnlineGetProjectIdsResultInfo
        • AsiaOnlineTranslateOptions
        • AsiaOnlineTranslationResultInfo
        • AsiaOnlineTranslationStatus
        • AssignmentChangeHistoryItemInfo
        • AutomatedActionStartedHistoryItemInfo
        • AutomatedActionStartedHistoryItemInfo.AutomatedActionTypes
        • AutoSplitJoinSettings
        • BilingualDocFormat
        • CannotStartOperationFault
        • ConfirmAndUpdateDocError
        • ConfirmAndUpdateOptions
        • ConfirmAndUpdateResultInfo
        • ConfirmAndUpdateSegmentStatuses
        • ConfirmAndUpdateTaskResult
        • ConfirmAndUpdateTMBehaviors
        • ConfirmAndUpdateUserNameBehaviors
        • CorpusLanguagePair
        • CreateDeliveryResult
        • CreateStatisticsOnDocumentsRequest
        • CreateStatisticsOnProjectRequest
        • CreateStatisticsRequestBase
        • CustomPreTranslateParameter
        • DeadlineChangeHistoryItemInfo
        • DeliverDocumentFault
        • DeliverDocumentRequest
        • DistanceMeasurementMode
        • DocDeliveryResult
        • DocDeliveryResultInfo
        • DocumentBilingualImportHistoryItemInfo
        • DocumentDeliverHistoryItemInfo
        • DocumentExportOptions
        • DocumentHistoryItemInfo
        • DocumentHistoryItemType
        • DocumentHistoryRequest
        • DocumentImportHistoryItemInfo
        • DocumentReturnHistoryItemInfo
        • DocumentRowsLockedHistoryItemInfo
        • DocumentRowsLockedHistoryItemInfo.LockModes
        • DocumentSlicingHistoryItemInfo
        • DocumentSnapshotCreatedHistoryItemInfo
        • DocumentStatus
        • DocumentXTranslationHistoryItemInfo
        • EditDistanceCsvResult
        • EditDistanceReportInfo
        • EditDistanceStatisticsOptions
        • ExpectedFinalStateAfterXTranslate
        • ExpectedSourceStateBeforeXTranslate
        • FileResultInfo
        • FirstAcceptAcceptHistoryItemInfo
        • FirstAcceptAssignHistoryItemInfo
        • FirstAcceptDeclineHistoryItemInfo
        • FirstAcceptFailedHistoryItemInfo
        • FirstAcceptStatus
        • FirstAcceptUserDecision
        • FragmentAssemblySettings
        • FuzzyEditDistanceReport
        • FuzzyEditDistanceResult
        • FuzzyEditDistanceResultForDocument
        • FuzzyEditDistanceResultForLang
        • FuzzyEditDistanceTaskResult
        • GenericFault
        • GroupSourcingAssignHistoryItemInfo
        • GroupSourcingDocumentDeliverHistoryItemInfo
        • ImportImageLocalizationPackResultInfo
        • ImportTranslationDocumentOptions
        • IServerProjectService
        • LevenshteinEditDistanceReport
        • LevenshteinEditDistanceResult
        • LevenshteinEditDistanceResultForDocument
        • LevenshteinEditDistanceResultForLang
        • LevenshteinEditDistanceTaskResult
        • ListServerProjectTranslationDocument2Options
        • ListServerProjectTranslationDocumentSliceOptions
        • ListTranslationDocumentAssignmentsOptions
        • MatchCoverageType
        • NewRevisionScenarioOptions
        • PackageContentDocument
        • PackageContentInfo
        • PackageCreationNotAllowedFault
        • PackageDeliveryOptions
        • PackageDeliveryResult
        • PackageDeliveryResultInfo
        • PackageImportOptions
        • PackageInfo
        • PostTransAnalysisReportForDocument
        • PostTransAnalysisReportForUser
        • PostTransAnalysisReportItem
        • PostTranslationAnalysisAsCSVResult
        • PostTranslationAnalysisAsCSVResultForLang
        • PostTranslationAnalysisOptions
        • PostTranslationAnalysisReportInfo
        • PostTranslationAnalysisResultInfo
        • PostTranslationAnalysisTaskResult
        • PostTranslationReportCounts
        • PostTranslationResultForLang
        • PreparePackageResultInfo
        • PreTransFilter
        • PretranslateCopySourceToTargetBehavior
        • PretranslateCopySourceToTargetConditions
        • PretranslateExpectedFinalTranslationState
        • PretranslateLookupBehavior
        • PretranslateOptions
        • PreTranslateProblem
        • PretranslateStateToConfirmAndLock
        • PreTranslateTaskResult
        • PreviewCreation
        • ProjectLaunchedHistoryItemInfo
        • QAReport
        • QAReportForDocument
        • QAReportTypes
        • ReconsolidateDocumentFault
        • ReimportDocumentOptions
        • RenameProjectFault
        • ResultInfo
        • ResultStatus
        • RtfBilingualExportOptions
        • RunQAGetReportOptions
        • RunQATaskResult
        • ServerProjectAddLanguageInfo
        • ServerProjectCommunicationSettings
        • ServerProjectConfidentialitySettings
        • ServerProjectCorporaAssignments
        • ServerProjectCreateInfo
        • ServerProjectDesktopDocsCreateInfo
        • ServerProjectInfo
        • ServerProjectListFilter
        • ServerProjectNotificationSettings
        • ServerProjectPackageResourceHandlingOptions
        • ServerProjectResourceAssignment
        • ServerProjectResourceAssignmentDetails
        • ServerProjectResourceAssignmentForResourceType
        • ServerProjectResourcesInPackages
        • ServerProjectRoles
        • ServerProjectStatus
        • ServerProjectTBAssignments
        • ServerProjectTBsForTargetLang
        • ServerProjectTMAssignmentDetails
        • ServerProjectTMAssignmentsForTargetLang
        • ServerProjectTranslationDocBasicInfo
        • ServerProjectTranslationDocInfo
        • ServerProjectTranslationDocInfo2
        • ServerProjectTranslationDocSliceInfo
        • ServerProjectTranslationDocumentsDifferentLanguageTranslations
        • ServerProjectTranslationDocumentsFromSameSourceFile
        • ServerProjectTranslationDocumentUserAssignments
        • ServerProjectTranslationDocumentWorkflowStatusChange
        • ServerProjectUpdateInfo
        • ServerProjectUserInfo
        • ServerProjectUserInfoHeader
        • SetDocumentWorkflowStatusFault
        • SetTranslationDocumentAssignmentsOptions
        • SliceDocumentFault
        • SliceDocumentRequest
        • SlicingMeasurementUnit
        • StatisticsAlgorithm
        • StatisticsOptions
        • StatisticsResultForLang
        • StatisticsResultFormat
        • StatisticsResultInfo
        • StatisticsTaskResult
        • SubvendorAssignDeadlineChangeHistoryItemInfo
        • SubvendorAssignHistoryItemInfo
        • TemplateBasedProjectCreateInfo
        • TemplateBasedProjectCreationFault
        • TemplateBasedProjectCreationInvalidMetaFault
        • TemplateBasedProjectCreationResultInfo
        • TMLanguagePair
        • TranslationDocExportResultInfo
        • TranslationDocImportResultInfo
        • TranslationDocumentAssigneeInfo
        • TranslationDocumentAssignmentFault
        • TranslationDocumentAssignmentInfo
        • TranslationDocumentAssignmentResultInfo
        • TranslationDocumentAssignments
        • TranslationDocumentAssignmentType
        • TranslationDocumentDetailedAssignmentInfo
        • TranslationDocumentDetailedAssignments
        • TranslationDocumentDetailedFirstAcceptAssignmentInfo
        • TranslationDocumentDetailedGroupSourcingAssignmentInfo
        • TranslationDocumentDetailedRoleAssignmentInfo
        • TranslationDocumentDetailedSingleUserAssignmentInfo
        • TranslationDocumentDetailedSubvendorAssignmentInfo
        • TranslationDocumentFirstAcceptAssignmentInfo
        • TranslationDocumentFirstAcceptUserInfo
        • TranslationDocumentGroupSourcingAssignmentInfo
        • TranslationDocumentGroupSourcingUserInfo
        • TranslationDocumentNoUserAssignmentInfo
        • TranslationDocumentRoleAssignmentInfo
        • TranslationDocumentRoleAssignmentResultInfo
        • TranslationDocumentSingleUserAssignmentInfo
        • TranslationDocumentSubvendorAssignmentInfo
        • TranslationDocumentUserRoleAssignment
        • TranslationDocumentUserRoleAssignmentDetails
        • TurnOffAutoPilotFault
        • TwoColumnRtfBilingualExportOptions
        • UnexpectedFault
        • UpdateWithTableRtfOptions
        • UserInfoHeader
        • WordCountMode
        • WorkflowStatus
        • WorkflowStatusChangeHistoryItemInfo
        • WorkingTMsDeletedHistoryItemInfo
        • WrapUpProjectFault
        • XliffBilingualExportOptions
        • XTranslateDocInfo
        • XTranslateDocumentResult
        • XTranslateOptions
        • XTranslateResultInfo
        • XTranslateScenario
        • XTranslateTaskResult
    • Security API
      • Overview
      • Users, groups, permissions
      • Session management
      • ISecurityService
      • API
        • GenericFault
        • GroupInfo
        • ISecurityService
        • ObjectPermission
        • UnexpectedFault
        • UserInfo
        • UserPackageWorkflowType
        • WeakPasswordFault
    • File upload/download API
      • Overview
      • IFileManagerService
      • API
        • GenericFault
        • IFileManagerService
        • UnexpectedFault
    • License (ELM) API
      • Overview
      • IELMService
      • API
        • ELMAssignment
        • ELMAssignmentType
        • ELMFault
        • ELMPermission
        • ELMPoolInfo
        • ELMProduct
        • ELMProjectPermission
        • GenericFault
        • IELMService
        • UnexpectedFault
    • Tasks API
      • Overview
      • ITasksService
      • API
        • GenericFault
        • ITasksService
        • TaskDoesNotExistFault
        • TaskInfo
        • TaskNotFinishedFault
        • TaskResult
        • TaskStatus
        • UnexpectedFault
    • Changelog

    Interface IResourceService

    This interface has operations for light resource management.

    Syntax
    public interface IResourceService

    Methods

    CloneAndPublish(ResourceType, LightResourceInfo)

    Creates a clone of an existing resource. The newly created resource will have the same data as the original one, but the properties (name, description, etc.) will be as defined by the resourceInfo parameter.

    Declaration
    Guid CloneAndPublish(ResourceType resourceType, LightResourceInfo resourceInfo)
    Parameters
    Type Name Description
    ResourceType resourceType

    The type of the resource to be cloned.

    LightResourceInfo resourceInfo

    The parameters of the resource to be created.

    • The Guid member identifies the resource to be cloned.
    • The IsDefault member is ignored.
    • For all resource types class LightResourceInfo can be used directly. As an alternative, the LightResourceInfo derived class belonging to the specific resource type (as defined by the "Described by class" section of the documentation of the appropriate "ResourceType" enum member) can also be used. However, in this latter case the RuleType for PathRule, and FilterName for FilterConfig resources can not be changed (these are ignored). For language dependent resources (e.g. SegRules) ResourceInfoWithLang can be used, and the resource can be cloned to a different language. One way to keep the original language is to use null as the language code.
    Returns
    Type Description
    Guid

    The Guid of the newly created resource.

    Exceptions
    Type Condition
    UnexpectedFault

    An unexpected error occurred; equivalent of an 501 'Internal server error' http result.

    GenericFault

    The details within the fault identify the specific error. Thrown for expected business error that have no specific faults.

    CreateAndPublish(ResourceType, LightResourceInfo)

    Creates a new resource with the parameters specified by the resourceInfo parameter. FilterConfig resources can not be created this way, use ImportNewAndPublish instead to create them.

    Declaration
    Guid CreateAndPublish(ResourceType resourceType, LightResourceInfo resourceInfo)
    Parameters
    Type Name Description
    ResourceType resourceType

    The type of the resource to be created.

    LightResourceInfo resourceInfo

    The parameters of the resource to be created. The Guid and IsDefault members of the resourceInfo parameter are ignored. To find out exactly which LightResourceInfo derived class is to be used here for a resource type, see the "Described by class" section of the documentation of the appropriate "ResourceType" enum member (e.g.ResourceInfoWithLang for SegRules).

    Returns
    Type Description
    Guid

    The Guid of the newly created resource.

    Exceptions
    Type Condition
    UnexpectedFault

    An unexpected error occurred; equivalent of an 501 'Internal server error' http result.

    GenericFault

    The details within the fault identify the specific error. Thrown for expected business error that have no specific faults.

    DeleteResource(ResourceType, Guid)

    Deletes a resource. If the resource is readonly, an exception is thrown.

    Declaration
    void DeleteResource(ResourceType resourceType, Guid resourceGuid)
    Parameters
    Type Name Description
    ResourceType resourceType

    The type of the resource.

    Guid resourceGuid

    The guid of the resource to be deleted.

    Exceptions
    Type Condition
    UnexpectedFault

    An unexpected error occurred; equivalent of an 501 'Internal server error' http result.

    GenericFault

    The details within the fault identify the specific error. Thrown for expected business error that have no specific faults.

    ExportResource(ResourceType, Guid)

    Exports the resource to a file. The format of the file is the same as used by memoQ import/export for the specific resource type.

    Declaration
    Guid ExportResource(ResourceType resourceType, Guid resourceGuid)
    Parameters
    Type Name Description
    ResourceType resourceType

    The type of the resource.

    Guid resourceGuid

    The guid of the resource.

    Returns
    Type Description
    Guid

    The guid of the resulting file of the operation. Can be dowloaded using FileManagerService.

    Exceptions
    Type Condition
    UnexpectedFault

    An unexpected error occurred; equivalent of an 501 'Internal server error' http result.

    GenericFault

    The details within the fault identify the specific error. Thrown for expected business error that have no specific faults.

    GetResourceInfo(ResourceType, Guid)

    Gets information about the specified resource.

    Declaration
    LightResourceInfo GetResourceInfo(ResourceType resourceType, Guid resourceGuid)
    Parameters
    Type Name Description
    ResourceType resourceType

    The type of the resource.

    Guid resourceGuid

    The guid of the resource.

    Returns
    Type Description
    LightResourceInfo

    The LightResourceInfo (or derived object, depending the type of the resource) object describing the resource. To find out exactly which derived class is returned here for a resource type, see the "Described by class" section of the documentation of the appropriate "ResourceType" enum member (e.g.ResourceInfoWithLang for SegRules).

    Exceptions
    Type Condition
    UnexpectedFault

    An unexpected error occurred; equivalent of an 501 'Internal server error' http result.

    GenericFault

    The details within the fault identify the specific error. Thrown for expected business error that have no specific faults.

    ImportNewAndPublish(ResourceType, Guid, LightResourceInfo)

    Creates a new resource and imports data from the specified file into it. Certain properties of the new resource are taken from the resourceInfo parameter, while others are taken from the header of the import file and can not be changed. The Name, Description and IsReadonly is taken from the resourceInfo parameter. For other rules see documentation for the resourceInfo parameter below.

    Declaration
    Guid ImportNewAndPublish(ResourceType resourceType, Guid fileGuid, LightResourceInfo resourceInfo)
    Parameters
    Type Name Description
    ResourceType resourceType

    The type of the resource to be newly imported.

    Guid fileGuid
    LightResourceInfo resourceInfo

    The properties of the resource to be created.

    • The IsDefault and Guid members of the resourceInfo parameter are ignored.
    • For all resource types class LightResourceInfo can be used directly. As an alternative, the LightResourceInfo derived class belonging to the specific resource type (as defined by the "Described by class" section of the documentation of the appropriate "ResourceType" enum member) can also be used. However, in this latter case the following properties can not be changed (are taken from the header of the import file):
    • LanguageCode for langauge dependent resources (can be null)
    • RuleType for PathRule resources
    • FilterName for FilterConfig resources (can be null)
    Returns
    Type Description
    Guid

    The Guid of the newly imported resource. Although the header of the import file contains a guid, it is ignored, and a new guid is assigned.

    Exceptions
    Type Condition
    UnexpectedFault

    An unexpected error occurred; equivalent of an 501 'Internal server error' http result.

    GenericFault

    The details within the fault identify the specific error. Thrown for expected business error that have no specific faults.

    ListResources(ResourceType, LightResourceListFilter)

    Returns the list of the light resources available on the server.

    Declaration
    LightResourceInfo[] ListResources(ResourceType resourceType, LightResourceListFilter filter = null)
    Parameters
    Type Name Description
    ResourceType resourceType

    The type of the resource to be listed.

    LightResourceListFilter filter

    Optional filtering to apply. Default null value means no filtering other they resource type.

    Returns
    Type Description
    LightResourceInfo[]

    An array of LightResourceInfo (or derived, depending the type of the resource) objects is returned. To find out exactly which derived class is returned here for a resource type, see the "Described by class" section of the documentation of the appropriate "ResourceType" enum member (e.g.ResourceInfoWithLang for SegRules).

    Exceptions
    Type Condition
    UnexpectedFault

    An unexpected error occurred; equivalent of an 501 'Internal server error' http result.

    GenericFault

    The details within the fault identify the specific error. Thrown for expected business error that have no specific faults.

    UpdateResourceProperties(ResourceType, LightResourceInfo)

    Updates the properties of a resource.

    Declaration
    void UpdateResourceProperties(ResourceType resourceType, LightResourceInfo resourceInfo)
    Parameters
    Type Name Description
    ResourceType resourceType

    The type of the resource to update.

    LightResourceInfo resourceInfo

    The new properties of the resource.

    • The Guid member identifies the resource to be updated.
    • The IsDefault member is ignored.
    • For read only resources (for which the Readonly property is true) only the Readonly property can be changed.
    • Changing the Name property renames the resource.
    • For all resource types class LightResourceInfo can be used directly. As an alternative, the LightResourceInfo derived class belonging to the specific resource type (as defined by the "Described by class" section of the documentation of the appropriate "ResourceType" enum member) can also be used. However, in this latter case the following properties can not be changed (these are ignored):
    • LanguageCode for langauge dependent resources (can be null)
    • RuleType for PathRule resources
    • FilterName for FilterConfig resources (can be null)
    Exceptions
    Type Condition
    UnexpectedFault

    An unexpected error occurred; equivalent of an 501 'Internal server error' http result.

    GenericFault

    The details within the fault identify the specific error. Thrown for expected business error that have no specific faults.

    Back to top memoQ Server API documentation