OBIEE 12.2.1 and Maps documents

This must be OBIEE 12 Maps week at Oracle.

First (Feb 26, 2016) Business Analytics - Proactive Support published OBIEE 12c and MapViewer - Common Issues and Troubleshooting Steps that points us to support document Doc ID 2109293.1

Next (Feb 29, 2016) Customer Engineering & Advocacy Lab (CEAL) published OBIEE 12c: Creating a Custom Layer in MapViewer for use with VA that points us to support document Doc ID 2105521.1

Naturally, it might be a good idea to read first the original documentation at chapter 12 of the System Administration Guide. 

Update (Mar 28, 2016):
A little later Andrew from http://bisoftdiary.com/ added the post Oracle Map builder simple map.

By the way, usually when you want to work with your specific geographical region, you have to upload the relevant geographical data to the DB and Associate it with the relevant BI content. When your data contains Latitude and Longitude data you can have maps without any such configuration.

For example in this Analysis (Answers) this is a map of battery disposal locations in northern Tel Aviv (there is no Tel Aviv specific information in my spacial database):

To get it, select the Variable Shape type in the Analysis Map component: 

Then,Custom Point Layer:

And assign the relevant Lon, Lat columns (or their combination as a single column):

Similar works with VA Project:

Just remember in the object properties (in the Map Tab):

to select Oracle Maps as Background Map instead of the default Thematic Map:

By the way, if you have problems with background of the map, the document "Background image in maps do not display after recent BICS March 2016 Upgrade (Doc ID 2116983.1)" at support site, might be handy.

OBIEE - You should be Mapping 5 - report based coordinates

זה הזמן להתוודות. פספסתי בענק אופציה חשובה ומעניינת במפות של OBIEE. היכולת לעבוד עם קוארדינטות של נקודות על מפה הלקוחות מהדוח עצמו.
כדי לעבוד עם מפות בOBIEE אמנם צריך איזה שהוא קישור לשכבת המפות שהוגדרה באדמיניסטציה כמו שתואר בפוסט השני מתוך הבאים:

OBIEE - You should be mapping, yeah

OBIEE - You should be mapping 2

OBIEE - You should be Mapping 3

OBIEE - You should be Mapping 4 - Master / Detail

אבל לא באמת חייבית לכלול את השדה הרלוונטי בדוח. על מה אני מדבר? נדגים:

יצרתי טבלה בבסיס הנתונים ובה שם הקניון, נקודות אורך ורוחב שהוצאתי מהמפות של גוגל, כמות החנויות שבקניון ושטח הקניון. הוספתי עמודה בה שם המדינה (Israel). ייבאתי את הטבלה באדמיניסטרטור של OBIEE וקישרתי אותה לטבלת המדינות (שכבר מוגדרת בהגדרות השכבות של המפות).
עכשיו יצרתי דוח על הטבלה החדשה בלבד ומערכת המפות עבדה ולא הודיע שגיאה על העדר קשר למפות.
מה עשיתי הלאה? אדגים:

הוספתי מפה:

כשנכנסים לערוך את המפה רואים שאין, כצפוי, שכבת ברירת מחדל. אבל גם אין שגיאה.

עכשיו נבחר בNew Map Format. במקרה שלי בחרתי בפורמט מסוג Bubble.
הנקודה החשובה היא לבחור באופציה האחרונה - Custom Point Layer. זה מה שאומר למוצר לעבוד עם הקוארדינטות שלכם.

מופיעה חלונית של הגדרות:

שימו לב שהוא כבר ניחש לבד על פי שמות העמודות, מה להגדיר כקוי אורך ומה כגובה. נחמד.
ניתן גם להגדיר את שני הערכים בעמודה אחת. אז תאלצו להגדיר את התו המפריד.
היתר, אלו כבר ההגדרות הרגילות של מה להציג כתוכן ובאיזו תצורה. והנה התוצאה:

ברור שבמקרה זה יש צורך להשתמש במפות של Google או Bing. המפות המובנות של Navteq המגיעות עם המוצר לא מכילות את רמת הפירוט הנדרשת.

עוד דבר אחד. אם אתם לוקחים את הקוארדינטות מGoggle, שימו לב שהוא מחזיר צמד ערכים בסדר הבא:  (Latitude, Longitude).

