Verwendung von „ monday.com “ mit „ IBM App Connect Enterprise “

monday.com ist ein Arbeitsbetriebssystem (Work OS), mit dem Teams Projekte und Workflows effektiv verwalten können. Es unterstützt Benutzer bei der Definition von Workflows, der Anpassung an sich ändernde Anforderungen, der Schaffung von Transparenz, der Zusammenarbeit und der Automatisierung von Aufgaben.

Die folgenden Schritte zeigen, wie Sie mithilfe der Connectorerkennung eine Verbindung zu einem monday.com -Account herstellen und einen monday.com Request -Knoten konfigurieren. Sie können eine ähnliche Prozedur ausführen, um einen monday.com Input -Knoten zur Überwachung von monday.com auf neue oder aktualisierte Objekte zu konfigurieren, indem Sie einen Flow erstellen, der einen monday.com Input -Knoten enthält, und ihn über die Connectorerkennung konfigurieren.

1. Erstellen Sie im „ IBM App Connect Enterprise “-Toolkit einen Ablauf, der einen Knoten vom Typ „ monday.com -Anfrage“ enthält.
2. Wählen Sie den Knoten monday.com Anforderung im Flow aus, um die Knoteneigenschaften im Editor anzuzeigen.
3. Klicken Sie auf der Registerkarte Basis auf Connector-Erkennung starten.
   Es erscheint eine Anzeige, in der Sie den Namen des Richtlinienprojekts und die Vaultdetails angeben können, die während der Connectorerkennung verwendet werden.
4. Geben Sie die Details des Richtlinienprojekts und der Vault an, die während der Connectorerkennung verwendet werden sollen:
   1. Geben Sie im Feld Richtlinienprojekt das Richtlinienprojekt an, in dem die Richtlinien gespeichert werden, die während der Connectorerkennung erstellt werden.
      Alternativ können Sie ein neues Richtlinienprojekt erstellen, indem Sie auf Neu klicken und dann den Namen des neuen Richtlinienprojekts angeben. Klicken Sie anschließend auf Fertigstellen.
   2. Geben Sie die Vault an, die während der Connectorerkennung verwendet wird. Berechtigungsnachweise, die während der Connector-Erkennung verwendet werden, werden standardmäßig in einer externen Verzeichnisvaultgespeichert. Dies ist eine App Connect Enterprise -Vault, die von jedem Integrationsserver verwendet werden kann. Alternativ können Sie die Berechtigungsnachweise in einer Integrationsserver-Vault speichern, die im Arbeitsverzeichnis des Integrationsservers erstellt und nur von diesem Integrationsserver verwendet werden kann.
      Um die Vault anzugeben, die zum Speichern der Berechtigungsnachweise verwendet werden soll, führen Sie die Schritte im Abschnitt Connectorerkennungsassistenten verwenden in einem der folgenden Abschnitte aus:

      • Konfigurieren eines externen Verzeichnistresors
      • Vault für Integrationsserver konfigurieren
   3. Geben Sie im Feld Vaultschlüssel den Vaultschlüssel ein, der für den Zugriff auf die in der Vault gespeicherten Berechtigungsnachweise verwendet wird. Der Vaultschlüssel muss mindestens 8 Zeichen lang sein.
   4. Optional: Standardmäßig werden die angegebene Vaultposition und der angegebene Vaultschlüssel als Vorgaben im Toolkit gespeichert, sodass die Werte beim Starten der Connectorerkennung voreingestellt sind. Wenn Sie die Vorgaben nicht sichern wollen, wählen Sie In Vaultvorgaben speichernab.
