GetTask()

Geeft één taak met bijbehorende attributen terug.

  • Quotum: 1
Tabel 1. Parameters
ParameterTypeMax. lengteVereistBeschrijving
apiTokentekenreeks20JUw API beveiligingstoken, geconfigureerd in Field View.
taskIdtekenreeks20JDe taak ID:
Opmerking: Er is ten minste één datumbereik vereist en geen enkel mag langer zijn dan 3 maanden. Als u meer dan één datumbereik in dezelfde call opgeeft, geeft het systeem alleen resultaten terug die aan beide bereiken voldoen, waardoor uw resultaten mogelijk worden beperkt.
Tabel 2. TaskInformation
ParameterTypeMax. lengteNULL toestaanBeschrijving
TaakIDtekenreeks20De unieke ID van de taak.
TaskTypeLinkIDgeheel getalDe taak link ID van het taak type.De taak link ID betreft verschillende versies van het taak type.
Locatietekenreeks100De locatie waar de taak is ingebracht.
Beschrijvingtekenreeks1000De beschrijving van de taak.
Statustekenreeks100De huidige status van de taak.
StatusColourtekenreeks50De statuskleur van de taak.
StatusDateDateTimeDe datum waarop de taak is gewijzigd naar deze status.
IssuedDateDateTimeDe datum waarop de taak is afgegeven/aangemaakt.
TaskTypetekenreeks100Het taak type.
IssuedToPackageIDgeheel getalJDe werkpakket ID waaraan de taak is afgegeven. Haal de werkpakket vakgebieden op met GetPackageTrades().
IssuedToPackagetekenreeks100De werkpakket beschrijving waaraan de taak is afgegeven.
IssuedToOrganisationtekenreeks100De naam van de organisatie waaraan de taak is afgegeven.
TargetDateDateTimeDe streefdatum waarop de taak gesloten moet zijn.
IssuedByUsertekenreeks100De naam van de persoon die de taak heeft afgegeven.
IssuedByOrganisationtekenreeks100De naam van de organisatie die de taak heeft afgegeven.
IssuedByOrganisationTypetekenreeks100Het type organisatie dat de taak heeft afgegeven.
Prioriteittekenreeks100De prioriteit die aan de taak moet worden gegeven.
Oorzaaktekenreeks100De beschrijving van de oorzaak.
CausedByOrganisationtekenreeks100De naam van de organisatie die ervoor heeft gezorgd dat deze taak is afgegeven/aangemaakt.
ActualStartDateDateTimeJDe datum waarop de taak daadwerkelijk is gestart.
ActualFinishDateDateTimeJDe datum waarop de taak daadwerkelijk is gesloten. Alleen geldig voor procestaken.
Kostengeheel getalJDe kosten die deze taak met zich meebracht.
OverDuebooleanStaat de taak nog open en is de streefdatum verstreken.
GereedbooleanIs de taak voltooid.
GeslotenbooleanIs de taak gesloten.
Oplossingtekenreeks1000Een opmerking over hoe de taak is opgelost.
LastModifiedDateTimeDe datum waarop de taak voor het laatst is gewijzigd.
Scoretekenreeks100JDe score die aan de taak is toegekend.
GPSLatitudedecimaalJDe GPS breedtegraad van de gebruiker van het mobiele apparaat wanneer deze deze vraag op het formulier invult.
GPSLongitudedecimaalJDe GPS lengtegraad van de gebruiker van het mobiele apparaat wanneer deze deze vraag in het formulier invult.
PercentageCompletedecimaalJ

Mobiele gebruikers kunnen dit veld wijzigen. Wanneer u de procestaak sluit, zet het systeem dit veld op 100.

Deze waarden zijn niet zichtbaar in web taken of rapporten, maar u kunt ervoor kiezen om de kolom 'Percentage voltooid' toe te voegen aan de tabel en de waarden daar te bekijken.

PlannedStartDateDateTimeJDe datum waarop de taak volgens de planning moet starten.
FormIdtekenreeksHet formulier of formulierantwoord waaraan de taak is gerelateerd.
DeletedbooleanIs de taak verwijderd.
LastModifiedOnServerDateTimeTijdstempel van de laatste update van deze taak.
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
	<soap:Body>
	<GetTaskResponse xmlns="https://localhost.priority1.uk.net/Priority1WebServices/XML">
	<GetTaskResult>
	<TaskInformationResponse xmlns="">
	<Status>
	<Code>SUCCESS</Code>
	<Message>Success. [ActivityId]: eaedfccf-0bbd-47fe-a4ea-7da7cb1058c1</Message>
	</Status>

               <TaskInformationItem>
                  <TaskID></TaskID>
                  <TaskTypeLinkID></TaskTypeLinkID>
                  <Location></Location>
                  <Description></Description>
                  <Status></Status>
                  <StatusColour></StatusColour>
                  <StatusDate></StatusDate>
                  <IssuedDate></IssuedDate>
                  <TaskType></TaskType>
                  <IssuedToPackageID></IssuedToPackageID>
                  <IssuedToPackage></IssuedToPackage>
                  <IssuedToOrganisation></IssuedToOrganisation>
                  <TargetDate xsi:nil="true"/>
                  <IssuedByUser></IssuedByUser>
                  <IssuedByOrganisation>H</IssuedByOrganisation>
                  <IssuedByOrganisationType></IssuedByOrganisationType>
                  <ActualStartDate xsi:nil="true"/>
                  <ActualFinishDate xsi:nil="true"/>
                  <Cost xsi:nil="true"/>
                  <OverDue></OverDue>
                  <Complete></Complete>
                  <Closed></Closed>
                  <LastModified></LastModified>
                  <Score/>
                  <GPSLatitude xsi:nil="true"/>
                  <GPSLongitude xsi:nil="true"/>
                  <PercentageComplete>0.00</PercentageComplete>
                  <PlannedStartDate xsi:nil="true"/>
                  <FormId/>
                  <Deleted></Deleted>
                  <LastModifiedOnServer></LastModifiedOnServer> 
             	</TaskInformationItem>
		</TaskInformationResponse>
		</GetTaskResult>
		</GetTaskResponse>
	</soap:Body>
</soap:Envelope>