Skip to content

Latest commit

 

History

History
483 lines (340 loc) · 24.2 KB

SurveyResponsePersonTargetAssociationsApi.md

File metadata and controls

483 lines (340 loc) · 24.2 KB

OpenAPI\Client\SurveyResponsePersonTargetAssociationsApi

All URIs are relative to https://api.ed-fi.org:443/v7.1/api/data/v3.

Method HTTP request Description
deleteSurveyResponsePersonTargetAssociationById() DELETE /tpdm/surveyResponsePersonTargetAssociations/{id} Deletes an existing resource using the resource identifier.
deletesSurveyResponsePersonTargetAssociations() GET /tpdm/surveyResponsePersonTargetAssociations/deletes Retrieves deleted resources based on change version.
getSurveyResponsePersonTargetAssociations() GET /tpdm/surveyResponsePersonTargetAssociations Retrieves specific resources using the resource's property values (using the "Get" pattern).
getSurveyResponsePersonTargetAssociationsById() GET /tpdm/surveyResponsePersonTargetAssociations/{id} Retrieves a specific resource using the resource's identifier (using the "Get By Id" pattern).
keyChangesSurveyResponsePersonTargetAssociations() GET /tpdm/surveyResponsePersonTargetAssociations/keyChanges Retrieves resources key changes based on change version.
postSurveyResponsePersonTargetAssociation() POST /tpdm/surveyResponsePersonTargetAssociations Creates or updates resources based on the natural key values of the supplied resource.
putSurveyResponsePersonTargetAssociation() PUT /tpdm/surveyResponsePersonTargetAssociations/{id} Updates a resource based on the resource identifier.

deleteSurveyResponsePersonTargetAssociationById()

deleteSurveyResponsePersonTargetAssociationById($id, $if_match)

Deletes an existing resource using the resource identifier.

The DELETE operation is used to delete an existing resource by identifier. If the resource doesn't exist, an error will result (the resource will not be found).

Example

<?php
require_once(__DIR__ . '/vendor/autoload.php');


// Configure OAuth2 access token for authorization: oauth2_client_credentials
$config = OpenAPI\Client\Configuration::getDefaultConfiguration()->setAccessToken('YOUR_ACCESS_TOKEN');


$apiInstance = new OpenAPI\Client\Api\SurveyResponsePersonTargetAssociationsApi(
    // If you want use custom http client, pass your client which implements `GuzzleHttp\ClientInterface`.
    // This is optional, `GuzzleHttp\Client` will be used as default.
    new GuzzleHttp\Client(),
    $config
);
$id = 'id_example'; // string | A resource identifier that uniquely identifies the resource.
$if_match = 'if_match_example'; // string | The ETag header value used to prevent the DELETE from removing a resource modified by another consumer.

try {
    $apiInstance->deleteSurveyResponsePersonTargetAssociationById($id, $if_match);
} catch (Exception $e) {
    echo 'Exception when calling SurveyResponsePersonTargetAssociationsApi->deleteSurveyResponsePersonTargetAssociationById: ', $e->getMessage(), PHP_EOL;
}

Parameters

Name Type Description Notes
id string A resource identifier that uniquely identifies the resource.
if_match string The ETag header value used to prevent the DELETE from removing a resource modified by another consumer. [optional]

Return type

void (empty response body)

Authorization

oauth2_client_credentials

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

deletesSurveyResponsePersonTargetAssociations()

deletesSurveyResponsePersonTargetAssociations($offset, $limit, $min_change_version, $max_change_version, $total_count, $use_snapshot): \OpenAPI\Client\Model\TrackedChangesTpdmSurveyResponsePersonTargetAssociationDelete[]

Retrieves deleted resources based on change version.

This operation is used to retrieve identifying information about resources that have been deleted.

Example

<?php
require_once(__DIR__ . '/vendor/autoload.php');


