För att hjälpa kunderna att få ut det mesta av Planview AgilePlace tillhandahåller vi Web Services för att automatisera vanliga uppgifter, t.ex. att skapa, uppdatera och flytta kort på en tavla. Dessutom finns det programvaruklienter för vanliga programmeringsspråk och plattformar, vilket gör det lättare att dra nytta av Planview AgilePlaces webbtjänster. I den här artikeln vill jag presentera Planview AgilePlace Client for Node.js.
En överblick
Vad kan du göra med Planview AgilePlace Web Services? Här är några exempel.
- Automatisera repetitiva uppgifter, t.ex. att uppdatera många kort samtidigt.
- Övervaka Planview AgilePlace för specifika förhållanden och skicka meddelanden.
- Synkronisera information mellan Planview AgilePlace och ett annat system.
Planview AgilePlace Client för Node.js gör det enkelt att
- hämtar en lista över styrelser,
- hämta ett bräde med alla banor och kort,
- söka efter kort,
- lägga till, uppdatera, flytta och ta bort kort,
- och många andra uppgifter.
Varför Node.js?
- Node.js fungerar på Windows, Mac OSX och Linux.
- Node.js-programmen skrivs i JavaScript, som är det mest populära och universella språket.
- Node.js kan enkelt konsumera och använda webbtjänster.
- Det finns tusentals kostnadsfria programvarukomponenter med öppen källkod för att utöka Node.js-funktionerna.
- Inga speciella programmeringsverktyg behövs, bara en bra textredigerare.
Det är troligt att de system som du vill integrera med Planview AgilePlace också innehåller webbtjänster. Node.js är en idealisk lösning för att ansluta webbtjänster.
Snabbstartguide
Vokabulär för Node.js
Innan vi börjar kan det vara bra att definiera några vanliga termer som används för att bygga program med Node.js.
Term | Definition |
---|---|
modul | Programvara som kan användas med Node.js. Planview AgilePlace Client för Node.js är en modul. 3Moduler från tredje part kallas också ofta för "paket". |
paket | Används ofta omväxlande med "modul". |
npm | "Pakethanteraren" för Node.js. Det är ett program som används för att ladda ner och installera moduler. |
Installera Node.js
Om du inte redan har Node.js, Gå till nodejs.org och ladda ner installationsprogrammet. Du kan kontrollera att Node.js är installerat och fungerar från en kommandotolk eller ett terminalfönster.
Detta borde skriva ut den installerade versionen av Node.js till konsolen.
Skapa en projektmapp
Därefter skapar du en mapp för programmet. Från kommando-/terminalfönstret kan du använda följande. Ändra gärna namnet eller sökvägen till mappen.
Installera Planview AgilePlace-klienten
Det är enkelt att installera Planview AgilePlace-klienten för Node.js med npm
.
Hej Planview AgilePlace
Skapa en textfil med namnet leankit.js
med en textredigerare. Lägg till följande kod och spara filen.
Kör nu Node.js-programmet genom att ange följande.
Om allt går bra bör du se en lista över dina Planview AgilePlace-kort skrivas ut på konsolen.
Skaffa ett Planview AgilePlace-bräde
Planview AgilePlace-klienten för Node.js gör det enkelt att få fram en tavla med alla banor och annan information.
Skapa en ny JavaScript-fil som heter board.js
. Lägg till följande kod och uppdatera den så att den passar ditt konto. Slutligen sparar du filen.
Kör programmet på följande sätt.
Hämtning av kort
Planview AgilePlace-klienten för Node.js gör det också enkelt att söka efter kort.
Skapa en ny JavaScript-fil som heter cards.js
. Lägg till följande kod, uppdatera den så att den stämmer överens med ditt konto och spara filen.
Kör programmet på följande sätt.
Du kan använda sökkriterierna query
för att ytterligare begränsa listan över kort. Du kan också ta bort egenskapen `board` för att lista korten från alla brädor du har tillgång till. Använd t.ex. denna fråga för att söka efter kort med "my card title" på alla brädor:
Lägg till ett nytt kort
I det här sista exemplet automatiserar vi att lägga till ett kort på en tavla.
Skapa en ny JavaScript-fil som heter add-card.js
. Lägg till följande kod, uppdatera den så att den stämmer överens med ditt konto och spara filen.
Kör programmet på följande sätt.
Om allt är lyckat bör ett nytt kort snart dyka upp på din tavla i den vanliga droppbanan!
Sammanfattning
Planview AgilePlace Client for Node.js är ett enkelt sätt att automatisera Planview AgilePlace-uppgifter med hjälp av Node.js. Denna introduktion har bara skrapat på ytan. Du kan uppdatera kort, flytta kort, hantera arbetsbord, lägga till kommentarer och bilagor och mycket mer. Mer information finns i dokumentationen och i källkoden till . Och se till att kolla in exempelprojekten!