OBIEE - You should be Mapping 4 - Master / Detail

בואו נבנה דוח אב בן בסיסי מבוסס מפות.
הרעיון הוא שאנו רואים מפה ועוד מספר דוחות בדף. כל קליק על אובייקט במפה (מדינה במקרה שלנו) מעביר את הדוחות במפה לאותו אובייקט. לדוגמא: כשאני מעל מדינה עם הסמן, אני רואה tooltip של פרטים (כפי שהגדרתי) עבור המדינה המסויימת.

לחיצה על המדינה מעבירה אותי למצב פעיל של tooltip:

עכשיו קליק על השם (Spain), מעביר את יתר הדוחות במסך לספרד:

איך עושים את זה?
כידוע, ברמת הקריטריון ניתן להגדיר אינטרקציה של אירע אב-בן (master detail) עם שם כלשהו (בחרתי map1).

באותו הדוח בו נמצאת המפה נוסיף עוד אובייקטי תצוגה. בדוגמא שלי אלו גרף וטבלת ציר (pivot).
בהם נחזיק את שדה המדינה (או כל אובייקט אחר על המפה) ברמה של מנחה - page (בטבלת הציר) או מקטעים - section (בגרף).
בתוך כל אחד מהם נבחר תכונות:

נדליק את אופצית האזנה לארוע אב-בן ונגדיר שם את השם שבחרנו קודם (map1).

זהו.
מעניין לציין שבאובייקטים שאינם מפות, העסק של אירועי אב-בן עובד גם בין דוחות שונים.

OBIEE - You should be Mapping 3

התחלנו עם בניית התשתית בשני המאמרים הקודמים:

OBIEE - You should be mapping, yeah

OBIEE - You should be mapping 2

עכשיו כשיש לנו תשתית, בואו נבנה דוח עם מפה.
נתחיל עם דוח בסיסי, עמודות של: שנים, קטגורית מוצרים וסכום שנמכר. שימו לב שלא בחרתי שום דבר שקשור למפה, למרות שקיימות עמודות בעולם התוכן הזה שקשורות למפות. זה אפשרי אבל לא חובה, כפי שנראה בהמשך. עכשיו נוסיף לדוח אובייקט של מפה:

כתוצאה מזה נוספה מפה ללא תוכן רלוונטי בדוח. גררתי אותה לשם נוחות שתוצג ליד הנתונים:

ניכנס לעריכת המפה וניבחר באופצית של הוספת תוכן חדש למפה:

כפי שניתן לראות יש כמה פורמטים אפשריים. ניתן ליצור כמה שכבות של מידע באותה מפה. נדגים זאת כאן. בואו נתחיל באופצית הנפוצה ביותר - מילוי בצבע. לא משנה מה ניבחר, זה השלב שהמערכת חייבת לדעת על בסיס איזה נתון גאוגרפי אנו מקשרים את הנתונים:

במקרה שלנו בחרנו את רמת המדינה. הבחירה הזו מוסיפה את השדה הרלוונטי גם ברמת הקריטריונים לדוח.

עכשיו יש למלא את חלון הפרמטרים.

תחילה,כמובן, שם התבנית.
הגדרה מה יוצג בtooltip של המפה. (tooltip הוא אלמנט עבודה חשוב במפה. נראה את זה במאמר הבא, כשנדבר על דוחות אב/בן תוך שימוש במפות).

 

לפי מה נשנה צבע (זה חייב להיות measure), סוג הbin / תיבה, מספר התיבות והסגנון שלהן.

ברירת המחדל של בחירה לפי אחוזים מקטינה את השליטה שלכם אבל נוחה במצגות. בחיים המעשיים כדאי לשקול את שתי החלופות האחרות. אם אינכם יודעים מה לעשות, האופציה השלישית של "מילוי מתמשך בצבע" יוצר את מינימום העבודה בשבילכם.

נמשיך עם הדוגמא של "יצירת תיבות לפי אחוזים". ניתן לבחור את מספר התיבות השונות (2-12) ולבחור את הסגנון. לא חייבים להשאר עם ברירת המחדל המאד אפורה. בדוגמא בחרתי 4 תיבות, מספר אחר יגרום לתצוגה רלוונטית בפס הסגנון. השקיפות נועדה לאפשר לראות את הערכים על המפה שמאחורי הצבע (שמות מדינות, במקרה שלנו.)