// Configure OAuth2 access token for authorization: oauth2_client_credentials
$config = OpenAPI\Client\Configuration::getDefaultConfiguration()->setAccessToken('YOUR_ACCESS_TOKEN');


$apiInstance = new OpenAPI\Client\Api\SurveyResponsePersonTargetAssociationsApi(
    // If you want use custom http client, pass your client which implements `GuzzleHttp\ClientInterface`.
    // This is optional, `GuzzleHttp\Client` will be used as default.
    new GuzzleHttp\Client(),
    $config
);
$offset = 0; // int | Indicates how many items should be skipped before returning results.
$limit = 25; // int | Indicates the maximum number of items that should be returned in the results.
$min_change_version = 56; // int | Used in synchronization to set sequence minimum ChangeVersion
$max_change_version = 56; // int | Used in synchronization to set sequence maximum ChangeVersion
$total_count = false; // bool | Indicates if the total number of items available should be returned in the 'Total-Count' header of the response.  If set to false, 'Total-Count' header will not be provided.
$use_snapshot = false; // bool | Indicates if the configured Snapshot should be used.

try {
    $result = $apiInstance->deletesSurveyResponsePersonTargetAssociations($offset, $limit, $min_change_version, $max_change_version, $total_count, $use_snapshot);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling SurveyResponsePersonTargetAssociationsApi->deletesSurveyResponsePersonTargetAssociations: ', $e->getMessage(), PHP_EOL;
}

Parameters

Name Type Description Notes
offset int Indicates how many items should be skipped before returning results. [optional] [default to 0]
limit int Indicates the maximum number of items that should be returned in the results. [optional] [default to 25]
min_change_version int Used in synchronization to set sequence minimum ChangeVersion [optional]
max_change_version int Used in synchronization to set sequence maximum ChangeVersion [optional]
total_count bool Indicates if the total number of items available should be returned in the 'Total-Count' header of the response. If set to false, 'Total-Count' header will not be provided. [optional] [default to false]
use_snapshot bool Indicates if the configured Snapshot should be used. [optional] [default to false]

Return type

\OpenAPI\Client\Model\TrackedChangesTpdmSurveyResponsePersonTargetAssociationDelete[]

Authorization

oauth2_client_credentials

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

getSurveyResponsePersonTargetAssociations()

getSurveyResponsePersonTargetAssociations($offset, $limit, $min_change_version, $max_change_version, $total_count, $person_id, $source_system_descriptor, $namespace, $survey_identifier, $survey_response_identifier, $id, $use_snapshot): \OpenAPI\Client\Model\TpdmSurveyResponsePersonTargetAssociation[]

Retrieves specific resources using the resource's property values (using the "Get" pattern).

This GET operation provides access to resources using the "Get" search pattern. The values of any properties of the resource that are specified will be used to return all matching results (if it exists).

Example

<?php
require_once(__DIR__ . '/vendor/autoload.php');


// Configure OAuth2 access token for authorization: oauth2_client_credentials
$config = OpenAPI\Client\Configuration::getDefaultConfiguration()->setAccessToken('YOUR_ACCESS_TOKEN');


$apiInstance = new OpenAPI\Client\Api\SurveyResponsePersonTargetAssociationsApi(
    // If you want use custom http client, pass your client which implements `GuzzleHttp\ClientInterface`.
    // This is optional, `GuzzleHttp\Client` will be used as default.
    new GuzzleHttp\Client(),
    $config
);
$offset = 0; // int | Indicates how many items should be skipped before returning results.
$limit = 25; // int | Indicates the maximum number of items that should be returned in the results.
$min_change_version = 56; // int | Used in synchronization to set sequence minimum ChangeVersion
$max_change_version = 56; // int | Used in synchronization to set sequence maximum ChangeVersion
$total_count = false; // bool | Indicates if the total number of items available should be returned in the 'Total-Count' header of the response.  If set to false, 'Total-Count' header will not be provided.
$person_id = 'person_id_example'; // string | A unique alphanumeric code assigned to a person.
$source_system_descriptor = 'source_system_descriptor_example'; // string | This descriptor defines the originating record source system for the person.
$namespace = 'namespace_example'; // string | Namespace for the survey.
$survey_identifier = 'survey_identifier_example'; // string | The unique survey identifier from the survey tool.
$survey_response_identifier = 'survey_response_identifier_example'; // string | The identifier of the survey typically from the survey application.
$id = 'id_example'; // string
$use_snapshot = false; // bool | Indicates if the configured Snapshot should be used.