5. Klicken Sie auf Erkennung starten , um den Connectorerkennungsassistenten für den Connector monday.com zu starten.
   Das Fenster Connectorerkennung wird angezeigt. Wenn vorhandene monday.com -Verbindungen (Konten) verfügbar sind, wird eine Liste dieser Verbindungen angezeigt. Wenn keine Verbindungen vorhanden sind, wird der Status des Connectors monday.com als Not connectedangezeigt.
   • Wenn monday.com Verbindungen (Konten) verfügbar sind, führen Sie die folgenden Schritte aus:
     1. Wählen Sie die Verbindung (das Konto) aus, die Sie verwenden möchten, indem Sie darauf klicken.
     2. Klicken Sie auf den erforderlichen Objekttyp und wählen Sie dann die Aktion aus, die Sie für das Objekt ausführen möchten. Um beispielsweise Boards aus monday.comabzurufen, klicken Sie auf Boards und anschließend auf Boards abrufen.
   • Wenn keine Verbindungen (Konten) vorhanden sind, führen Sie die folgenden Schritte aus:
     1. Klicken Sie auf den erforderlichen Objekttyp und wählen Sie dann die Aktion aus, die Sie für dieses Objekt ausführen wollen. Um beispielsweise Boards aus monday.comabzurufen, klicken Sie auf Boards und anschließend auf Boards abrufen.
     2. Klicken Sie auf Verbinden.
        Es wird ein Fenster angezeigt, in das Sie die Verbindungsdetails für Ihr Konto monday.com eingeben können. Geben Sie die folgenden Informationen ein:

        • API-Token: Das API-Token für die monday.com -Instanz.
        • Proxy-Name : Wählen Sie den Namen des Proxys aus oder geben Sie ihn ein, den „ App Connect “ für die Weiterleitung der Connector-Aufrufe verwenden soll. Dieses Feld ist nur erforderlich, wenn Anrufe über einen Proxy geleitet werden müssen. Bei der Verwendung des „ IBM App Connect Enterprise “-Toolkits sollte der Proxy-Name in folgender Form angegeben werden: {PolicyProjectName}:HTTPProxyPolicyName

        Weitere Informationen zum Ermitteln dieser Verbindungsdaten finden Sie im Abschnitt „Verwendung von IBM App Connect mit monday.com “ in der Dokumentation zu Continuous Delivery (CD) unter IBM App Connect in containers.

     3. Klicken Sie auf Verbinden.
6. Legen Sie die erforderlichen Connectoreigenschaften im Assistenten fest.
   Sie können Bedingungen für den Datenabruf hinzufügen, indem Sie auf Bedingung hinzufügen klicken und anschließend die Eigenschaft auswählen, nach der gefiltert werden soll. Sie können beispielsweise Boards mit einer angegebenen ID abrufen. Sie können auch Eigenschaften festlegen, die die maximale Anzahl der abzurufenden Datensätze und die Aktion angeben, die ausgeführt werden soll, wenn dieser Grenzwert überschritten wird.
7. Wenn Sie die Eigenschaften im Connectorerkennungsassistenten angegeben haben, klicken Sie auf Speichern.
   Die Anmeldedaten für die Verbindung zu monday.com werden im Tresor gespeichert, während die übrigen Verbindungsdetails in der Richtlinie „ monday.com “ hinterlegt sind. Die Werte der Eigenschaften, die Sie im Assistenten festgelegt haben, werden an den Knoten „ monday.com -Anfrage“ im „ IBM App Connect Enterprise -Toolkit“ zurückgegeben.
8. Wenn Sie die Erkennung abgeschlossen und die Eigenschaftswerte gespeichert haben, verlassen Sie den Connectorerkennungsassistenten, indem Sie auf das X in der rechten oberen Ecke des Fensters klicken oder die Tastenkombination Alt+F4drücken.
9. Zurück zur Bearbeitung des Knotens „ monday.com -Anfrage“ im „ IBM App Connect Enterprise “-Toolkit.
   Die Connectoreigenschaften, die im Assistenten für die Connectorerkennung (in Schritt 6) festgelegt wurden, sind jetzt im monday.com Request im Eigenschafteneditor sichtbar. Auf der Registerkarte Basis werden die Werte der Eigenschaften Aktion und Objekt angezeigt, die Sie im Assistenten festgelegt haben. Wenn Sie beispielsweise im Assistenten „Boards“ > „Boards abrufen“ ausgewählt haben, werden auf der Registerkarte „Grundlegend“ des Knotens die folgenden Eigenschaften angezeigt:

   • Aktion - RETRIEVEALL
   • Objekt - Board

   Die Werte der Eigenschaften Aktion und Objekt werden schreibgeschützt angezeigt. Wenn Sie diese Werte ändern möchten, können Sie dies tun, indem Sie erneut auf Connectorerkennung starten klicken und im Assistenten für die Connectorerkennung neue Werte festlegen.

   Die Eigenschaft Schemabasisname gibt den Basisnamen der Schemadateien an, die das Format der Anforderungs-und Antwortnachrichten beschreiben, die vom monday.com -Connector gesendet und empfangen werden. Der Schemabasisname wird automatisch bei der ersten Ausführung der Erkennung für den Knoten festgelegt und basiert auf dem aktuellen Flow-Namen und dem Knotennamen. Wenn Sie diese Eigenschaft manuell festlegen, bevor Sie die Erkennung zum ersten Mal ausführen, wird der von Ihnen festgelegte Wert verwendet. Wenn Sie die Schemas nach der Erkennung umbenennen, müssen Sie diese Eigenschaft so bearbeiten, dass sie dem Schemabasisnamen entspricht, der von den umbenannten Schemas im Projekt verwendet wird. Wenn Sie diese Eigenschaft nach der Erkennung ändern, müssen Sie entweder die Schemanamen umbenennen, damit sie übereinstimmen, oder die Erkennung erneut ausführen.

   Abhängig von der Aktion, die während der Erkennung ausgewählt wurde, generiert der Assistent für Connectorerkennung entweder ein Anforderungsschema und ein Antwortschema oder nur ein Antwortschema. Ein Anforderungsschema wird nur generiert, wenn die ausgewählte Aktion und das ausgewählte Objekt eine Anforderungsnachricht erfordern. Das generierte Anforderungsschema wird für die Validierung der Anforderungsnachricht verwendet. Wenn die Aktion RETRIEVE oder DELETEwar, wird nur das Antwortschema vom Connector zurückgegeben.

   Die generierten Schemadateien werden dem Projekt hinzugefügt und können vom Knoten Zuordnung für die Umsetzung von Eingabe-und Ausgabedaten verwendet werden. Der vollständige Dateiname des Schemas wird aus dem Schemabasisnamen (z. B. gen/MyMessageFlow.monday.com_Request) mit dem Suffix response.schema.json oder request.schema.jsonabgeleitet. Sie können das Schema öffnen, indem Sie auf Anforderungsschema öffnen oder auf Antwortschema öffnenklicken.