נקבל את המפה הבאה:

בחלון האפשרויות הייתה גם אופציה של "אפשר למשתמש לוח מידע לערוך נתוני סף" - "Allow Dashboard Users to Edit Thresholds". התצוגה של רכיב העריכה היא תמיד בערכים גם אם בחרתי תיבות לפי אחוזים. התוצאה היא בעייתית לעתים אם עובדים לפי אחוזים ולא לפי ערכים, במקרה ויש הבדל משמעותי בין הקבוצות השונות, כמו במקרה שלי, בו כל הפסים נדחקו לתחום התחתון של הסקלה:

שמתם לב שארצות הברית מופיעה בנתונים ולא במפה? זה מה שקורה כששם המדינה בטבלאות המפות ובטבלאות הנתונים לא זהה. חשוב להיות מודעים לזה.

בואו נוסיף לדוגמא על אותה המפה גם גרף עמודות:

חלון הפרמטרים שלו קצת שונה:

אפשר לשחק עם גודל התרשים, אבל חובה לבחור את העמודה / עמודות על פיהן מחולקות העמודות של הגרף. במקרה שלי אלו שנים, דהיינו עמודה עבור כל שנה.

שמתם לב שקשה לראות את נתוני אירופה?
מה הבעיה, עושים זום:

עכשיו, באמצעות סימון V ניתן לבחור איזו שכבת מידע מהשתיים מציגים על המפה.

במקרה שלי הדגמתי הכל על מפת גוגל. ניתן כמובן לבחור להשתמש במפת navteq (בשביל לבלבל אותכם, המסך שלי הפעם בעברית):

הבחירה היא במצב עריכה של המפה:

שימו לב גם לחלון מאפייני המפה:

שם ניתן להגדיר את גודל המפה, אפשרויות גלילה, כלי תצוגה שונים ובמיוחד את מה שהציק לי בזמנו:
בלשונית האינטרקציה ניתן להגדיר, האם תצוגת המפה ההתחלתית היא דינמית או שמירה אחרונה.

אם לא ברור לכם, המפה היא דינמית. אם לדוגמא יש לי נתונים רק מאירופה, והאופציה (ברירת המחדל) היא דינמית, אוטומטית המפה תתמקד באירופה. אבל לעתים קרובות, יש לי תצוגה מועדפת שאותה אני רוצה לשמור. זה הפתרון.

OBIEE - You should be mapping 2

התחלנו כאן להסביר את תהליך הקינפוג של מפות בOBIEE. בואו נמשיך. הגענו לסעיף 9:

9. הפעילו מחדש את כל רכיבי שרת הBI שסגרתם בסעיף 7.

10. ההמשך נעשה בתוך הדפדפן בOBIEE.

בחרו Administration.

Manage Map Data.

בשלב הבא יש להוסיף שכבות של מידע גאוגרפי.

נבחר לשונית Layers וכפתור Import Layers. 

 

אם עשיתם כל הכתוב עד עכשיו, יש לכם כמות מפחידה של שכבות אפשריות לייבוא. זה נובע ממיגוון הגדול של דוגמאות המוכנות שאורקל מספקת. בשביל ההתחלה אפשר להתמקד באילו המתחילות בOBIEE.למשל נוסיף שכבות של מדינה ועיר. 

נקבל:

עכשיו בא השלב בו מקשרים את השכבות עם המידע שלכם. בדוגמא שלי השתמשתי בנתוני ברירת המחדל המגיעים עם ההתקנת בסיס הנתונים אורקל בסכמת SH. שם יש שמות מדינות בטבלת countries.עומדים על השכבה הרלוונטית ובוחרים בEdit Layers:

לוחצים על הפלוס של BI Key Columns:

בוחרים Subject Area

ואת השדה הרלוונטי:

אפשר לחבר כאן מקורות מידע נוספים בOBIEE לאותה ההגדרה. 

ב Layer Key

יש דוגמאות שונות של איך המידע הגאוגרפי קיים כרגע בשכבה. למשל ברמת מדינה :

