Zum Inhalt springen

Änderungen von Dokument Kontaktmanagement

Zuletzt geändert von Katharina Prummer am 2025/05/16 10:59
Von Version 79.1
bearbeitet von Katharina Prummer
am 2025/05/13 13:35
Änderungskommentar: Neuen Anhang b4it_Anbindung_MSGraph.pdf hochladen
Auf Version 69.1
bearbeitet von Katharina Prummer
am 2025/02/28 10:47
Änderungskommentar: Es gibt keinen Kommentar für diese Version

Zusammenfassung

Details

Seiteneigenschaften
Inhalt
... ... @@ -419,6 +419,15 @@
419 419  
420 420  
421 421  
422 +
423 +
424 +
425 +
426 +
427 +
428 +
429 +
430 +
422 422  = Einrichtung Ablagepfad/Auscheckpfad Dokumente =
423 423  
424 424  Vorraussetzung: Sie haben die Berechtigung um in die Programmparameter zu kommen.
... ... @@ -442,13 +442,8 @@
442 442  
443 443  = Einrichtung E-Mail Anbindung =
444 444  
445 -(% class="box warningmessage" %)
446 -(((
447 -Ab Version 25.1 verfügbar
448 -)))
454 +[[image:Programmparameter_Email_04-2024.png||alt="ProgrammParameter_Email_Anbindung.png" height="373" width="915"]]
449 449  
450 -[[image:image-20250228114149-5.png]]
451 -
452 452  Indem man den Begriff **Programmparameter **in die [[Schnellsuche>>https://wiki.non-profit-manager.org/bin/view/Allgemeine%20Bedienung/Software%20Module/03%20-%20Das%20Modul%20Kontaktmanagement/#HSchnellsuche]] eingibt, gelangt man zu den **Einstellungen **der **Programmparameter **(Ziffer **1**).
453 453  Hier wählt man bei der Rubrik **Allgemein **den Unterpunkt **Mail **(Ziffer **2**) aus und gelangt so zu den Einstellungen des **E-Mail Modus** (Ziffer **3**).
454 454  Je nach dem, welche der drei Optionen man auswählt, verändern sich die Einstellungen.
... ... @@ -461,7 +461,7 @@
461 461  
462 462  == E-Mail Modus IMAP/SMTP ==
463 463  
464 -[[image:image-20250228123954-7.png]]
468 +[[image:Email_Anbindung_IMAP_SMTP.png||height="506" style="float:left" width="770"]]
465 465  
466 466  (% style="margin-left:auto; width:714px" %)
467 467  |=(% style="width: 74px;" %)(((
... ... @@ -472,40 +472,94 @@
472 472  |(% style="width:74px" %)(((
473 473  **1**
474 474  )))|(% style="width:636px" %)(((
475 -In der Auswahlliste wählt man "**SMTP**" aus.
479 +Hier macht man Angaben zum **IMAP **Server und zum **SMTP **Server. Dabei steht es dem Anwender frei, ob er eine **IP **oder einen **Namen **eingibt. Dahinter bietet sich Platz für den Port.
476 476  )))
477 477  |(% style="width:74px" %)(((
478 478  **2**
479 -)))|(% style="width:636px" %)Hier macht man Angaben zum **IMAP **Server und zum **SMTP **Server. Dabei steht es dem Anwender frei, ob er eine **IP **oder einen **Namen **eingibt.
483 +)))|(% style="width:636px" %)(((
484 +Hier bestimmt man den **E-Mail Timeout**.
485 +**Achtung**: Die Angabe ist in Millisekunden. 1 Sekunde entspricht hier also 1000 Millisekunden.
486 +)))
480 480  |(% style="width:74px" %)(((
481 481  **3**
482 482  )))|(% style="width:636px" %)(((
483 -Indem man ein Häkchen setzt, **aktiviert **man die **SSL**. Dies bedeutet die Einstellung für das Secure Sockets Layer. Eine Verschlüsselung der Daten.
490 +Indem man ein Häkchen setzt, **aktiviert **man die **SSL**. Dies bedeutet, dass...
484 484  )))
492 +|(% style="width:74px" %)(((
493 +**4**
494 +)))|(% style="width:636px" %)(((
495 +Hier bestimmt man das **Verfahren**, wie der **Login **zu erfolgen hat.
496 +)))
497 +|(% style="width:74px" %)(((
498 +**5**
499 +)))|(% style="width:636px" %)(((
500 +Hier werden die **ClientID **und **TenantID** eingeblendet.
501 +)))
502 +|(% style="width:74px" %)(((
503 +**6**
504 +)))|(% style="width:636px" %)(((
505 +Hier werden **Absender **und **Empfänger **festgelegt. Möchte man die Einstellung testen, kann man dies über den **Testmail**-Button tun.
506 +)))
507 +|(% style="width:74px" %)(((
508 +**7**
509 +)))|(% style="width:636px" %)(((
510 +Hier legt man die **Anmeldeoption **fest.
511 +)))
512 +|(% style="width:74px" %)(((
513 +**8 BRAUCHEN WIR NICHT**
514 +)))|(% style="width:636px" %)(((
515 +Hier bestimmt man den **Ablageordner**. Soll das ganze automatisch verlaufen, setzt man ein Häkchen bei **versendete UP-Belege im Ordner ablegen**.
516 +)))
517 +|(% style="width:74px" %)(((
518 +**9 BRAUCHEN WIR NICHT**
519 +)))|(% style="width:636px" %)(((
520 +Hier bestimmt man **Kürzel **für das **Hauptdokument **(Beleg) und für **zusätzliche Anlagen **fest.
521 +)))
485 485  
486 486  
487 487  
525 +== E-Mail Modus Outlook ==
488 488  
527 +Gibt nur eine vorrausestzung, dass Outlook installiert sein muss und eingerichtet sein muss mit mindestens einem Konto.
489 489  
529 +[[image:Email_Anbindung_Outlook.png||height="415" style="float:left" width="842"]]
490 490  
531 +(% style="margin-left:auto; width:642px" %)
532 +|=(% style="width: 71px;" %)(((
533 +Nummer
534 +)))|=(% style="width: 564px;" %)(((
535 +Beschreibung
536 +)))
537 +|(% style="width:71px" %)(((
538 +**1**
539 +)))|(% style="width:564px" %)(((
540 +Hier werden die **ClientID **und **TenantID** eingeblendet.
541 +)))
542 +|(% style="width:71px" %)(((
543 +**2**
544 +)))|(% style="width:564px" %)(((
545 +Hier legt man die **Anmeldeoption **fest.
546 +)))
547 +|(% style="width:71px" %)(((
548 +**3 BRAUCHEN WIR NICHT**
549 +)))|(% style="width:564px" %)(((
550 +Hier bestimmt man den **Ablageordner**. Soll das ganze automatisch verlaufen, setzt man ein Häkchen bei **versendete UP-Belege im Ordner ablegen**.
551 +)))
552 +|(% style="width:71px" %)(((
553 +**4 BRAUCHEN WIR NICHT**
554 +)))|(% style="width:564px" %)(((
555 +Hier bestimmt man **Kürzel **für das **Hauptdokument **(Beleg) und für **zusätzliche Anlagen **fest.
556 +)))
491 491  
492 492  
493 493  
494 -== E-Mail Modus Outlook ==
495 495  
496 -Damit die Funktion genutzt werden kann, muss **Outlook lokal installiert** sein und es muss **mindestens ein E-Mail-Konto** in Outlook eingerichtet sein.
497 497  
498 -[[image:image-20250228113650-4.png]]
499 499  
500 -(% style="margin-left:auto; width:642px" %)
501 -|=(% style="width: 71px;" %)Nummer|=(% style="width: 564px;" %)Beschreibung
502 -|(% style="width:71px" %)1|(% style="width:564px" %)In der Auswahlliste "Outlook" auswählen
503 503  
504 -
505 -
506 506  == E-Mail Modus EWS ==
507 507  
508 -[[image:image-20250228124752-8.png]]
566 +[[image:Email_Anbindung_EWS.png||height="517" width="1067"]]
509 509  
510 510  (% style="width:1066px" %)
511 511  |=(% style="width: 77px;" %)(((
... ... @@ -516,7 +516,7 @@
516 516  |(% style="width:77px" %)(((
517 517  **1**
518 518  )))|(% style="width:985px" %)(((
519 -In der Auswahlliste "EWS" auswählen
577 +Möchte man einen **Testdurchlauf **mit dem **EWS-Zugang** starten, gelingt dies über diese Schaltfläche.
520 520  )))
521 521  |(% style="width:77px" %)(((
522 522  **2**
... ... @@ -528,13 +528,17 @@
528 528  )))|(% style="width:985px" %)(((
529 529  Hier bestimmt man das **Verfahren**, wie der **Login **zu erfolgen hat.
530 530  )))
531 -|(% style="width:77px" %)4|(% style="width:985px" %)Hier kann eine fester E-Mail Adresse und das Passwort zu einem Postfach angeben.
532 532  |(% style="width:77px" %)(((
533 -**5**
590 +**4**
534 534  )))|(% style="width:985px" %)(((
535 535  Hier werden die **ClientID **und **TenantID** eingeblendet.
536 536  )))
537 537  |(% style="width:77px" %)(((
595 +**5**
596 +)))|(% style="width:985px" %)(((
597 +Hier werden **Absender **und **Empfänger **festgelegt. Möchte man die Einstellung testen, kann man dies über den **Testmail**-Button tun.
598 +)))
599 +|(% style="width:77px" %)(((
538 538  **6**
539 539  )))|(% style="width:985px" %)(((
540 540  Hier legt man die **Anmeldeoption **fest.
... ... @@ -542,64 +542,45 @@
542 542  |(% style="width:77px" %)(((
543 543  **7**
544 544  )))|(% style="width:985px" %)(((
545 -Hier kann der Exchange Web Service Zugang getestet werden.
607 +Hier bestimmt man den **Ablageordner**. Soll das ganze automatisch verlaufen, setzt man ein Häkchen bei **versendete UP-Belege im Ordner ablegen**.
546 546  )))
609 +|(% style="width:77px" %)(((
610 +**8**
611 +)))|(% style="width:985px" %)(((
612 +Hier bestimmt man **Kürzel **für das **Hauptdokument **(Beleg) und für **zusätzliche Anlagen **fest.
613 +)))
547 547  
548 -== E-Mail Modus MS Graph ==
549 549  
550 -{{info}}
551 -Die **Nutzung **des E-Mail Modus **MS Graph** **setzt voraus**, dass der **Webservice aktiv **ist.
552 -{{/info}}
553 553  
554 -=== Einrichtung E-Mail-Anbindung mit MS-Graph und Azure in base4IT ===
555 555  
556 556  
557 -Die base4it Software bietet ihren Anwendern die Möglichkeiten
558 -• E-Mails aus für sie freigebenen Postfächern einem Kontakt als „Aktivität“ zuzuweisen
559 -• Eine „Aktivität“ als ausgehende E-Mail anzulegen und zu versenden
560 560  
561 561  
562 -Beide Funktionalitäten benötigen eine Anbindung an das E-Mail-System des Kunden. Bei Kunden mit
563 -lokalem Exchange Server erfolgt dies über EWS, bei Exchange in der Cloud mit EWS oder MS-Graph.
564 -Nach aktuellem Stand ist EWS für Exchange Online per 1.Oktober 2026 abgekündigt, ein Wechsel auf
565 -MS-Graph ist erforderlich.
566 566  
567 567  
568 -**~1. Anwendung registrieren**
569 -In Azure muss eine Anwendung registriert werden, der Name kann frei gewählt werden. Alle Kunden,
570 -die bereits für die base4it-EWS-Anbindung eine Anwendung registriert haben, können diese weiter
571 -verwenden, müssen allerdings die MS-Graph API-Berechtigungen (permissions) ergänzen.
572 572  
573 573  
574 -**2. API-Berechtigungen (permissions)**
575 -base4it benötigt nur „delegierte Berechtigungen“ (delegated permissions), alle Zugriffe erfolgen im
576 -Kontext des angemeldeten Users. Folgende Permissions werden benötigt:
577 577  
578 -[[image:image-20250513133105-1.png]]
579 579  
580 -**3. Authentifizierung**
581 -Bei Zugriff über MS Graph wird von base4it nur OAUTH 2.0 als Authentifizierung unterstützt, daher muss
582 -für die registrierte Anwendung folgender Eintrag im Bereich „Authentifizierung“ → „Mobilgerät und
583 -Desktopanwendung“ vorhanden sein:
584 584  
585 -Bei erstem Zugriff auf das Mailkonto (Abruf der eingegangenen Mails oder Senden einer Aktivität als E-
586 -Mail) erscheint das Microsoft Authentifizierungsfenster zur Anmeldung mit E-Mail-Adresse und
587 -Passwort, danach die konfigurierte 2FA-Authentifizierung. base4it merkt sich nach erfolgreicher
588 -Anmeldung das von Microsoft zurückgegebene Token im Hauptspeicher und verwendet es für die
589 -weiteren Zugriffe bis zum Beenden der Anwendung bzw. dem zeitlichen Ablauf des Tokens, falls
590 -zwischenzeitlich kein Zugriff erfolgt.
591 591  
592 -[[image:image-20250513133410-2.png]]
593 593  
594 594  
595 -**4. Konfiguration base4IT**
631 +(% class="wikigeneratedid" id="HE-MailModusMSGraph" %)
632 +E-Mail Modus MS Graph
596 596  
597 -[[image:image-20250228125914-9.png||height="295" width="974"]]
634 +{{info}}
635 +Die **Nutzung **des E-Mail Modus **MS Graph** **setzt voraus**, dass der **Webservice aktiv **ist.
636 +{{/info}}
598 598  
638 +[[image:Email_MS-Graph.png||height="624" style="float:left" width="1073"]]
639 +
599 599  (% style="margin-left:auto; width:411px" %)
600 600  |=(% style="width: 83px;" %)Nummer|=(% style="width: 324px;" %)Beschreibung
601 -|(% style="width:83px" %)1|(% style="width:324px" %)In der Auswahlliste "MSGraph" auswählen
602 -|(% style="width:83px" %)**2**|(% style="width:324px" %)Hier werden die **ClientID **und **TenantID** einfügen.
642 +|(% style="width:83px" %)**1**|(% style="width:324px" %)Hier werden die **ClientID **und **TenantID** eingeblendet.
643 +|(% style="width:83px" %)**2**|(% style="width:324px" %)Über den Button **Parameterübersicht **gelangt man zu einer tabellarischen Anzeige der Programmparameter. Hier unterteilen die Spalten unter anderem in die Bereiche, Standardwerte und Datentypen. Außerdem kann man hier via Anklicken der jeweiligen Kästchen auswählen, ob der jeweilige Programmparameter mandbezogen oder usergroupbezogen ist.
644 +|(% style="width:83px" %)**3**|(% style="width:324px" %)Mittels Button **Übersetzungen verwalten** kann man sämtliche Begriffe gemäß der Übersetzungen einsehen und verwalten.
645 +|(% style="width:83px" %)**4**|(% style="width:324px" %)Mit dem Button **Zustandsüberwachung konfigurieren **gelangt man zum Fenster der Zustandsüberwachung. Neben dem Benutzernamen und Überwachungsintervall in Stunden, legt man hier auch die Mailversandoptionen fest. Außerdem definiert man hier noch Absender, Empfänger und Betreff der Mail.
603 603  
604 604  
605 605  
... ... @@ -607,4 +607,10 @@
607 607  
608 608  
609 609  
653 +
654 +
655 +
656 +
657 +
658 +
610 610  
b4it_Anbindung_MSGraph.pdf
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.kprummer
Größe
... ... @@ -1,1 +1,0 @@
1 -73.7 KB
Inhalt
image-20250228113446-3.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.kprummer
Größe
... ... @@ -1,1 +1,0 @@
1 -86.5 KB
Inhalt
image-20250228113650-4.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.kprummer
Größe
... ... @@ -1,1 +1,0 @@
1 -88.0 KB
Inhalt
image-20250228123954-7.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.kprummer
Größe
... ... @@ -1,1 +1,0 @@
1 -91.6 KB
Inhalt
image-20250228124752-8.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.kprummer
Größe
... ... @@ -1,1 +1,0 @@
1 -123.1 KB
Inhalt
image-20250228125914-9.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.kprummer
Größe
... ... @@ -1,1 +1,0 @@
1 -53.8 KB
Inhalt
image-20250513133105-1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.kprummer
Größe
... ... @@ -1,1 +1,0 @@
1 -97.0 KB
Inhalt
image-20250513133410-2.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.kprummer
Größe
... ... @@ -1,1 +1,0 @@
1 -56.5 KB
Inhalt