Get Primavera Synchronizer - Schedules

Schedules

Download API definition:

This API is a Technical Preview and is available for testing purposes only. Do not use in production.

Get Primavera Synchronizer

GET https://dev-api.bentley.com/schedules/{scheduleId}/imports/primavera/synchronizers/{synchronizerId}

Get Primavera Synchronizer

Request parameters

scheduleId

Yes

The unique identifier of the Schedule.

synchronizerId

Yes

The unique identifier of Primavera Synchronizer.

Request headers

If-None-Match

A header that makes the request conditional. If the ETag of the requested resource or resource collection matches the provided value, a 304 (Not Modified) response is returned. For more information see the official documentation.

Authorization

Yes

OAuth access token with itwin-platform scope

Yes

Setting to application/vnd.bentley.itwin-platform.v1+json is recommended.

Response 200 OK

json

{
    "synchronizer": {
        "deleted": false,
        "id": "21c5e710-d391-442a-9989-e017cdea8d91",
        "originalProjectName": "Civil Structure",
        "originalProjectPath": "C:\\documents\\civil",
        "originalSynchronizationTime": "2019-12-01T12:00:00Z",
        "originalSynchronizationType": "Import",
        "projectName": "Civil Structure v3",
        "projectPath": "C:\\documents\\civil\\new",
        "projects": [{
            "id": "1",
            "userDefinedId": "Civil Structure"
        }],
        "synchronizationDetails": {
            "created": {
                "calendars": 2,
                "links": 64,
                "resourceRates": 2,
                "resources": 2,
                "tasks": 89
            },
            "deleted": {
                "resourceRates": 2,
                "tasks": 3
            },
            "updated": {
                "resources": 4,
                "tasks": 2
            },
            "warnings": [{
                    "message": "Warning: the resource [R11 - Cost] is already assigned to the task [T11]; repeated assignment will be skipped"
                },
                {
                    "message": "Warning: the resource [R22 - Cost] is already assigned to the task [T22]; repeated assignment will be skipped"
                }
            ]
        },
        "synchronizationTime": "2020-01-05T12:00:00Z",
        "synchronizationType": "SynchronizeFrom",
        "synchronizerName": "Civil Structure"
    }
}

Response headers

ETag

A header that identifies a specific version of a resource or resource collection. For more information see the official documentation.

This response indicates that request lacks valid authentication credentials. Access token might not been provided, issued by the wrong issuer, does not have required scopes or request headers were malformed.

json

{
    "error": {
        "code": "HeaderNotFound",
        "message": "Header Authorization was not found in the request. Access denied."
    }
}

Response 404 Not Found

This response indicates that the provided Synchronizer or Schedule is not available.

json

{
    "error": {
        "code": "ScheduleNotFound",
        "message": "Requested Schedule is not available.",
        "target": "scheduleId"
    }
}

Response 429 Too many requests

This response indicates that the client sent more requests than allowed by this API for the current tier of the client.

json

{
    "error": {
        "code": "RateLimitExceeded",
        "message": "The client sent more requests than allowed by this API for the current tier of the client."
    }
}

Response headers

retry-after

Number of seconds to wait until client is allowed to make more requests.

Definitions

Primavera Synchronizer

Representation of a Primavera Synchronizer.

deleted

Boolean, null

Is this Synchronizer deleted.

String

The unique identifier of the Synchronizer.

originalProjectName

String

The name of the initial import project.

originalProjectPath

String

The path of the initial import project.

originalSynchronizationTime

Date-time

The date on which the initial import occurred.

originalSynchronizationType

SynchronizationType

The type of the initial import.

projectName

String

The name of the project.

projectPath

String

The path of the project.

projects

PrimaveraExternalProjectInformation[]

Information about projects that are present in the Primavera file that was used when importing or synchronizing.

synchronizationDetails

SynchronizerExpandedDetails

Expanded details of the Synchronizer.

synchronizationTime

Date-time

The date on which the synchronization occurred.

synchronizationType

SynchronizationType

The type of synchronization.

synchronizerName

String

The name of the Synchronizer.

json

