Loftware Cloud Workday-Integrations-API

Loftware Cloud API für Workday

image6.png

Loftware Cloud bietet Unterstützung für den Etikettendruck in Workday, dem Cloud-System für Finanzen, Personalverwaltung und Planung. Sie können Etiketten direkt von Workday aus auf Ihren mit der Cloud verbundenen Druckern ausdrucken , ohne eine Loftware Stellfläche vor Ort zu benötigen oder einen Druckertreiber installieren zu müssen.

Unsere Loftware Cloud API für Workday:

  • Akzeptiert XML-Nutzdaten von Workday.

  • Erzeugt Druckaufträge (z. B. mit ZPL für Zebra-Drucker).

  • Sendet Druckaufträge an Ihre mit der Cloud verbundenen Drucker.

Workday unterstützt den Export von XML-Daten aus verschiedenen Geschäftsprozessen, so dass Sie nichts Neues entwickeln müssen.

Sie müssen Ihre ausgehende Verbindung von Workday auf Ihrer neuen Loftware Cloud-API konfigurieren und XML-Nutzdaten an die API senden.

Die API erkennt den XML-Typ und führt integrierte Arbeitsabläufe aus, um Daten zu extrahieren und zugehörige Etiketten auf Ihren Druckern zu drucken.

Workday_API_diagram.png

Workday-API-Integrationen funktionieren wie andere Loftware Cloud APIs.

Hinweis

Nutzen Sie die Workday-Integrations-APIs, um Etiketten zu drucken, die Sie mit Ihrer mobilen Workday-App scannen und verfolgen können. Auf einem mobilen Handgerät mit der Workday-Mobil-App können Sie beispielsweise Ihr App-Inventar öffnen und Ihr Etikett scannen, um Informationen über Ihre gescannten Artikel zu erhalten.

Drucken aus Workday

Sie können Etiketten aus Workday auf Cloud-Druckern drucken, die in Loftware Cloud registriert sind. Sie können XML-Daten-Tags von Workday als variable Datenquellen in Ihren Etikettenvorlagen und Formularen verwenden, indem Sie die Variablennamen mit den XML-Tags abgleichen. Loftware Cloud APIs verarbeiten Workday-XML-Daten und drucken jeden Datensatz.

Workday-API-Integrationen unterstützen 6 Arten von XML von Workday:

  • Gruppe Warenlieferung

  • Warenlieferschein

  • Standorte des Inventars

  • Standorte

  • Nach Standorten

  • Eingänge

Um von Workday aus zu drucken, konfigurieren Sie Ihre Verbindungseinstellungen.

Konfiguration Ihrer Loftware Cloud Workday-API

  1. In Control Center fügen Sie Loftware Cloud API-Abonnements für Ihre Workday-APIs über das Entwicklerportal sowie andere Loftware Cloud APIs hinzu. Weitere Informationen finden Sie unter Cloud Print API.

  2. Fügen Sie Ihre Cloud-Drucker in Loftware Cloud hinzu. Weitere Informationen finden Sie unter Cloud-Drucker.

  3. Konfigurieren Sie Ihren HTTP-Transport in Workday so, dass Ihre URL mit Ihrem Loftware Cloud Abonnementschlüssel in der Abfragefolge verwendet wird:

    https://labelcloudapi.onnicelabel.com/workdayintegration/v1/PrintFromXml?subscription-key={Ihr Abonnementschlüssel}
  4. Erstellen Sie Ihre Etikettenvorlagen. Ordnen Sie Ihre Variablennamen Ihren Workday-XML-Daten zu.

  5. Fügen Sie Etikettenvorlagen, die Sie aus Workday drucken möchten, zu Ihren Loftware Cloud Dokumenten hinzu.

  6. Drucken Sie Ihre Etiketten direkt von Workday aus. Weitere Informationen finden Sie in Ihrer Workday-Dokumentation.

Testen von Loftware Cloud Workday-APIs im Loftware Entwicklerportal (POST)

  1. Melden Sie sich beim Loftware Cloud API Entwicklerportal an.

  2. Gehen Sie zu APIs > Workday Integration API und klicken Sie auf v1. Die Seite Workday Integration API wird geöffnet.

  3. Gehen Sie zu PrintFromXml (POST) und klicken Sie auf Ausprobieren.

  4. Fügen Sie Ihre Abfrageparameter hinzu.

  5. Wählen Sie Ihren korrekten Abonnementschlüssel (aus Ihrem Profil im Entwicklerportal). Sie können Ihren Primär- oder Sekundärschlüssel verwenden:

    POST https://labelcloudapi.onnicelabel.com/workdayintegration/v1/PrintFromXml HTTP/1.1
    Host: labelcloudapidev.onnicelabel.com
    Ocp-Apim-Subscription-Key: ••••••••••••••••••••••••••••••••
    Anforderung

    Hinweis

    Die Workday-Integrations-APIs verwenden keine Header. Ihr Abonnementschlüssel wird anstelle des HTTP-Headers zu Ihrer URL in einem Query-String hinzugefügt.

  6. Fügen Sie unter Anfragetext Ihren Workday-Anfragetext im XML-Format hinzu.

    workday.png

    1. Fügen Sie Ihren Drucker hinzu:

      <wd:Label_Printer>YourCloudPrinterName</wd:Label_Printer>
    2. Fügen Sie den Pfad Ihrer Etikettenvorlage hinzu:

      <wd:Label_Template>/Labels/YourLabelName.nlbl</wd:Label_Printer>
    3. Optional: Wenn Ihre Etikettenvorlagen Variablen enthalten, fügen Sie diese hier hinzu. Ihre Variablen müssen mit den Namen Ihrer Workday-XML-Daten-Tags übereinstimmen, damit sie mit Ihren Etiketten funktionieren. (Für einfache Etikettenvorlagen oder Testdrucke können Sie diesen Abschnitt löschen).

      Fügen Sie zum Beispiel für Ihr Erstellungsdatum hinzu:

      <wd:Created_Date>2020-01-12-17:00</wd:Created_Date>

      Ihre Variable Created_Date zeigt Ihr Datum anhand von Workday-Daten an.

  7. Klicken Sie auf Send.

