Déploiement de la réécriture

La réécriture permet aux utilisateurs de mettre à jour les données directement à partir des tableaux de bord et des analyses.

Les champs de réécriture apparaissent comme des champs modifiables dans les analyses pour les utilisateurs disposant du privilège Réécrire dans la base de données. Les valeurs qu'ils saisissent sont enregistrées dans la base de données Les champs de réécriture apparaissent comme des champs en lecture seule pour les utilisateurs ne disposant pas du privilège Réécrire dans la base de données.

Si un utilisateur saisit une valeur dans un champ modifiable et clique sur le bouton de réécriture, l'application exécute la commande SQL insert ou update définie dans le modèle de réécriture. Si la commande fonctionne, l'analyse est mise à jour avec la nouvelle valeur. En cas d'erreur lors de la lecture du modèle ou de l'exécution de la commande SQL, un message d'erreur apparaît.

La commande insert est exécutée lorsqu'un enregistrement n'existe pas encore et que l'utilisateur saisit de nouvelles données dans la table. Dans ce cas, l'utilisateur a effectué une saisie dans un enregistrement de table dans lequel la valeur d'origine était NULL. La commande update est exécutée lorsqu'un utilisateur modifie des données existantes. Pour afficher un enregistrement qui n'existe pas encore dans la table physique, vous pouvez créer une autre table analogue. Servez-vous de cette table analogue pour afficher des enregistrements de réserve qu'un utilisateur peut modifier.

<?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>

Les administrateurs peuvent permettre aux utilisateurs de modifier les données dans les analyses et tableaux de bord.

1. Configurez votre modèle sémantique .

   Remarque :

   Suivez ces étapes si vous utilisez l'outil d'administration de modèle pour développer des modèles sémantiques. Si vous utilisez le modeleur sémantique, reportez-vous à

   Activation de la réécriture sur les colonnes .

   1. Dans l'outil d'administration de modèle, ouvrez votre modèle sémantique (fichier .rpd).
   2. Dans la couche physique, cliquez deux fois sur la table physique contenant la colonne pour laquelle vous souhaitez activer la réécriture.
   3. Dans l'onglet Général de la boîte de dialogue Table physique, vérifiez que l'option Mise en mémoire cache possible n'est pas sélectionnée. Si vous désélectionnez cette option, vous vous assurez que les utilisateurs de Presentation Services voient les mises à jour immédiatement.
   4. Dans la couche Modèle de gestion et correspondance, cliquez deux fois sur la colonne logique correspondante.
   5. Dans la boîte de dialogue Colonne logique, sélectionnez Accessible en écriture, puis cliquez sur OK.
   6. Dans la couche Présentation, cliquez deux fois sur la colonne qui correspond à la colonne logique pour laquelle vous avez activé la réécriture.
   7. Dans la boîte de dialogue Colonne de présentation, cliquez sur Droits d'accès.
   8. Sélectionnez le droit d'accès Lecture/Ecriture pour les utilisateurs et les rôles d'application appropriés.
   9. Enregistrez les modifications.
2. Créez un document XML avec vos modèles de réécriture. Reportez-vous à Création de fichiers de modèle de réécriture.

   Le document XML peut contenir plusieurs modèles. Cet exemple montre un document XML qui contient deux modèles (SetQuotaUseID et 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>

   Remarque : vous devez inclure un élément <insert> et un élément <update>, même s'ils ne sont pas utilisés. Par exemple, si vous n'exécutez qu'une commande insert, vous devez inclure une instruction update vide : <update></update>.
3. Copiez le document XML contenant vos modèles de réécriture dans le presse-papiers.
4. Appliquez votre modèle de réécriture dans Oracle Analytics :
   1. Cliquez sur Console, puis sur Paramètres système.
   2. Dans Fichier XML de modèle de réécriture, collez le modèle de réécriture que vous avez copié à l'étape 3.
5. Octroyez des droits d'accès pour utiliser le code de réécriture :
   1. Accédez à la page d'accueil classique, puis cliquez sur Administration.
   2. Sous Sécurité, cliquez sur Gérer les privilèges et accédez à Réécrire.
   3. Octroyez le privilège Réécrire dans la base de données à l'utilisateur authentifié.
   4. Octroyez le privilège Gérer la réécriture à l'administrateur de service BI.
6. Pour activer la réécriture dans les colonnes, procédez comme suit :
   1. Dans l'éditeur d'analyse, affichez les propriétés de la colonne pour laquelle vous voulez activer la réécriture.
   2. Dans la boîte de dialogue Propriétés de colonne, cliquez sur l'onglet Réécrire.
      Si la colonne a été activée pour la réécriture dans le modèle sémantique, la case Activer la réécriture est disponible.
   3. Sélectionnez l'option Activer la réécriture.
   4. Indiquez la valeur des autres options si vous souhaitez modifier les valeurs par défaut.
   5. Enregistrez les modifications.
   La réécriture est activée pour la colonne dans toutes les analyses qui comprennent cette dernière.
7. Pour activer la réécriture dans les vues de table, procédez comme suit :
   1. Dans l'éditeur d'analyse, ouvrez la vue de table à des fins de modification.
   2. Cliquez sur Visualiser les propriétés.
   3. Dans la boîte de dialogue Propriétés de la table, cliquez sur l'onglet Réécrire.
   4. Sélectionnez l'option Activer la réécriture.
   5. Cochez la case Nom de modèle, puis indiquez la valeur "WebMessage name=" dans le modèle de réécriture que vous avez spécifié à l'étape 2.
      Par exemple, le nom de modèle de l'exemple de modèle à l'étape 2 est SetQuotaUseID.
   6. Enregistrez les modifications.