Wstęp

Niezależnie od tego, na jaki element została przypisana akcja, zawsze konfigurowane są one w ten sam sposób oraz obsługiwane przez wtyczkę w ten sam sposób. Jak widać na Konfiguracja DataViewer, akcję można przypisać do:

widoku - akcja zostanie uruchomiona po kliknięciu w wiersz
kolumnie - akcja zostanie uruchomiona po kliknięciu w komórkę dla odpowiedniej kolumny
link - akcja zostanie uruchomiona po kliknięciu w link

Każdy obiekt akcji musi zawierać pole type określające typ akcji. Poszczególne typy akcji zostały przedstawione poniżej.

Akcja: wyświetlenie okienka do zarządzania komentarzami

Wartość type: showComments

Opis: wyświetlenie okienka, w którym użytkownik będzie miał możliwość dodania nowego komentarza, lub usunięcia własnego komentarza.

Opcje konfiguracyjne

Akcja nie zawiera żadnych opcji konfiguracyjnych.

Przykładowa konfiguracja

"action": {
  "type": "showComments"
}

Akcja: przejście do formularza zadania

Wartość type: showActivityForm

Opis: przejście do formularza zadania na podstawie podanego processId oraz activityId

Opcje konfiguracyjne

mapping (object) - obiekt mapowania wartości kolumn na processId oraz activityId

Obiekt mapping

processId (string) - identyfikator kolumny widoku, której wartość ma być podstawiona jako identyfikator procesu
activityId (string) - identyfikator kolumny widoku, której wartość ma być podstawiona jako identyfikator zadania

Przykładowa konfiguracja

{
    "menus": [
        {
            "id": "exampleMenuId",
            "name": "Przykładowa nazwa menu",
            "views": [
                {
                    "id": "exampleViewId",
                    "name": "Przykładowa nazwa widoku",
                    "source": {
                        "type": "DATASOURCE",
                        "id": "exampleDatasourceId"
                    },
                    "outputs": [
                        {
                            "id": "exampleOutputId1",
                            "name": "Identyfikator procesu",
                            "alias": "processIdFromDatasource",
                            "primaryKey": true
                        },
                        {
                            "id": "exampleOutputId2",
                            "name": "Identyfikator zadania",
                            "alias": "activityIdFromDatasource"
                        }
                    ],
                    "action": {
                        "type": "showActivityForm",
                        "mapping": {
                            "processId": "exampleOutputId1",
                            "activityId": "exampleOutputId2"
                        }
                    }
                }
            ]
        }
    ]
}

Akcja: przejście do historii zadania

Wartość type: showActivityDetails

Opis: przejście do historii zadania na podstawie podanego processId oraz activityId

Opcje konfiguracyjne

mapping (object) - obiekt mapowania wartości kolumn na processId oraz activityId

Obiekt mapping

processId (string) - identyfikator kolumny widoku, której wartość ma być podstawiona jako identyfikator procesu
activityId (string) - identyfikator kolumny widoku, której wartość ma być podstawiona jako identyfikator zadania

Przykładowa konfiguracja

{
    "menus": [
        {
            "id": "exampleMenuId",
            "name": "Przykładowa nazwa menu",
            "views": [
                {
                    "id": "exampleViewId",
                    "name": "Przykładowa nazwa widoku",
                    "source": {
                        "type": "DATASOURCE",
                        "id": "exampleDatasourceId"
                    },
                    "outputs": [
                        {
                            "id": "exampleOutputId1",
                            "name": "Identyfikator procesu",
                            "alias": "processIdFromDatasource",
                            "primaryKey": true
                        },
                        {
                            "id": "exampleOutputId2",
                            "name": "Identyfikator zadania",
                            "alias": "activityIdFromDatasource"
                        }
                    ],
                    "action": {
                        "type": "showActivityDetails",
                        "mapping": {
                            "processId": "exampleOutputId1",
                            "activityId": "exampleOutputId2"
                        }
                    }
                }
            ]
        }
    ]
}

Akcja: przejście do historii procesu

Wartość type: showProcessDetails

Opis: przejście do historii zadania na podstawie podanego processId.

Opcje konfiguracyjne

mapping (object) - obiekt mapowania wartości kolumn na processId

Obiekt mapping

processId (string) - identyfikator kolumny widoku, której wartość ma być podstawiona jako identyfikator procesu

Przykładowa konfiguracja

