# Czynności

GET /v2/activities

Activity (Czynność).

# Definicja obiektu

Definicja obiektu Activity.

# Atrybuty

rowId int
Unikalny identyfikator dla tego wiersza.

id string
Unikalny identyfikator dla tego obiektu.

cardNumber string
Numer karty pracy pracownika.

employeeUniqueId int
Unikalny identyfikator pracownika.

employee string
Numer interfejsowy pracownika.

day date
Dzień pracy odpowiadający dobie pracowniczej.

from datetime
Rozpoczęcie czynności.

to datetime
Zakończenie czynności.

actId guid
Unikalny identyfikator wybranej czynności.

actName string
Nazwa wybranej czynności.

actPath string
Ścieżka wyboru wybranej czynności.

device object
Obiekt opisujacy urządzenie, na którym została wystartowana czynność.

id guid
Unikalny identyfikator urządzenia.

name string
Nazwa urządzenia.

location string
Nazwa lokalizacji urządzenia.

params array
Lista obiektów opisujących wartości parametrów skojarzonych z tą czynnością.

id int
Unikalny identyfikator tego obiektu.

paramId guid
Unikalny identyfikator definicji parametru.

paramName string
Nazwa parametru parametru.

value string
Wartość parametru.

modifiedAt datetime
Data i czas ostatniej modyfikacji

# Przykład

{
    "rowId": 123,
    "modifiedAt": "2020-02-01T00:00:00",
    "id": "xyz456",
    "cardNumber": "2020/01/030054",
    "employee": "abc123",
    "day": "2020-01-01",
    "from": "2020-01-01T00:00:00",
    "to": "2020-01-01T00:00:00",
    "actId": "123abc",
    "actName": "Bindowanie",
    "actPath": "Czynności\\Magazyn",
    "device": {
        "id": "abc123",
        "name": "Terminal 1"
    },
    "params": [
        {
            "id": "123",
            "paramid": "abc123",
            "paramName": "Ilość palet",
            "value": "1"
        }
    ]
}

# Lista obiektów

Zwraca stronicowalną listę wszystkich zarejestrowanych czynności wybieranych przez pracowników.

Parametry

  • limit - ilość rekordów dla strony - domyślnie 1000 (max 20000)
  • lastRowId - indeks ostatniego wiersza lastRowId z obiektu Paging, brak tego parametru oznacza, że system zwróci pierwszą stronę danych dla zadanego warunku wyszukiwania
  • includes - nazwy pól typu obiektu Activity rozdzielonych przecinkiem, które mają zostać dołączone (możliwe wartości: params, device) - domyślnie puste
  • from - filtr bazujący na dacie wystąpienia czynności, podanie tej daty spowoduje, że zwrócone zostaną tylko te które będą starsze bądź równe podanej wartości - domyślnie dzień bieżący
  • to - filtr bazujący na dacie wystąpienia czynności, podanie tej daty spowoduje, że zwrócone zostaną tylko te które będą nowsze bądź równe podanej wartości - domyślnie dzień bieżący
  • employee - podany id pracownika spowoduje, że zwrócone zostaną wpisy tylko jednego pracownika - domyślnie puste
  • location - podany id lokalizacji spowoduje, że zwrócone zostaną wpisy pracowników ze wskazanej lokalizacji - domyślnie puste
  • withArchivedEmployees - dla wartości 1 dodatkowo zostaną zwrócone dane także dla pracowników archiwalnych - domyślnie puste
{
    "paging": {
        "firstRowId": 1,
        "lastRowId": 1,
        "fetched": 1
    },
    "items": [
        { Activity },
        { ... }
    ]
}

Zwraca
Obiekt zawierający metadane oraz listę zarejestrowanych czynności wskazywanych przez pracowników items. Każdy element listy jest osobnym obiektem Activity. Pusta lista oznacza, że nie ma więcej rekordów. To żądanie nigdy nie powinno zwrócić błędu.