יש לדאוג שהמידע בטבלאות שלכם מתאים לפורמט זה ולקשר אותו לשדה הרלוונטי בsubject area הרלוונטי. אפשר לראות את פורמט הנתונים בSample Data. בדוגמה זו, אם תאור המדינה שלכם לא מתאים לנתוני טבלת המפות (United States לעומת United States of America למשל) המדינה הזו פשוט לא תעבוד על מפות.

מה חסר? המפות עצמן.

התחילו עם הלשונית Background Maps.

הפעילו את לחצן Import Background Map.

בחרו את המפה הרלוונטית לכם:

נשייך את השכבות לכל מפה:
נלחץ על עריכה במפה מסויימת, נלחץ על פלוס כדי להוסיף שכבות רלוונטיות ונסמן בקליק של עכבר, לאילו רמות פירוט כל שכבה רלוונטית.

כברירת מחדל יש 19 רמות פירוט כאשר 0 היא הכללית ביותר ו19 היא המפורטת ביותר (המרחק בקטן ביותר מעל כדור הארץ).

11.      עכשיו, בדוחות בהם נבחרו עמודות המשוייכות למידע גאוגרפי ניתן להוסיף גם אובייקט של מפה.(נרחיב על זה בפוסטים הבאים)

12.  כל זה טוב ויפה אבל אין לי ערים בישראל (חוץ מירושלים) בנתונים שקיבלתי מאורקל. איך נוסיף? בזמנכם הפנוי, אתם מוזמנים להשלים את טבלת הערים (OBIEE_CITY). בדוגמא הבאה, כל עיר מתווספת כנקודה בלבד ולא כפוליגון מסודר.
מה הדרך הפשוטה לקבל קווי אורך ורוחב של מקומות?  יש מאגרים רבים, אבל לשם הפתרון המהיר, פותחים Google maps, בוחרים מקום ולוחצים קליק ימני ו-What’s Here. אז מקבלים קווי אורך ורוחב למעלה. למשל תל אביב: 32.045915,34.768982 (שימו לב שבפונקציה בהמשך סדר המספרים הפוך). מריצים בבסיס נתונים אורקל, אחרי שמתחברים למשתמש obiee_navteq:

 

insert into OBIEE_CITY

select

'ISR',

'TEL-AVIV',

NULL,

MDSYS.SDO_GEOMETRY(

2001,

8307,

MDSYS.SDO_POINT_TYPE(34.768982, 32.045915,NULL),

NULL,

NULL),

'TEL_AVIV',

'XX',

NULL,

'Isr_Tel-Aviv',

'Isr_No State_Tel-Aviv',

'ISR_XX_Tel-Aviv' from dual ;

 

13. במידה ויש בעיות בייבוא של DMP בסעיף 6 מהסוג הבא: 

IMP-00017: following statement failed with ORACLE error 3252

...

...

IMP-00003: ORACLE error 3252 encountered

ORA-03252: initial extent size not enough for LOB segment

הפתרון הוא (תודה תמר נירנברג)

alter system set db_16k_cache_size=16k; ---(or other multiple of 16)

create tablespace

   ts_16k

datafile

'/YOU_DATA_FILE_LOCATION/oradata/bi_db/bi_db_ts_16k.dbf'

size

   100M

blocksize

   16k;

  ואז לעשות:

--drop the PARTITION table and re-create it in tablespace   ts_16k

  בשלב הבא לייבא את הנתונים בלבד.

 14. אם תשאלו את עצמכם, מהי הלשונית הנוספת ליד Background Maps, בשם Images... התשובה הוא:

       א. אלו אובייקטים גרפיים מיוחדים שניתן להוסיף למפה.

       ב. אני לא מתכנן לכסות את זה בקרוב אבל יש דוגמאות יפות בסביבת ההדגמות של אורקל.


15. במידה ויש בעיה עם כמות הנתונים במפה, ניתן לשלוט על הפרמטר בקובץ instanceconfig.xml:

<ServerInstance>

...

<SpatialMaps><LayerDataLayout><MaxRecords>1000</MaxRecords></LayerDataLayout></SpatialMaps>

 16. בבנית דוחות עם מפות חייבים להשתמש גם בעמודות שהוגדרו בlayers, כדי שנוכל לעבוד עם מפות.