try {
    $result = $apiInstance->getSurveyResponsePersonTargetAssociations($offset, $limit, $min_change_version, $max_change_version, $total_count, $person_id, $source_system_descriptor, $namespace, $survey_identifier, $survey_response_identifier, $id, $use_snapshot);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling SurveyResponsePersonTargetAssociationsApi->getSurveyResponsePersonTargetAssociations: ', $e->getMessage(), PHP_EOL;
}

Parameters

Name Type Description Notes
offset int Indicates how many items should be skipped before returning results. [optional] [default to 0]
limit int Indicates the maximum number of items that should be returned in the results. [optional] [default to 25]
min_change_version int Used in synchronization to set sequence minimum ChangeVersion [optional]
max_change_version int Used in synchronization to set sequence maximum ChangeVersion [optional]
total_count bool Indicates if the total number of items available should be returned in the 'Total-Count' header of the response. If set to false, 'Total-Count' header will not be provided. [optional] [default to false]
person_id string A unique alphanumeric code assigned to a person. [optional]
source_system_descriptor string This descriptor defines the originating record source system for the person. [optional]
namespace string Namespace for the survey. [optional]
survey_identifier string The unique survey identifier from the survey tool. [optional]
survey_response_identifier string The identifier of the survey typically from the survey application. [optional]
id string [optional]
use_snapshot bool Indicates if the configured Snapshot should be used. [optional] [default to false]

Return type

\OpenAPI\Client\Model\TpdmSurveyResponsePersonTargetAssociation[]

Authorization

oauth2_client_credentials

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

getSurveyResponsePersonTargetAssociationsById()

getSurveyResponsePersonTargetAssociationsById($id, $if_none_match, $use_snapshot): \OpenAPI\Client\Model\TpdmSurveyResponsePersonTargetAssociation

Retrieves a specific resource using the resource's identifier (using the "Get By Id" pattern).

This GET operation retrieves a resource by the specified resource identifier.

Example

<?php
require_once(__DIR__ . '/vendor/autoload.php');


// Configure OAuth2 access token for authorization: oauth2_client_credentials
$config = OpenAPI\Client\Configuration::getDefaultConfiguration()->setAccessToken('YOUR_ACCESS_TOKEN');


$apiInstance = new OpenAPI\Client\Api\SurveyResponsePersonTargetAssociationsApi(
    // If you want use custom http client, pass your client which implements `GuzzleHttp\ClientInterface`.
    // This is optional, `GuzzleHttp\Client` will be used as default.
    new GuzzleHttp\Client(),
    $config
);
$id = 'id_example'; // string | A resource identifier that uniquely identifies the resource.
$if_none_match = 'if_none_match_example'; // string | The previously returned ETag header value, used here to prevent the unnecessary data transfer of an unchanged resource.
$use_snapshot = false; // bool | Indicates if the configured Snapshot should be used.

try {
    $result = $apiInstance->getSurveyResponsePersonTargetAssociationsById($id, $if_none_match, $use_snapshot);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling SurveyResponsePersonTargetAssociationsApi->getSurveyResponsePersonTargetAssociationsById: ', $e->getMessage(), PHP_EOL;
}

Parameters

