GetAssociations()

Returns a list of objects (Forms and Tasks) associated to the Asset. Returned values can then be used against the GetForm or GetTask endpoints.

  • Quota: 10
Table 1. Parameters
Parameter Type Max Length Required Description
apiToken string 20 Y Your API security token configured in Field View.
assetId int Y The ID of the asset.
Table 2. Returns
Field Type Description
GetAssociationsResponse GetAssociationsResponse Returns a list of associated objects, 0 or more.
Important: All dates are returned in UTC.
<GetAssociationsResponse>
	 <GetAssociationsResult>
		<AssetAssociationsResponse>
		   <Status>
			  <Code>SUCCESS</Code>
			  <Message>Success. [ActivityId]: bfc2509d-d36b-466c-835c-0e5fde5bc723</Message>
		   </Status>
		   <Tasks>
			  <TaskAssociation>
				 <TaskID>T1.12345</TaskID>
				 <Description>SubTask1</Description>
				 <IssuedDate>2018-05-11T21:44:09.79Z</IssuedDate>
				 <IssuedToPackageID>1</IssuedToPackageID>
				 <TargetDate xsi:nil="true"/>
				 <ActualFinishDate xsi:nil="true"/>
				 <Cost>0</Cost>
				 <LastModified>2018-05-11T21:44:10.507Z</LastModified>
				 <TaskTypeId>3</TaskTypeId>
				 <IssuedToOrgansationID>3</IssuedToOrgansationID>
				 <IssuedByOrganisationID>4</IssuedByOrganisationID>
				 <IssuedByUserID>1.1</IssuedByUserID>
				 <CausedByOrganisationID xsi:nil="true"/>
			  </TaskAssociation>
			  <TaskAssociation>
				 <TaskID>T1.456789</TaskID>
				 <Description>Task 2</Description>
				 <IssuedDate>2018-05-03T19:39:41.2Z</IssuedDate>
				 <IssuedToPackageID>1</IssuedToPackageID>
				 <TargetDate xsi:nil="true"/>
				 <ActualFinishDate xsi:nil="true"/>
				 <Cost>0</Cost>
				 <LastModified>2018-05-16T18:06:01.893Z</LastModified>
				 <TaskTypeId>2</TaskTypeId>
				 <IssuedToOrgansationID>3</IssuedToOrgansationID>
				 <IssuedByOrganisationID>4</IssuedByOrganisationID>
				 <IssuedByUserID>1.1</IssuedByUserID>
				 <CausedByOrganisationID xsi:nil="true"/>
			  </TaskAssociation>
		   </Tasks>
		   <Forms>
			   <FormAssociation>
				 <FormID>F1.12345</FormID>
				 <FormTemplateLinkID>1</FormTemplateLinkID>
				 <FormTitle>Hot Works Permit</FormTitle>
				 <CreatedDate>2013-09-05T09:58:38Z</CreatedDate>
				 <FormExpiryDate xsi:nil="true"/>
				 <ParentTypeId xsi:nil="true"/>
				 <Deleted>false</Deleted>
				 <HasComment>false</HasComment>
				 <HasPhoto>false</HasPhoto>
				 <IssuedToOrganisationId xsi:nil="true"/>
				 <HasDocument xsi:nil="true"/>
				 <OrganisationId>1</OrganisationId>
				 <ProjectId>2</ProjectId>
			  </FormAssociation>
		   </Forms>
		</AssetAssociationsResponse>
	</GetAssociationsResult>
</GetAssociationsResponse>