10. Überprüfen Sie, ob die Eigenschafteneinstellungen auf dem monday.com Request -Knoten korrekt sind, und speichern Sie dann den Nachrichtenfluss.
11. Auf der Registerkarte Verbindung des monday.com Anforderung zeigt die Eigenschaft Richtlinie den Namen der Richtlinie an, die die Details der Sicherheitsidentität enthält, die für die Verbindung verwendet werden soll. Die Richtlinie hat den Typ monday.com.
    Weitere Informationen finden Sie unter Monday.com policy.
12. Optional: Setzen Sie die Eigenschaft Zeitlimit auf der Registerkarte Verbindung , um die Zeit (in Sekunden) anzugeben, die der Knoten darauf wartet, dass monday.com die Operation verarbeitet.
13. Die Registerkarte Filter des monday.com Anforderungsknotens enthält Eigenschaften, die steuern, wie der Nachrichtenfluss Daten auswählt. Die Anfangswerte dieser Eigenschaften werden aus den Eigenschaftswerten übernommen, die für den Connector monday.com im Connectorerkennungsassistenten festgelegt wurden, einschließlich der Filteroptionseigenschaften und aller Bedingungen, die angegeben wurden (wie in Schritt 6beschrieben). Wenn Sie dann zum Assistenten für die Connectorerkennung zurückkehren und die Werte von Eigenschaften ändern (z. B. durch Hinzufügen neuer Bedingungen), werden diese Aktualisierungen in den auf dem Knoten festgelegten Eigenschaften widergespiegelt.

    Die Eigenschaften für Filteroptionen steuern, welche Objekte bearbeitet werden sollen, wenn der monday.com Request -Knoten ausgeführt wird. Die Eigenschaften für Filtergrenzwert steuern die maximale Anzahl der abzurufenden Elemente und die Aktion, die ausgeführt werden soll, wenn der Grenzwert überschritten wird.

    Sie können die Werte ändern, indem Sie neben dem Wert, den Sie ändern möchten, im Abschnitt Filteroptionen auf Bearbeiten klicken und die Eigenschaftswerte ändern, die im Abschnitt Filterbegrenzung festgelegt wurden.

    Die Eigenschaftswerte können Textwerte oder ESQL-oder XPATH-Ausdrücke sein, die aus dem Inhalt der Nachricht aufgelöst werden, die während der Ausführung an den monday.com Request -Knoten übergeben wird.

14. Legen Sie auf der Registerkarte Anforderung die Eigenschaft Datenposition fest, um die Position in der Baumstruktur für eingehende Nachrichten anzugeben, die die Objektdaten enthält, die in monday.comerstellt werden sollen. Diese Daten bilden die Anforderung, die vom monday.com Request -Knoten an das monday.com -System gesendet wird.
15. Legen Sie auf der Registerkarte Ergebnis die Eigenschaft Position der Ausgabedaten fest, um die Position in der Baumstruktur der Ausgabenachricht anzugeben, die die Daten des in monday.comerstellten Datensatzes enthalten soll.
16. Standardmäßig werden Anforderungsnachrichten anhand des Anforderungsschemas validiert, das während der Connectorerkennung generiert wurde. Sie können die Anforderungsprüfung inaktivieren oder die Validierungseinstellungen ändern, indem Sie die Validierungseigenschaften des monday.com Anforderung verwenden.
17. Speichern Sie den Nachrichtenfluss.