Name Type Description Notes
id string A resource identifier that uniquely identifies the resource.
if_none_match string The previously returned ETag header value, used here to prevent the unnecessary data transfer of an unchanged resource. [optional]
use_snapshot bool Indicates if the configured Snapshot should be used. [optional] [default to false]

Return type

\OpenAPI\Client\Model\TpdmSurveyResponsePersonTargetAssociation

Authorization

oauth2_client_credentials

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

keyChangesSurveyResponsePersonTargetAssociations()

keyChangesSurveyResponsePersonTargetAssociations($offset, $limit, $min_change_version, $max_change_version, $total_count, $use_snapshot): \OpenAPI\Client\Model\TrackedChangesTpdmSurveyResponsePersonTargetAssociationKeyChange[]

Retrieves resources key changes based on change version.

This operation is used to retrieve identifying information about resources whose key values have been changed.

Example

<?php
require_once(__DIR__ . '/vendor/autoload.php');


// Configure OAuth2 access token for authorization: oauth2_client_credentials
$config = OpenAPI\Client\Configuration::getDefaultConfiguration()->setAccessToken('YOUR_ACCESS_TOKEN');


$apiInstance = new OpenAPI\Client\Api\SurveyResponsePersonTargetAssociationsApi(
    // If you want use custom http client, pass your client which implements `GuzzleHttp\ClientInterface`.
    // This is optional, `GuzzleHttp\Client` will be used as default.
    new GuzzleHttp\Client(),
    $config
);
$offset = 0; // int | Indicates how many items should be skipped before returning results.
$limit = 25; // int | Indicates the maximum number of items that should be returned in the results.
$min_change_version = 56; // int | Used in synchronization to set sequence minimum ChangeVersion
$max_change_version = 56; // int | Used in synchronization to set sequence maximum ChangeVersion
$total_count = false; // bool | Indicates if the total number of items available should be returned in the 'Total-Count' header of the response.  If set to false, 'Total-Count' header will not be provided.
$use_snapshot = false; // bool | Indicates if the configured Snapshot should be used.

try {
    $result = $apiInstance->keyChangesSurveyResponsePersonTargetAssociations($offset, $limit, $min_change_version, $max_change_version, $total_count, $use_snapshot);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling SurveyResponsePersonTargetAssociationsApi->keyChangesSurveyResponsePersonTargetAssociations: ', $e->getMessage(), PHP_EOL;
}

Parameters

Name Type Description Notes
offset int Indicates how many items should be skipped before returning results. [optional] [default to 0]
limit int Indicates the maximum number of items that should be returned in the results. [optional] [default to 25]
min_change_version int Used in synchronization to set sequence minimum ChangeVersion [optional]
max_change_version int Used in synchronization to set sequence maximum ChangeVersion [optional]
total_count bool Indicates if the total number of items available should be returned in the 'Total-Count' header of the response. If set to false, 'Total-Count' header will not be provided. [optional] [default to false]
use_snapshot bool Indicates if the configured Snapshot should be used. [optional] [default to false]

Return type

\OpenAPI\Client\Model\TrackedChangesTpdmSurveyResponsePersonTargetAssociationKeyChange[]

Authorization

oauth2_client_credentials

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

postSurveyResponsePersonTargetAssociation()

postSurveyResponsePersonTargetAssociation($tpdm_survey_response_person_target_association)

Creates or updates resources based on the natural key values of the supplied resource.

The POST operation can be used to create or update resources. In database terms, this is often referred to as an "upsert" operation (insert + update). Clients should NOT include the resource "id" in the JSON body because it will result in an error. The web service will identify whether the resource already exists based on the natural key values provided, and update or create the resource appropriately. It is recommended to use POST for both create and update except while updating natural key of a resource in which case PUT operation must be used.

Example

<?php
require_once(__DIR__ . '/vendor/autoload.php');


// Configure OAuth2 access token for authorization: oauth2_client_credentials
$config = OpenAPI\Client\Configuration::getDefaultConfiguration()->setAccessToken('YOUR_ACCESS_TOKEN');


