Verbindungen Docs (vormals IBM Docs) ist bald zu veröffentlichen seine nächsten großen Update, Verbindungen Docs 2.0. Und mit ihm, fügt das IBM-Team eine neue, signifikante Fähigkeit: Integration mit Dritt Dokumenten-Repositories. Für unabhängige Softwareanbieter, die bereits zu speichern sind, zu organisieren, oder Dokumente zu teilen, können Sie nun leicht dokumentenzentrierte Zusammenarbeit mit Ihrem bestehenden Angebot hinzuzufügen. Lasst uns anfangen.

Überblick

Die allgemeine Idee ist recht einfach. Verbindungen Docs kümmert sich um all die Echtzeit-Co-Bearbeitung, Kommentierung, Tracking-Änderungen, Konvertierung von Dateiformaten, etc. Sie müssen nur das Dokument zu Verbindungen Docs über eine programmatische Schnittstelle zu liefern. Ihre Schnittstelle wird für beide das Abrufen und Speichern des Dokuments sowie der Rückkehr einige Informationen über das Dokument verantwortlich. Verbindungen Docs 2.0 unterstützt zwei Formate: und REST. Ich werde auf den letzteren konzentrieren, weil mit REST können Sie in Java-Code, node.js - wirklich alles - und die Kommunikation mit beliebigen Dokumenten-Repository.

Installation

Verbindungen Docs 2.0 installiert in einem WebSphere Application Server-Cluster. Der Prozess zu tun, eine Installation von WebSphere wird hier nicht behandelt. Aber ich habe auf die wichtigsten Schritte, um ein paar externe Beiträge verknüpft.

. . (Dieser Link zeigt ein eigenes Profil. Sie können nur wählen Sie Zelle auf dem Bildschirm Umgebungsauswahl.). (Dieser Link ist wirklich gut, aber es ist spezifisch für Portal. Sie brauchen nicht die Rewrite-Regeln zu fügen, und es wird keine wp_profile sein.)

Mit den oben genannten Voraussetzungen können Sie Verbindungen Docs installieren. Alle Schritte sind wie Screenshots in der Datei. Ein paar Punkte, wie Sie die folgenden Schritte durchlaufen:

• Pakete installieren Stellen Sie sicher, die "andere Content-Management-Systeme" Paket verwendet wird. Dies ist die Option für Dritte ISVs. Ich habe nicht die Erweiterungspakete ausgewählt. Diese werden nur mit IBM Connections verwendet. Vermutlich werden Sie nicht Connections Docs neben IBM Connections werden installieren.
• Node Identification verwendete ich die Standardeinstellungen für Cluster und Knotennamen. Der Webserver Sie zuvor installiert aufgeführt sein. Wenn Sie wollen, diesen Schritt nicht tun, könnten Sie wahrscheinlich eine falsche URL in der "Enter URL" Textfeld und den späteren Zugriff Docs mit den internen Ports eingeben.
• Integration mit anderen Content Management Systemen Dies ist der wichtige Bildschirm. Ich habe meine eigene Implementierung während meiner Installation. Aber da wir eine Probe von IBM später in diesem Beitrag nicht sicher gestellt werden, werden wir die folgenden Werte in diesem Bildschirm eingeben. Repository-Typ: REST-URL für die Datei-Metadaten: Serverinformationen> / docs-Probe / files / {ID} / meta URL zum Ermitteln / Setzen Dateiinhalt: Serverinformationen> / docs-Probe / files / {ID} / content Anruf-Authentifizierung Methode: s2s_token Server-zu-Server-Token-Schlüssel: Token-Server-zu-Server-Token-Wert: 123456789 Act als Benutzer: als Benutzer Benutzer Endpunkt Profile: <Lassen Sie dieses Feld leer> Repository zu Hause: Serverinformationen> / docs-Probe / Dateien
• Die clientseitige Einhängepunkte Ich wählte lokale Verzeichnisse zu verwenden, anstatt NFS-Shares. Erstellen Sie diese Verzeichnisse manuell vor der Installation.
• Editor Server Cluster vollständig qualifizierten Hostnamen und die Adresse der Verbindungen Dateiserver: <add eine gefälschte URL; dies ist ein Bug> vollständig qualifizierte Hostname und Anschrift des E-Mail-Benachrichtigungsdienst: <eine gefälschte URL hinzufügen; dies ist ein Bug>
• Restart Webserver Ja