{
    "menus": [
        {
            "id": "exampleMenuId",
            "name": "Przykładowa nazwa menu",
            "views": [
                {
                    "id": "exampleViewId",
                    "name": "Przykładowa nazwa widoku",
                    "source": {
                        "type": "DATASOURCE",
                        "id": "exampleDatasourceId"
                    },
                    "outputs": [
                        {
                            "id": "exampleOutputId1",
                            "name": "Identyfikator procesu",
                            "alias": "processIdFromDatasource",
                            "primaryKey": true
                        },
                        {
                            "id": "exampleOutputId2",
                            "name": "Identyfikator zadania",
                            "alias": "activityIdFromDatasource"
                        }
                    ],
                    "action": {
                        "type": "showProcessDetails",
                        "mapping": {
                            "processId": "exampleOutputId1"
                        }
                    }
                }
            ]
        }
    ]
}

Akcja: przejście do widoku

Wartość type: showView

Opis: przejście do innego widoku w obrębie tego samego menu. Wartości kolumn mogą być zmapowane na wartości filtrów w docelowym widoku.

Opcje konfiguracyjne

mappings (list) - lista obiektów mapowania wartości kolumn aktualnego widoku na wartości filtrów docelowego widoku (UWAGA - mappings jest listą obiektów)
viewId (string) - identyfikator docelowego widoku

Obiekt mapping

value (string) - wartość która ma być podstawiona jako wartość filtra w docelowym widoku
outputId (string) - identyfikator kolumny widoku, której wartość ma być podstawiona jako wartość filtra w docelowym widoku. Opcja będzie uwzględniona tylko gdy parametr value będzie pusty (null)
inputId (string) - identyfikator filtra w docelowym widoku

Przykładowa konfiguracja

{
    "menus": [
        {
            "id": "exampleMenuId",
            "name": "Przykładowa nazwa menu",
            "views": [
                {
                    "id": "exampleViewId1",
                    "name": "Przykładowa nazwa widoku 1",
                    "source": {
                        "type": "DATASOURCE",
                        "id": "exampleDatasourceId1"
                    },
                    "outputs": [
                        {
                            "id": "exampleOutputId1",
                            "name": "Identyfikator procesu",
                            "alias": "processIdFromDatasource",
                            "primaryKey": true
                        }
                    ],
                    "action": {
                        "type": "showView",
                        "viewId": "exampleViewId2",
                        "mappings": [
                            {
                                "outputId": "exampleOutputId1",
                                "inputId": "exampleInputId2"
                            }
                        ]
                    }
                },
                {
                    "id": "exampleViewId2",
                    "name": "Przykładowa nazwa widoku 2",
                    "source": {
                        "type": "DATASOURCE",
                        "id": "exampleDatasourceId2"
                    },
                    "inputs": [
                        {
                            "id": "exampleInputId2",
                            "name": "Identyfikator procesu",
                            "alias": "processIdToDatasource"
                        }
                    ],
                    "outputs": [
                        {
                            "id": "exampleOutputId2",
                            "name": "Identyfikator zadania",
                            "alias": "activityIdFromDatasource",
                            "primaryKey": true
                        }
                    ]
                }
            ]
        }
    ]
}

Akcja: przejście do innej strony

Wartość type: openUrl

Opis: przejście do innego innej strony na podstawie podanego adresu URL. Wartości kolumn mogą być zmapowane na parametry zapytania.

Opcje konfiguracyjne

parameters (list) - lista obiektów mapowania wartości kolumn aktualnego widoku na parametry zapytania adresu URL (UWAGA - parameters jest listą obiektów)
url (string) - adres URL
absolute (boolean) - określenie, czy adres URL jest ścieżką bezwzględną
openInNewTab (boolean) - określenie, czy strona ma być otwarta w nowej karcie

Przejście do widoku

Jeżeli akcja ma przejść na stroną spoza systemu PlusWorkflow, adres URL powinien być ścieżką bezwzględną np. https://www.google.com

Jeżeli akcja ma przejść na stronę w obrębie systemu PlusWorkflow, to parametr absolute powinien być ustawione na true, a adres URL powinien być ścieżką względną np. ShowProcessHistory.do

Obiekt parameter

outputId (string) - identyfikator kolumny widoku, której wartość ma być podstawiona jako wartość parametru zapytania
name (string) - nazwa parametru zapytania

Przykładowa konfiguracja

{
    "menus": [
        {
            "id": "exampleMenuId",
            "name": "Przykładowa nazwa menu",
            "views": [
                {
                    "id": "exampleViewId",
                    "name": "Przykładowa nazwa widoku",
                    "source": {
                        "type": "DATASOURCE",
                        "id": "exampleDatasourceId"
                    },
                    "outputs": [
                        {
                            "id": "exampleOutputId1",
                            "name": "Identyfikator procesu",
                            "alias": "processIdFromDatasource",
                            "primaryKey": true
                        }
                    ],
                    "action": {
                        "type": "openUrl",
                        "url": "https://www.google.com/search",
                        "absolute": true,
                        "openInNewTab": true,
                        "parameters": [
                          {
                            "name": "q",
                            "outputId": "exampleOutputId1"
                          }
                        ]
                      }
                }
            ]
        }
    ]
}