Zastosowanie i przykład

Rozszerzenie sieci Web Lista pozycji ma parametry dotyczące jego podstawowej funkcjonalności oraz dodatkowe parametry pozwalające dostosować jego zawartość.

Poniżej przedstawiono parametry podstawowe:

  • Klucze pozycji: Odwołanie do zakresu komórek zawierających nazwy unikatowe elementów i akcji do dalszego przetwarzania. W chwili wyzwolenia akcji Actions.Input.Text wysyła jedną z tych wartości:
    • Actions.Input.Text="Row": Pozycja zostanie zaznaczona.
    • Actions.Input.Text="Edit": Kliknięto przycisk Edytuj.
    • Actions.Input.Text="Delete": Kliknięto przycisk Usuń.
  • Dane pozycji: Odwołanie do zakresu komórek zawierających dane pozycji lub do komórki zawierającej te same dane w formacie XML. Pierwsza kolumna zakresu danych jest zarezerwowana dla następujących opcjonalnych właściwości kluczy pozycji:
  • Tytuł (ciąg)
  • Opis 1 (ciąg)
  • Opis 2 (ciąg)
  • Sygnatura czasowa (ciąg)
  • Widoczne (wartość logiczna): jeśli Fałsz, pozycja jest ukryta. Domyślną wartością jest Prawda.
  • Włączone (wartość logiczna): jeśli Fałsz, pozycja jest wyłączona. Domyślną wartością jest Prawda.
  • Wybrano (wartość logiczna): jeśli Prawda, pozycja jest zaznaczona. Domyślna wartość to Fałsz.
  • Edytuj (wartość logiczna): jeśli Prawda, zostaną wyświetlone ikony edycji i usuwania. Domyślna wartość to Fałsz.
Te dodatkowe parametry umożliwiają dostosowanie zawartości. Określ ="", aby używać ustawień domyślnych, gdy są dostępne.
Uwaga