{
    "title": "Primavera Synchronizer",
    "type": "object",
    "properties": {
        "deleted": {
            "type": "boolean",
            "description": "Is this Synchronizer deleted.",
            "nullable": true
        },
        "id": {
            "type": "string",
            "description": "The unique identifier of the Synchronizer."
        },
        "originalProjectName": {
            "type": "string",
            "description": "The name of the initial import project."
        },
        "originalProjectPath": {
            "type": "string",
            "description": "The path of the initial import project."
        },
        "originalSynchronizationTime": {
            "type": "string",
            "description": "The date on which the initial import occurred.",
            "format": "date-time"
        },
        "originalSynchronizationType": {
            "$ref": "#/components/schemas/SynchronizationType",
            "description": "The type of the initial import."
        },
        "projectName": {
            "type": "string",
            "description": "The name of the project."
        },
        "projectPath": {
            "type": "string",
            "description": "The path of the project."
        },
        "projects": {
            "type": "array",
            "items": {
                "$ref": "#/components/schemas/PrimaveraExternalProjectInformation"
            },
            "description": "Information about projects that are present in the Primavera file that was used when importing or synchronizing."
        },
        "synchronizationDetails": {
            "$ref": "#/components/schemas/SynchronizerExpandedDetails",
            "description": "Expanded details of the Synchronizer."
        },
        "synchronizationTime": {
            "type": "string",
            "description": "The date on which the synchronization occurred.",
            "format": "date-time"
        },
        "synchronizationType": {
            "$ref": "#/components/schemas/SynchronizationType",
            "description": "The type of synchronization."
        },
        "synchronizerName": {
            "type": "string",
            "description": "The name of the Synchronizer."
        }
    },
    "additionalProperties": false,
    "description": "Representation of a Primavera Synchronizer."
}

Primavera Synchronizer Response

Container for Primavera Synchronizer object.

synchronizer

PrimaveraSynchronizer

Primavera Synchronizer Properties.

json

{
    "title": "Primavera Synchronizer Response",
    "type": "object",
    "properties": {
        "synchronizer": {
            "$ref": "#/components/schemas/PrimaveraSynchronizer",
            "description": "Primavera Synchronizer Properties."
        }
    },
    "additionalProperties": false,
    "description": "Container for Primavera Synchronizer object."
}

Primavera External Project Information

Properties regarding the Primavera external project.

String

The unique identifier of the project.

userDefinedId

String

A unique project Id defined by the user.

json

{
    "title": "Primavera External Project Information",
    "type": "object",
    "properties": {
        "id": {
            "type": "string",
            "description": "The unique identifier of the project."
        },
        "userDefinedId": {
            "type": "string",
            "description": "A unique project Id defined by the user."
        }
    },
    "additionalProperties": false,
    "description": "Properties regarding the Primavera external project."
}

Synchronization Type

Synchronization Type specifies if it was an import, export or synchronization.

Import

String

Export

String

SynchronizeFrom

String

SynchronizeTo

String

Unknown

String

json

{
    "title": "Synchronization Type",
    "enum": [
        "Import",
        "Export",
        "SynchronizeFrom",
        "SynchronizeTo",
        "Unknown"
    ],
    "type": "string",
    "description": "Synchronization Type specifies if it was an import, export or synchronization."
}

Synchronizer Expanded Data Model

Expanded details of a Synchronizer.

created

SynchronizerWriteLogsModel

Detailed amounts of created entities.

deleted

SynchronizerWriteLogsModel

Detailed amounts of deleted entities.

updated

SynchronizerWriteLogsModel

Detailed amounts of updated entities.

warnings

SynchronizerLogsMessage[]

Warnings that occurred during last Synchronization.

json

{
    "title": "Synchronizer Expanded Data Model",
    "type": "object",
    "properties": {
        "created": {
            "$ref": "#/components/schemas/SynchronizerWriteLogsModel",
            "description": "Detailed amounts of created entities."
        },
        "deleted": {
            "$ref": "#/components/schemas/SynchronizerWriteLogsModel",
            "description": "Detailed amounts of deleted entities."
        },
        "updated": {
            "$ref": "#/components/schemas/SynchronizerWriteLogsModel",
            "description": "Detailed amounts of updated entities."
        },
        "warnings": {
            "type": "array",
            "items": {
                "$ref": "#/components/schemas/SynchronizerLogsMessage"
            },
            "description": "Warnings that occurred during last Synchronization."
        }
    },
    "additionalProperties": false,
    "description": "Expanded details of a Synchronizer."
}

Synchronizer Logs Message

Synchronizer Logs Message.

message

String

Log message of a Synchronizer Logs Message.

json

{
    "title": "Synchronizer Logs Message",
    "type": "object",
    "properties": {
        "message": {
            "type": "string",
            "description": "Log message of a Synchronizer Logs Message."
        }
    },
    "additionalProperties": false,
    "description": "Synchronizer Logs Message."
}

Synchronizer Write Logs Model

Synchronizer modification counts.

activityCodeValues

Integer, null

The amount of Activity Code Values modified.

activityCodeValuesAssignments

Integer, null

The mount of Activity Code Values Assignments modified.

