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