Wdrażanie funkcji zapisu zwrotnego

Funkcja zapisu zwrotnego umożliwia użytkownikom aktualizowanie danych bezpośrednio z pulpitów informacyjnych i analiz.

Użytkownicy mający uprawnienie Zapisywanie zwrotne w bazie danych widzą w analizach pola z włączonym zapisem zwrotnym jako pola edytowalne. Wartości wprowadzane w tych polach są zapisywane w bazie danych. Użytkownicy niemający uprawnienia Zapisywanie zwrotne w bazie danych widzą pola z włączonym zapisem zwrotnym jako pola tylko do odczytu.

Jeśli użytkownik wpisze jakąś wartość w polu edytowalnym i naciśnie przycisk zapisu zwrotnego, aplikacja uruchomi polecenie SQL insert lub update zdefiniowane w szablonie zapisu zwrotnego. Jeśli polecenie zostanie pomyślnie wykonane, analiza jest aktualizowana z użyciem nowej wartości. Jeśli podczas odczytywania szablonu lub uruchamiania polecenia SQL wystąpi błąd, zostanie wyświetlony komunikat o błędzie.

Polecenie insert jest uruchamiane, gdy rekord jeszcze nie istnieje, a użytkownik wprowadzi nowe dane do tabeli. Oznacza to, że użytkownik wpisał wartość w polu rekordu tabeli, które pierwotnie miało wartość Null. Polecenie update jest uruchamiane, gdy użytkownik zmodyfikuje istniejące dane. Aby wyświetlić rekord, który jeszcze nie istnieje w tabeli fizycznej, można utworzyć inną podobną tabelę. Tabeli tej można następnie użyć do wyświetlania rekordów-wypełniaczy, które użytkownik może modyfikować.

<?xml version="1.0" encoding="utf-8" ?>
<WebMessageTables xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="oracle.bi.presentation/writebackschemas/v1">
<WebMessageTable lang="en-us" system="WriteBack" table="Messages">
   <WebMessage name="SetQuotaUseID">
      <XML>
         <writeBack connectionPool="Supplier">
            <insert>INSERT INTO regiontypequota VALUES(@{c5f6e60e1d6eb1098},@{c5d7e483445037d9e},'@{c3a93e65731210ed1}','@{c6b8735ea60ff3011}',@{c0432jkl53eb92cd8})</insert>
            <update></update>
         </writeBack>
      </XML>
   </WebMessage>
<WebMessage name="SetForecastUseID">
      <XML>
         <writeBack connectionPool="Supplier">
            <insert>INSERT INTO regiontypeforecast VALUES(@{c83ebf607f3cb8320},@{cb7e2046a0fba2204},'@{c5a93e65d31f10e0}','@{c5a93e65d31f10e0}',@{c7322jkl93ev92cd8})</insert>
            <update></update>
         </writeBack>
      </XML>
   </WebMessage>
</WebMessageTable>
</WebMessageTables>

Administratorzy mogą umożliwić użytkownikom edycję danych w analizach i pulpitach informacyjnych.

1. Przygotować model semantyczny.

   Uwaga:

   Jeśli do tworzenia modeli semantycznych jest używane narzędzie Model Administration Tool, należy wykonać następujące czynności. Jeśli jest używane narzędzie Semantic Modeler, zob.

   Włączanie zapisu zwrotnego w kolumnach .

   1. W narzędziu Model Administration Tool otworzyć model semantyczny (plik .rpd).
   2. W warstwie fizycznej kliknąć dwukrotnie na tabeli fizycznej, zawierającej kolumnę, dla której ma zostać włączona możliwość zapisu zwrotnego.
   3. Na karcie Ogólne okna dialogowego "Tabela fizyczna" upewnić się, że nie jest wybrana opcja Może być buforowane. Jeśli ta opcja nie jest wybrana, użytkownicy Presentation Services będą od razu widzieć aktualizacje.
   4. W warstwie "Model biznesowy i mapowanie" kliknąć dwukrotnie na odpowiadającej kolumnie logicznej.
   5. W oknie dialogowym "Kolumna logiczna" wybrać opcję Możliwość zapisu, po czym nacisnąć przycisk OK.
   6. W warstwie "Prezentacja" kliknąć dwukrotnie na kolumnie odpowiadającej kolumnie logicznej, zawierającej kolumnę, dla której została włączona możliwość zapisu zwrotnego.
   7. W oknie dialogowym "Kolumna prezentacji" wybrać Uprawnienia.
   8. Wybrać uprawnienie Odczyt/zapis dla odpowiednich użytkowników i ról poziomu aplikacji.
   9. Zapisać dokonane zmiany.
