import app from "../../topdesk.app.mjs";
export default {
key: "topdesk-get-knowledge-items",
name: "Get Knowledge Items",
description: "Returns a list of Knowledge Items. [See the documentation](https://developers.topdesk.com/explorer/?page=knowledge-base#/Knowledge%20Items/getKnowledgeItems)",
version: "0.0.1",
type: "action",
props: {
app,
maxResults: {
type: "integer",
label: "Max Results",
description: "Maximum number of knowledge items to return. Leave empty to return all items.",
optional: true,
},
fields: {
type: "string[]",
label: "Fields",
description: "Additional fields to include in the response. ID and number are always included.",
optional: true,
options: [
"parent",
"visibility",
"urls",
"news",
"manager",
"status",
"standardSolution",
"externalLink",
"language",
"title",
"description",
"content",
"commentsForOperators",
"keywords",
"creator",
"modifier",
"creationDate",
"modificationDate",
"translation.creator",
"translation.modifier",
"translation.creationDate",
"translation.modificationDate",
"availableTranslations",
],
},
query: {
type: "string",
label: "Query",
description: `A FIQL query to filter the response. Use semicolons to combine multiple conditions.
**Available filter fields:**
- \`parent.id\`, \`parent.number\`
- \`visibility.sspVisibility\`, \`visibility.sspVisibleFrom\`, \`visibility.sspVisibleUntil\`
- \`visibility.sspVisibilityFilteredOnBranches\`, \`visibility.operatorVisibilityFilteredOnBranches\`
- \`visibility.publicKnowledgeItem\`, \`visibility.branches.id\`, \`visibility.branches.name\`
- \`manager.id\`, \`manager.name\`
- \`status.id\`, \`status.name\`
- \`standardSolution.id\`, \`standardSolution.name\`
- \`externalLink.id\`, \`externalLink.type\`, \`externalLink.date\`
- \`archived\`, \`news\`
**Operators:**
- \`==\` (equals), \`!=\` (not equals)
- \`=gt=\` (greater than), \`=ge=\` (greater than or equal)
- \`=lt=\` (less than), \`=le=\` (less than or equal)
- \`=in=\` (in list), \`=out=\` (not in list)
**Example:** \`parent.id==3fa85f64-5717-4562-b3fc-2c963f66afa6;externalLink.id=in=(oneTool,otherTool)\`
[See the documentation](https://developers.topdesk.com/explorer/?page=knowledge-base#/Knowledge%20Items/getKnowledgeItems) for more information.`,
optional: true,
},
language: {
type: "string",
label: "Language",
description: "The language of the Knowledge Item content, in BCP 47 format (e.g., `en`)",
optional: true,
},
},
annotations: {
readOnlyHint: true,
destructiveHint: false,
openWorldHint: true,
},
async run({ $ }) {
const {
app,
maxResults,
fields,
query,
language,
} = this;
const items = [];
const paginator = app.paginate({
fn: app.listKnowledgeItems,
fnArgs: {
$,
params: {
fields: Array.isArray(fields) && fields?.length
? fields.join(",")
: typeof fields === "string" && fields.length
? fields
: undefined,
query,
language,
page_size: 100,
},
},
maxResults,
dataField: "item",
});
for await (const item of paginator) {
items.push(item);
}
$.export("$summary", `Successfully retrieved \`${items.length}\` knowledge item(s)`);
return items;
},
};
Chase Roberts@chsrbrts@benedictevans If you haven’t used @pipedream yet, then you haven’t lived.
✨Ellie Day✨@heyelliedayEvaluation update: @pipedream has quite literally been a dream to work with! I’m excited to leverage this tool for all the various workflows I need to write. I’m currently at 11k invocations a day from the initial workflows I’ve written in the past couple weeks.
Michael Braedley@MBraedleyUpdate: I got it working properly, and it's working so well that I'm dropping IFTTT. @pipedream can do everything that IFTTT basic can, and most (if not all things) IFTTT pro can for free or at a reasonable price if you need it. I am recommending it for basically any power user.
Thomas Cutting@mrthomascuttingWant quick+dirty integrations for a serverless workflow - @pipedream is my new go-to 😃
Matthew Roberts@mattdotrobertsday 013 - finally hit node js. This is the secret sauce of taking #nocode projects that one step further. Pumped about getting deeper into @pipedream now
Kenneth Auchenberg 💭@auchenbergYahoo Pipes is back! Kinda 😍 @pipedream
Raymond Camden 🥑@raymondcamdenAwesome video by the @pipedream folks showing real time twitter sentiment analysis integrated with Google Sheets. This is where Pipedream *really* shines, connecting systems together in easy workflows.
Nacho Caballero@nachocaballeroI couldn't recommend @pipedream more. It's an amazing service to integrate different APIs. Much more powerful than Zapier and more user-friendly than AWS Lambda. I'm very proud to wear this t-shirt #NoCode
Jason Snow@jyksnwDeveloped a working prototype environmental sensor IoT solution with @particle Photon, @pipedream, and @MongoDB with full graphing and alerting in less than a day! All amazing technology, will def. be exploring these more.
Steven Terrana@steven_terrana@burgwyn you've inspired me to finally set up my own blog. I'll make sure my first blog post explains the tech behind the setup. think @obsdmd + @GatsbyJS + @pipedream.
🚄 James Augeri, PhD@DotDotJamesWant to low-code your back end, need more horsepower than @Bubble / @KnackHQ, or just miss Yahoo! Pipes? Check out @PipeDream
Sébastien Chopin@AtinuxGitHub issues should be like @linear_app for maintainers. Looking forward more integrations with GH actions or tools like @pipedream 👀
Raul@raul_predescuIf you're a dev and not using @pipedream, you're missing out. Been using it for months, daily. FREE for devs. Plenty of integrations and good limits. Absolutely love it.
Bruno Skvorc@bitfallsSo @pipedream is pretty amazing. In 3 minutes I just made a flow which adds @rickastley's Never Gonna Give You Up to my @spotify playlist whenever a new pull request arrives in an old repo of mine.
Zach Lanich@ZachLanichUm, wow 🤯 @pipedream
Steven Bell@bellontechI just used @pipedream to build a Shopify App. Wow, they make small backed tasks easy.
Jay Hack 🎩🇺🇸@_jayhack_Very impressed with this bad boi - it reminds me of a @PalantirTech internal tool, but geared towards integrations instead of data analysis and far more customizable. Great expectations here 🚀🤩
Tree Sturgeon 🔥🚴♂️🌳@philsturgeonFor context this is day 2 of a really challenging and stupid migration from Notion to @airtable with disparate/missing data. It's going better than expected and thanks to @pipedream I don't have to bother the iOS dev to add W3W.