Manage Related Document Files

ManageRelatedDocumentFiles

This service adds, updates, and deletes one or more Related Document files within specified folders for a specific opportunity.

Input Parameters

This service requires the following request parameter(s):

Input Parameter Description Required/Optional Business Rules Web Service Schema
OpportunityID Opportunity ID Required
  • Certificate must have Manage Synopses, Manage Forecasts, or Manage Packages role
  • At least one of the following actions must be specified: Add File, Replace File, or Remove File
  • Opportunity ID must belong to Agency associated with the certificate (or any of its Sub-Agencies if certificate has Manage Agencies role)
  • Opportunity must have a Synopsis, Forecast or Package to have Related Documents
  • Attachment file cannot contain viruses
GrantsCommonElements: OpportunityID
ModificationComments Modification Comments Optional
  • If modification comments are specified, Opportunity will be included in the nightly email notification
GrantsCommonElements: ModificationComments
AddFile Add File Optional (Multiple occurrences allowed)
  • File Name must be unique within a folder
  • File Description must be unique within a folder
  • Folder ID must belong to specified Opportunity ID
GrantsRelatedDocument_V1.0: AddFile
ReplaceFile Replace File Optional (Multiple occurrences allowed)
  • File Name must be unique within a folder
  • File Description must be unique within a folder
  • File ID must belong to specified Opportunity ID
  • File and File Name must be provided if either is provided
GrantsRelatedDocument_V1.0: ReplaceFile
RemoveFile Remove File Optional (Multiple occurrences allowed)
  • File ID must belong to specified Opportunity ID
GrantsRelatedDocument_V1.0: RemoveFile

Return Values

This service returns a collection of objects containing the following details:

Return Value Comment / Example Required/Optional Web Service Schema
CompletionStatus Success, Partial, Fail Required GrantsCommonElements: CompletionStatus
ErrorDetails   Optional GrantsCommonElements: ErrorDetails
AddFileResult   Optional (May have multiple occurrences) GrantsRelatedDocument_V1.0: AddFileResult
ReplaceFileResult   Optional (May have multiple occurrences) GrantsRelatedDocument_V1.0: ReplaceFileResult
RemoveFileResult   Optional (May have multiple occurrences) GrantsRelatedDocument_V1.0: RemoveFileResult