Konfigurowanie programu Maximo Anywhere

Transkrypt

Konfigurowanie programu Maximo Anywhere
IBM Maximo Anywhere
Wersja 7 Wydanie 5
Konfigurowanie programu Maximo
Anywhere
Uwaga
Przed wykorzystaniem tych informacji oraz produktu, którego dotyczą, należy zapoznać się z sekcją “Informacje” na stronie 29.
Ta edycja dotyczy wersji 7, wydania 5, modyfikacji 2 produktu IBM Maximo Anywhere i wszystkich kolejnych wydań i
modyfikacji, chyba że w nowszych edycjach wskazano inaczej.
© Copyright IBM Corporation 2013, 2015.
Spis treści
Konfigurowanie programu Maximo
Anywhere . . . . . . . . . . . . . . 1
Pliki definicji aplikacji . . . . . . . . . . . . 1
Zasoby danych w definicji aplikacji . . . . . . . . 3
Włączanie aplikacji Anywhere Administration . . . . . 6
Modyfikowanie aplikacji mobilnych za pomocą aplikacji
Anywhere Administration . . . . . . . . . . . 7
Definiowanie zapytań dotyczących listy prac . . . . . 8
Tworzenie zapytań w rozwiązaniu Maximo Asset
Management . . . . . . . . . . . . . . 8
Tworzenie zapytań o zasoby OSLC . . . . . . . 9
Dodawanie zapytań do aplikacji mobilnych . . . . 10
Konfigurowanie inwentaryzacji ze stanami ewidencyjnymi
i bez stanów ewidencyjnych . . . . . . . . . . 12
Określanie kryteriów dotyczących pobierania danych
wyszukiwania . . . . . . . . . . . . . . 13
Konfigurowanie rozmiaru stron w celu pobierania danych 14
Implementacja zgłaszania awarii w programie Maximo
Anywhere . . . . . . . . . . . . . . . 15
Konfigurowanie map . . . . . . . . . . . . 15
Informacje o położeniu na mapie . . . . . . . 15
© Copyright IBM Corp. 2013, 2015
Adresy usług . . . . . . . . . . .
Włączanie zadania CRON zapewniającego
automatyczne lokalizowanie . . . . . . . .
Właściwości systemowe — zadanie CRON . .
Konfiguracja dostępu do dostawcy usług map . .
Włączanie widoku mapy . . . . . . . . .
Dodawanie map na urządzeniach z systemem iOS
Aktywacja GPS . . . . . . . . . .
Konfigurowanie linii tras . . . . . . . .
Konfigurowanie poziomów powiększenia . . .
Aktywowanie skanowania kodów paskowych . . .
Podłączanie skanerów kodów paskowych Bluetooth do
aplikacji mobilnych . . . . . . . . . . .
Włączanie szyfrowania lokalnej składnicy danych . .
Zmiana okresu pulsu . . . . . . . . . . .
Właściwości dotyczące załączników . . . . . .
Właściwości limitu czasu. . . . . . . . . .
. 17
.
.
.
.
.
.
.
.
18
19
19
20
22
22
23
23
24
.
.
.
.
.
25
25
26
26
27
Informacje . . . . . . . . . . . . . 29
Strategia ochrony prywatności .
Znaki towarowe . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 31
. 31
iii
iv
Konfigurowanie programu Maximo Anywhere
Konfigurowanie programu Maximo Anywhere
Rozwiązanie Maximo Anywhere można dostosować do potrzeb biznesowych firmy.
Użytkownik może zdefiniować zapytania dotyczące listy pracy i inne ustawienia związane z
pobieraniem danych z serwera. Można włączyć funkcje map, obsługę załączników,
skanowanie kodów paskowych i szyfrowanie danych. Ustawienia konfiguracji można
zastosować na poziomie aplikacji i systemu.
Pliki definicji aplikacji
Definicję aplikacji stanowi plik XML, w którym zdefiniowano interfejs użytkownika oraz
źródła danych dla aplikacji Maximo Anywhere dla urządzeń mobilnych. Aplikację można
skonfigurować, edytując jej definicję lub korzystając ze specjalnej aplikacji serwerowej,
Anywhere Administration (o ile jest włączona).
Maximo Anywhere zawiera aplikacje mobilne tworzone z myślą o pracownikach
korzystających z urządzeń mobilnych i wdrażane w celu zapewnienia im możliwości
realizowania działań biznesowych.
Aplikacje mobilne
We wszystkich aplikacjach mobilnych można wprowadzić następujące zmiany:
v Można określić zapytania pozwalające ustalić, które rekordy z listy prac można pobrać z
serwera.
v Można zdefiniować dane wyszukiwania, jakie mogą być pobierane z serwera.
W aplikacji Work Execution można wprowadzić następujące zmiany:
v Można określić zapytania pozwalające ustalić, które rekordy z listy prac można pobrać z
serwera.
v Można zdefiniować dane wyszukiwania, jakie mogą być pobierane z serwera.
v Włączanie widoku mapy.
v Włączanie skanowania kodów paskowych.
v Ograniczenie dostępu do wprowadzania zmian statusu wg grupy użytkowników.
W aplikacji Inspection można wprowadzić następujące zmiany:
v Włączanie widoku mapy.
v Włączanie skanowania kodów paskowych.
v Włączanie załączników.
v Włączanie GPS.
W aplikacji Physical Count można wprowadzić następujące zmiany:
v Włączanie skanowania kodów paskowych.
Definicja aplikacji mobilnej ma nazwę app.xml i znajduje się w katalogu głównym aplikacji.
Tabela 1. Katalogi plików app.xml
Aplikacja
Katalog
Aplikacja Maximo Anywhere Work Execution
kat_główny_instalacji\MaximoAnywhere\apps\
WorkExecution\artifact
© Copyright IBM Corp. 2013, 2015
1
Tabela 1. Katalogi plików app.xml (kontynuacja)
Aplikacja
Katalog
Aplikacja Maximo Anywhere Work Approval
kat_główny_instalacji\MaximoAnywhere\apps\
WorkApproval\artifact
Aplikacja Maximo Anywhere Inspection
kat_główny_instalacji\MaximoAnywhere\apps\
Inspection\artifact
Aplikacja Maximo Anywhere Physical Count
kat_główny_instalacji\MaximoAnywhere\apps\
PhysicalCount\artifact
Po wprowadzeniu zmian w definicji aplikacji konieczne jest utworzenie i wdrożenie aplikacji.
W przypadku korzystania z aplikacji Anywhere Administration budowanie i wdrażanie
aplikacji nie jest wymagane. W zależności od rodzaju wprowadzonych zmian zaktualizowana
aplikacja zostanie udostępniona użytkownikom jako nowa wersja aplikacji lub jako
bezpośrednia aktualizacja:
v Jeśli zmiana polegała na wprowadzeniu nowego lub zaktualizowanego kodu rodzimego,
aplikacja musi zostać wdrożona jako nowa wersja. Przykładowo po aktywowaniu widoku
mapy lub skanowania kodów paskowych w procesie tworzenia do aplikacji dodawany jest
kod rodzimy. Użytkownicy muszą pobrać z serwera nową wersję aplikacji i zainstalować
ją.
v Jeśli zmiana dotyczyła zaktualizowanych zasobów WWW, aplikację można wdrożyć bez
zmiany jej wersji. Użytkownicy mogą zatwierdzić zmianę jako bezpośrednią aktualizację
wersji aplikacji, która jest zainstalowana na ich urządzeniach.
Definicja aplikacji mobilnej obejmuje atrybut requiredRole określający grupę użytkowników
w aplikacji dostawcy, którzy mają uprawnienia do korzystania z tej aplikacji. Atrybut ten
zawiera odwołanie do jednej z wstępnie zdefiniowanych grup użytkowników, jakie są
wdrażane podczas przeprowadzania instalacji w środowisku aplikacji dostawcy. W czasie
wykonywania do danej aplikacji mogą zalogować się wyłącznie użytkownicy należący do
określonej grupy.
Przykładowo, atrybut requiredRole z definicji aplikacji Work Execution stanowi odwołanie
do grupy uprawnień ANYWHERE_TECHNICIAN w programie Maximo Asset Management.
Do aplikacji Work Execution mogą zalogować się tylko użytkownicy należący do grupy
ANYWHERE_TECHNICIAN.
Struktura plików definicji aplikacji
Element XML <app> stanowi element główny pliku definicji aplikacji. Element <app> ma
trzy elementy podrzędne, które definiują podstawową strukturę definicji aplikacji.
Element <ui>
Zawiera specyfikacje dotyczące widoków w aplikacji dla urządzeń mobilnych z
uwzględnieniem widoków listy prac, szczegółów rekordów, wyszukiwań oraz okien
dialogowych.
Element <data>
Zawiera specyfikacje dotyczące źródeł danych używanych przez aplikację z
uwzględnieniem listy prac, wyszukiwania i zasobów systemowych.
Element <messages>
Zawiera komunikaty wyświetlane w interfejsie użytkownika i rejestrowane w
dzienniku aplikacji.
Pojęcia pokrewne:
2
Konfigurowanie programu Maximo Anywhere
“Zasoby danych w definicji aplikacji”
Dane używane w aplikacji dla urządzeń mobilnych są określane w definicji aplikacji na
podstawie zasobów OSLC. Zasoby są klasyfikowane jako zasoby podstawowe, pomocnicze,
wyszukiwania lub systemowe. Na podstawie tych kategorii ustalany jest sposób określania
zasobów w definicji aplikacji oraz sposób zarządzania nimi w czasie wykonywania.
Zadania pokrewne:
“Włączanie aplikacji Anywhere Administration” na stronie 6
Domyślnie aplikacja Anywhere Administration jest wyłączona. Modyfikując aplikacje
mobilne za pomocą aplikacji Anywhere Administration, można uniknąć konieczności ich
ponownego budowania i wdrażania.
Zasoby danych w definicji aplikacji
Dane używane w aplikacji dla urządzeń mobilnych są określane w definicji aplikacji na
podstawie zasobów OSLC. Zasoby są klasyfikowane jako zasoby podstawowe, pomocnicze,
wyszukiwania lub systemowe. Na podstawie tych kategorii ustalany jest sposób określania
zasobów w definicji aplikacji oraz sposób zarządzania nimi w czasie wykonywania.
Zasób OSLC reprezentuje obiekt biznesowy, konfiguracji lub domeny, który należy do
aplikacji dostawcy. W aplikacji dostawcy zasób jest definiowany na podstawie dokumentu
kształtu, który opisuje strukturę zasobu oraz wszystkie możliwe właściwości. W celu
przeprowadzenia integracji zasób jest publikowany przez strukturę obiektu OSLC. Zasób jest
zarejestrowany w dostawcy usługi określającym operacje na danych dostępne w przypadku
zasobu w aplikacjach konsumenta oraz zarządzającym nimi.
W rozwiązaniu Maximo Anywhere, gdzie aplikacje mobilne działają jako konsumenci,
definicja aplikacji określa zasoby używane przez aplikację mobilną. Element <data> XML
zawiera specyfikacje dotyczące wszystkich zasobów. Główne cechy zasobu są zdefiniowane
przez atrybuty elementu głównego, <resource>.
Tabela 2. Atrybuty elementu <resource>
Atrybut
Określa
Wykorzystanie
providedBy
Dostawca usługi używany w przypadku
Wymagane w przypadku zasobów
operacji wykonywanych na danych w tym podstawowych, wyszukiwania i
zasobie.
systemowych. Odwołanie do dostawcy
usługi jest wymagane w przypadku
zasobów pobranych z aplikacji dostawcy
jako niezależne obiekty. Dostawca usługi
określa, czy dane zasobu można
zaktualizować, utworzyć lub usunąć w
ramach aplikacji konsumującej. W
przypadku zasobu podstawowego
dostawca usługi określa również, które
zapytania są dostępne w aplikacjach
konsumujących.
describedBy
Dokument kształtu definiujący zasób.
Wymagane w przypadku zasobów
podstawowych, wyszukiwania i
systemowych. Specyfikacje tych zasobów
w definicji aplikacji muszą być zgodne z
definicją w dokumencie kształtu.
name
Niepowtarzalna nazwa używana w
przypadku odniesień do tego zasobu w
definicji aplikacji.
Wymagane w przypadku wszystkich
zasobów.
Konfigurowanie programu Maximo Anywhere
3
Tabela 2. Atrybuty elementu <resource> (kontynuacja)
Atrybut
Określa
Wykorzystanie
pageSize
Liczba instancji zasobów, które można
pobrać jednocześnie z aplikacji dostawcy.
Jeśli podczas wykonywania zapytania
liczba odpowiadających instancji zasobu
przekroczy wartość rozmiaru strony, ta
wartość jest używana do podziału listy
rekordów na listy podrzędne pobierane w
kolejnych wywołaniach.
Wymagane w przypadku zasobów
podstawowych, wyszukiwania i
systemowych.
additional
Data
Określa, czy zasób jest zasobem
wyszukiwania.
Wymagany z wartością true w przypadku
wszystkich zasobów wyszukiwania.
isSystem
Określa, czy zasób jest zasobem
systemowym.
Wymagany z wartością true w przypadku
wszystkich zasobów systemowych.
W poniższym przykładzie przedstawiono atrybuty definiujące zasób podstawowy, workOrder,
w definicji aplikacji przeznaczonej dla aplikacji Work Execution:
<resource providedBy="/oslc/sp/WorkManagement"
describedBy="http://jazz.net/ns/ism/work/smarter_physical_infrastructure#WorkOrder"
name="workOrder"
pageSize="100"
[...]>
W poniższym przykładzie przedstawiono atrybuty definiujące zasób wyszukiwania danych,
additionalasset, w definicji aplikacji przeznaczonej dla aplikacji Work Execution:
<resource providedBy="/oslc/sp/AssetManagement"
describedBy="http://open-services.net/ns/asset#Asset"
name="additionalasset"
pageSize="1000"
additionalData="true">
Element <resource> jest elementem nadrzędnym względem elementu <attributes>. Ten
element zawiera listę atrybutów określających dane zasobu używane przez aplikację mobilną.
Atrybuty na liście odpowiadają właściwościom zdefiniowanym przez dokument kształtu
zasobu w aplikacji dostawcy.
Zasób podstawowy
Zasób podstawowy odzwierciedla obiekt najwyższego poziomu w rekordzie listy prac. Zasób
podstawowy może być obiektem nadrzędnym względem co najmniej jednego zasobu
pomocniczego. Zasób pomocniczy odzwierciedla obiekt podrzędny w rekordzie listy prac.
Zasób podstawowy może być połączony relacją „jeden do jednego” lub „jeden do wielu” z
zasobem pomocniczym. W przypadku relacji „jeden do wielu” między zasobem
podstawowym i pomocniczym dane dla zasobu pomocniczego są wyświetlane jako lista
obiektów podrzędnych w rekordzie listy prac.
Przykładowo: zlecenie pracy jest zasobem podstawowym w rekordach listy prac dla aplikacji
Work Execution. Zasób zlecenia pracy można powiązać z zasobami pomocniczymi takimi
jak: zasób fizyczny, lokalizacja, zadanie lub pracownik. Zlecenie pracy może zawierać
pojedynczy zasób podstawowy lub pojedynczą lokalizację oraz wiele zadań i przypisań
pracowników. Przypisania pracowników i zadania są wyświetlane w postaci listy w zleceniu
pracy.
W definicji aplikacji zasoby podstawowe i pomocnicze są definiowane jako odrębne obiekty.
Cechy zasobu podstawowego:
4
Konfigurowanie programu Maximo Anywhere
v Powiązania z dostawcą usługi i dokumentem kształtu w przypadku zasobu podstawowego
w aplikacji dostawcy.
v Lista zapytań używanych w czasie wykonywania w celu pobrania rekordów listy prac z
serwera. Lista jest zawarta w elemencie <queryBases> .
v Wartość wielkości strony określa maksymalną liczbę rekordów listy prac, jakie można
pobrać w każdym żądaniu.
v Proste i złożone atrybuty właściwości w przypadku zasobu podstawowego są definiowane
w dokumencie kształtu. Atrybuty proste reprezentują dane lokalne w przypadku zasobu
podstawowego. Atrybuty złożone odnoszą się do zasobów pomocniczych.
Zasoby pomocnicze obejmują atrybuty proste w przypadku danych należących do zasobów
pomocniczych, ale są używane w rekordzie listy prac. Zasoby pomocnicze są uzależnione od
zasobu podstawowego, z którym są powiązane. Zasoby pomocnicze (w przeciwieństwie do
zasobu podstawowego) nie są pobierane niezależnie z aplikacji dostawcy i nie wymagają
powiązań z dostawcą usługi ani dokumentem kształtu.
Zasoby wyszukiwania
W czasie wykonywania użytkownicy mogą zmieniać dane pomocnicze znajdujące się w
rekordzie listy pracy, uwzględniając odpowiednie reguły biznesowe i możliwości aplikacji. W
przypadku wielu zmian używany jest element sterujący wyszukiwania, który pozwala na
tworzenie odniesień i wybór danych znajdujących się poza rekordem listy danych.
Przykładowymi danymi wyszukiwania są zasoby, narzędzia i materiały, jakie można dodać do
zlecenia pracy.
Użytkownicy muszą pobrać dane wyszukiwania, aby je udostępnić w aplikacji dla urządzeń
mobilnych. Lokalnie zapisane dane wyszukiwania mogą być odświeżane na żądanie.
Obiekty wyszukiwania są prezentowane w definicji aplikacji jako zasoby wyszukiwania.
Zasób wyszukiwania ma następujące cechy:
v Atrybut additionalData o wartości true.
v Odwołania do dostawcy usług i dokumentu kształtu dla zasobu wyszukiwania w aplikacji
dostawcy.
v Wartość wielkości strony określa maksymalną liczbę rekordów, jakie można pobrać w
każdym żądaniu.
v Proste atrybuty właściwości zasobu wyszukiwania zgodne z definicją w dokumencie
kształtu.
Zasoby systemowe
Zasoby systemowe reprezentują obiekty, które znajdują się poza rekordem listy pracy, ale są
niezbędne do wykonywania operacji systemowych w aplikacjach dla urządzeń mobilnych.
Poniżej przedstawiono przykładowe zasoby sklasyfikowane jako zasoby systemowe dla
aplikacji Work Execution:
v Listy wartości domeny, które są używane do zmiany statusu zlecenia pracy oraz innych
atrybutów rekordu listy prac.
v Pracownicy i zasoby w postaci umiejętności pracowników dla bieżącego użytkownika
wymagane na potrzeby raportowania czasu pracy.
v Ustawienia licznika czasu pracy aktywowanego w aplikacji dostawcy, które są wymagane
do lokalnego sprawdzania poprawności transakcji pracowników.
Konfigurowanie programu Maximo Anywhere
5
Dane systemowe są pobierane automatycznie przy pierwszym zalogowaniu się użytkownika
do aplikacji. Jeśli pobieranie nie powiedzie się, użytkownik nie może się zalogować. Dane
systemowe zapisane lokalnie są odświeżanie za każdym razem, gdy użytkownik odświeża
dane wyszukiwania.
W definicji aplikacji zasób systemowy ma atrybut isSystem o wartości true. Inne cechy są
takie same, jak cechy zasobu wyszukiwania.
Włączanie aplikacji Anywhere Administration
Domyślnie aplikacja Anywhere Administration jest wyłączona. Modyfikując aplikacje
mobilne za pomocą aplikacji Anywhere Administration, można uniknąć konieczności ich
ponownego budowania i wdrażania.
Zanim rozpoczniesz
W produkcie Maximo Asset Management, w aplikacji Właściwości systemu, określ nazwę
hosta we właściwości mxe.oslc.webappurl. Właściwość mxe.oslc.webappurl definiuje
publiczny adres URL służący do wyszukiwania zasobów OSLC. Domyślny adres URL to
http://localhost/maximo/oslc/.
O tym zadaniu
Aplikację Anywhere Administration włącza się, ustawiając właściwość si.adminmode w
pliku worklight.properties. Po włączeniu aplikacji Anywhere Administration należy
załadować do niej dane. Dane należy ładować każdorazowo po dodaniu zasobów danych do
udostępnionych aplikacji Maximo Anywhere, po usunięciu zasobów danych z aplikacji lub po
utworzeniu własnych aplikacji.
W celu załadowania danych do aplikacji Anywhere Administration należy uruchomić
narzędziowy skrypt Ant. Narzędzie to nosi nazwę admin-config-loader.xml i znajduje się w
folderze MaximoAnywhere.
Zasoby danych, takie jak zapytania i ustawienia map dostarczone z produktem i określone w
pliku app.xml są ignorowane i zastępowane przez zasoby danych zdefiniowane za pomocą
aplikacji Anywhere Administration.
Procedura
1. W pliku worklight.properties znajdującym się w folderze MaximoAnywhere\server\
conf odszukaj właściwość si.adminmode i ustaw ją na true.
2. Uruchom komendę build all, czyli plik build.cmd w systemie Windows lub build.sh
w systemie UNIX bądź Linux. Zostanie wygenerowany plik artefaktów .apk lub .ipa, a
wszystkie pliki dystrybuowalne projektu Maximo Anywhere zostaną wdrożone na
serwerze MobileFirst Server.
3. Przeprowadź wdrożenie pliku WAR na serwerze MobileFirst Server.
a. W narzędziu do konfiguracji serwera wybierz opcję zastąpienia plików WAR
wdrożonej konfiguracji serwera MobileFirst.
b. Wykonaj kroki w kreatorze.
4. Opcjonalne: W celu uruchomienia narzędzia w środowisku programistycznym określ
nazwę użytkownika i hasło jako argumenty pliku.
a. W programie MobileFirst Studio dodaj plik Ant admin-config-loader.xml do widoku
Ant.
b. Prawym przyciskiem myszy kliknij plik Ant admin-config-loader.xml i wybierz
opcję Run As>Ant Build.
6
Konfigurowanie programu Maximo Anywhere
c. Na karcie Main dodaj nazwę użytkownika i hasło dla adaptera w polu Arguments.
-Dadapter.connection.user=<nazwa_użytkownika>
-Dadapter.connection.password=<hasło>
5. Załaduj dane do aplikacji Anywhere Administration.
Środowisko
Czynność
W środowisku programistycznym w MobileFirst
Studio
Uruchom plik admin-config-loader.xml z widoku
Ant.
W środowisku produkcyjnym
Uruchom komendę:
ant -f admin-config-loader.xml allApps
Parametr allApps powoduje przejrzenie
wszystkich folderów aplikacji w poszukiwaniu
udostępnionych aplikacji Maximo Anywhere i
wszelkich utworzonych aplikacji własnych
użytkownika.
6. W programie Maximo Asset Management, w aplikacji Grupy uprawnień, otwórz grupę
ANYWHERE_INSPECTOR.
7. Na karcie Aplikacje odszukaj aplikację Anywhere Administration i nadaj do niej
uprawnienia.
8. Uzyskaj dostęp do aplikacji Anywhere Administration z modułu integracji w programie
Maximo Asset Management.
Informacje pokrewne:
MobileFirst Server Configuration Tool
Modyfikowanie aplikacji mobilnych za pomocą aplikacji Anywhere
Administration
Modyfikując aplikacje mobilne za pomocą aplikacji Anywhere Administration, można
uniknąć konieczności ich ponownego budowania i wdrażania. Po zdefiniowaniu grupy
użytkowników uprawnionych do obserwacji modyfikacji aplikacji różni użytkownicy będą
mieli dostęp do różnych typów danych.
Zanim rozpoczniesz
Włącz aplikację Anywhere Administration.
O tym zadaniu
Zasoby danych, takie jak zapytania o listy robocze i ustawienia map, zdefiniowane w aplikacji
przesłaniają zasoby udostępnione z produktem i zdefiniowane w pliku app.xml.
Procedura
1. Uzyskaj dostęp do aplikacji Anywhere Administration z modułu integracji w programie
Maximo Asset Management i wybierz aplikacjęMaximo Anywhere, którą chcesz
zmodyfikować.
2. Wybierz kartę właściwą dla typu danych, które zamierzasz zmieniać:
Karta
Dane
Dane listy
Zapytania o listy prac
Dane list wyszukiwania
Pobrane dane
Konfigurowanie programu Maximo Anywhere
7
Karta
Dane
Ustawienia
Mapy
3. Opcjonalne: Aby skonfigurować grupę dla zasobu danych, w wierszu tego zasobu
wybierz ikonę Menu szczegółów, a następnie wybierz grupę z listy.
4. Aby utworzyć nowe zapytanie kliknij przycisk Nowy wiersz i utwórz zapytanie. Aby
zmodyfikować istniejące zapytanie, wybierz ikonę Menu szczegółów odpowiedniego
wiersza i wybierz nowe wartości do zapytania.
5. Opcjonalne: Aby wyświetlić listę wszystkich właściwości globalnych, które można
zmodyfikować dla aplikacji mobilnych Maximo Anywhere, kliknij opcję Właściwości
globalne Anywhere. Ustawienia grupy nie są włączone dla tych właściwości.
6. Na urządzeniu mobilnym wyloguj się ze zmodyfikowanej aplikacji i zaloguj się z
powrotem, aby wprowadzone zmiany konfiguracyjne stały się widoczne.
Definiowanie zapytań dotyczących listy prac
Zapytania dotyczące listy prac definiowane w przypadku aplikacji mobilnej pozwalają ustalić,
które rekordy z serwera mogą być pobrane przez pracowników korzystających z urządzeń
mobilnych. Zapytania niestandardowe tworzy się w programie Maximo Asset Management.
Implementacja tych zapytań w aplikacji mobilnej odbywa się poprzez zaktualizowanie
definicji aplikacji i wdrożenie nowej wersji aplikacji. Zapytania takie można także
implementować za pomocą aplikacji Anywhere Administration, o ile jest włączona.
Tworzenie zapytań w rozwiązaniu Maximo Asset Management
Podczas tworzenia zapytań w rozwiązaniu Maximo Asset Management należy określić
kryteria wyszukiwania odpowiadające wymogom docelowych grup użytkowników w
Maximo Anywhere.
O tym zadaniu
Tworzone są zapytania dotyczące listy prac w aplikacji Maximo zapewniającej dostęp do
zasobów podstawowych w aplikacji mobilnej. Aplikacja zapewniająca uwierzytelnienie musi
być zarejestrowana w strukturze obiektu dla zasobu. Przykładowo: zasobem podstawowym w
aplikacji Maximo Anywhere Work Execution jest zlecenie pracy. W środowisku Maximo
Asset Management aplikacja Zlecenia pracy jest zarejestrowana jako aplikacja zapewniająca
uwierzytelnienie dla struktury obiektu oslcwodetail i zasobu zlecenia pracy. Dlatego
użytkownik tworzy zapytania dla aplikacji Work Execution w aplikacji Zlecenia Pracy.
Zapytania utworzone w aplikacji Maximo należy zapisać i oznaczyć jako publiczne.
Zapytania publiczne są automatycznie dodawane do dostawcy usług zarządzającego
powiązanymi danymi zasobów. Zapytania te są wdrażane i używane przez aplikacje
konsumujące, takie jak aplikacje mobilne w celu pobierania danych z aplikacji dostawcy.
Kryteria wyszukiwania definiowane dla zapytania określają wyniki wyszukiwania zwracane
podczas wykonywania. Rzeczywista lista wyników dla danego użytkownika jest uzależniona
od uprawnień do dostępu danego użytkownika w Maximo Asset Management. Przykładowo:
użytkownik należy do grupy uprawnień, która dysponuje możliwością wyświetlania zleceń
pracy dla ośrodka A, ale nie dla ośrodka B. Gdy ten użytkownik uruchomi zapytanie w
aplikacji w celu pobrania wszystkich zleceń pracy zawartych na liście konserwacji
zapobiegawczych, to zlecenia pracy dla ośrodka A (ale nie dla ośrodka B) zostaną pobrane na
jego urządzenie.
Kryteria wyszukiwania mogą obejmować stałe rozwiązywane dynamicznie, gdy zapytanie
jest wykonywane w Maximo Asset Management. Lista rekordów jest filtrowana wg wartości
8
Konfigurowanie programu Maximo Anywhere
zwracanej dla rozwiązanej stałej. Przykładowo: zapytanie domyślne WORKIOWN dla
aplikacji Work Execution zawiera stałą :USER. Po wykonaniu zapytania stała jest
rozwiązywana w celu zwrócenia wszystkich zleceń pracy, którymi dysponuje bieżący
użytkownik.
Procedura
1. W rozwiązaniu Maximo Asset Management otwórz aplikację zapewniającą dostęp do
zasobów podstawowych aplikacji mobilnej.
2. Na karcie List kliknij pozycję Advanced Search, użyj jednej z dostępnych opcji w celu
określenia kryteriów wyszukiwania i kliknij przycisk Find. Upewnij się, że zapytanie
zwraca oczekiwane wyniki.
3. Kliknij pozycję Save Query i określ niepowtarzalną nazwę zapytania. W nazwie
zapytania nie można używać spacji.
4. Wybierz opcję Publiczne.
5. Kliknij przycisk OK.
Co dalej
Użyj nazwy zapytania określonej w Maximo Asset Management w celu dodania zapytania do
definicji aplikacji w przypadku aplikacji mobilnej.
Tworzenie zapytań o zasoby OSLC
W programie Maximo Asset Management zasób OSLC może być skojarzony z aplikacją
poprzez strukturę obiektów. Tworzone zapytania publiczne są dodawane do dostawcy usług
jako możliwości zapytania dla zasobu. Zdefiniowanych zapytań można używać, aby
uzyskiwać dostęp do zasobu OSLC. Jeśli mają być obsługiwane różne wersje aplikacji
Maximo korzystającej z tego samego zasobu, można zdefiniować zapytania o zasoby dla
każdej z tych wersji.
Zanim rozpoczniesz
Za pomocą tej procedury można tworzyć zapytania dotyczące następujących aplikacji, ale nie
aplikacji Physical Count:
v Work Execution
v Work Approval
v Inspection
W przypadku aplikacji Physical Count należy użyć aplikacji Anywhere Administration.
O tym zadaniu
Zapytania o zasoby mogą być realizowane jako zapisane zapytania aplikacji lub jako
zapytania zdefiniowane przez skrypt automatyzacji.
Procedura
1. W aplikacji Zasoby produktu OSLC wybierz zasób OSLC.
2. Z menu Wybierz czynności wybierz opcję Definicja zapytania o zasób.
3. Określ zapytanie dotyczące zasobu.
Zapytanie
Czynność
W przypadku zapytania zapisanego w aplikacji Określ aplikację i zapytanie lub skopiuj wszystkie
zapytania publiczne powiązane z aplikacją.
Konfigurowanie programu Maximo Anywhere
9
Zapytanie
Czynność
W przypadku zapytania utworzonego przez
skrypt
Określ nazwę skryptu zapytania.
4. Określ unikalny identyfikator URI używany przez zapytanie i zapisz rekord.
5. W aplikacji Właściwości systemu określ nazwę hosta we właściwości
mxe.oslc.webappurl. Właściwość mxe.oslc.webappurl definiuje publiczny adres
URL służący do wyszukiwania zasobów OSLC. Domyślny adres URL to
http://localhost/maximo/oslc/.
6. Zaimportuj zmodyfikowany zasób OSLC z programu Maximo Asset Management do
programu Maximo Anywhere. Zasób OSLC jest importowany do plików RDF (Resource
Description Framework).
Co dalej
Dodaj zapytanie o zasób OSLC i identyfikator URI do pliku app.xml aplikacji mobilnej.
Informacje pokrewne:
Importowanie zasobów OSLC do programu Maximo Anywhere
Dodawanie zapytań do aplikacji mobilnych
Aby użytkownicy korzystający z urządzeń mobilnych mogli pobierać rekordy listy prac z
serwera, do każdej aplikacji mobilnej należy dodać co najmniej jedno zapytanie. Dodawanie
zapytań do aplikacji mobilnej polega na uwzględnieniu zapytania w pliku definicji aplikacji.
Zapytania można także dodawać za pomocą aplikacji Anywhere Administration, o ile jest
włączona.
Zanim rozpoczniesz
Można dodać zapytania dotyczące następujących aplikacji, ale nie aplikacji Physical Count:
v Work Execution
v Work Approval
v Inspection
Zapytania przeznaczone do zaimplementowania w aplikacji mobilnej muszą być zapisane
jako zapytania publiczne w środowisku Maximo Asset Management
O tym zadaniu
W definicji aplikacji zapytania dodawane są do specyfikacji dla widoku listy prac i zasobu
podstawowego. Każde zapytanie musi odpowiadać zapytaniu publicznemu w rozwiązaniu
Maximo Asset Management i mieć taką samą nazwę jak to zapytanie. Natomiast zapytanie
publiczne odpowiada zapytaniu w dostawcy usługi dla zasobu podstawowego.
Każda definicja aplikacji zawiera trzy zapytania systemowe: rekordy utworzone lokalnie,
rekordy z błędami i wyniki wyszukiwania. Te zapytania są używane w funkcjach
systemowych aplikacji mobilnej. Kodów tych zapytań nie można usuwać ani zmieniać.
Procedura
1. W edytorze XML otwórz app.xml z katalogu MaximoAnywhere\apps\app_name\
artifact.
2. Dodaj zapytanie do widoku listy prac. Widok listy prac to pierwszy widok zdefiniowany
w sekcji interfejsu użytkownika definicji aplikacji.
10
Konfigurowanie programu Maximo Anywhere
a. W elemencie <queries> dotyczącym widoku listy prac dodaj element podrzędny
<query>.
b. Za pomocą atrybutu queryBase określ nazwę zapytania publicznego w rozwiązaniu
Maximo Asset Management. W nazwie zapytania są rozróżniane małe i wielkie litery.
c. Za pomocą atrybutu label określ etykietę zapytania wyświetlaną w menu listy prac.
d. Opcjonalne: Aby określić to zapytanie jako domyślne w widoku listy prac, określ
etykietę zapytania jako wartość atrybutu label w nadrzędnym elemencie <view>.
W tym przykładzie do widoku listy prac w aplikacji Work Execution dodano trzy
zapytania:
<view id="WorkExecution.WorkItemsView" label="Work I Own"
saveonshow="true"
<queries resource="workOrder">
<query label="Work I Own" queryBase name="WorkIOwn">
<query label="Assigned to My Labor" queryBase name="WorkforMyLabor">
<query label="Work Assigned to My Crew" queryBase name="WorkforMyCrew">
<...>
</queries>
<...>
</view>
3. Zapytanie określone w kroku 2. dodaj do zasobu podstawowego. Zasób podstawowy to
pierwszy zasób zdefiniowany w sekcji danych definicji aplikacji.
a. W elemencie <queryBases> dotyczącym zasobu podstawowego dodaj element
podrzędny queryBase.
b. W atrybucie name określ nazwę zapytania publicznego w środowisku Maximo. W
nazwie zapytania są rozróżniane małe i wielkie litery.
c. W atrybucie queryUri określ sposób pobierania rekordów zapytania z programu
Maximo.
W tym przykładzie dla aplikacji Work Execution do zasobu podstawowego workOrder
dodano trzy zapytania:
<resource providedBy="/oslc/sp/WorkManagement"
describedBy="http://jazz.net/ns/ism/work/
smarter_physical_infrastucture#WorkOrder"
name="workOrder" pageSize="100"
class="application.business.WorkOrderObject">
<...>
<queryBases>
<queryBase name="WorkIOwn" queryUri="/oslc/os/oslcwodetail?savedQuery=WorkIOwn">
<queryBase name="WorkforMyLabor" queryUri="/oslc/os/oslcwodetail?savedQuery=WorkforMyLabor">
<queryBase name="WorkforMyCrew" queryUri="/oslc/os/oslcwodetail?savedQuery=WorkforMyCrew">
</queryBases>
<...>
</resource>
4. Zapisz plik.
5. Zbuduj i wdróż aplikację.
Co dalej
Zaloguj się w aplikacji i sprawdź, czy dodane zapytania są wyświetlane w menu listy prac.
Upewnij się, że lista rekordów po uruchomieniu zapytania w aplikacji dostawcy i aplikacji
mobilnej jest taka sama.
Pojęcia pokrewne:
“Zasoby danych w definicji aplikacji” na stronie 3
Dane używane w aplikacji dla urządzeń mobilnych są określane w definicji aplikacji na
podstawie zasobów OSLC. Zasoby są klasyfikowane jako zasoby podstawowe, pomocnicze,
wyszukiwania lub systemowe. Na podstawie tych kategorii ustalany jest sposób określania
zasobów w definicji aplikacji oraz sposób zarządzania nimi w czasie wykonywania.
Konfigurowanie programu Maximo Anywhere
11
Konfigurowanie inwentaryzacji ze stanami ewidencyjnymi i bez stanów
ewidencyjnych
Inwentaryzacje fizyczne w aplikacji Physical Count mogą być prowadzone ze stanami
ewidencyjnymi lub bez stanów ewidencyjnych. Domyślnie inwentaryzacja odbywa się bez
stanów ewidencyjnych. Aby prowadzić inwentaryzacje bez stanów ewidencyjnych lub
zmienić inwentaryzacje ze stanami w inwentaryzacje bez stanów ewidencyjnych, należy
zmodyfikować plik app.xml. Inwentaryzacje takie można także tworzyć za pomocą aplikacji
Anywhere Administration, o ile jest włączona.
O tym zadaniu
Podczas inwentaryzacji bez stanów ewidencyjnych aplikacja wymaga wprowadzenia wartości
liczbowych sald odzwierciedlających fizyczne stany magazynowe. Podczas inwentaryzacji ze
stanami ewidencyjnymi aplikacja wymaga wprowadzenia wartości liczbowych tylko wtedy,
gdy bieżące saldo pozycji różni się od fizycznego stanu magazynowego.
Jeśli w sekcji blindCountQueryBases pliku app.xml nie zdefiniowano podstawy zapytania, to
inwentaryzacja odbywa się ze stanami ewidencyjnymi.
Procedura
Aby utworzyć inwentaryzację bez stanów ewidencyjnych lub zmienić inwentaryzację ze
stanami ewidencyjnymi w inwentaryzację bez stanów ewidencyjnych:
1. W pliku app.xml utwórz atrybut lokalny dla inwentaryzacji.
2. Dodaj atrybut lokalny do listy podstaw zapytań w sekcji inwentaryzacji bez stanów
ewidencyjnych.
Aby zmienić inwentaryzację bez stanów ewidencyjnych w inwentaryzację ze stanami
ewidencyjnymi:
3. Usuń atrybut lokalny inwentaryzacji z listy podstaw zapytań w sekcji inwentaryzacji bez
stanów ewidencyjnych w pliku app.xml.
Przykład
Poniższy przykład sekcji inwentaryzacji bez stanów ewidencyjnych w pliku app.xml zawiera
listę podstaw zapytań dla takich inwentaryzacji:
<!-- BlindCount QueryBases -->
<resource name="blindCountQueryBases">
<attributes>
<localAttribute name="getCentralStoreroom" dataType="boolean" />
<localAttribute name="getAtlantaStoreroom" dataType="boolean" />
</attributes>
<whereClause />
</resource>
Zadania pokrewne:
“Włączanie aplikacji Anywhere Administration” na stronie 6
Domyślnie aplikacja Anywhere Administration jest wyłączona. Modyfikując aplikacje
mobilne za pomocą aplikacji Anywhere Administration, można uniknąć konieczności ich
ponownego budowania i wdrażania.
“Modyfikowanie aplikacji mobilnych za pomocą aplikacji Anywhere Administration” na
stronie 7
Modyfikując aplikacje mobilne za pomocą aplikacji Anywhere Administration, można
uniknąć konieczności ich ponownego budowania i wdrażania. Po zdefiniowaniu grupy
użytkowników uprawnionych do obserwacji modyfikacji aplikacji różni użytkownicy będą
12
Konfigurowanie programu Maximo Anywhere
mieli dostęp do różnych typów danych.
Określanie kryteriów dotyczących pobierania danych wyszukiwania
Aby zawęzić zakres zapytania w przypadku zasobu wyszukiwania, do zasobu w pliku
definicji aplikacji można dodać klauzulę WHERE. Takie klauzule WHERE można także
dodawać za pomocą aplikacji Anywhere Administration, o ile jest włączona.Kryteria zawarte
w klauzuli WHERE są ustalane w sposób dynamiczny podczas pobierania danych
wyszukiwania z aplikacji dostawcy.
O tym zadaniu
Domyślnie zapytanie dotyczące zasobu wyszukiwania powoduje pobranie wszystkich
rekordów lub instancji zasobu dostępnych w aplikacji dostawcy. W zależności od wymagań
użytkowników aplikacji dla urządzeń mobilnych można filtrować zestaw wyników, tak aby
odpowiadał niestandardowym kryteriom. Kryteria można określić, dodając klauzulę WHERE
do zasobu wyszukiwania w pliku definicji aplikacji.
Plik definicji aplikacji w przypadku aplikacji mobilnej może zawierać wstępnie zdefiniowane
klauzule WHERE dotyczące zasobów systemowych i wyszukiwania. Kryteria zawarte we
wstępnie zdefiniowanej klauzuli WHERE są wymagane przez aplikację mobilną w celu
obsługiwania operacji systemowych i nie można ich modyfikować. W klauzulach WHERE
można jednak zawrzeć dodatkowe kryteria. W tym celu należy użyć operatorów oraz .
Maximo Anywhere obsługuje klauzulę WHERE OSLC. Kryteria w klauzuli WHERE OSLC
są zapisane w standardowym formacie obejmującym atrybut, operator i stałą. Na przykład
poniższą klauzulę WHERE można dodać do zasobu listy wyszukiwania additionallocations w
celu pobrania lokalizacji tylko z OŚRODKA A:
<whereClause clause="spi:siteid=’SITE A’" />
Klauzula WHERE obejmuje następujące pozycje:
id_ośrodka
Atrybut zasobu listy wyszukiwania additionallocations.
=
Operator porównania oznaczający równość. Wokół operatorów porównania nie
można stosować spacji.
SITE A
Stała oznaczająca kryterium wartości lokalizacji dotyczące dopasowania rekordów
lokalizacji.
Kryteria zawarte w klauzuli WHERE są zazwyczaj oparte na atrybutach zasobu
wyszukiwania, do których odnosi się klauzula WHERE. Jednak klauzula WHERE może
również zawierać kryteria oparte na atrybutach zasobów systemowych. Na przykład poniższa
klauzula WHERE wyszukuje zasób mylaborcraftrate dla rekordu pracownika powiązanego z
bieżącym użytkownikiem. Rekord pracownika dla bieżącego użytkownika jest zapisywany
jako [${mylabor.laborcode}], gdzie łańcuch laborcode stanowi atrybut zasobu systemowego
mylabor. spi:defaultcraft jest atrybutem zasobu systemowego mylaborcraftrate:
<whereClause clause="spi:laborcode in [${mylabor.laborcode}] and
spi:defaultcraft=1" />
W przypadku klauzul WHERE używających atrybutów z innych zasobów nie można tworzyć
odwołań cyklicznych. Przykładowo: jeśli klauzula WHERE zasobu A korzysta z atrybutu z
zasobu B, klauzula WHERE zasobu B nie może korzystać z atrybutu z zasobu A.
Konfigurowanie programu Maximo Anywhere
13
Definicja XSD aplikacji nie może zweryfikować poprawności zawartości elementu
<whereClause>. W przypadku dodania klauzul WHERE do zasobów wyszukiwania w pliku
definicji aplikacji należy przetestować zaktualizowaną aplikację środowiska wykonawczego,
zanim zostanie ona wdrożona w środowisku produkcyjnym.
Procedura
1. W katalogu MaximoAnywhere\apps\app_name\artifact otwórz plik app.xml. W sekcji
danych pliku znajdź zasób, który zostanie skonfigurowany.
2. W elemencie <whereClause> określ kryteria jako wartość atrybutu klauzuli i zapisz plik.
3. Zbuduj i wdróż aplikację.
Zadania pokrewne:
“Włączanie aplikacji Anywhere Administration” na stronie 6
Domyślnie aplikacja Anywhere Administration jest wyłączona. Modyfikując aplikacje
mobilne za pomocą aplikacji Anywhere Administration, można uniknąć konieczności ich
ponownego budowania i wdrażania.
“Modyfikowanie aplikacji mobilnych za pomocą aplikacji Anywhere Administration” na
stronie 7
Modyfikując aplikacje mobilne za pomocą aplikacji Anywhere Administration, można
uniknąć konieczności ich ponownego budowania i wdrażania. Po zdefiniowaniu grupy
użytkowników uprawnionych do obserwacji modyfikacji aplikacji różni użytkownicy będą
mieli dostęp do różnych typów danych.
Konfigurowanie rozmiaru stron w celu pobierania danych
Aby zmniejszyć liczbę rekordów pobieranych jednocześnie z serwera, można skonfigurować
rozmiar strony dla zasobów podstawowych, wyszukiwania i systemowych.
O tym zadaniu
Rozmiar strony zasobu danych w pliku definicji aplikacji pozwala na zdefiniowanie liczby
rekordów pobieranych jednocześnie z serwera. Jeśli rozmiar listy rekordów przekracza
wartość rozmiaru strony, lista rekordów zostanie podzielona na listy podrzędne pobierane
jako oddzielne strony w kolejnych żądaniach.
W przypadku pojedynczych zasobów można określić różne wartości:
v Rozmiar strony w przypadku zasobów podstawowych określa liczbę rekordów, jakie
można pobrać na stronie wyników, gdy w aplikacji mobilnej użytkownik wybierze
zapytanie o listę prac. Domyślną wartością rozmiaru strony w przypadku zasobów
podstawowych jest 100.
v Rozmiar strony w przypadku zasobów wyszukiwania lub systemowych określa liczbę
rekordów, jakie można pobrać na stronie wyników dla tego typu zasobu, gdy w urządzeniu
mobilnym użytkownik pobierze lub odświeży dane wyszukiwania. Domyślną wartością
rozmiaru strony w przypadku większości zasobów wyszukiwania i systemowych jest 1000.
Zmniejszenie rozmiaru strony pozwala skrócić czas odpowiedzi podczas pobierania danych.
Zwiększając rozmiar strony, można zmniejszyć liczbę żądań przesyłanych przez aplikację w
celu pobrania pełnej listy wyników.
Procedura
1. W katalogu MaximoAnywhere\apps\app_name\artifact otwórz plik app.xml.
2. W sekcji danych pliku zaktualizuj wartość atrybutu pageSize dla zasobów lub zasobów,
które zostaną skonfigurowane. Atrybut pageSize to element główny zasobu.
3. Zapisz plik.
14
Konfigurowanie programu Maximo Anywhere
4. Zbuduj i wdróż aplikację.
Implementacja zgłaszania awarii w programie Maximo Anywhere
Domyślnie zapytanie pobierające dane o awarii pobiera wszystkie rekordy lub instancje
zasobu dostępne w aplikacji dostawcy. W zależności od wymagań użytkowników aplikacji
dla urządzeń mobilnych można filtrować zestaw wyników, tak aby odpowiadał
niestandardowym kryteriom.
Aby zawęzić zakres zapytania dotyczącego danych o awariach, można dodać klauzulę
WHERE do elementu queryBases w pliku definicji aplikacji (app.xml). Kryteria zawarte w
klauzuli WHERE są ustalane w sposób dynamiczny podczas pobierania danych
wyszukiwania z aplikacji dostawcy.
Przykładowo, można pobrać zlecenia pracy z kodami błędów, które są przypisane do
konkretnej organizacji. Jeśli organizacja, która jest wskazana dla zleceń pracy w programie
Maximo Asset Management, zawiera słowo ORG A, wówczas pobrane zostaną tylko zlecenia
pracy dla tej organizacji. Aby zawęzić zbiór pobieranych rekordów, dodaj następujący kod na
końcu sekcji queryBases:
<whereClause clause="spi_wm:orgid=’ORG A’"/>
Plik definicji aplikacji zawiera kilka sekcji kodu queryBases. Sekcja queryBases, którą należy
zmodyfikować, znajduje się w ramach następującego kodu:
<resource providedBy="/oslc/sp/SmarterPhysicalInfrastructure"
describedBy="http://jazz.net/ns/ism/asset/smarter_physical_infrastructure#FailureList"
name="failureListResource" pageSize="1000" additionalData="true">
Konfigurowanie map
W widoku mapy w aplikacjach Maximo Anywhere Work Execution i Maximo Anywhere
Inspection użytkownicy mogą odczytywać położenia geograficzne zleceń pracy. Aby
zapewnić dostęp do widoku mapy, należy przygotować środowisko Maximo Anywhere i
skonfigurować aplikację.
Informacje o położeniu na mapie
Informacje o położeniu to współrzędne geograficzne używane w celu określenia lokalizacji
zlecenia pracy i dodawania znaczników pozycji na mapie. Gdy zlecenie pracy w systemie
przedsiębiorstwa zawiera informacje o położeniu, np. adres usługi, te dane są wprowadzane
do aplikacji IBM® Maximo Anywhere Work Execution po pobraniu danego zlecenie pracy.
Jeśli zlecenia pracy w systemie przedsiębiorstwa nie zawierają informacji o położeniu, te
informacje należy skonfigurować w systemie przedsiębiorstwa.
Współrzędne lub informacje o położeniu zlecenia pracy są pobierane od dostawcy usługi map
do środowiska systemu przedsiębiorstwa.
Wskazówki dojazdu i dotyczące wyznaczania trasy w przypadku zleceń pracy dostępne na
liście prac bieżącego pracownika korzystającego z urządzeń mobilnych są dostępne, gdy w
urządzeniu mobilnym skonfigurowano dostawcę usługi map.
Jeśli system przedsiębiorstwa zawiera rozwiązanie IBM Maximo Spatial Asset Management,
informacje o położeniu pobierane są z obiektów zleceń pracy powiązanych z elementem na
mapie. Jeśli rozwiązanie Maximo Spatial Asset Management nie jest środowiskiem pracy
bieżącego użytkownika, informacje o położeniu są uzyskiwane za pomocą obiektów
niedowiązanych. Obiekt niedowiązany to obiekt zlecenia pracy, który nie jest połączony z
elementem na mapie. Dlatego obiekty niedowiązane zapewniają statyczne informacje o
Konfigurowanie programu Maximo Anywhere
15
współrzędnych geograficznych, które należy ręcznie dodać i zachować w obiekcie adresu
usługi. Obiekty zlecenia pracy, które mogą zawierać informacje o położeniu: zlecenie pracy,
adres usługi, zasób i lokalizacja.
Gdy rozwiązanie Maximo Spatial Asset Management jest dostępne, informacje o położeniu są
uzyskiwane za pomocą obiektów dowiązanych. Obiekt dowiązany to obiekt w zleceniu pracy
dowiązany do elementu na mapie w określonym systemie GIS. Obiekt dowiązany może być
obiektem zlecenia pracy lub zasobem, lokalizacją lub adresem usługi powiązanej. Dowiązanie
między obiektem i elementem na mapie powoduje włączenie funkcji automatycznego
lokalizowania, co pozwala na dynamiczne uzyskiwanie współrzędnych geograficznych z
systemu GIS, gdy działa zadanie CRON.
Jeśli użytkownik nie korzysta z rozwiązania Maximo Spatial Asset Management, informacje
o położeniu są pobierane ze statycznych współrzędnych geograficznych dodawanych i
przechowywanych w obiekcie adresu usługi. Statyczne współrzędne geograficzne należy
ręcznie dodawać do aplikacji Adres usługi w systemie Maximo Asset Management. Statyczne
współrzędne geograficzne można dodawać masowo lub poddawać migracji do aplikacji
Struktura integracji systemu Maximo Asset Management.
Aby korzystać z map Esri offline, należy opracować pliki TPK związane z obszarami
geograficznymi, w których realizowane będą zlecenia pracy. Układ współrzędnych adresu
usługi musi być zgodny z układem współrzędnych używanym do tworzenia map w trybie
offline.
Funkcja automatycznego lokalizowania określa położenie geograficzne rekordu poprzez
przetworzenie dostępnych informacji o położeniu w danej kolejności. Kolejność to obiekt
dowiązany zlecenia pracy, współrzędne X/Y zlecenia pracy, adres usługi powiązany ze
zleceniem pracy, współrzędne X/Y adresu usługi zlecenia pracy, dowiązany zasób zlecenia
pracy, współrzędne X/Y zasobu zlecenia pracy, dowiązana lokalizacja zlecenia pracy i
współrzędne X/Y lokalizacji zlecenia pracy.
Planowanie lokalizacji automatycznej zleceń pracy odbywa się za pomocą zadania CRON
WoAutoLocateCronTask.
Na poniższym rysunku przedstawiono przepływ danych między aplikacją Maximo Anywhere
na urządzeniu mobilnym, systemem przedsiębiorstwa i dostawcą usług map (serwer Esri
ArcGIS). W celu zapewnienia informacji o wyznaczaniu trasy w rozwiązaniu Maximo
Anywhere należy skonfigurować dostawcę usługi map.
16
Konfigurowanie programu Maximo Anywhere
Serwer Esri ArcGIS
Wskazówki
dojazdu
Współrzędne
System
przedsiębiorstwa
Urządzenie mobilne
Aplikacja
Maximo Anywhere
Zadanie Cron
Wtyczka map
Maximo Anywhere
(kod rodzimy)
Dane (OSLC)
Mapa offline
(plik TPK)
MobileFirst Server
Adapter
Dane
(JSON przez HTTP)
API dostawcy
usług mapy
(Esri Android SDK)
Dane są pobierane do urządzenia mobilnego ze środowiska systemu przedsiębiorstwa za
pomocą MobileFirst Server. Wymiana danych jest odzwierciedlona na rysunku za pomocą
OSLC, między środowiskiem systemu przedsiębiorstwa i MobileFirst Server, i przez format
JSON przesyłany za pomocą protokołu HTTP, między rozwiązaniem MobileFirst Server i
urządzeniem mobilnym.
Zadania pokrewne:
“Włączanie zadania CRON zapewniającego automatyczne lokalizowanie” na stronie 18
Rozwiązanie Maximo Anywhere zapewnia dostęp do zadania CRON
WoAutoLocateCronTask umożliwiającego korzystanie z funkcji automatycznego
lokalizowania. Domyślnie zadanie CRON nie jest włączone, ponieważ obsługa map jest
opcjonalna w rozwiązaniu Maximo Anywhere. W przypadku włączenia funkcji map należy
włączyć zadanie CRON.
Informacje pokrewne:
Kolejność procesu wyszukiwania funkcji Automatyczna lokalizacja dla zleceń pracy
Adresy usług
Adresy usług w systemie przedsiębiorstwa pozwalają na udostępnienie informacji
dotyczących położenia na mapie. Jeśli produkt Maximo Spatial Asset Management nie jest
używany, informacje o położeniu mogą być udostępniane za pomocą aplikacji Adres usługi.
Aplikacja Adres usługi Maximo jest objęta licencją Maximo Anywhere.
Jeśli podczas instalowania produktu Maximo Anywhere aplikacja Maximo Spatial Asset
Management jest już zainstalowana, wersja aplikacji Adres usługi w programie Maximo
Asset Management zostanie zaktualizowana do wersji Maximo Spatial Asset Management.
Zaktualizowana wersja aplikacji Adres usługi obsługuje obiekty dowiązane, które zawierają
informacje o położeniu na mapie.
Konfigurowanie programu Maximo Anywhere
17
Obiekt adresu usługi w aplikacji Adres usługi zawiera pola współrzędnych X/Y, w których
wprowadzane są informacje o położeniu. Informacje o położeniu można ręcznie dodać do
aplikacji. Ponadto po zainstalowaniu produktu Maximo Spatial Asset Management i
powiązaniu go z serwerem Esri ArcGIS do uzyskiwania informacji o położeniu mogą być
używane obiekty dowiązane do elementu na mapie.
Aplikację Adres usługi można skonfigurować, tak aby korzystała z pól długości i szerokości
geograficznej lub z pól współrzędnych X/Y. Jednak, aby aplikacja mogła korzystać z funkcji
mapy w programie Maximo Anywhere, musi być skonfigurowana w oparciu o pola
współrzędnych X/Y. System współrzędnych adresu usługi, który jest używany dla zleceń
pracy i obiektów powiązanych, musi być zgodny z systemem współrzędnych używanym do
tworzenia map w trybie offline (pliki TPK). Ponadto system współrzędnych adresu usługi
musi być zgodny z mapą, która jest skonfigurowana na serwerze Esri ArcGIS.
Włączanie zadania CRON zapewniającego automatyczne
lokalizowanie
Rozwiązanie Maximo Anywhere zapewnia dostęp do zadania CRON
WoAutoLocateCronTask umożliwiającego korzystanie z funkcji automatycznego
lokalizowania. Domyślnie zadanie CRON nie jest włączone, ponieważ obsługa map jest
opcjonalna w rozwiązaniu Maximo Anywhere. W przypadku włączenia funkcji map należy
włączyć zadanie CRON.
O tym zadaniu
Funkcja automatycznej lokalizacji w rozwiązaniu Maximo Asset Management pozwala na
aktualizowanie lub dodawanie informacji o położeniu do zleceń pracy. Informacje o
położeniu są używane w aplikacji Maximo Anywhere Work Execution w celu nakładania
położeń zleceń pracy na widok mapy.
Zadanie WoAutoLocateCronTask uruchamia funkcję automatycznego lokalizowania. Zadanie
CRON zawiera dwie instancje zadań CRON:
v Domyślnie instancja WoAutoLocateInstance powoduje wybranie zleceń pracy
zawierających zaplanowaną lub docelową datę początkową przypadającą w ciągu dwóch
dni od daty bieżącej. Należy zaplanować uruchamianie tej instancji co 24 godziny, aby
informacje o położeniu były aktualizowane lub dodawane do wszystkich zleceń pracy
przeznaczonych do uruchomienia w ciągu dwóch dni.
v Domyślnie instancja EmergentWoTask powoduje wybranie zleceń pracy zatwierdzonych
lub uruchomionych w czasie 5 minut przed bieżącą godziną. Należy zaplanować tę
instancję z częstotliwością, z jaką zlecenia pracy mogą być zatwierdzane lub uruchamiane,
aby informacje o położeniu były aktualizowane lub dodawane do danych zleceń pracy.
Kryteria wyboru zleceń pracy można zmienić w przypadku obydwu instancji zadania CRON,
modyfikując parametr WO_WHERECLAUSE. W przypadku instancji EmergentWoTask
można modyfikować parametr EMERG_WO_TIME.
Procedura
1. W aplikacji Cron Task Setup w rozwiązaniu Maximo Asset Management otwórz rekord
WoAutoLocateCronTask.
2. Zdefiniuj ustawienie każdej instancji zadania CRON:
a. Określ harmonogram każdej instancji zadania CRON. Wartość parametru
EMERG_WO_TIME powinna być co najmniej równa liczbie minut określonych w
harmonogramie. Ten parametr pobiera wszystkie zlecenia pracy zmodyfikowane od
czasu uruchomienia harmonogramu, do dwukrotnej wartości tego parametru.
18
Konfigurowanie programu Maximo Anywhere
Przykładowo: jeśli wartością parametru jest 5 minut, zostaną pobrane wszystkie
zlecenia pracy zmodyfikowane w poprzednich 10 minutach.
b. Określ użytkownika dysponującego danymi uprawnieniami, np. maxadmin.
Użytkownik musi mieć dostęp do czynności realizowanych przez zadanie cron.
c. Zaznacz pola wyboru Active oraz Keep History.
d. W polu Max Number of History Records wprowadź wartość 1000.
e. Opcjonalne: Aby zmienić kryteria wyboru zlecenia pracy, zaktualizuj parametr
WO_WHERECLAUSE.
3. W menu Wybierz czynności wybierz opcję Żądanie przeładowania.
4. Wybierz zadanie CRON i kliknij przycisk OK.
Właściwości systemowe — zadanie CRON
Instancje zadania CRON WoAutoLocateCronTask zawierają dwie powiązane właściwości
systemowe.
Aby zmienić wartość właściwości, należy użyć aplikacji Właściwości systemu Maximo Asset
Management.
Tabela 3. Właściwości systemowe — zadanie CRON
Wartość
domyślna
Właściwość
Opis
mxe.plussng.max.recs.returned.
arcgis.server
Maksymalna liczba rekordów zwracanych
jednocześnie przez serwer Esri ArcGIS.
Wartość ta oznacza najmniejszą liczbę
rekordów, które może otrzymać klient od
dowolnej usługi map używanej przez Maximo
Spatial Asset Management na serwerze Esri
ArcGIS. Ta właściwość systemowa jest
stosowana tylko, gdy rozwiązanie Maximo
Spatial Asset Management jest wdrożone w
środowisku systemu przedsiębiorstwa.
1000
mxe.plussng.cron.max.autoloc.
grp.objects
Maksymalna liczba zleceń pracy z obiektami
lokalizacji, które można przetworzyć
jednocześnie. Wartość ogranicza zapytanie
skonfigurowane w przypadku instancji zadań
automatycznej lokalizacji CRON, jeśli
zapytanie zwraca dużą liczbę zleceń pracy z
obiektami lokalizacji.
2000
Konfiguracja dostępu do dostawcy usług map
Dostawca usług map jest wymagany w celu zapewniania wskazówek dotyczących wytyczania
tras i dojazdu w ramach zleceń pracy w widoku mapy. Informacje o konfiguracji obowiązują
w przypadku wszystkich aplikacji uwzględniających widok mapy, które są wdrożone w
bieżącym środowisku.
Zanim rozpoczniesz
Na urządzeniach mobilnych i serwerze Esri ArcGIS należy skonfigurować opcje bezpiecznej
komunikacji.
Konfigurowanie programu Maximo Anywhere
19
O tym zadaniu
Informacje używane w celu uzyskania dostępu do serwera Esri ArcGIS nie są domyślnie
dodawane do pliku worklight.properties, ponieważ obsługa map w rozwiązaniu Maximo
Anywhere jest funkcją opcjonalną. Konfiguracja informacji o uwierzytelnianiu polega na
wprowadzeniu zmian w niniejszym pliku.
Po uruchomieniu aplikacji z widokiem map informacje są przesyłane do aplikacji, aby
pracownicy używający urządzeń mobilnych mogli korzystać z usługi wytyczania tras.
Procedura
1. W katalogu maximoanywhere_home\MaximoAnywhere\server\conf dokonaj edycji
pliku worklight.properties i określ następujące właściwości:
Właściwość
Opis
si.map.esri.authentication.isEnabled
Umożliwia uwierzytelnienie na serwerze Esri
ArcGIS. Wybranie opcji 1 powoduje włączenie
uwierzytelnienia.
si.map.esri.username
Nazwa użytkownika używana na serwerze Esri
ArcGIS w celu uzyskania dostępu do usługi
wytyczania trasy.
si.map.esri.password
Hasło używane na serwerze Esri ArcGIS w celu
uzyskania dostępu do usługi wytyczania trasy.
si.map.esri.routeService
Bezpieczny adres URL usługi wytyczania trasy na
serwerze Esri ArcGIS. W przypadku tej
właściwości użyj np. adresu
https://route.arcgis.com/arcgis/rest/services/World/
Route/NAServer/Route_World
2. Zapisz i zamknij plik.
3. Opcjonalne: Zaszyfruj plik worklight.properties za pomocą procedury szyfrowania
plików encrypt.bat. Właściwość si.map.esri.password.enc zawiera wartość szyfrującą
podobną do HhMEhpY3f6F6rlJQ17qwbw\=\=.
4. Zbuduj i wdróż aplikację.
5. Zrestartuj MobileFirst Server.
Pojęcia pokrewne:
Wdrażanie aplikacji na serwer
Informacje pokrewne:
Pomoc dla programistów w systemie Android
Pomoc serwera Esri ArcGIS
Zapisywanie właściwości w formacie zaszyfrowanym
Włączanie widoku mapy
Dzięki widokowi mapy pracownicy korzystający z urządzeń mobilnych dysponują
informacjami o lokalizacji geograficznej zleceń pracy zawartych na ich bieżących listach
prac. Zanim pracownicy korzystający z urządzeń mobilnych będą mogli uzyskać informacje
dotyczące wytyczania trasy w aplikacji Work Execution, należy włączyć widok map.
20
Konfigurowanie programu Maximo Anywhere
Zanim rozpoczniesz
W przypadku dostawcy usług map Esri wymagana jest licencja Esri. W przypadku map
offline:
v Należy utworzyć mapy zgodne z dostawcą usług map Esri i obsługiwane przez tego
dostawcę.
v Urządzenia mobilne korzystające z widoku map muszą mieć wystarczającą ilość miejsca w
pamięci na pliki map offline (.TPK) (które mogą być większe niż 1 GB).
O tym zadaniu
Widok mapy jest domyślnie wyłączony, ponieważ obsługa map w rozwiązaniu Maximo
Anywhere jest opcjonalna. Włączenie widoku map powoduje wyświetlenie ikony widoku
map na liście prac. Lista prac odpowiada znacznikom pozycji zlecenia pracy dostępnym w
widoku mapy.
Po włączeniu widoku mapy zaktualizowaną aplikację należy wdrożyć jako nową wersję
aplikacji. Użytkownicy muszą pobrać z serwera nową wersję aplikacji i zainstalować ją.
Należy wybrać albo mapy offline, albo online; nie można używać obu typów map
jednocześnie. W przypadku map offline należy określić położenie i nazwę pliku TPK. W
przypadku map online należy określić atrybut providerUrl.
Procedura
1. W katalogu maximoanywhere_home\MaximoAnywhere\apps\app_name edytuj plik
app-feature.properties i ustaw właściwość map.enabled=true.
2. Zapisz i zamknij plik.
3. Z katalogu maximoanywhere_home\MaximoAnywhere\apps\WorkExecution\
artifact, otwórz plik app.xml i zmodyfikuj atrybut mapy. Atrybut można także
zmodyfikować za pomocą aplikacji Anywhere Administration, o ile jest włączona.
a. W przypadku map offline w atrybucie LocalMapUrl wprowadź lokalizację i nazwę
pliku TPK na urządzeniu mobilnym. Ponadto w przypadku urządzeń iOS należy w
atrybucie iosMapAccessMethod określić sposób dostępu: albo z folderu
Documents, albo z pakietu.
v W przypadku urządzeń Android będzie to: androidLocalMapUrl="file://
ścieżka_folderu/nazwa_pliku_mapy.tpk".
v W przypadku urządzeń iOS będzie to: iosLocalMapUrl="file://ścieżka_folderu/
nazwa_pliku_mapy.tpk". Należy także wprowadzić wartość useDocumentsFolder
albo useBundle dla atrybutu iosMapAccessMethod.
b. W przypadku map online należy określić atrybut providerUrl. Wartość może określać
dowolną poprawną usługę ArcGIS tworzenia obrazów na podstawie map. Jeśli atrybut
providerUrl nie zostanie określony, używany będzie plik TPK zdefiniowany przez
użytkownika.
4. Zapisz i zamknij plik.
5. Zbuduj i wdróż aplikację.
Co dalej
Aktywacja GPS
Pojęcia pokrewne:
Wdrażanie aplikacji na serwer
Informacje pokrewne:
Konfigurowanie programu Maximo Anywhere
21
Włączanie aplikacji Anywhere Administration
Domyślnie aplikacja Anywhere Administration jest wyłączona. Modyfikując aplikacje
mobilne za pomocą aplikacji Anywhere Administration, można uniknąć konieczności ich
ponownego budowania i wdrażania.
Modyfikowanie aplikacji mobilnych za pomocą aplikacji Anywhere Administration
Modyfikując aplikacje mobilne za pomocą aplikacji Anywhere Administration, można
uniknąć konieczności ich ponownego budowania i wdrażania. Po zdefiniowaniu grupy
użytkowników uprawnionych do obserwacji modyfikacji aplikacji różni użytkownicy będą
mieli dostęp do różnych typów danych.
Dodawanie map na urządzeniach z systemem iOS
Aby używać map na urządzeniach z systemem iOS, można dodać plik mapy do aplikacji
Work Execution lub pobrać plik mapy na urządzenie za pomocą iTunes.
Zanim rozpoczniesz
Utwórz mapy, które chcesz dodać do aplikacji Work Execution.
Włącz widok mapy w urządzeniu iOS, aktualizując plik app.xml, aby określić nazwę mapy i
sposób dostępu do pliku mapy.
O tym zadaniu
Dodanie pliku mapy do aplikacji Work Execution przed wdrożeniem zagwarantuje, że ten
sam plik mapy zostanie wdrożony na wszystkich urządzeniach pobierających aplikację. Po
udostępnieniu zaktualizowanej wersji mapy i ponownym wdrożeniu aplikacji zmiana zostanie
wprowadzona na wszystkich urządzeniach.
Jeśli plik mapy zostanie umieszczony na urządzeniu za pomocą iTunes, to w aplikacji Work
Execution na poszczególnych urządzeniach używane będą różne mapy. Ta metoda jest
przydatna, jeśli pracownicy mobilni operują w różnych regionach geograficznych.
Procedura
v Aby dodać ten sam plik mapy do aplikacji Work Execution na wszystkich urządzeniach,
skopiuj plik mapy do katalogu MaximoAnywhere\apps\WorkExecution\iphone\native\
Resources\ISIImage.bundle\nazwa_pliku_mapy.tpk i przeprowadź budowanie i
wdrożenie aplikacji.
v Aby dodać plik mapy z dowolnej stacji roboczej na konkretne urządzenie, skopiuj mapę na
urządzenie, korzystając z udostępniania plików w iTunes.
Aktywacja GPS
Rozwiązanie Maximo Anywhere korzysta z danych GPS w celu określania położenia
geograficznego pracowników korzystających z urządzeń mobilnych oraz zleceń pracy. Dane
GPS są również wymagane podczas umieszczania znaczników pozycji w widoku mapy.
Zanim rozpoczniesz
Widok mapy musi być włączony.
O tym zadaniu
Funkcja GPS jest domyślnie wyłączona, ponieważ obsługa map w rozwiązaniu Maximo
Anywhere jest opcjonalna.
22
Konfigurowanie programu Maximo Anywhere
Procedura
1. W katalogu maximoanywhere_home\MaximoAnywhere\apps\app_name edytuj plik
app-feature.properties i ustaw właściwość gps.enabled=true.
2. Zapisz i zamknij plik.
3. Zbuduj i wdróż aplikację.
Pojęcia pokrewne:
Wdrażanie aplikacji na serwer
Konfigurowanie linii tras
Przy włączonym widoku mapy można określać kolor, przezroczystość i szerokość linii tras
między znacznikami. Linie trasy można konfigurować za pomocą aplikacji Anywhere
Administration, o ile jest włączona.
O tym zadaniu
Aby zmienić kolor, przezroczystość i szerokość linii tras, należy zmodyfikować plik
worklight.properties w folderze MaximoAnywhere\server\conf. Szerokość domyślna to 5.
Kolor domyślny to niebieski z 50-procentową przezroczystością (7F0000FF).
Wartość określająca kolor i przezroczystość linii tras ma postać AARRGGBB. AA oznacza
poziom przezroczystości. Wartość RRGGBB określają kolor: RR to składowa czerwona, GG
to składowa zielona, a BB to składowa niebieska.
Procedura
1. W pliku worklight.properties zmodyfikuj właściwość si.map.directionsPathWidth,
aby zmienić szerokość linii tras. Aby zmienić kolor i przezroczystość, zmodyfikuj
właściwość si.map.directionsPathColor.
2. Zbuduj i wdróż aplikację.
Informacje pokrewne:
Obliczanie wartości koloru i szerokości dla linii tras na mapie
Wartości szesnastkowe kolorów
Włączanie aplikacji Anywhere Administration
Domyślnie aplikacja Anywhere Administration jest wyłączona. Modyfikując aplikacje
mobilne za pomocą aplikacji Anywhere Administration, można uniknąć konieczności ich
ponownego budowania i wdrażania.
Modyfikowanie aplikacji mobilnych za pomocą aplikacji Anywhere Administration
Modyfikując aplikacje mobilne za pomocą aplikacji Anywhere Administration, można
uniknąć konieczności ich ponownego budowania i wdrażania. Po zdefiniowaniu grupy
użytkowników uprawnionych do obserwacji modyfikacji aplikacji różni użytkownicy będą
mieli dostęp do różnych typów danych.
Konfigurowanie poziomów powiększenia
Przy włączonym widoku mapy można sterować poziomem powiększenia map internetowych.
Poziomy powiększenia można także konfigurować za pomocą aplikacji Anywhere
Administration, o ile jest włączona.
O tym zadaniu
Aby zmienić poziom powiększenia, należy edytować plik worklight.properties w folderze
MaximoAnywhere\server\conf. Wartością domyślną jest 19.
Konfigurowanie programu Maximo Anywhere
23
Wartość domyślna, czyli 19, jest poprawna dla domyślnego adresu URL map internetowych
Esri skonfigurowanego w pliku app.xml:
providerUrl="http://server.arcgisonline.com/ArcGIS/rest/services/World_Topo_Map/
MapServer/tile/{z}/{y}/{x}"
Plik app.xml znajduje się w katalogu: MaximoAnywhere\apps\app_name\artifact .
W przypadku pozostałych adresów URL obowiązują inne poprawne poziomy powiększenia.
W domyślnym adresie URL określony jest typ mapy, w tym przypadku World_Topo_Map.
Aby użyć innego typu mapy, zmień typ mapy w adresie URL. Na przykład, aby skorzystać z
map dna oceanów, wpisz w adresie URL typ Ocean_Basemap:
http://server.arcgisonline.com/ArcGIS/rest/services/Ocean_Basemap/MapServer/
tile/{z}/{y}/{x}
Jeśli na serwerze zdefiniowane są inne typy map, zmień pierwszą część adresu według
schematu: tile/{z}/{y}/{x}, na przykład:
http://myownserver.com/myUrlForBaseMaps/myBaseMapType/tile/{z}/{y}/{x}
Procedura
1. W pliku worklight.properties zmodyfikuj właściwość
si.map.openLayers.maxZoom, aby zmienić poziom powiększenia map
internetowych.
2. Zbuduj i wdróż aplikację.
Informacje pokrewne:
Dostawcy URL ESRI
Włączanie aplikacji Anywhere Administration
Domyślnie aplikacja Anywhere Administration jest wyłączona. Modyfikując aplikacje
mobilne za pomocą aplikacji Anywhere Administration, można uniknąć konieczności ich
ponownego budowania i wdrażania.
Modyfikowanie aplikacji mobilnych za pomocą aplikacji Anywhere Administration
Modyfikując aplikacje mobilne za pomocą aplikacji Anywhere Administration, można
uniknąć konieczności ich ponownego budowania i wdrażania. Po zdefiniowaniu grupy
użytkowników uprawnionych do obserwacji modyfikacji aplikacji różni użytkownicy będą
mieli dostęp do różnych typów danych.
Aktywowanie skanowania kodów paskowych
Po włączeniu funkcji skanowania kodów paskowych użytkownicy urządzeń mobilnych mogą
skanować kody paskowe w celu zapoznania się ze szczegółami dotyczącymi zleceń pracy.
O tym zadaniu
Domyślnie funkcja skanowania kodów paskowych jest wyłączona, ale można ją włączyć w
pliku app-feature.properties.
Po włączeniu funkcji skanowania kodów paskowych zaktualizowaną aplikację należy
wdrożyć jako nową wersję aplikacji. Użytkownicy muszą pobrać z serwera nową wersję
aplikacji i zainstalować ją.
Procedura
1. Otwórz plik app-feature.properties w folderze MaximoAnywhere\apps\app_name,
odszukaj właściwość barcode.enabled i ustaw ją na true.
2. Zbuduj i wdróż aplikację.
24
Konfigurowanie programu Maximo Anywhere
Informacje pokrewne:
Wdrażanie aplikacji na serwer
Podłączanie skanerów kodów paskowych Bluetooth do aplikacji
mobilnych
Aby korzystać ze skanera kodów paskowych Bluetooth razem z aplikacją mobilną, należy
skojarzyć skaner z urządzeniem, a następnie podłączyć skaner do aplikacji.
O tym zadaniu
Aby podłączyć skaner do aplikacji, należy zeskanować znaki na początku i końcu kodu
paskowego pozycji. Znaki te oddzielają od siebie kody paskowe. Kody tych znaków podane
są w instrukcji producenta skanera. Niezastosowanie się do tego wymogu spowoduje, że
aplikacja będzie ignorowała skanowane dane.
Procedura
1. Skojarz skaner kodów paskowych z urządzeniem, postępując zgodnie z instrukcją
producenta skanera.
2. Podłącz skaner do aplikacji:
a. Dodaj przedrostek, skanując kody kreskowe oznaczające otwierający nawias
kwadratowy , [.
b. Dodaj pierwszy przyrostek, skanując kody kreskowe oznaczające ukośnik odwrotny,
\.
c. Dodaj drugi przyrostek, skanując kody kreskowe oznaczające zamykający nawias
kwadratowy, ].
3. Aby automatycznie wznawiać połączenie po przejściu urządzenia w tryb offline, należy
zeskanować kod paskowy służący do podłączania urządzenia. Ten kod podany jest w
instrukcji producenta skanera.
Włączanie szyfrowania lokalnej składnicy danych
Szyfrowanie danych jest włączane na poziomie projektu Maximo Anywhere. Po włączeniu
szyfrowania składnica danych tworzona w urządzeniu dla każdej aplikacji mobilnej jest
automatycznie szyfrowana.
O tym zadaniu
Szyfrowanie można włączać i wyłączać za pomocą ustawienia szyfrowania w pliku
build.properties w projekcie Maximo Anywhere. Aktywne ustawienie wpływa na wszystkie
aplikacje, które są następnie tworzone i wdrażane w ramach projektu.
Włączenie szyfrowania powoduje zwiększenie poziomu ochrony danych aplikacji
przechowywanych na urządzeniu. Jednak wydajność aplikacji może ulec obniżeniu z powodu
dodatkowego czasu wymaganego przez procesy szyfrowania i odszyfrowywania.
Po wyłączeniu szyfrowania danych lokalnie przechowywane hasło logowania jest nadal
zabezpieczone. Domyślnie szyfrowanie danych jest wyłączone.
W czasie wykonywania nie można przekształcić lokalnej składnicy danych z formatu
szyfrowanego do nieszyfrowanego i odwrotnie. Jeśli ustawienie szyfrowania danych ulegnie
zmianie pomiędzy aktualizacjami aplikacji, należy usunąć zawartość pamięci podręcznej oraz
Konfigurowanie programu Maximo Anywhere
25
dane bieżącej wersji aplikacji, zdeinstalować bieżącą wersję i zainstalować wersję
zaktualizowaną. Po wyczyszczeniu danych aplikacji niezsynchronizowane dane zostaną
utracone.
Po zainstalowaniu i zalogowaniu się do zaktualizowanej wersji aplikacji lokalna składnica
danych jest tworzona w formacie zgodnym z aktywnym ustawieniem.
Procedura
1.
2.
3.
4.
Otwórz plik build.properties w folderze MaximoAnywhere.
Określ właściwość enableDataEncryption.
Zapisz i zamknij plik.
Utwórz i wdróż aplikacje.
Zmiana okresu pulsu
Można zmienić częstotliwość sygnału pulsu przesyłanego przez aktywne aplikacje Maximo
Anywhere do MobileFirst Server.
O tym zadaniu
W czasie wykonywania aplikacja Maximo Anywhere generuje sygnał pulsu z częstotliwością
zdefiniowaną na poziomie systemu. Sygnał jest używany w celu określenia, czy aplikacja jest
połączona z rozwiązaniem MobileFirst Server. W przypadku potwierdzenia łączności
aplikacja przesyła zmiany danych lokalnych, które nie zostały jeszcze zapisane na serwerze.
Częstotliwość pulsu określa więc częstotliwość automatycznego wysyłania.
Definiowanie częstotliwości sygnału pulsu polega na określeniu okresu między sygnałami w
pliku worklight.properties dla projektu Maximo Anywhere. Aktywne ustawienie wpływa na
wszystkie aplikacje, które są budowane i wdrażane w projekcie.
Domyślny okres pulsu wynosi 1200 sekund (20 minut). Niższa wartość powoduje skrócenie
czasu działania akumulatora w urządzeniu, na którym działają aplikacje Maximo Anywhere.
Procedura
1. Otwórz plik worklight.properties dostępny w katalogu maximoanywhere_home\
MaximoAnywhere\server\conf.
2. We właściwości si.device.heartbeat.timeInterval określ okres pulsu w sekundach.
3. Zapisz i zamknij plik.
4. Utwórz i wdróż aplikacje.
Właściwości dotyczące załączników
Plik app-feature.properties zawiera właściwość umożliwiającą korzystanie z załączników.
Pobieraniem i przesyłaniem załączników, ich maksymalną wielkością i położeniem sterują
właściwości zapisane w pliku worklight.properties. Załączniki można także włączać za
pomocą aplikacji Anywhere Administration, o ile jest włączona.
Aby umożliwić korzystanie z załączników, otwórz plik app-feature.properties z folderu
MaximoAnywhere\apps\app_name i nadaj właściwości attachments.enabled wartość
true. Załączniki są domyślnie włączone dla aplikacji obsługujących załączniki.
Aby zmienić wartość właściwości określającej załącznik, zmodyfikuj plik
worklight.properties w katalogu maximoanywhere_home\MaximoAnywhere\server\
conf.
26
Konfigurowanie programu Maximo Anywhere
Wartość
domyślna
Właściwość
Opis
si.device.downloadAttachments
WithBulkDownload
Gdy warunek jest spełniony, załączniki zleceń pracy są
pobierane razem z listą prac. Użytkownik aplikacji może
przesłonić domyślną wartość tej właściwości, usuwając
zaznaczenie pola wyboru Pobieraj załączniki z listą prac w
widoku Ustawienia w aplikacji Maximo Anywhere Work
Execution.
true
si.device.onlyBulkDownloadPrint
WithReportAttachments
Domyślnie razem z listą prac pobierane są tylko załączniki,
które można drukować. Można przesłonić ustawienie
domyślne, przechodząc do aplikacji Maximo Asset
Management i usuwając zaznaczenie pola wyboru Drukuj
załączony dokument z raportem, jeśli typ umożliwia
drukowanie w oknie Właściwości załącznika. Załączniki
można nadal pobrać ręcznie.
true
si.att.proxy.maxfilesize
Steruje maksymalną wielkością załącznika, który można
pobrać razem z listą prac. Można zmienić wartość domyślną
na wartość wyższą lub niższą.
5242880
(5 MB)
si.attach.uploadmaxsize
Steruje maksymalną wielkością załącznika, który można
przesłać razem z rekordem pracy. Można zmienić wartość
domyślną na wartość wyższą lub niższą. Jeśli w charakterze
serwera zaplecza używany jest produkt Maximo Asset
Management, właściwość dokumentu załącznika
mxe.doclink.maxfilesize nie może mieć wartości
mniejszej niż właściwość si.attach.uploadmaxsize.
10 MB
si.attachment.basedirectory
Steruje położeniem katalogu głównego załączników. Jeśli z
urządzenia mobilnego korzysta wielu użytkowników,
załączniki mogą być dodawane do osobnych katalogów
użytkowników (po jednym katalogu dla każdego
użytkownika). Wszystkie katalogi użytkowników zostają
umieszczone w obrębie katalogu bazowego. Aby zwolnić
miejsce zajmowane przez załączniki, należy usunąć je z
katalogów użytkowników lub usunąć katalog domyślny.
anywhere
si.attach.doclink.doctypes.defpath
Katalog, w którym domyślnie przechowywane są załączniki.
Nazwa katalogu musi zgadzać się z określoną we właściwości
mxe.doclink.doctypes.defpath i właściwości
mxe.doclink.path01 środowiska Maximo Asset
Management. Katalog ten musi być dostępny zarówno z
serwera aplikacji, jak i z serwera WWW. W środowisku z
więcej niż jednym serwerem katalog musi być udostępniony i
używany na wszystkich odpowiednich serwerach.
DOC
-LINKS
Zadania pokrewne:
“Włączanie aplikacji Anywhere Administration” na stronie 6
Domyślnie aplikacja Anywhere Administration jest wyłączona. Modyfikując aplikacje
mobilne za pomocą aplikacji Anywhere Administration, można uniknąć konieczności ich
ponownego budowania i wdrażania.
“Modyfikowanie aplikacji mobilnych za pomocą aplikacji Anywhere Administration” na
stronie 7
Modyfikując aplikacje mobilne za pomocą aplikacji Anywhere Administration, można
uniknąć konieczności ich ponownego budowania i wdrażania. Po zdefiniowaniu grupy
użytkowników uprawnionych do obserwacji modyfikacji aplikacji różni użytkownicy będą
mieli dostęp do różnych typów danych.
Właściwości limitu czasu
Czasem odliczanym do przekroczenia limitu czasu i czasem oczekiwania na ponowne
przesłanie żądania sterują właściwości zawarte w pliku worklight.properties. Takie
właściwości limitu czasu można także konfigurować za pomocą aplikacji Anywhere
Administration, o ile jest włączona.
Poniżej przedstawiono przykłady opisujące zachowanie domyślne w przypadku żądań,
których limit czasu upłynął w aplikacji Maximo Anywhere Work Execution:
Konfigurowanie programu Maximo Anywhere
27
v Użytkownik próbuje uzyskać dostęp do rozwiązania MobileFirst Server. Następuje
przekroczenie limitu czasu żądania i przez 60 sekund użytkownik nie może ponownie
przesłać żądania.
v Użytkownik próbuje nawiązać połączenie z adapterem. Po 3 sekundach następuje
przekroczenie limitu czasu żądania.
v Użytkownik próbuje pobrać dużą ilość danych. Po 6 minutach następuje przekroczenie
limitu czasu żądania.
Aby zmienić wartość właściwości, należy edytować plik worklight.properties zawarty w
katalogu maximoanywhere_home\MaximoAnywhere\server\conf.
Wartość
domyślna
Właściwość
Opis
si.device.connectivity.
timeout.interval
Czas oczekiwania między próbami uzyskania dostępu 60000 ms
do MobileFirst Server. Określ 0, aby nie stosować
limitu czasu Jeśli rozwiązanie MobileFirst Server nie
odpowiada, do aplikacji jest przesyłany błąd.
si.device.connectivity.
timeout
Dozwolony czas na uzyskanie połączenia z
adapterem, zanim wyświetlony zostanie monit o
przekroczeniu limitu.
3000 ms
si.device.connectivity.
timeout.stablepagination
Dozwolony czas na pobranie dużej ilości danych,
takich jak dane wyszukiwania, zanim wyświetlony
zostanie monit o przekroczeniu limitu czasu.
360000 ms
Zadania pokrewne:
“Włączanie aplikacji Anywhere Administration” na stronie 6
Domyślnie aplikacja Anywhere Administration jest wyłączona. Modyfikując aplikacje
mobilne za pomocą aplikacji Anywhere Administration, można uniknąć konieczności ich
ponownego budowania i wdrażania.
“Modyfikowanie aplikacji mobilnych za pomocą aplikacji Anywhere Administration” na
stronie 7
Modyfikując aplikacje mobilne za pomocą aplikacji Anywhere Administration, można
uniknąć konieczności ich ponownego budowania i wdrażania. Po zdefiniowaniu grupy
użytkowników uprawnionych do obserwacji modyfikacji aplikacji różni użytkownicy będą
mieli dostęp do różnych typów danych.
Informacje pokrewne:
Wdrażanie aplikacji na serwer
28
Konfigurowanie programu Maximo Anywhere
Informacje
Niniejsza publikacja została przygotowana z myślą o produktach i usługach oferowanych w
Stanach Zjednoczonych.
IBM może nie oferować w innych krajach produktów, usług lub opcji omawianych w tej
publikacji. Informacje o produktach i usługach dostępnych w danym kraju można uzyskać od
lokalnego przedstawiciela IBM. Jakakolwiek wzmianka na temat produktu, programu lub
usługi IBM nie oznacza, że może być zastosowany jedynie ten produkt, ten program lub ta
usługa IBM. Zamiast nich można zastosować ich odpowiednik funkcjonalny, pod warunkiem
że nie narusza to praw własności intelektualnej IBM. Jednakże cała odpowiedzialność za
ocenę przydatności i sprawdzenie działania produktu, programu lub usługi pochodzących od
producenta innego niż IBM spoczywa na użytkowniku.
IBM może posiadać patenty lub złożone wnioski patentowe na towary i usługi, o których
mowa w niniejszej publikacji. Przedstawienie tej publikacji nie daje żadnych uprawnień
licencyjnych do tychże patentów. Wnioski o przyznanie licencji można zgłaszać na piśmie
pod adresem:
IBM Director of Licensing
IBM Corporation
North Castle Drive
Armonk, NY 10504-1785
U.S.A.
Zapytania dotyczące zestawów znaków dwubajtowych (DBCS) należy kierować do lokalnych
działów własności intelektualnej IBM (IBM Intellectual Property Department) lub wysłać je
na piśmie na adres:
Intellectual Property Licensing
Legal and Intellectual Property Law
IBM Japan Ltd.
1623-14, Shimotsuruma, Yamato-shi
Kanagawa 242-8502 Japonia
Poniższy akapit nie obowiązuje w Wielkiej Brytanii, a także w innych krajach, w których jego
treść pozostaje w sprzeczności z przepisami prawa miejscowego: INTERNATIONAL
BUSINESS MACHINES CORPORATION DOSTARCZA TĘ PUBLIKACJĘ W STANIE,
W JAKIM SIĘ ZNAJDUJE ("AS IS"), BEZ UDZIELANIA JAKICHKOLWIEK
GWARANCJI (RĘKOJMIĘ RÓWNIEŻ WYŁĄCZA SIĘ), WYRAŹNYCH LUB
DOMNIEMANYCH, A W SZCZEGÓLNOŚCI DOMNIEMANYCH GWARANCJI
PRZYDATNOŚCI HANDLOWEJ, PRZYDATNOŚCI DO OKREŚLONEGO CELU ORAZ
GWARANCJI, ŻE PUBLIKACJA TA NIE NARUSZA PRAW OSÓB TRZECICH.
Ustawodawstwa niektórych krajów nie dopuszczają zastrzeżeń dotyczących gwarancji
wyraźnych lub domniemanych w odniesieniu do pewnych transakcji; w takiej sytuacji
powyższe zdanie nie ma zastosowania.
Informacje zawarte w niniejszej publikacji mogą zawierać nieścisłości techniczne lub błędy
typograficzne. Informacje te są okresowo aktualizowane, a zmiany te zostaną uwzględnione w
kolejnych wydaniach tej publikacji. IBM zastrzega sobie prawo do wprowadzania ulepszeń
i/lub zmian w produktach i/lub programach opisanych w tej publikacji w dowolnym czasie,
bez wcześniejszego powiadomienia.
© Copyright IBM Corp. 2013, 2015
29
Wszelkie wzmianki w tej publikacji na temat stron internetowych innych podmiotów zostały
wprowadzone wyłącznie dla wygody użytkownika i w żadnym wypadku nie stanowią zachęty
do ich odwiedzania. Materiały dostępne na tych stronach nie są częścią materiałów
opracowanych dla tego produktu IBM, a użytkownik korzysta z nich na własną
odpowiedzialność.
IBM ma prawo do używania i rozpowszechniania informacji przysłanych przez użytkownika
w dowolny sposób, jaki uzna za właściwy, bez żadnych zobowiązań wobec ich autora.
Licencjobiorcy tego programu, którzy chcieliby uzyskać informacje na temat programu w
celu: (i) wdrożenia wymiany informacji między niezależnie utworzonymi programami i
innymi programami (łącznie z tym opisywanym) oraz (ii) wykorzystywania wymienianych
informacji, powinni skontaktować się z:
IBM Corporation
2Z4A/101
11400 Burnet Road
Austin, TX 78758 U.S.A.
Informacje takie mogą być udostępnione, o ile spełnione zostaną odpowiednie warunki, w
tym, w niektórych przypadkach, zostanie uiszczona stosowna opłata.
Licencjonowany program opisany w niniejszej publikacji oraz wszystkie inne licencjonowane
materiały dostępne dla tego programu są dostarczane przez IBM na warunkach określonych w
Umowie IBM z Klientem, Międzynarodowej Umowie Licencyjnej IBM na Program lub w
innych podobnych umowach zawartych między IBM i użytkownikami.
Informacje dotyczące produktów innych niż produkty IBM pochodzą od dostawców tych
produktów, z opublikowanych przez nich zapowiedzi lub innych powszechnie dostępnych
źródeł. IBM nie testował tych produktów i nie może potwierdzić dokładności pomiarów
wydajności, kompatybilności ani żadnych innych danych związanych z tymi produktami.
Pytania dotyczące możliwości produktów innych podmiotów należy kierować do dostawców
tych produktów.
Publikacja ta zawiera przykładowe dane i raporty używane w codziennej pracy. W celu
kompleksowego ich zilustrowania podane przykłady zawierają nazwiska osób prywatnych,
nazwy przedsiębiorstw oraz nazwy produktów. Wszystkie te nazwy/nazwiska są fikcyjne i
jakiekolwiek podobieństwo do istniejących nazw/nazwisk i adresów jest całkowicie
przypadkowe.
LICENCJA W ZAKRESIE PRAW AUTORSKICH:
Niniejsza publikacja zawiera przykładowe aplikacje w kodzie źródłowym, ilustrujące techniki
programowania w różnych systemach operacyjnych. Użytkownik może kopiować,
modyfikować i rozpowszechniać te programy przykładowe w dowolnej formie bez uiszczania
opłat na rzecz firmy IBM, w celu rozbudowy, użytkowania, handlowym lub w celu
rozpowszechniania aplikacji zgodnych z aplikacyjnym interfejsem programowym dla tego
systemu operacyjnego, dla którego napisane były programy przykładowe. Programy
przykładowe nie zostały gruntownie przetestowane. IBM nie może zatem gwarantować ani
sugerować niezawodności, użyteczności i funkcjonalności tych programów. Programy
przykładowe są dostarczane w stanie, w jakim się znajdują ("AS IS"), bez udzielania
jakichkolwiek gwarancji (rękojmię również wyłącza się). IBM nie ponosi odpowiedzialności
za jakiekolwiek szkody wynikające z używania programów przykładowych.
30
Konfigurowanie programu Maximo Anywhere
Strategia ochrony prywatności
Produkty programowe IBM, w tym oprogramowanie udostępniane w postaci usług
(„Oprogramowanie”) może używać plików cookie lub innych rozwiązań technicznych do
zbierania informacji o sposobie korzystania z produktu w celu doskonalenia interakcji z
użytkownikiem, dopasowania interakcji do preferencji konkretnego użytkownika lub w
innych celach. W wielu przypadkach Oprogramowanie nie zbiera żadnych informacji
umożliwiających identyfikację tożsamości osób. Część Oprogramowania może jednak
umożliwiać gromadzenie informacji pozwalających na identyfikację osoby. Jeśli Oferowane
Oprogramowanie korzysta z informacji cookie do gromadzenia informacji pozwalających na
identyfikację osoby, poniżej znajdują się szczegółowe informacje na temat takiego
korzystania.
W zależności od wdrożonych konfiguracji niniejsze Oferowane oprogramowanie może
korzystać z plików cookie sesji i trwałych gromadzących nazwy użytkowników, hasła lub
inne informacje pozwalające na identyfikację użytkownika w celach zarządzania sesją,
uwierzytelniania, konfigurowania funkcji jednokrotnego logowania lub innych celach
funkcjonalnych. Informacje cookie można wyłączyć, ale może to spowodować odłączenie
aktywowanych przez nie funkcjonalności.
Jeśli konfiguracje, w jakich to Oprogramowanie zostało wdrożone, umożliwiają klientowi
zbieranie informacji umożliwiających identyfikację tożsamości użytkowników końcowych za
pośrednictwem plików cookie i innych rozwiązań technicznych, to klient powinien zwrócić
się we własnym zakresie o poradę prawną dotyczącą obowiązujących go przepisów
dotyczących zbierania takich danych, w szczególności obowiązkach informacyjnych i
konieczności uzyskania zgody użytkowników.
Więcej informacji o stosowaniu różnych rozwiązań technicznych, w tym informacji cookie,
do wspomnianych wyżej celów zawiera Strategia IBM w zakresie ochrony prywatności
dostępna pod adresem http://www.ibm.com/privacy oraz Oświadczenie IBM o Ochronie
Prywatności w Internecie dostępne pod adresem http://www.ibm.com/privacy/details, a w
szczególności jego sekcja zatytułowana „Informacje cookie, sygnalizatory WWW i inne
technologie”, jak również Oświadczenie IBM o ochronie prywatności w oprogramowaniu, w
tym w oprogramowaniu udostępnianym w postaci usług pod adresem http://www.ibm.com/
software/info/product-privacy.
Znaki towarowe
IBM, logo IBM oraz ibm.com są znakami towarowymi lub zastrzeżonymi znakami
towarowymi International Business Machines Corp. zarejestrowanymi w wielu systemach
prawnych na całym świecie. Nazwy innych produktów i usług mogą być znakami
towarowymi IBM lub innych podmiotów. Aktualna lista znaków towarowych IBM dostępna
jest w serwisie WWW IBM, w sekcji “Copyright and trademark information” (Informacje o
prawach autorskich i znakach towarowych), pod adresem www.ibm.com/legal/
copytrade.shtml.
Java oraz wszystkie znaki towarowe i logo dotyczące języka Java są znakami towarowymi lub
zastrzeżonymi znakami towarowymi Oracle i/lub przedsiębiorstw afiliowanych Oracle.
Linux jest zastrzeżonym znakiem towarowym Linusa Torvaldsa w Stanach Zjednoczonych
i/lub w innych krajach.
Microsoft, Windows i logo Windows są znakami towarowymi Microsoft Corporation w
Stanach Zjednoczonych i/lub w innych krajach.
Informacje
31
UNIX jest zastrzeżonym znakiem towarowym The Open Group w Stanach Zjednoczonych i
w innych krajach.
32
Konfigurowanie programu Maximo Anywhere
Drukowane w USA