Ta strona została przetłumaczona przez Cloud Translation API.

Finalizowanie zadań

Zakładamy w nim, że wiesz, jak tworzyć zadania i ich używać. Zapewnia z konkretnych przykładów realizacji zadań związanych z dostawą:

Zamknięcie zadania: zamknięcie zadania dotyczącego dostawy zmienia jego stan na CLOSED i wskazuje, że zadanie nie jest już aktywne.
Wyznaczanie wyniku zadania: po zamknięciu zadania możesz je zakończyć, wykonując kolejne kroki. ustawiając jego wynik na SUCCEEDED lub FAILED. To ważne, jest częścią finalizacji zadania, aby pokazać wyniki realizacji na ścieżce do zakupu. udostępnianie danych i zapewnienie prawidłowych rozliczeń za usługę Fleet Engine.

Zamykanie zadania

Możesz zamknąć zadanie na te sposoby:

Aktualizowanie stanu zatrzymania pojazdu. Usuwasz przystanek z pojazdu, co z kolei spowoduje zamknięcie wszystkich zadań związanych z przystankiem. Zobacz Zaktualizuj stan przystanku, aby uzyskać szczegółowe informacje.
Usuń zadanie z listy postojów dla pojazdów. Wymaga to aktualizacji na liście zadań dla przystanku, ale w zamkniętym zadaniu nie widać z dłuższej listy. Zobacz sekcję Aktualizowanie kolejności zadań w artykule Aktualizowanie zadań.
Ustaw stan zadania na CLOSED. Można to zrobić tylko na zadaniach niebędących przypisane do pojazdów. Informacje o tym podejściu znajdziesz w tej sekcji.

Po zamknięciu zadania nie można go ponownie otworzyć.

Zamknięcie zadania nie oznacza jego powodzenia ani niepowodzenia. Wskazuje że zadanie nie jest już uznawane za trwające. Aby wskazać rzeczywisty wynik zadania, który będzie widoczny na potrzeby śledzenia floty. w celach związanych ze współpracą, należy wskazać rzeczywisty wynik zadania. Zobacz Określ wynik zadania poniżej.

Pola zadań do zamykania zadań

W tej sekcji opisano pola, które należy ustawić przy zamykaniu zadanie. Fleet Engine ignoruje wszystkie inne pola w jednostce na potrzeby aktualizacji.

Pole wymagane	Wartość
`state`	`State.CLOSED`

Bezpośrednie zamykanie zadania

W przykładach poniżej pokazujemy, jak ustawić nieprzypisane zadanie jako zamknięte. w gRPC albo za pomocą wywołania żądania HTTP REST do UpdateTask

gRPC

 static final String PROJECT_ID = "my-delivery-co-gcp-project";
 static final String TASK_ID = "task-8241890";

 DeliveryServiceBlockingStub deliveryService =
   DeliveryServiceGrpc.newBlockingStub(channel);

 // Task settings
 String taskName = "providers/" + PROJECT_ID + "/tasks/" + TASK_ID;
 Task task = Task.newBuilder()
   .setName(taskName)
   .setState(Task.State.CLOSED) // You can only directly CLOSE a
   .build();                    // task that is NOT assigned to a vehicle.

 // Task request
 UpdateTaskRequest updateTaskRequest =
   UpdateTaskRequest.newBuilder()  // No need for the header
       .setTask(task)
       .setUpdateMask(FieldMask.newBuilder().addPaths("state"))
       .build();

 try {
   Task updatedTask = deliveryService.updateTask(updateTaskRequest);
 } catch (StatusRuntimeException e) {
   Status s = e.getStatus();
   switch (s.getCode()) {
      case NOT_FOUND:
        break;
      case PERMISSION_DENIED:
        break;
   }
   return;
 }

REST

PATCH https://fleetengine.googleapis.com/v1/providers/<project_id>/tasks/<id>?updateMask=state

<id> to unikalny identyfikator zadania.
Nagłówek żądania musi zawierać pole Authorization z wartością Bearer <token>, gdzie <token> jest wydawany przez serwer zgodnie z wytycznymi opisanymi w artykule Role na koncie usługi oraz Tokeny internetowe JSON.
W treści żądania musisz umieścić element Task

Przykładowe polecenie curl:

 # Set JWT, PROJECT_ID, and TASK_ID in the local environment
 curl -X PATCH "https://fleetengine.googleapis.com/v1/providers/${PROJECT_ID}/tasks/${TASK_ID}?updateMask=state,taskOutcome,taskOutcomeTime" \
   -H "Content-type: application/json" \
   -H "Authorization: Bearer ${JWT}" \
   --data-binary @- << EOM
 {
   "state": "CLOSED",
   "taskOutcome": "SUCCEEDED",
   "taskOutcomeTime": "$(date -u +"%Y-%m-%dT%H:%M:%SZ")"
 }
 EOM

Wyznacz wynik zadania

