Get all document types

get

/hcmRestApi/resources/11.13.18.05/hrDocumentTypes

Request

Query Parameters
  • When this parameter is provided, the specified children are included in the resource payload (instead of just a link). The value of this query parameter is "all" or "". More than one child can be specified using comma as a separator. Example: ?expand=Employees,Localizations. Nested children can also be provided following the format "Child.NestedChild" (Example: ?expand=Employees.Managers). If a nested child is provided (Example: Employees.Managers), the missing children will be processed implicitly. For example, "?expand=Employees.Managers" is the same as "?expand=Employees,Employees.Managers" (which will expand Employees and Managers).
  • This parameter filters the resource fields. Only the specified fields are returned, which means that if no fields are specified, no fields are returned (useful to get only the links). If an indirect child resource is provided (Example: Employees.Managers), the missing children will be processed implicitly. For example, "?fields=Employees.Managers:Empname" is the same as "?fields=;Employees:;Employees.Managers:Empname" (which will only return the "Empname" field for Managers). the value of this query parameter is a list of resource fields. The attribute can be a direct (Example: Employees) or indirect (Example: Employees.Managers) child. It cannot be combined with expand query parameter. If both are provided, only fields will be considered.

    Format: ?fields=Attribute1,Attribute2

    Format for fields in child resource: ?fields=Accessor1:Attribute1,Attribute2
  • Used as a predefined finder to search the collection.

    Format ?finder=<finderName>;<variableName>=<variableValue>,<variableName2>=<variableValue2>

    The following are the available finder names and corresponding finder variables

    • PrimaryKey Finds all the document types that match the specified primary key criteria.
      Finder Variables
      • DocumentTypeId; integer; Unique identifier of the document type.
    • findByDocumentType Finds all the document types that match the specified criteria.
      Finder Variables
      • DocumentType; string; Filter attribute to retrieve document types based on document type.
      • LegislationCode; string; Filter attribute to retrieve document types based on legislation code.
  • This parameter restricts the number of resources returned inside the resource collection. If the limit exceeds the resource count then the framework will only return the available resources.
  • This parameter can be used to show only certain links while accessing a singular resource or a resource collection. The parameter value format is a comma-separated list of : <link_relation>

    Example:
    self,canonical
  • Used to define the starting position of the resource collection. If offset exceeds the resource count then no resources are returned. Default value is 0.
  • The resource item payload will be filtered in order to contain only data (no links section, for example).
  • This parameter orders a resource collection based on the specified fields. The parameter value is a comma-separated string of attribute names, each optionally followed by a colon and "asc" or "desc". Specify "asc" for ascending and "desc" for descending. The default value is "asc". For example, ?orderBy=field1:asc,field2:desc
  • This query parameter defines the where clause. The resource collection will be queried using the provided expressions. The value of this query parameter is one or more expressions. Example: ?q=Deptno>=10 and <= 30;Loc!=NY

    Format: ?q=expression1;expression2

    You can use these queryable attributes to filter this collection resource using the q query parameter:
    • ActiveInactiveFlag; boolean; Indicates whether the document type is active. The default value is Yes.
    • ArchiveCriteriaBasis; string; Criteria for archiving document records based on the document type.
    • ArchiveCriteriaDays; integer; Number of days after which document records are archived based on the document type.
    • AuthorizationRequiredFlag; boolean; Indicates whether approval is required for the document type. The default value is No.
    • BiReportPath; string; URL or path where the report is available.
    • CategoryCode; string; Category of the document type.
    • CommentsLabel; string; Label for the field that the user defines for the issuing comments.
    • CommentsRequired; string; Indicates whether comments are relevant (Y) or required (R) or not relevant (N). The default value is relevant (Y).
    • CreatedBy; string; Name of the user who created the document type.
    • CreationDate; string; Date on which the document type was created.
    • DateFromLabel; string; Label for the field that the user defines for the from date.
    • DateFromRequired; string; Indicates whether date from is relevant (Y) or required (R) or not relevant (N). The default value is relevant (Y).
    • DateToLabel; string; Label for the field that the user defines for the to date.
    • DateToRequired; string; Indicates whether date to is relevant (Y) or required (R) or not relevant (N). The default value is relevant (Y).
    • Description; string; Description for the document type.
    • DffCtxSegDefaultValue; string; Default value for the document records flexfield context segment.
    • DffCtxSegDisplayPreference; string; Display preference for the document records flexfield context segment.
    • DffGlbSegDisplayPreference; string; Display preference for the document records flexfield global segment.
    • DocumentNameLabel; string; Label for the field that the user defines for the document name.
    • DocumentNameRequired; string; Indicates whether document name is relevant (Y) or required (R) or not relevant (N). The default setting is relevant (Y).
    • DocumentNumberLabel; string; Label for the field that the user defines for the document number.
    • DocumentNumberRequired; string; Indicates whether document number is relevant (Y) or required (R) or not relevant (N). The default value is relevant (Y).
    • DocumentType; string; Unique name to identify the document type.
    • DocumentTypeId; integer; Surrogate ID for the document type which is available only when updating existing records.
    • DocumentTypeLevel; string; Indicates whether the document type applies to a person or an individual assignment. The default value is Person.
    • HierarchyCode; string; Hierarchy code to support delivery preferences on this document type.
    • IssuedDateLabel; string; Label for the field that the user defines for the issued date.
    • IssuedDateRequired; string; Indicates whether issued date is relevant (Y) or required (R) or not relevant (N). The default value is relevant (Y).
    • IssuingAuthorityLabel; string; Label for the field that the user defines for the issuing authority.
    • IssuingAuthorityRequired; string; Indicates whether issuing authority is relevant (Y) or required (R) or not relevant (N). The default value is relevant (Y).
    • IssuingCountryLabel; string; Label for the field that the user defines for the issuing country.
    • IssuingCountryRequired; string; Indicates whether issuing country is relevant (Y) or required (R) or not relevant (N). The default value is relevant (Y).
    • IssuingLocationLabel; string; Label for the field that the user defines for the issuing location.
    • IssuingLocationRequired; string; Indicates whether issuing location is relevant (Y) or required (R) or not relevant (N). The default value is relevant (Y).
    • LastUpdateDate; string; Date the document type was last updated.
    • LastUpdatedBy; string; User who last updated the document type.
    • LegislationCode; string; Legislation code if this is a legislation specific document type.
    • LockCreateFlag; boolean; Indicates whether it restricts or allows creating document records of this document type. The default value is No
    • LockCreateRoleList; string; List of roles that can create document records based on the document type.
    • LockDeleteFlag; boolean; Indicates whether it restricts or allows deleting document records of this document type. The default value is No.
    • LockDeleteRoleList; string; List of roles allowed to delete document records based on the document type.
    • LockUpdateFlag; boolean; Indicates whether it restricts or allows updating document records of this document type. The default value is No.
    • LockUpdateRoleList; string; List of roles allowed to update document records based on the document type.
    • MinimumAttachmentsCount; integer; Minimum number of attachments that a user must attach for a specific document type.
    • MultipleOccurencesFlag; boolean; Indicates whether multiple occurrences of this document type are allowed. The default value is Yes.
    • PublishRequiredFlag; boolean; Indicates whether document records of this document type must be published. The default value is No.
    • PurgeArchiveCriteriaDays; integer; Number of days after which archived document records will be purged.
    • SubCategoryCode; string; Code of the subcategory for the document type.
    • SystemDocumentType; string; System-generated name that uniquely identifies the document type.
    • TagList; string; Lookup code of the tag used for the document type derived from the lookup ORA_PER_DOC_TYPE_TAGS.
    • WarningPeriod; integer; Number of days in advance to generate an alert when a document record based on this document type is about to expire.
  • The resource collection representation will include the "estimated row count" when "?totalResults=true", otherwise the count is not included. The default value is "false".