activityCodes

Integer, null

The amount of Activity Codes modified.

calendars

Integer, null

The amount of Calenders modified.

costCodes

Integer, null

The amount of Cost Codes modified.

links

Integer, null

The amount of Links modified.

resourceAssignments

Integer, null

The amount of Resource Assignments modified.

resourceCodeValues

Integer, null

The amount of Resource Code Values modified.

resourceCodes

Integer, null

The amount of Resource Codes modified.

resourceRates

Integer, null

The amount of Resource Rates modified.

resources

Integer, null

The amount of Resources modified.

taskCosts

Integer, null

The amount of Task Costs modified.

tasks

Integer, null

The amount of Tasks modified.

userFieldValues

Integer, null

The mount of User Field Values modified.

userFields

Integer, null

The mount of User Fields modified.

json

{
    "title": "Synchronizer Write Logs Model",
    "type": "object",
    "properties": {
        "activityCodeValues": {
            "type": "integer",
            "description": "The amount of Activity Code Values modified.",
            "nullable": true
        },
        "activityCodeValuesAssignments": {
            "type": "integer",
            "description": "The mount of Activity Code Values Assignments modified.",
            "nullable": true
        },
        "activityCodes": {
            "type": "integer",
            "description": "The amount of Activity Codes modified.",
            "nullable": true
        },
        "calendars": {
            "type": "integer",
            "description": "The amount of Calenders modified.",
            "nullable": true
        },
        "costCodes": {
            "type": "integer",
            "description": "The amount of Cost Codes modified.",
            "nullable": true
        },
        "links": {
            "type": "integer",
            "description": "The amount of Links modified.",
            "nullable": true
        },
        "resourceAssignments": {
            "type": "integer",
            "description": "The amount of Resource Assignments modified.",
            "nullable": true
        },
        "resourceCodeValues": {
            "type": "integer",
            "description": "The amount of Resource Code Values modified.",
            "nullable": true
        },
        "resourceCodes": {
            "type": "integer",
            "description": "The amount of Resource Codes modified.",
            "nullable": true
        },
        "resourceRates": {
            "type": "integer",
            "description": "The amount of Resource Rates modified.",
            "nullable": true
        },
        "resources": {
            "type": "integer",
            "description": "The amount of Resources modified.",
            "nullable": true
        },
        "taskCosts": {
            "type": "integer",
            "description": "The amount of Task Costs modified.",
            "nullable": true
        },
        "tasks": {
            "type": "integer",
            "description": "The amount of Tasks modified.",
            "nullable": true
        },
        "userFieldValues": {
            "type": "integer",
            "description": "The mount of User Field Values modified.",
            "nullable": true
        },
        "userFields": {
            "type": "integer",
            "description": "The mount of User Fields modified.",
            "nullable": true
        }
    },
    "additionalProperties": false,
    "description": "Synchronizer modification counts."
}

Error

Contains error information.

code

String

One of a server-defined set of error codes.

message

String

A human-readable representation of the error.

target

String, null

The target of the error.

json

{
    "type": "object",
    "description": "Contains error information.",
    "properties": {
        "code": {
            "type": "string",
            "description": "One of a server-defined set of error codes."
        },
        "message": {
            "type": "string",
            "description": "A human-readable representation of the error."
        },
        "target": {
            "type": "string",
            "description": "The target of the error.",
            "nullable": true
        }
    },
    "required": [
        "code",
        "message"
    ],
    "additionalProperties": true
}

Error Response

Gives details for an error that occurred while handling the request. Note that clients MUST NOT assume that every failed request will produce an object of this schema, or that all of the properties in the response will be non-null, as the error may have prevented this response from being constructed.

error

Error

Error information.

json

{
    "type": "object",
    "title": "Error Response",
    "description": "Gives details for an error that occurred while handling the request. Note that clients MUST NOT assume that every failed request will produce an object of this schema, or that all of the properties in the response will be non-null, as the error may have prevented this response from being constructed.",
    "properties": {
        "error": {
            "description": "Error information.",
            "$ref": "#/components/schemas/Error"
        }
    },
    "required": [
        "error"
    ],
    "additionalProperties": false
}

Was this page helpful?

Request

Request parameters

Request headers

Response

Response 200 OK

Response headers

Response 304 Not Modified

Response 401 Unauthorized

Response 404 Not Found

Response 429 Too many requests

Response headers

Definitions

Primavera Synchronizer

Primavera Synchronizer Response

Primavera External Project Information

Synchronization Type

Synchronizer Expanded Data Model

Synchronizer Logs Message

Synchronizer Write Logs Model

Error

Error Response