Aby wskazać rzeczywisty wynik zadania, określasz wynik dla zadań zamkniętych do SUCCEEDED lub FAILED. Zadanie musi zostać zamknięte, zanim ustawisz jego wyniki. Fleet Engine pobiera opłaty tylko za zadania dostawy o stanie SUCCEEDED

Szczegóły wyniku zadania

Zadania zawierają też dodatkowe informacje o wyniku działania. Możesz ustawić te wartości: bezpośrednio, a Fleet Engine będzie przestrzegać Twoich ustawień:

Lokalizacja wyniku zadania: Fleet Engine automatycznie wypełnia zadanie. lokalizację wyniku z ostatnią znaną lokalizacją pojazdu. Możesz podać: niż wolisz.
Czas wyniku zadania: Fleet Engine nie wypełnia tego pola, ale jest które można ustawić.

Możesz użyć dowolnej z poniższych metod, aby ustawić task_outcome_location i task_outcome_time:

Zaktualizuj je w tym samym żądaniu, które określa wynik zadania.
Zaktualizuj je później, gdy ustawisz wynik zadania.
Zmień je ponownie po ustawieniu.

Fleet Engine uniemożliwia te aktualizacje związane z wynikami zadań:

Nie można zmienić wyniku zadania, jeśli jest on ustawiony na SUCCEEDED albo FAILED
Nie możesz ustawić lokalizacji ani czasu wyniku w przypadku zadań bez na określony wynik.

Pola zadania służące do określania wyniku

W tej sekcji opisujemy pola wymagane i opcjonalne, które należy ustawić podczas konfigurowania w wyniku wykonania zadania. Podczas aktualizacji Fleet Engine ignoruje inne pola w jednostce.

Pole wymagane	Wartość
`taskOutcome`	`Outcome.SUCCEEDED` lub `Outcome.FAILED`

Pole opcjonalne	Wartość
`taskOutcomeLocation`	Lokalizacja, w której zadanie zostało ukończone. Jeśli nie zostanie ustawiona, Fleet Engine domyślnie ustawiana jest ostatnia lokalizacja pojazdu.
`taskOutcomeTime`	Sygnatura czasowa ukończenia zadania.

Przykłady wyników zadania

Poniższy przykład pokazuje, jak korzystać z biblioteki gRPC Java oraz protokołu HTTP. wywołanie REST do UpdateTask w celu ustawienia wyniku zadania na SUCCEEDED i ustawienia miejsce, w którym zadanie zostało ukończone.

gRPC

 static final String PROJECT_ID = "my-delivery-co-gcp-project";
 static final String TASK_ID = "task-8241890";

 DeliveryServiceBlockingStub deliveryService =
   DeliveryServiceGrpc.newBlockingStub(channel);

 // Task settings
 String taskName = "providers/" + PROJECT_ID + "/tasks/" + TASK_ID;
 Task task = Task.newBuilder()
   .setName(taskName)
   .setTaskOutcome(TaskOutcome.SUCCEEDED)
   .setTaskOutcomeTime(now())
   .setTaskOutcomeLocation(               // Grand Indonesia East Mall
     LocationInfo.newBuilder().setPoint(
       LatLng.newBuilder().setLatitude(-6.195139).setLongitude(106.820826)))
   .build();

 // Task request
 UpdateTaskRequest updateTaskRequest =
   UpdateTaskRequest.newBuilder()  // No need for the header
       .setTask(task)
       .setUpdateMask(FieldMask.newBuilder().addPaths("task_outcome", "task_outcome_time", "task_outcome_location"))
       .build();

 try {
   Task updatedTask = deliveryService.updateTask(updateTaskRequest);
 } catch (StatusRuntimeException e) {
   Status s = e.getStatus();
   switch (s.getCode()) {
      case NOT_FOUND:
        break;
      case PERMISSION_DENIED:
        break;
   }
   return;
 }

REST

PATCH https://fleetengine.googleapis.com/v1/providers/<project_id>/tasks/<id>?updateMask=taskOutcome,taskOutcomeTime,taskOutcomeLocation

<id> to unikalny identyfikator zadania.
Nagłówek żądania musi zawierać pole Authorization z wartością Bearer <token>, gdzie <token> jest wydawany przez serwer zgodnie z wytycznymi opisanymi w artykule Role na koncie usługi oraz Tokeny internetowe JSON.
Treść żądania musi zawierać element Task.

 # Set JWT, PROJECT_ID, and TASK_ID in the local environment
 curl -X PATCH "https://fleetengine.googleapis.com/v1/providers/${PROJECT_ID}/tasks/${TASK_ID}?updateMask=taskOutcome,taskOutcomeTime,taskOutcomeLocation" \
   -H "Content-type: application/json" \
   -H "Authorization: Bearer ${JWT}" \
   --data-binary @- << EOM
 {
   "taskOutcome": "SUCCEEDED",
   "taskOutcomeTime": "$(date -u +"%Y-%m-%dT%H:%M:%SZ")",
   "taskOutcomeLocation": {
     "point": {
       "latitude": -6.195139,
       "longitude": 106.820826
     }
   }
 }
 EOM

Co dalej?

Znajdowanie zadań