Tam, gdzie może być wprowadzany tekst, na przykład w przypadku komunikatów o błędach, należy używać funkcji TRANSLATEUNIQUESTRING, aby zapewnić tłumaczenie w razie zmiany języka interfejsu użytkownika.

  • Wybór wielokrotny: Jeśli Prawda, wybór wielokrotny jest włączony. Domyślna wartość to Fałsz.
  • Symbol zastępczy pola wyszukiwania: domyślnie pole wyszukiwania jest widoczne i puste. Wybierz Fałsz, aby wyłączyć pole wyboru.
  • Komunikat o błędzie: Domyślny komunikat o błędzie, jeśli nie ma elementów listy, to Brak dostępnych pozycji.
  • Tytuł główny: Tytuł listy. Domyślnie nie jest wyświetlany żaden tytuł.
  • Kolor tytułu głównego: Domyślny kolor tytułu to #368ac0.
  • Kolor tytułu: Domyślny kolor czcionki tytułu to #1a1a1a.
  • Wybrany kolor: Kolor, w którym podświetlony jest wybrany wiersz. Domyślny kolor to #c8e9f4.
  • Wybrane pozycje (tekst): Domyślny tekst to Wybrane. Ten parametr ma zastosowanie tylko wtedy, gdy jest włączony wybór wielokrotny.
  • Akcja usuwania: Definiuje akcję wykonywaną na komórce po kliknięciu przycisku Usuń. Domyślny tekst to Usuń. Ten parametr ma zastosowanie tylko wtedy, gdy jest włączony wybór wielokrotny.
  • Ukryj obramowanie boków: Wybierz wartość Prawda, aby ukryć lewą i prawą krawędź wiersza. Domyślnie obramowanie jest widoczne.
  • Kolor obramowania: Domyślny kolor obramowania to #d8d8d8.
  1. Utwórz raport Application Studio.
  2. Wstaw te przykładowe dane do zakresu B8:H12:
    Klucz Tytuł Opis1 Opis2 Włączone Zaznaczone Edytuj
    a Pozycja A Opis A FAŁSZ PRAWDA
    b Pozycja B Opis B Szczegółowe informacje B FAŁSZ FAŁSZ FAŁSZ
    c Pozycja C Opis C PRAWDA FAŁSZ
    d Pozycja D Opis D FAŁSZ FAŁSZ
  3. Utwórz zmienną raportu o nazwie rv_SelectedItem oraz określ c jako wartość i wartość domyślną. We właściwościach zmiennej określ Fałsz jako wartość opcji Jest trwałeIs Persistent.
  4. W komórce G9 określ =ReportVariables.rv_SelectedItem.Text=B9. Skopiuj formułę do komórek G10, G11 i G12.
    Po tej aktualizacji komórki zachowują swoje oryginalne teksty.
  5. Na każdej z kluczowych komórek (B9, B10, B11 i B12) utwórz akcję z tymi cechami:
    Akcje: Typ
    Wybierz Ustaw parametry jako typ akcji.
    Akcje: Tryb
    Wybierz Rozszerzenie sieci Web jako tryb.
    Akcje: Warunek
    Określ =Actions.Input.Text="ROW".
    Uwaga

    Ten warunek jest nieprawidłowy, chyba że trybem akcji jest Rozszerzenie sieci Web.

    Parametry: Nazwa
    Kliknij Dodaj parametr i wybierz zmienną rv_SelectedItem.
    Parametry: Właściwość
    Określ Selected Value(.Text).
    Parametry: Wartość
    Dla akcji w komórce B9 określ =B9. Dla pozostałych akcji określ odpowiednio =B10, =B11 i =B12.
  6. Utwórz zmienną raportu o nazwie rv_TitleItemA i określ Pozycja A jako jej wartość. We właściwościach zmiennej określ Pozycja A jako wartość domyślną i wybierz Fałsz dla opcji Jest trwałe.
  7. W komórce C9 określ =ReportVariables.rv_TitleItemA.Text i naciśnij klawisz Enter.
    Po tej zmianie komórka zachowuje swój oryginalny tekst.
  8. W komórce B9 utwórz akcję z następującymi cechami:
    Akcje: Typ
    Wybierz Ustaw parametry jako typ akcji.
    Akcje: Tryb
    Wybierz Rozszerzenie sieci Web jako tryb.
    Akcje: Warunek
    Określ =Actions.Input.Text="EDIT"
    Uwaga

    Ten warunek jest nieprawidłowy, chyba że trybem akcji jest Rozszerzenie sieci Web.

    Parametry: Nazwa
    Kliknij Dodaj parametr i wybierz zmienną rv_TitleItemA.
    Parametry: Właściwość
    Wybierz Value(.Text)
    Parametry: Wartość
    Określ ="Edytowano pozycję A".
  9. W komórce B13 wpisz następującą forjułę SETPROPERTY: 
    =SETPROPERTY("",B9:B12,C8,C9:C12,D8,D9:D12,E8,E9:E12,F8,F9:F12,G8,G9:G12,H8,H9:H12)
  10. Kliknij Rozszerzenie sieci Web na pasku narzędzi Obiekty, a następnie kliknij dwukrotnie rozszerzenie sieci Web Lista pozycji.
    Kursor zmieni się w krzyżyk.
  11. Przeciągnij kursor, aby wstawić rozszerzenie sieci Web oraz określić jego rozmiar i położenie.
  12. Określ następujące parametry.
    Nazwy unikatowe
    Określ zakres komórek zawierających nazwy unikatowe elementów listy. W tym przykładzie określ =B9:B12.
    Dane pozycji
    Określ zakres komórek definiujących tabelę danych dla rozszerzenia. W tym przykładzie określ =B13.
  13. Ewentualnie określ wartości tych parametrów albo określ ="", aby używać wartości domyślnych.
    Tytuł główny
    Domyślnie lista nie ma tytułu. Opcjonalnie określ tytuł.
    Kolor czcionki tytułu głównego
    Jeśli określono tytuł główny, jego kolor domyślny to niebieski (#368ac0). Opcjonalnie można określić inną wartość koloru.
    Symbol zastępczy pola wyszukiwania
    Domyślnie pole wyszukiwania jest puste. Opcjonalnie można zdefiniować tekst, który ma być wyświetlany w tym polu. Aby ukryć pole wyszukiwania, określ FAŁSZ (z uwzględnieniem wielkości liter).
    Komunikat o błędzie:
    Domyślnie żaden błąd nie jest wyświetlany, jeśli nie ma dostępnych pozycji. Opcjonalnie określ komunikat o błędzie. Użyj funkcji TRANSLATESTRING, aby zapewnić tłumaczenie komunikatu o błędzie w przypadku zmiany języka interfejsu użytkownika.
    Kolor czcionki tytułu
    Domyślnie tytuły pozycji listy mają kolor ciemnoszary (#1a1a1a). Opcjonalnie można podać inną wartość koloru
    Wybrany kolor
    Określ kolor wyróżnienia wybranej pozycji z listy. Domyślny kolor to jasnoniebieski (#c8e9f4). Opcjonalnie można określić inną wartość koloru.
    Wybór wielokrotny
    Domyślnie można wybierać tylko pojedyncze pozycje. Aby włączyć pola wyboru wielu elementów, określ ="TRUE".
    Ukryj obramowanie boków
    Domyślnie każdy wiersz ma obramowanie z lewej i prawej strony. Określ "=TRUE", aby ukryć te obramowania.
    Kolor obramowania
    Domyślnie górna i boczne krawędzie listy są szare (#d8d8d8). Opcjonalnie można określić inną wartość koloru.
    Wybrane pozycje (tekst)
    Jeśli jest włączona opcja wielokrotnego wyboru, pokazywana jest liczba wybranych elementów i słowo Selected. Można również określić inny tekst. Użyj funkcji TRANSLATESTRINGUNIQUE, aby zapewnić tłumaczenie tekstu, jeśli język interfejsu użytkownika ulegnie zmianie.
    Przycisk Usuń paska akcji

    Jeśli wybór wielokrotny jest włączony, można wyświetlić przycisk Usuń, aby usunąć zaznaczenie wybranych elementów. Określ odwołanie do komórki, która zawiera słowo Usuń.

    Użyj funkcji TRANSLATESTRING, aby zapewnić tłumaczenie przycisku, jeśli język interfejsu użytkownika ulegnie zmianie.