Oracle Analytics Cloud a změna vlastnictví objektů katalogu

Když uživatelé opustí společnost, změní oddělení nebo dokonce změní název, je nutné změnit vlastnictví objektů katalogu, aby byla zachována konzistence v celém katalogu, a od toho tu je Oracle Analytics Cloud.

Změna vlastnictví pomocí skriptu pomocí příkazu runcat v Oracle Analytics Cloudu

Správa uživatelů a jejich obsahu v Oracle Analytics Cloud může být náročný úkol – zejména když uživatelé opouštějí organizaci nebo se jejich role mění. Jednou z běžných výzev, kterým administrátoři čelí, je potřeba znovu přiřadit vlastnictví položek katalogu v rámci velkého počtu sestav a složek.

Ruční aktualizace vlastnictví? Není škálovatelné. A tady přichází na řadu automatizace.

Vytvořili jsme skript, který můžete použít ke změně vlastnictví objektů katalogu v Oracle Analytics Cloud. Skript používá dva příkazy runcat. Pokud nevíte, runcat.sh/cmd je velmi užitečný nástroj pro provádění různých typů změn v katalogu Oracle Analytics Cloud. Jednou z takových možností je změna vlastnictví objektu katalogu.

Nástroj příkazového řádku runcat je součástí klientských nástrojů Oracle Analytics Cloud pro Windows i Linux a je součástí instalace serveru Oracle Analytics.

Co tento skript dělá?

Před spuštěním tohoto skriptu se ujistěte, že máte aktuální snímek jako zálohu.

Tento skript automatizuje proces:

• Generování úplné katalogové sestavy všech položek ve složce / shared.
• Filtrování položek katalogu podle vlastnictví uživatele, s vyloučením obsahu specifického pro systém (například složek _portal).
• Generování přehledů obsahu vlastněného uživateli podle jednotlivých uživatelů.
• Příprava a tisk příkazů pro opětovné přiřazení vlastnictví novým uživatelům na základě vstupního souboru CSV.

Skript spustí příkaz runcat služby Oracle Analytics Cloud dvakrát s různými možnostmi.

• První možnost vygeneruje seznam vlastníků a objektů, které vlastní.
• Druhá možnost změní vlastnictví těchto objektů.

Před spuštěním skriptu je nutné provést úvodní nastavení, které zahrnuje vytvoření několika proměnných, z nichž některé se používají jako vstup pro runcat:

• catalogPath: Cesta k umístění skriptu runcat.sh od Oracle.
• oacURL: Koncový bod pro prostředí Oracle Analytics Cloud.
• userFile: Soubor CSV obsahující mapování uživatelů ve formátu ID_uživatele, e-mail.

Například:

catalogPath = ‚/scratch/AdminTool/bi/bitools/bin‘
oacURL = ‚https://oracleAnalytics-id-ia.analytics.ocp.oraclecloud.com/analytics-ws/saw.dll‘
userFile = ‚/scratch/amar/report/finalScript/python/activeUsers.csv‘

Vstupní soubor, v tomto případě activeUsersC.csv, musí být také vytvořen. Vstupní soubor je soubor s jedním sloupcem, který obsahuje dvě hodnoty oddělené čárkou. Tyto dvě hodnoty jsou ID uživatele nebo starý vlastník a e-mail nebo nový vlastník. Pokud uživatel již neexistuje, bude ignorován. Formát vstupního souboru je:

Příkaz report vygeneruje pro každého starého uživatele výstupní soubor se seznamem objektů, které mají být změněny. Po kroku report příkaz vypíše nové uživatele a odpovídající výstupní soubor obsahující seznam objektů, které mají být přejmenovány. Skript se v tomto bodě pozastaví a nabídne vám možnost skript zastavit a zkontrolovat výstupní soubory, nebo pokračovat s příkazem setOwnership. Po kontrole změn, které mají být provedeny, jednoduše skript znovu spusťte, ale tentokrát ho nechte pokračovat, místo abyste ho zastavili.

Dvě možnosti runcat jsou ‚report‘ pro generování seznamu vlastnictví a ‚setOwnership‘ pro změnu vlastníka.

Struktura příkazu report je:

runcat.sh -cmd report -online "https://OACinstance.ocp.oraclecloud.com/analytics-ws/saw.dll"
-excelFormat -delimiter "," -forceoutputFile "/scratch/tmp/Object.xls" -folder "/shared" -type "All" -fields "Owner:Path" -recursionDepth 19 -credentials "/scratch/tmp/boot.txt"

Argumenty pro příkaz jsou:

• -cmd  
  Příkaz runcat, který se v této zprávě používá.
• -online
  URL adresa Oracle Analytics Cloud. Toto je proměnná oacURL.
• -excelFormat
  Výstup bude ve formátu akceptovatelném pro Excel.
• -delimiter
  Oddělovač mezi poli v sestavě.
• -forceoutputFile   
  Pokud výstupní soubor již existuje, bude přepsán. Toto je proměnná userFile.
• -složka    
  Cesta k souboru katalogu, o kterém se má vytvořit sestava.
• -type   
  Typ objektu katalogu, o kterém se má vytvářet sestava.
• -fields     
  Prvky katalogu, o kterých se má vytvářet sestava.
• -recursionDepth 
  Maximální úroveň složky katalogu, pro kterou se má vytvořit report.
• -credentials   
  Cesta k souboru s přihlašovacími údaji.

Struktura příkazu setOwnership je:

runcat.sh -cmd setOwnership -online "https://OACinstance.ocp.oraclecloud.com/analytics-ws/saw.dll" -ownername  -accountType user -itemFromFile "/scratch/tmp/Object.xls" -recursive false -credentials "/scratch/tmp/boot.txt "

Rozdíly jsou:

• -jméno_vlastníka  
  Jméno účtu, které má být nastaveno jako vlastník.
• -accountType  
  Typ účtu. Například uživatel, aplikační role nebo skupina.
• -itemFromFile  
  Soubor obsahující cesty k objektům katalogu, u kterých se mají změnit vlastnictví. Toto je proměnná userFile a výstup příkazu report.
• -recursive   
  Určuje, zda je vlastnictví rekurzivně nastaveno na podřízené objekty. Recursive je nastaven na hodnotu false, protože v nadřazené složce mohou být objekty s různými vlastníky. Nechceme nastavit vlastnictví pro všechny objekty, pouze pro ty, které patří vlastníkovi, kterého měníme.

Je vyžadován soubor s přihlašovacími údaji, který musí být ve specifickém formátu, kde první řádek bude přihlašovací jméno a druhý řádek heslo. Formát je:

Skript naleznete v sekci Ke stažení.

Změna vlastnictví v konzoli Oracle Analytics Cloud 

Kromě spuštění výše uvedeného skriptu pro změnu vlastníka objektu katalogu můžete také použít Správu obsahu v konzoli Oracle Analytics.

Abyste mohli používat Správu obsahu, musíte mít roli aplikace BIServiceAdministrator.

Po otevření aplikace Správa obsahu se zobrazí seznam všech objektů v katalogu.

Můžete řadit podle jména, vlastníka nebo data úpravy. Řadit můžete v poli řazení vlevo nahoře nebo kliknutím na jeden z názvů sloupců.

Můžete filtrovat podle konkrétního typu objektu nebo vlastníka. * je zástupný znak.

Chcete-li změnit vlastníka, klikněte na řádek, položku nebo položky, u kterých chcete změnit vlastnictví, a klikněte na Změnit vlastnictví.

• Tlačítko Změnit vlastnictví se neaktivuje, dokud nevyberete objekt.
• Vybrané objekty jsou zvýrazněny.
• Pro výběr více objektů použijte klávesy Shift a Ctrl.

V tomto příkladu jsou vybrány čtyři sešity vlastněné uživatelem admin.

Po kliknutí na tlačítko Změnit vlastnictví se zobrazí dialogové okno s počtem vybraných objektů a možnostmi změny vlastnictví. Můžete vybrat sebe nebo jiného uživatele či roli, na kterou chcete vlastnictví změnit. Po výběru jména se tlačítko OK aktivuje.

Změna vlastnictví objektu pomocí skriptu je všestrannější než použití Správy obsahu, protože můžete změnit více vlastníků v jedné transakci. S Správou obsahu můžete změnit pouze jednoho vlastníka najednou.

Odstraňování problémů

Pokud se pokusíte změnit vlastnictví objektu na aktuálního vlastníka, zobrazí se vám varování, že uživatel, kterému se pokoušíte změnit vlastnictví, již objekt vlastní. Varování se zobrazí pro každý objekt, u kterého se nový a starý vlastník shodují. Najeďte myší na zprávu a zobrazí se vám konkrétní varování.

Výzva k akci

Nyní, když jste si přečetli tento článek, vyzkoušejte to sami a dejte nám vědět své výsledky v komunitě Oracle Analytics Cloud, kde můžete také klást otázky a sdílet nápady. Pro další informace nás neváhejte kontaktovat.

Zdroj: Oracle