Jetzt eine Tasse Kaffee greifen, weil die auf meiner VM dauert etwa eine Stunde installieren.

siehe Für diejenigen, die Beta-Code, den manuellen Schritt im Abschnitt zur Fehlerbehebung am Ende dieses Beitrags.

Um die Installation zu bestätigen, rufen Sie die URL-Server-Informationen> / docs / api / Liste? Method = Dateityp. Sie sollten eine JSON-Antwort mit den folgenden Daten erhalten.

{".ods":"20480",".xls":"20480",".odt":"20480",".pptx":"51200",".txt":"20480",".ppt":"51200",".xlsx":"20480",".csv":"5120",".doc":"20480",".odp":"51200",".docx":"20480"}

Sicherheit

Docs stützt sich auf die Java-Sicherheitschef des Benutzers. Es gibt ein paar Möglichkeiten, die Sicherheit zu nähern: LDAP, SAML, OAuth, usw. Wenn Sie den WebSphere-Server installiert ist, die Sicherheit aktiviert werden sollte. Sie können sich in WebSphere Konsole melden sich die Benutzer in die Datei basiertes Repository hinzuzufügen. Access Manager url>: <port> / ibm / console. Gehen Sie dann auf Benutzer und Gruppen -> Benutzer verwalten. Dann die erstellen verwenden, um einen neuen Benutzer hinzuzufügen.

Integration über REST

Über die Einstellungen von oben als Beispiel, die out-of-the-box funktioniert Dokumentwiedergewinnungs- Prozess wie diesem.

Der Benutzer beginnt in der 3rd-Party-Anwendung und wählt ein Dokument zu bearbeiten. Die 3rd-Party-Anwendung durchführen würde alle Vorgänge so zu tun. Zum Beispiel müssen das Dokument möglicherweise durchgeführt in der 3rd-Party-Repository oder Authentifizierung gesperrt werden. Schließlich wird die dritte Partei Anwendung sollte den Benutzer auf die Docs-Anwendung umleiten. Wenn der Benutzer in WebSphere nicht authentifiziert ist, wird eine Umleitung auf die Login-Seite auftreten. Beachten Sie, dass dies nicht auftreten kann oder erforderlich sein, je nach Konfiguration Ihres speziellen Server. Verbindungen Docs werden Metadaten über die von der file_id URL-Parameter beschrieben Dokument anfordern. Die 3rd-Party-Anwendung muss mit spezifischen JSON-Daten beschreiben das Dokument und Berechtigungen reagieren, die auf dem Dokument ausgeführt werden können. Besonderer Hinweis: schließen Sie die Erweiterung in der Eigenschaft "Name". Wenn Sie dies nicht tun, wird der MIME-Typ nicht erkannt werden und ein Fehler auftritt. Alternativ können Sie auch eine "mime" JSON-Eigenschaft mit der Erweiterung als Wert hinzufügen. Verbindungen Docswird dann das eigentliche Dokument anfordern. Die 3rd-Party-Anwendung sendet über das Dokument. Der Benutzer wird auf die Docs-Anwendung umgeleitet, wo das Dokument fertig geöffnet bearbeitet werden.

Es gibt optionale, zusätzliche Schritte, wenn Sie integrierte Profile haben. Dies wird hier nicht behandelt [yet], aber der Prozess ist im Wesentlichen gleich. einen Endpunkt der 3rd-Party-Repository Da kann Docs externen Benutzerinformationen im JSON-Format abfragen.

{

Endpoint-Security 2013     Endpoint-Security-10 Download