2. Utworzyć dokument XML z szablonem (lub szablonami) zapisu zwrotnego. Zob. Tworzenie plików szablonów zapisu zwrotnego.

   Dokument XML może zawierać wiele szablonów. W tym przykładzie pokazano dokument XML, który zawiera dwa szablony (SetQuotaUseID i SetForecastUseID).

   <?xml version="1.0" encoding="utf-8" ?>
   <WebMessageTables xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="oracle.bi.presentation/writebackschemas/v1">
   <WebMessageTable lang="en-us" system="WriteBack" table="Messages">
      <WebMessage name="SetQuotaUseID">
         <XML>
            <writeBack connectionPool="Supplier">
               <insert>INSERT INTO regiontypequota VALUES(@{c5f6e60e1d6eb1098},@{c5d7e483445037d9e},'@{c3a93e65731210ed1}','@{c6b8735ea60ff3011}',@{c0432jkl53eb92cd8})</insert>
               <update>UPDATE regiontypequota SET Dollars=@{c0432jkl53eb92cd8} WHERE YR=@{c5f6e60e1d6eb1098} AND Quarter=@{c5d7e483445037d9e} AND Region='@{c3a93e65731210ed1}' AND ItemType='@{c6b8735ea60ff3011}'</update>
            </writeBack>
         </XML>
      </WebMessage>
   <WebMessage name="SetForecastUseID">
         <XML>
            <writeBack connectionPool="Supplier">
               <insert>INSERT INTO regiontypeforecast VALUES(@{c83ebf607f3cb8320},@{cb7e2046a0fba2204},'@{c5a93e65d31f10e01}','@{c5a93e65d31f10e0}',@{c7322jkl93ev92cd8})</insert>
               <update>UPDATE regiontypeforecast SET Dollars=@{c7322jkl93ev92cd8} WHERE YR=@{c83ebf607f3cb8320} AND Quarter=@{cb7e2046a0fba2204} AND Region='@{c5a93e65d31f10e01}' AND ItemType='@{c5a93e65d31f10e0}'</update>
            </writeBack>
         </XML>
      </WebMessage>
   </WebMessageTable>
   </WebMessageTables>

   Uwaga: konieczne jest umieszczenie zarówno elementu <insert>, jak i elementu <update>, nawet wówczas, gdy nie są faktycznie wykorzystywane oba z nich. Na przykład jeśli jest wykonywana tylko operacja insert, należy umieścić pustą instrukcję update (<update></update>).
3. Skopiować do schowka dokument XML zawierający szablony zapisu zwrotnego.
4. Zastosować swój szablon zapisu zwrotnego w Oracle Analytics:
   1. Wybrać opcję Konsola, a następnie Ustawienia systemowe.
   2. W obszarze XML szablonu zapisu zwrotnego wkleić szablon, który został skopiowany w kroku 3.
5. Przypisać uprawnienia zezwalające na używanie kodu zapisu zwrotnego:
   1. Przejść na stronę startową Classic, po czym kliknąć na łączu Administrowanie.
   2. W obszarze Zabezpieczenia wybrać Zarządzanie uprawnieniami, po czym przejść do opcji Zapis zwrotny.
   3. Przyznać uprawnienie Zapisywanie zwrotne w bazie danych roli Zidentyfikowany użytkownik.
   4. Przyznać uprawnienie Zarządzanie zapisywaniem zwrotnym roli Administrator usługi BI.
6. Aby włączyć zapis zwrotny w kolumnach:
   1. W edytorze analiz wyświetlić właściwości kolumny, dla której ma zostać włączona możliwość zapisu zwrotnego.
   2. W oknie "Właściwości kolumny" kliknąć na karcie Zapis zwrotny.
      Jeśli dla kolumny istnieje możliwość zapisu zwrotnego w modelu semantycznym, jest dostępne pole wyboru Włącz zapis zwrotny.
   3. Wybrać opcję Włącz zapis zwrotny.
   4. Jeśli mają zostać zmienione ustawienia domyślne, określić wartości innych opcji.
   5. Zapisać dokonane zmiany.
   Została włączona możliwość zapisu zwrotnego dla kolumny z dowolnej, zawierającej ją analizy.
7. Aby włączyć zapis zwrotny w widokach tabel:
   1. W edytorze analiz otworzyć widok tabeli do edycji.
   2. Nacisnąć przycisk Właściwości widoku.
   3. W oknie dialogowym "Właściwości kolumny" kliknąć na karcie Zapis zwrotny.
   4. Wybrać opcję Włącz zapis zwrotny.
   5. Zaznaczyć pole wyboru Nazwa szablonu, po czym określić wartość "WebMessage name=" w szablonie zapisu zwrotnego, określonym w punkcie 2.
      Na przykład wartością Nazwa szablonu z przykładowego szablonu z punktu 2 jest "SetQuotaUseID".
   6. Zapisać dokonane zmiany.