$apiInstance = new OpenAPI\Client\Api\SurveyResponsePersonTargetAssociationsApi(
    // If you want use custom http client, pass your client which implements `GuzzleHttp\ClientInterface`.
    // This is optional, `GuzzleHttp\Client` will be used as default.
    new GuzzleHttp\Client(),
    $config
);
$tpdm_survey_response_person_target_association = new \OpenAPI\Client\Model\TpdmSurveyResponsePersonTargetAssociation(); // \OpenAPI\Client\Model\TpdmSurveyResponsePersonTargetAssociation | The JSON representation of the \"surveyResponsePersonTargetAssociation\" resource to be created or updated.

try {
    $apiInstance->postSurveyResponsePersonTargetAssociation($tpdm_survey_response_person_target_association);
} catch (Exception $e) {
    echo 'Exception when calling SurveyResponsePersonTargetAssociationsApi->postSurveyResponsePersonTargetAssociation: ', $e->getMessage(), PHP_EOL;
}

Parameters

Name Type Description Notes
tpdm_survey_response_person_target_association \OpenAPI\Client\Model\TpdmSurveyResponsePersonTargetAssociation The JSON representation of the &quot;surveyResponsePersonTargetAssociation&quot; resource to be created or updated.

Return type

void (empty response body)

Authorization

oauth2_client_credentials

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

putSurveyResponsePersonTargetAssociation()

putSurveyResponsePersonTargetAssociation($id, $tpdm_survey_response_person_target_association, $if_match)

Updates a resource based on the resource identifier.

The PUT operation is used to update a resource by identifier. If the resource identifier ("id") is provided in the JSON body, it will be ignored. Additionally, this API resource is not configured for cascading natural key updates. Natural key values for this resource cannot be changed using PUT operation, so the recommendation is to use POST as that supports upsert behavior.

Example

<?php
require_once(__DIR__ . '/vendor/autoload.php');


// Configure OAuth2 access token for authorization: oauth2_client_credentials
$config = OpenAPI\Client\Configuration::getDefaultConfiguration()->setAccessToken('YOUR_ACCESS_TOKEN');


$apiInstance = new OpenAPI\Client\Api\SurveyResponsePersonTargetAssociationsApi(
    // If you want use custom http client, pass your client which implements `GuzzleHttp\ClientInterface`.
    // This is optional, `GuzzleHttp\Client` will be used as default.
    new GuzzleHttp\Client(),
    $config
);
$id = 'id_example'; // string | A resource identifier that uniquely identifies the resource.
$tpdm_survey_response_person_target_association = new \OpenAPI\Client\Model\TpdmSurveyResponsePersonTargetAssociation(); // \OpenAPI\Client\Model\TpdmSurveyResponsePersonTargetAssociation | The JSON representation of the \"surveyResponsePersonTargetAssociation\" resource to be created or updated.
$if_match = 'if_match_example'; // string | The ETag header value used to prevent the PUT from updating a resource modified by another consumer.

try {
    $apiInstance->putSurveyResponsePersonTargetAssociation($id, $tpdm_survey_response_person_target_association, $if_match);
} catch (Exception $e) {
    echo 'Exception when calling SurveyResponsePersonTargetAssociationsApi->putSurveyResponsePersonTargetAssociation: ', $e->getMessage(), PHP_EOL;
}

Parameters

Name Type Description Notes
id string A resource identifier that uniquely identifies the resource.
tpdm_survey_response_person_target_association \OpenAPI\Client\Model\TpdmSurveyResponsePersonTargetAssociation The JSON representation of the &quot;surveyResponsePersonTargetAssociation&quot; resource to be created or updated.
if_match string The ETag header value used to prevent the PUT from updating a resource modified by another consumer. [optional]

Return type

void (empty response body)

Authorization

oauth2_client_credentials

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]