Ihre Workday-API übernimmt Ihre XML-Datensätze und verarbeitet Ihre Daten. Sie haben Ihr Etikett erfolgreich auf Ihrem mit der Cloud verbundenen Drucker gedruckt.

Verwendung der Cloud-Trigger-API mit Workday

Verwenden Sie Cloud-Trigger-APIs mit Workday, um benutzerdefinierte Konfigurationslogik zu erstellen und von Automation Dienst ohne Cloud-Drucker zu drucken. Automation muss auf einem Computer mit Zugriff auf Ihre Drucker installiert werden.

Weitere Informationen finden Sie unter Cloud-Trigger ausführen .

Für die Integration mit Workday über Cloud Trigger verwenden Sie die Cloud Trigger API (Neu) API auf unserem Entwicklerportal. Sie müssen die XML-Datenverarbeitung von Workday in Ihrer Automation Konfiguration anwenden und Ihren Abonnementschlüssel in Ihrer Anfrage-URL statt in Ihrer Kopfzeile hinzufügen:

https://labelcloudapi.onnicelabel.com/Trigger/v1/CloudTrigger/{triggerId}? Abonnementschlüssel ={Ihr Abonnementschlüssel}

Tabelle 3.  Cloud-Trigger-API mit Workday vs. Workday-Integrations-API

API:

Cloud Trigger API

Cloud Trigger API (Neu)

Workday-Integrations-API

Unterstützte Drucker:

Alle Druckertypen.

Nur Cloud Drucker.

Infrastruktur vor Ort

Ja, erfordert einen Computer mit Automatisierungsdienst und Zugang zu Druckern.

Nein, Cloud-Drucker verbinden sich direkt mit LabelCloud.

Workday Studio erforderlich

Ja (erfordert http-Header)

Nein

Nein

Workday XML-Verarbeitungslogik

Manuell in Ihrer Automation Konfiguration mit Aktionen und Filtern konfiguriert.

Vordefiniert

Endpunkt

https://labelcloudapi.onnicelabel.com/TriggerApi/CloudTrigger/Workday

Erfordert http-Header: api-version:v1

https://labelcloudapi.onnicelabel.com/Trigger/v1/CloudTrigger/Workday?subscription-key={Ihr Abonnementschlüssel}

https://labelcloudapi.onnicelabel.com/workdayintegration/v1/PrintFromXml?subscription-key={Ihr Abonnementschlüssel}

Drucker- und Etikettenauswahl

In Automation mit Aktionen konfiguriert.

Wird von Workday in XML-Nutzdaten bereitgestellt.


Unterstützte XML-Elemente

Loftware Cloud Workday-APIs unterstützen die folgenden XML-Elemente:

GoodsDeliveryGroup:

  • Goods_Delivery_Group_Data

    • Group_Number

    • Beschreibung

    • Assigned_To

    • Created_Date

    • Number_of_Copies

    • Label_Printer

    • Label_Template

Inventory_Label_Goods_Delivery_Ticket:

  • Goods_Delivery_Ticket_Data

    • Goods_Delivery_Ticket

      • Just_in_Time_Goods_Delivery

      • Created_Date

      • Created_by_Worker

      • Liefern an

      • Deliver-To_Address

      • Delivery_Ticket

      • Ursprung

      • Originating_Business_Document

      • Anforderer

    • Number_of_Copies

    • Label_Printer

    • Label_Template