Header Parameters
  • If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
  • The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.

There's no request body for this operation.

Back to Top

Response

Supported Media Types

Default Response

The following table describes the default response for this task.
Headers
  • If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
  • The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.
Body ()
Root Schema : hrDocumentTypes
Type: object
Show Source
Nested Schema : Items
Type: array
Title: Items
The items in the collection.
Show Source
Nested Schema : hrDocumentTypes-item-response
Type: object
Show Source
  • Title: Active
    Maximum Length: 30
    Default Value: true
    Indicates whether the document type is active. The default value is Yes.
  • Title: Archive Criteria Basis
    Maximum Length: 30
    Criteria for archiving document records based on the document type.
  • Title: Archive After Days
    Number of days after which document records are archived based on the document type.
  • Attachments
    Title: Attachments
    The attachments resource is used to view, create, and update attachments.
  • Title: Approval Required
    Maximum Length: 1
    Default Value: false
    Indicates whether approval is required for the document type. The default value is No.
  • Title: Report Path
    Maximum Length: 2000
    URL or path where the report is available.
  • Title: Category
    Maximum Length: 30
    Category of the document type.
  • Title: New Label for Issuing Comments
    Maximum Length: 200
    Label for the field that the user defines for the issuing comments.
  • Title: Issuing Comments Applicable
    Maximum Length: 30
    Default Value: Y
    Indicates whether comments are relevant (Y) or required (R) or not relevant (N). The default value is relevant (Y).
  • Read Only: true
    Maximum Length: 64
    Name of the user who created the document type.
  • Read Only: true
    Date on which the document type was created.
  • Title: New Label for From Date
    Maximum Length: 200
    Label for the field that the user defines for the from date.
  • Title: From Date Applicable
    Maximum Length: 30
    Default Value: Y
    Indicates whether date from is relevant (Y) or required (R) or not relevant (N). The default value is relevant (Y).
  • Title: New Label for To Date
    Maximum Length: 200
    Label for the field that the user defines for the to date.
  • Title: To Date Applicable
    Maximum Length: 30
    Default Value: Y
    Indicates whether date to is relevant (Y) or required (R) or not relevant (N). The default value is relevant (Y).
  • Title: Description
    Maximum Length: 4000
    Description for the document type.
  • Title: Default Value for Context Segment
    Maximum Length: 120
    Default value for the document records flexfield context segment.
  • Title: Display Preference for Context Segment
    Maximum Length: 30
    Display preference for the document records flexfield context segment.
  • Title: Display Preference for Global Segment
    Maximum Length: 30
    Display preference for the document records flexfield global segment.
  • Title: New Label for Name
    Maximum Length: 200
    Label for the field that the user defines for the document name.
  • Title: Document Name Applicable
    Maximum Length: 30
    Default Value: Y
    Indicates whether document name is relevant (Y) or required (R) or not relevant (N). The default setting is relevant (Y).
  • Title: New Label for Number
    Maximum Length: 200
    Label for the field that the user defines for the document number.
  • Title: Document Number Applicable
    Maximum Length: 30
    Default Value: Y
    Indicates whether document number is relevant (Y) or required (R) or not relevant (N). The default value is relevant (Y).
  • Title: Type
    Maximum Length: 80
    Unique name to identify the document type.
  • Title: Type
    Surrogate ID for the document type which is available only when updating existing records.
  • Title: Document Type Level
    Maximum Length: 30
    Default Value: ORA_P
    Indicates whether the document type applies to a person or an individual assignment. The default value is Person.
  • documentTypesDDF
  • documentTypesDFF
  • Title: Override Hierarchy
    Maximum Length: 30
    Hierarchy code to support delivery preferences on this document type.
  • Title: New Label for Issued Date
    Maximum Length: 200
    Label for the field that the user defines for the issued date.
  • Title: Issued on Applicable
    Maximum Length: 30
    Default Value: Y
    Indicates whether issued date is relevant (Y) or required (R) or not relevant (N). The default value is relevant (Y).
  • Title: New Label for Issuing Authority
    Maximum Length: 200
    Label for the field that the user defines for the issuing authority.
  • Title: Issuing Authority Applicable
    Maximum Length: 30
    Default Value: Y
    Indicates whether issuing authority is relevant (Y) or required (R) or not relevant (N). The default value is relevant (Y).
  • Title: New Label for Issuing Country
    Maximum Length: 200
    Label for the field that the user defines for the issuing country.
  • Title: Issuing Country Applicable
    Maximum Length: 30
    Default Value: Y
    Indicates whether issuing country is relevant (Y) or required (R) or not relevant (N). The default value is relevant (Y).
  • Title: New Label for Issuing Location
    Maximum Length: 200
    Label for the field that the user defines for the issuing location.
  • Title: Issuing Location Applicable
    Maximum Length: 30
    Default Value: Y
    Indicates whether issuing location is relevant (Y) or required (R) or not relevant (N). The default value is relevant (Y).
  • Read Only: true
    Date the document type was last updated.
  • Read Only: true
    Maximum Length: 64
    User who last updated the document type.
  • Title: Country
    Maximum Length: 30
    Legislation code if this is a legislation specific document type.
  • Links
  • Title: Restrict Create
    Maximum Length: 30
    Default Value: false
    Indicates whether it restricts or allows creating document records of this document type. The default value is No
  • Title: Roles Excluded from Restriction
    Maximum Length: 4000
    List of roles that can create document records based on the document type.
  • Title: Restrict Delete
    Maximum Length: 30
    Default Value: false
    Indicates whether it restricts or allows deleting document records of this document type. The default value is No.
  • Title: Roles Excluded from Restriction
    Maximum Length: 4000
    List of roles allowed to delete document records based on the document type.
  • Title: Restrict Update
    Maximum Length: 30
    Default Value: false
    Indicates whether it restricts or allows updating document records of this document type. The default value is No.
  • Title: Roles Excluded from Restriction
    Maximum Length: 4000
    List of roles allowed to update document records based on the document type.
  • Title: Minimum Attachments
    Default Value: 0
    Minimum number of attachments that a user must attach for a specific document type.
  • Title: Allow multiple occurrences
    Maximum Length: 30
    Default Value: true
    Indicates whether multiple occurrences of this document type are allowed. The default value is Yes.
  • Title: Publish Required
    Maximum Length: 30
    Default Value: false
    Indicates whether document records of this document type must be published. The default value is No.
  • Title: Purge After Days
    Number of days after which archived document records will be purged.
  • Title: Subcategory
    Maximum Length: 30
    Code of the subcategory for the document type.
  • Title: System Document Type
    Maximum Length: 120
    System-generated name that uniquely identifies the document type.
  • Title: Tags
    Maximum Length: 2000
    Lookup code of the tag used for the document type derived from the lookup ORA_PER_DOC_TYPE_TAGS.
  • Translations for Document Types
    Title: Translations for Document Types
    The translations is a child of the hrDocumentTypes resource. It includes all the translated values of the document type.
  • Title: Expiration Notification Period
    Number of days in advance to generate an alert when a document record based on this document type is about to expire.
Nested Schema : Attachments
Type: array
Title: Attachments
The attachments resource is used to view, create, and update attachments.
Show Source
Nested Schema : documentTypesDDF
Type: array
Show Source
Nested Schema : documentTypesDFF
Type: array
Show Source
Nested Schema : Translations for Document Types
Type: array
Title: Translations for Document Types
The translations is a child of the hrDocumentTypes resource. It includes all the translated values of the document type.
Show Source
Nested Schema : hrDocumentTypes-attachments-item-response
Type: object
Show Source
Nested Schema : Attachment Previews
Type: array
Title: Attachment Previews
The attachments preview resource is used to preview the attachment pages.
Show Source
Nested Schema : hrDocumentTypes-attachments-AttachmentsPreview-item-response
Type: object
Show Source
Nested Schema : hrDocumentTypes-documentTypesDDF-item-response
Type: object
Show Source
Nested Schema : hrDocumentTypes-documentTypesDFF-item-response
Type: object
Show Source
Nested Schema : hrDocumentTypes-translations-item-response
Type: object
Show Source
Back to Top