Course14:IT Connect - 03 The myApps client at a first glance: Difference between revisions
Jump to navigation
Jump to search
Since we are going to walk through the client now, you may want to open a new browser-window and run myApps in it while you continue to view this book in parallel.
![2fact](https://class.innovaphone.com/moodle2/file.php/1642/Course_Data%2FThe_myApps_Client%2F2fact.png)
Oops, so what is that?
You now need to open your E-Mail (the special training E-Mail which you have specified during the Install).
You did not receive the E-Mail? Either run the Install again (and this time only continue if you really received the test E-Mail
) or have your trainer disable two-factor authentication on your PBX (which might be the faster, while not the better solution
).
![home](https://class.innovaphone.com/moodle2/file.php/1642/Course_Data%2FThe_myApps_Client%2Fhome.png)
Now that you're logged-in, you see what is called the home screen. Let's see what it has.
![presence](https://class.innovaphone.com/moodle2/file.php/1642/Course_Data%2FThe_myApps_Client%2Fpresence.png)
The left and middle part of the header bar allows you to manage you presence state. Your presence is made up of two parts.
Click on the grid icon to display the
list of all apps available to you. You will notice that some of them
have a coloured home symbol and some don't . Those with the coloured symbol will be shown on your home screen.
In order to cleanup your home screen,
click on all the coloured home symbols except for Devices and Users.
To give it a try, drag the Devices App to the right. As soon as it covers another item, this item will jump out of the way and you can
drop the dragged App to the now free space.
Go ahead and add yourself to your myApp's home screen! Then switch back to the home screen. It should
include an App which represents yourself now. If you click on this contact-as-an-App, the Users App will open again and show the user details.
You can drag an app into the app focus (you can of course also drag the focus app out of the focus again).
Give it a try right now!
Upload your own avatar (i.e. photo) to your user record in the PBX.
You can try that right now. Download myApps (Windows) from the
Recommended Tools for this Course page, install it and configure it so it would dock to the right. Here is how:
(Created page with "{{#moodlebook: Master Templates / V14 Templates / Connect| The myApps client at a first glance | 141 }}") |
m (Protected "Course14:IT Connect - 03 The myApps client at a first glance" ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))) |
(No difference)
|
Latest revision as of 13:56, 16 May 2024
A short walk through the myApps client, which is your interface to the complete PBX system.
Log-in to myApps
So now let us log-in to myApps and briefly look at some of the Apps available there.
Starting
To start the client once the Install was run, you can simply type in your PBX's IP address into the address bar of your favorite browser, like in
http://invalid member reference '.network' in 'network'.2
or you can of course use the FQDN you specified in the Install before, as in
http://hq-invalid member reference '.globaldomain' in 'globaldomain'
So this is a browser-based client and you can open it from any web browser.
You will then be asked for a Username and a Password. Once you have filled in those, you can Sign in.
![](https://class.innovaphone.com/moodle2/filter/wikilink/imm6.png)
This is best done using the link
Start myApps with English UI
which will start it with the English UI so it matches all the screenshots in this book.
You can resize the myApps window to the smallest horizontal size so that you can view this book and myApps side-by-side even on a small screen.
You have specified the user and password to log-in to myApps as Admin account during the Install. So Username should be ckl and you should have noted the Password in your Setup-data.xls.
So go ahead and log in!
Two-factor authentication
![2fact](https://class.innovaphone.com/moodle2/file.php/1642/Course_Data%2FThe_myApps_Client%2F2fact.png)
myApps does not reject your login, but insists on "Additional authentication required".
This is what is known as two-factor authentication (which we have enabled in the Install). To log-in to myApps, you need to convince the PBX that you really are who you say you are. Your username and password is not enough, you need to provide a second proof.
In our case, the PBX has sent an E-Mail to the address which we specified for the user and we need to click on the confirmation link in that E-Mail.
![](https://class.innovaphone.com/moodle2/filter/wikilink/imm6.png)
So open
training-mail.innovaphone.com/owa and log-in using CLASS\invalid member reference '.longuser' in 'longuser' as user and invalid member reference '.pw' in 'pw' as password.
![link_intern.png](https://class.innovaphone.com/moodle2/filter/wikilink/link_intern.png)
You will see an E-Mail similar to this one:
Hello Christoph Künkel!
There was a login attempt using your account.
myApps (Firefox)
Security code: 6426
It was you? Click here to continue with your login:
https://hq.invalid member reference '.domain' in 'domain'/PBX0/session.xml?action=verify&id=27d72c0c1cc65b014d100090334000b3&code=6426&xsl=session.xsl
It wasn't you? Please click here and inform your administrator:
https://hq.invalid member reference '.domain' in 'domain'/PBX0/session.xml?action=reject&id=27d72c0c1cc65b014d100090334000b3&code=6426&xsl=session.xsl
myApps Login (invalid member reference '.domain' in 'domain')
When you
click on the "Click here to continue with your login" link, the PBX will know that you have received the E-Mail and approved the log-in, so it will let you pass.
![](https://class.innovaphone.com/moodle2/filter/wikilink/imm6.png)
Your login was verified.
You can close this page now.
![Further Hints (Further Hints)](https://class.innovaphone.com/moodle2/filter/wikilink/hints.png)
![wink](https://class.innovaphone.com/moodle2/pix/s/wink.gif)
![wink](https://class.innovaphone.com/moodle2/pix/s/wink.gif)
The Home Screen
![home](https://class.innovaphone.com/moodle2/file.php/1642/Course_Data%2FThe_myApps_Client%2Fhome.png)
Your Presence
![presence](https://class.innovaphone.com/moodle2/file.php/1642/Course_Data%2FThe_myApps_Client%2Fpresence.png)
The coloured square on the upper left corner allows you to set your activity (something like Available, Away, Busy or Do not disturb). When you set this, it will be shown to other users, for example when they try to call you.
Right next to the coloured square, you find a text field that allows you to add a some text to your presence.
Settings
The
burger menu on the upper right edge gives you access to
various settings for the myApps client. You can close them again using the burger menu on the upper right edge.
![screenshot.png](https://class.innovaphone.com/moodle2/filter/wikilink/screenshot.png)
![video2.png](https://class.innovaphone.com/moodle2/filter/wikilink/video2.png)
There are various sub-dialogues. For now, we should just have a look at the
Edit Profile dialogue. It has
multiple tabs which can be selected. One of them are your call diversions for example. You can close them by
clicking on the upper left cross.
![screenshot.png](https://class.innovaphone.com/moodle2/filter/wikilink/screenshot.png)
![video2.png](https://class.innovaphone.com/moodle2/filter/wikilink/video2.png)
![video2.png](https://class.innovaphone.com/moodle2/filter/wikilink/video2.png)
For now it is enough to know that this is the way to access your personal settings.
More on call diversion
You have probably noticed the well-known call diversion settings for Always (CFU), Busy (CFB) and No response (CFNR). They are executed if you enable them explicitly, either in your profile or on the phone.
However, the PBX can also enable and disable them automatically based on your presence. This feature is enabled when the Call forward based on Presence switch is
turned on in addition to the CFB or CFNR option.
![screenshot.png](https://class.innovaphone.com/moodle2/filter/wikilink/screenshot.png)
If so, CFB will be executed when your presence is busy or do not disturb and CFNR when your presence is away.
If you
activate the option Call forwarding when offline on myApps, a call forwarding is triggered if no myApps client is active for this user. The destination of the call forwarding depends on your CFNR configuration.
![screenshot.png](https://class.innovaphone.com/moodle2/filter/wikilink/screenshot.png)
Tutorials App
There is a link to our tutorials app built into the burger menu. When you click
the button called Tutorials, you will be redirected to a website that hosts tutorial videos created by innovaphone.
![screenshot.png](https://class.innovaphone.com/moodle2/filter/wikilink/screenshot.png)
Apps
The
main part of the home screen shows all the Apps you have placed on your home screen, so that you have immediate access to them.
![screenshot.png](https://class.innovaphone.com/moodle2/filter/wikilink/screenshot.png)
Well, actually, the Install has kindly put them on your home screen for you ![smile](https://class.innovaphone.com/moodle2/pix/s/smiley.gif)
![smile](https://class.innovaphone.com/moodle2/pix/s/smiley.gif)
While this is nice and useful, the home screen is a little crowded now. So we will have a look at how items are added to and removed from the home screen. This is done using the list of all apps available to you, which is shown when you click on the
grid icon on the lower right edge.
![screenshot.png](https://class.innovaphone.com/moodle2/filter/wikilink/screenshot.png)
![](https://class.innovaphone.com/moodle2/filter/wikilink/imm6.png)
![screenshot.png](https://class.innovaphone.com/moodle2/filter/wikilink/screenshot.png)
![screenshot.png](https://class.innovaphone.com/moodle2/filter/wikilink/screenshot.png)
![](https://class.innovaphone.com/moodle2/filter/wikilink/imm6.png)
![video2.png](https://class.innovaphone.com/moodle2/filter/wikilink/video2.png)
To return back to the home screen, click on the
home symbol on the lower left edge, and eh voilà, your home screen
looks much cleaner now.
![screenshot.png](https://class.innovaphone.com/moodle2/filter/wikilink/screenshot.png)
![screenshot.png](https://class.innovaphone.com/moodle2/filter/wikilink/screenshot.png)
Grouping
For faster access and clearer overview, you can re-arrange and group the items on your home screen.
To re-arrange an item, simply drag and drop it to the desired place using the mouse. To create a new group, drag an item to some free space on the home screen. A new group title will appear. You can rename the group by clicking in to the group header and type in the new name.
![](https://class.innovaphone.com/moodle2/filter/wikilink/imm6.png)
![video2.png](https://class.innovaphone.com/moodle2/filter/wikilink/video2.png)
Then create a new group by dragging the Devices App downwards. You will see a new group title.
Drop the App and edit the new group title.
![video2.png](https://class.innovaphone.com/moodle2/filter/wikilink/video2.png)
You can even collapse and expand groups by
clicking on the little caret symbol on the left side of the group title.
![video2.png](https://class.innovaphone.com/moodle2/filter/wikilink/video2.png)
Starting an App
So what is an App?
An App is a web-based application that runs under control of the myApps client. When you click on an item on your home screen, the App will be started and it will run in the same browser window.
All relevant functionality (such as controlling a phone (CTI), looking up contacts in a directory, visual voice mail etc.) is implemented in a bunch of Apps which can be run from the myApps client. myApps itself only serves as a host for these apps.
Note that myApp's footer changed to
show the new app that is running. You can now switch between the Users App and myApps's home screen by clicking on those symbols.
![video2.png](https://class.innovaphone.com/moodle2/filter/wikilink/video2.png)
Users is an App that allows you to browse all users on the PBX. Currently, it is a bit boring, as there only is one user defined, which is yourself
We will discuss this in much more detail later.
![wink](https://class.innovaphone.com/moodle2/pix/s/wink.gif)
For the moment, you may want to click on the only item shown. This
opens a dialogue which shows some details of the user. For now, just note the following things:
![video2.png](https://class.innovaphone.com/moodle2/filter/wikilink/video2.png)
- the presence note you entered before
is shown
- a
coloured block on the lower left edge of the user's avatar indicates the presence activity you selected before
- a
home symbol is shown that allows you to put the user as an App to myApp's home screen
![](https://class.innovaphone.com/moodle2/filter/wikilink/imm6.png)
![video2.png](https://class.innovaphone.com/moodle2/filter/wikilink/video2.png)
You may think that the new item on the home screen does not fit the group you have created lately.
Pin an app
You can also
pin an app. A pinned app is always running and cannot be closed accidentally. Even if you press X to close the app, it remains in the background. Also, a pinned app is launched automatically when myApps is started.
![video2.png](https://class.innovaphone.com/moodle2/filter/wikilink/video2.png)
App focus
![video2.png](https://class.innovaphone.com/moodle2/filter/wikilink/video2.png)
An app in focus is automatically displayed once the myApps client is loaded. When other apps are closed, myApps returns to the app in focus instead of to the home screen (you can still switch to the home screen by selecting it explicitly using the home symbol on te lower left).
To
deactivate this feature completely, you must click on it and then switch it off in the pop-up window that appears.
![video2.png](https://class.innovaphone.com/moodle2/filter/wikilink/video2.png)
Cleaning up your Home Screen
You already have seen that you can
toggle the show on home screen symbol in the list of all apps available.
![screenshot.png](https://class.innovaphone.com/moodle2/filter/wikilink/screenshot.png)
There is also another method available, which might be more convenient: you can use the so-called long-press on any item on your home screen. This is done by clicking on the item without releasing the mouse button. Just like as if you wanted to drag the item to another place. However, in this case, you do not drag it. After short while, a dialog will pop up and you tick the Remove from home check-mark.
![](https://class.innovaphone.com/moodle2/filter/wikilink/imm6.png)
Yay, Practice!
To get a little familiar with using Apps in myApps, here is a little challenge!
![](https://class.innovaphone.com/moodle2/filter/wikilink/imm6.png)
If you have a nice one at hand, use it. If not, you can use this:
![avatar](https://class.innovaphone.com/moodle2/user/pix.php/0/f1.jpg)
![avatar](https://class.innovaphone.com/moodle2/user/pix.php/0/f1.jpg)
- download your avatar picture to your computer
- open a windows explorer which shows the directory where you have saved the picture
- go to myApp's home screen
- open the Profile App (you see your own profile)
- click on the image with the silhouette
- from the windows explorer, drag the picture in to the profile app
- adjust the frame so that it shows the part of your picture that you want to show as avatar
- save it
Depending on the browser you can also drag and drop the picture directly from a webpage. Just drag the above picture to the profile app.
When you switch back to the home screen, you will see the entry for yourself with a (hopefully)
nice avatar .
![screenshot.png](https://class.innovaphone.com/moodle2/filter/wikilink/screenshot.png)
Platform specific functions
To provide functionality that requires operating system support and is not available within a browser, myApps has a native install program (also know as the launcher). When it is installed, it adds features such as:
- docking. You can dock myApps to the right or left edge of the screen
- local installation. Apps are stored on the local machine when started for the first time, so they can be started even if the machine is off-line
- native video and app sharing instead of WebRTC (so you can share your screen actively)
- hotkeys (e.g. to accept a call)
- audio and video for the Softwarephone
- 3PTY
- URL handler (so you can click on a tel:// link and myApps would open)
- access native contact directories
- user activity (although there is also limited support for this without launcher)
- multi-windowing (Apps can be launched in separate windows)
- recording
- auto-start of Apps upon incoming calls
- auto-update
![](https://class.innovaphone.com/moodle2/filter/wikilink/imm6.png)
![https://class.innovaphone.com/moodle2/mod/resource/icon.gif](https://class.innovaphone.com/moodle2/mod/resource/icon.gif)
- When you start the native myApps it will
ask you for the server to connect to . Please use hq-invalid member reference '.globaldomain' in 'globaldomain' and click Config.
If you had already started the native client before, it will log you in automatically. In this case, go to the settings and
log out
- now you can
sign in using your account name (remember? it is ckl)
- to the PBX, this native myApps is a new client, so it will
do the 2-factor authentication again (see chapter Two-factor authentication above for how to
access the E-Mail )
- go to the settings using
the burger menu on the upper right
- at this point, you may want to
change the language to English (as we did in the myApps web version), so the App matches the screenshots in this book
- Then click on
More under Settings
- select
Dock on the right
To close the native myApps program:
- close myApps using a
right-click on its tray icon
Just as a reminder, when you need to approve your login, you can use your existing session in your browser. Or, you can use the link in the email sent to you. If you use our training email system, here are the credentials again:
- Web client:
https://training-mail.innovaphone.com/owa/
- User: CLASS\invalid member reference '.longuser' in 'longuser'
- Password: invalid member reference '.pw' in 'pw'
Notifications
The myApps client (both running as a web page and in the launcher) can provide you with notifications. For example, if you log in on another device, you can be
be notified
.
![screenshot.png](https://class.innovaphone.com/moodle2/filter/wikilink/screenshot.png)
![Screenshot: be notified - Course_Data/The_myApps_Client/myapps-windows-notification.png](https://class.innovaphone.com/moodle2/file.php/1642/Course_Data%2FThe_myApps_Client%2Fmyapps-windows-notification.png)
This is under control of two separate option flags. To enable all notifications (which we recommend), you need to enable both the
App notifications slider in the standard myApps settings and the platform specific
Show notifications check-mark in the More settings.
![screenshot.png](https://class.innovaphone.com/moodle2/filter/wikilink/screenshot.png)
![screenshot.png](https://class.innovaphone.com/moodle2/filter/wikilink/screenshot.png)
Summary
myApps is the primary user interface to the PBX functions (well, except for your phone perhaps). It is web-based and as such available on any platform that supports web browsing.
Some features however need native operating system support. For these, a platform specific install is provided (currently for Windows, Android, iOS and MacOS).
myApps on its own provides only a very limited function set (such as authentication and the home screen which allows you to launch more apps). All other functionality is provided by further Apps which may be installed from an App Store. The App Store in turn is managed by the PBX administrator (so as to ensure full control over the choice of Apps available).