Inventory_Label_Inventory_Locations:

  • Inventory_Location_Data

    • Speicherort

      • Global_Location_Number_-_GLN

      • Location_External_Name

      • Location_Identifier

      • Location_Name

      • Inventory_Location_Attributes

        • Inventory_Location

        • Inventory_Location_Chain

        • Inventory_Location_Usage_Type

        • Inventory_Site

    • Item_Descriptor

      • CAS_Number

      • CDM_Code

      • GTIN

      • HCPCS_Code

      • Is_Controlled

      • Is_Energy_Star

      • Is_Green

      • Is_Hazardous

      • Is_Latex-Free

      • Is_Patient_Chargeable

      • Is_Radioactive

      • Is_Refrigerated

      • Is_Reusable

      • Is_Toxin

      • Item_Description

      • Packaging_String

      • Item_Identifier

      • Item_Name

      • Manufacturer_Name

      • Manufacturer_Part_Id

      • Manufacturers_for_Procurement_Item

        • Item_Manufacturer

      • Spend_Category_for_Item

      • UNSPSC

      • UPN

      • Unit_Price

      • Default_Ordering_Unit_of_Measure

      • Legacy_Item_Number

    • Item_Inventory_Attributes

      • Replenishment_Type

      • Average_Daily_Usage

      • Base_Reorder_Point_Quantity

      • Fixed_Order_Quantity

      • Fixed_Order_Unit_of_Measure

      • Inventory_ABC_Classification

      • Include_in_Count

      • Purchase_Item

      • Replenishment_Unit_of_Measure

      • Inventory_Site

      • Lead_Time

      • Base_Maximum_Quantity

      • Preferred_Supplier_Lead_Time

      • Is_Preferred_Picking_Location

      • Is_Default_Put_Away_Location

      • Label_Printer

      • Label_Template

Inventory_Label_Location:

  • Location_Data

    • Global_Location_Number-GLN

    • Location_Attributes

    • Location_External_Name

    • Location_Hierarchies_included_with_Allowed_Values

    • Location_Identifier

    • Location_Name

    • Superior_Location

    • Worksite_ID_Code

    • Location_Inventory_Attributes

      • Inventory_Location

      • Inventory_Location_Chain

      • Inventory_Site

      • Source_Inventory_Site

    • Label_Printer

    • Label_Template

Inventory_Label_Par_Location:

  • Par_Location_Data

    • Speicherort

      • Global_Location_Number-GLN

      • Location_Attributes

      • Location_External_Name

      • Location_Hierarchies_included_with_Allowed_Values

      • Location_Identifier

      • Location_Name

      • Superior_Location

      • Worksite_ID_Code

    • Par_Location

      • Inventory_Stock_Request_Type

      • Par_Company

      • Par_Count_Option

      • Par_Location

      • Requisition_Type

      • Source_Inventory_Site

      • Source_Requisition_Company

      • Enforce_Reorder_Point

    • Bin

    • Pos.

    • Item_Description

    • Kanban

    • Item_Identifier

    • Par_Company

    • Par_Level

    • Just_In_Time

    • Replenishment_Source

    • Erforderlich

    • Par_Unit_Of_Measure

    • Line_Source_Inventory_Site

    • Line_Source_Requisition_Company

    • Reorder_Point

    • Item_Specific_Data

      • CAS_Number

      • CDM_Code

      • GTIN

      • HCPCS_Code

      • Is_Controlled

      • Is_Energy_Star

      • Is_Green

      • Is_Hazardous

      • Is_Latex-Free

      • Is_Patient_Chargeable

      • Is_Radioactive

      • Is_Refrigerated

      • Is_Reusable

      • Is_Toxin

      • Item_Description

      • Item_Identifier

      • Item_Name

      • Packaging_String

      • Manufacturer_Name

      • Manufacturer_Part_Id

      • Hersteller

        • Item_Manufacturer

      • Spend_Category_for_Item

      • UNSPSC

      • UPN

      • Unit_Price

      • Default_Ordering_Unit_of_Measure

    • Label_Printer

    • Label_Template

Inventory_Label_Receipt_Goods_Line:

  • Receipt_Line_Data

    • Receipt_Date

    • Purchase_Order_for_Receipt_Line

    • Quantity_Shipped

    • Item_Description

    • Spend_Category

    • Unit_Cost

    • Delivery_Type

    • Lieferadresse

    • Ship-to_contact

    • Deliver-to__Location_

    • Deliver-to__Address_

    • Put_Away_Location

    • Worktags

    • Worktag

  • Beleg

    • Receipt_Number

    • Firma

    • Lieferant

    • Received_By

    • Just_In_Time_Purchase_Order

  • Item_Descriptor

    • Item_Identifier

    • Packaging_String

    • Unit_Price

    • Item_Name

    • Default_Ordering_Unit_of_Measure

    • Item_Lead_Time

    • CAS_Number

    • UNSPSC

    • Manufacturer_Name

    • Manufacturer_Part_Id

    • Manufacturer_URL

    • GTIN

    • UPC

    • NIGP

    • Is_Toxin

    • Is_Radioactive

    • Is_Radioactive_Minor

    • Is_Hazardous

    • Is_Select_Agent

    • Is_Controlled

    • Is_Green_Product

    • Is_Green

    • Is_Energy_Star

    • Is_Patient_Chargeable

    • Is_Recycled

    • Is_Reusable

    • Is_Latex-Free

    • Is_Refrigerated

    • Manufacturers_for_Procurement_Item

      • Item_Manufacturer

    • UPN

    • CDM_Code

    • HCPCS_Code

  • Number_of_Copies

  • Label_Printing_Unit_of_Measure

  • Label_Printer

  • Label_Template