Action
Create Craft Note
UPDATES
about 2 years ago
typo fixed
about 2 years ago
typo fixed
about 2 years ago
added note on how to retrieve the space id
about 2 years ago
fixed typo
about 2 years ago
updated to use credentials of craft space instead of manual need to configure the space id in the script step. description updated
about 3 years ago
description update
about 3 years ago
updated to use x-callback-url and fixed create document issues by encoding the content
about 3 years ago
updated to use x-callback-url scheme.
created by @FlohGro / more on my Blog
Create Craft Note
This action creates a new Document in Craft in a configurable space.
[Configuration]
If you don’t want to use the (any of my) action for different Craft spaces there is no configuration needed. When you first run any of my Craft actions it will ask you to store the space id of your Craft space. This is a one time action and you don’t need to do it for any other of my Craft actions you install.
To retrieve your spaceId just copy the deeplink of any document in that space (refer to the Craft Support Page when you don’t know how to do that). Paste the copied id into a draft and you will se a link similar to this: “craftdocs://open?blockId=[the block id]&spaceId=[the spaceId]” - find the character combination “[the spaceId]” after the “spaceId=” and copy it and paste it into the prompt of this action.
To use these actions with different spaces you need to duplicate the action for each space you want to use it. I recommend to e.g. add a suffix to the action name to describe the space for which you configure it.
The action uses Drafts possibility to store credentials to distinguish different spaces. When you duplicate the action for another space you have to change the name of the credential. Therefore you need edit this line const spaceIdCredentialName = "CraftDocumentSpace" in the script step of the action and change the CraftDocumentSpace to something different (e.g. describe the space in a suffix like „CraftDocumentSpacePersonal" or „CraftDocumentSpaceWork“. If you use several of my Craft actions you should use the same credential name in all of them.
[Usage]
When you made notes during a meeting or while reading something and you decide to move the notes to Craft, simply run this action and it will create and open the new document in Craft. The markdown formatting will not be changed and applied to each created block in Craft.
If you want to use the actions for different spaces in Craft just follow the instructions above.
If you find this useful and want to support me you can
Trusted memberSteps
-
script
// created by @FlohGro // optional configuration of the spaceIdCredentialName - only necessary if you want to use the same action for different Craft Spaces const spaceIdCredentialName = "CraftDocumentSpace" let spaceID = getCraftSpaceIdToUse(); let title = draft.displayTitle let content = draft.processTemplate("[[body]]") content = encodeURIComponent(content) const baseURL = "craftdocs://x-callback-url/createdocument?" var cb = CallbackURL.create() cb.baseURL = baseURL cb.addParameter("spaceId", spaceID) cb.addParameter("title", title) cb.addParameter("content", content) cb.addParameter("folderId", "") cb.waitForResponse = true let result = cb.open() if (result == true) { console.log("Craft note successfully created") } else { console.log("Craft note result:" + cb.status + " " + cb.callbackResponse) if (cb.status == "cancelled") { context.cancel() } else { context.fail() } } function getCraftSpaceIdToUse() { let credential = Credential.create(spaceIdCredentialName, "Credential to store the spaceId of the space you want to use in Drafts.\ninsert your spaceId into the TextField below. \n\nNOTES: \n- this is a one time action, you don't need to do it everytime\n- Multiple spaces are currently not supported with this spaceId credential helper"); credential.addTextField("spaceId", "spaceId"); if (credential.authorize()) { return credential.getValue("spaceId"); } else { let errorStr = "failed storing / retrieving space Id with credential" app.displayErrorMessage(errorStr); context.fail(errorStr); console.log(errorStr); return false; } }
Options
-
After Success Default Notification Info Log Level Info
;%5Cn%5Cnlet%20title%20=%20draft.displayTitle%5Cn%5Cnlet%20content%20=%20draft.processTemplate(%5C%22[[body]]%5C%22)%5Cn%5Cncontent%20=%20encodeURIComponent(content)%5Cn%5Cnconst%20baseURL%20=%20%5C%22craftdocs://x-callback-url/createdocument?%5C%22%5Cn%5Cnvar%20cb%20=%20CallbackURL.create()%5Cncb.baseURL%20=%20baseURL%5Cncb.addParameter(%5C%22spaceId%5C%22,%20spaceID)%5Cncb.addParameter(%5C%22title%5C%22,%20title)%5Cncb.addParameter(%5C%22content%5C%22,%20content)%5Cncb.addParameter(%5C%22folderId%5C%22,%20%5C%22%5C%22)%5Cncb.waitForResponse%20=%20true%5Cn%5Cnlet%20result%20=%20cb.open()%5Cn%5Cnif%20(result%20==%20true)%20%7B%5Cn%20%20%20%20console.log(%5C%22Craft%20note%20successfully%20created%5C%22)%5Cn%7D%20else%20%7B%5Cn%20%20%20%20console.log(%5C%22Craft%20note%20result:%5C%22%20+%20cb.status%20+%20%5C%22%20%5C%22%20+%20cb.callbackResponse)%5Cn%20%20%20%20if%20(cb.status%20==%20%5C%22cancelled%5C%22)%20%7B%5Cn%20%20%20%20%20%20%20%20context.cancel()%5Cn%20%20%20%20%7D%20else%20%7B%5Cn%20%20%20%20%20%20%20%20context.fail()%5Cn%20%20%20%20%7D%5Cn%7D%5Cn%5Cnfunction%20getCraftSpaceIdToUse()%20%7B%5Cn%20%20%20%20let%20credential%20=%20Credential.create(spaceIdCredentialName,%20%5C%22Credential%20to%20store%20the%20spaceId%20of%20the%20space%20you%20want%20to%20use%20in%20Drafts.%5C%5Cninsert%20your%20spaceId%20into%20the%20TextField%20below.%20%5C%5Cn%5C%5CnNOTES:%20%5C%5Cn-%20this%20is%20a%20one%20time%20action,%20you%20don't%20need%20to%20do%20it%20everytime%5C%5Cn-%20Multiple%20spaces%20are%20currently%20not%20supported%20with%20this%20spaceId%20credential%20helper%5C%22);%5Cn%20%20%20%20credential.addTextField(%5C%22spaceId%5C%22,%20%5C%22spaceId%5C%22);%5Cn%20%20%20%20if%20(credential.authorize())%20%7B%5Cn%20%20%20%20%20%20%20%20return%20credential.getValue(%5C%22spaceId%5C%22);%5Cn%20%20%20%20%7D%20else%20%7B%5Cn%20%20%20%20%20%20%20%20let%20errorStr%20=%20%5C%22failed%20storing%20/%20retrieving%20space%20Id%20with%20credential%5C%22%5Cn%20%20%20%20%20%20%20%20app.displayErrorMessage(errorStr);%5Cn%20%20%20%20%20%20%20%20context.fail(errorStr);%5Cn%20%20%20%20%20%20%20%20console.log(errorStr);%5Cn%20%20%20%20%20%20%20%20return%20false;%5Cn%20%20%20%20%7D%5Cn%7D%22,%22allowAsync%22:%22false%22%7D,%22type%22:%22script%22,%22isEnabled%22:true,%22uuid%22:%22C433F6B8-E797-4D16-A08D-068B2C1E74AD%22%7D],%22backingPlatforms%22:3,%22shortName%22:%22%22,%22shouldConfirm%22:false,%22disposition%22:3,%22keyCommand%22:%7B%22optionKey%22:false,%22input%22:%22%22,%22controlKey%22:false,%22commandKey%22:false,%22type%22:%22action%22,%22discoverabilityTitle%22:%22Create%20Craft%20Note%22,%22shiftKey%22:false%7D,%22logLevel%22:2,%22groupDisposition%22:0,%22notificationType%22:2,%22tintColor%22:%22violet%22,%22actionDescription%22:%22*created%20by%20[@FlohGro](https://twitter.com/FlohGro)%20/%20more%20on%20my%20[Blog](http://www.flohgro.com/blog)*%5Cn%5Cn%23%23%20Create%20Craft%20Note%5Cn%5CnThis%20action%20creates%20a%20new%20Document%20in%20Craft%20in%20a%20configurable%20space.%5Cn%5Cn%23%23%20[Configuration]%5Cn%5Cn%5CnIf%20you%20don%E2%80%99t%20want%20to%20use%20the%20(any%20of%20my)%20action%20for%20different%20Craft%20spaces%20there%20is%20no%20configuration%20needed.%20When%20you%20first%20run%20any%20of%20my%20Craft%20actions%20it%20will%20ask%20you%20to%20store%20the%20space%20id%20of%20your%20Craft%20space.%20This%20is%20a%20one%20time%20action%20and%20you%20don%E2%80%99t%20need%20to%20do%20it%20for%20any%20other%20of%20my%20Craft%20actions%20you%20install.%5Cn%5CnTo%20retrieve%20your%20spaceId%20just%20copy%20the%20deeplink%20of%20any%20document%20in%20that%20space%20(refer%20to%20the%20[Craft%20Support%20Page](https://support.craft.do/hc/en-us/articles/360020043878-How-to-link-into-a-specific-place-in-Craft-with-a-Deeplink)%20when%20you%20don't%20know%20how%20to%20do%20that).%20Paste%20the%20copied%20id%20into%20a%20draft%20and%20you%20will%20se%20a%20link%20similar%20to%20this:%20%5C%22craftdocs://open?blockId=[the%20block%20id]%5Cu0026spaceId=[the%20spaceId]%5C%22%20-%20find%20the%20character%20combination%20%5C%22[the%20spaceId]%5C%22%20after%20the%20%5C%22spaceId=%5C%22%20and%20copy%20it%20and%20paste%20it%20into%20the%20prompt%20of%20this%20action.%5Cn%5CnTo%20use%20these%20actions%20with%20different%20spaces%20you%20need%20to%20duplicate%20the%20action%20for%20each%20space%20you%20want%20to%20use%20it.%20I%20recommend%20to%20e.g.%20add%20a%20suffix%20to%20the%20action%20name%20to%20describe%20the%20space%20for%20which%20you%20configure%20it.%20%20%5CnThe%20action%20uses%20Drafts%20possibility%20to%20store%20[credentials](https://docs.getdrafts.com/docs/settings/credentials)%20to%20distinguish%20different%20spaces.%20When%20you%20duplicate%20the%20action%20for%20another%20space%20you%20have%20to%20change%20the%20name%20of%20the%20credential.%20Therefore%20you%20need%20edit%20this%20line%20%60const%20spaceIdCredentialName%20=%20%5C%22CraftDocumentSpace%5C%22%60%20in%20the%20script%20step%20of%20the%20action%20and%20change%20the%20%60CraftDocumentSpace%60%20to%20something%20different%20(e.g.%20describe%20the%20space%20in%20a%20suffix%20like%20%E2%80%9ECraftDocumentSpacePersonal%5C%22%20or%20%E2%80%9ECraftDocumentSpaceWork%E2%80%9C.%20If%20you%20use%20several%20of%20my%20Craft%20actions%20you%20should%20use%20the%20same%20credential%20name%20in%20all%20of%20them.%5Cn%5Cn%23%23%20[Usage]%5Cn%5Cn%5CnWhen%20you%20made%20notes%20during%20a%20meeting%20or%20while%20reading%20something%20and%20you%20decide%20to%20move%20the%20notes%20to%20Craft,%20simply%20run%20this%20action%20and%20it%20will%20create%20and%20open%20the%20new%20document%20in%20Craft.%20The%20markdown%20formatting%20will%20not%20be%20changed%20and%20applied%20to%20each%20created%20block%20in%20Craft.%5Cn%5CnIf%20you%20want%20to%20use%20the%20actions%20for%20different%20spaces%20in%20Craft%20just%20follow%20the%20instructions%20above.%5Cn%5Cn---%5Cn%5Cn*If%20you%20find%20this%20useful%20and%20want%20to%20support%20me%20you%20can*%20%5Cn%5Cn%5Cu003ca%20href=%5C%22https://www.buymeacoffee.com/flohgro%5C%22%20target=%5C%22_blank%5C%22%5Cu003e%5Cu003cimg%20src=%5C%22https://cdn.buymeacoffee.com/buttons/v2/default-blue.png%5C%22%20alt=%5C%22Buy%20Me%20A%20Coffee%5C%22%20style=%5C%22height:%2051px%20!important;width:%20209px%20!important;%5C%22%20%5Cu003e%5Cu003c/a%5Cu003e%22,%22keyUseIcon%22:false,%22icon%22:%22memo%22,%22visibility%22:480,%22backingIsSeparator%22:false,%22groupUUID%22:%2225801B11-1228-4E40-A9E9-460EE3D1E84D%22,%22assignTags%22:[],%22name%22:%22Create%20Craft%20Note%22%7D){kind=link}