Printing support

ResearchKit/Common/ORKAnswerFormat.m

@@ -1040,7 +1040,7 @@ + (BOOL)supportsSecureCoding {
 }
 
 - (NSString *)stringForAnswer:(id)answer {
-    return ORKTimeOfDayStringFromComponents(answer);
+    return answer ? ORKTimeOfDayStringFromComponents(answer) : nil;
 }
 
 @end

ResearchKit/Common/ORKHelpers.m

@@ -89,6 +89,20 @@ id findInArrayByKey(NSArray * array, NSString *key, id value) {
     return nil;
 }
 
+NSString *ORKLocalizedStringFromDate(NSDate *date) {
+    if (!date) {
+        return @"";
+    }
+    static NSDateFormatter *formatter = nil;
+    static dispatch_once_t onceToken;
+    dispatch_once(&onceToken, ^{
+        formatter = [NSDateFormatter new];
+        formatter.dateStyle = NSDateFormatterShortStyle;
+        formatter.timeStyle = NSDateFormatterMediumStyle;
+    });
+    return [formatter stringFromDate:date];
+}
+
 NSString *ORKStringFromDateISO8601(NSDate *date) {
     static NSDateFormatter *formatter = nil;
     static dispatch_once_t onceToken;

ResearchKit/Common/ORKHelpers_Internal.h

@@ -158,6 +158,10 @@ UIColor *ORKRGBA(uint32_t x, CGFloat alpha);
 
 id findInArrayByKey(NSArray * array, NSString *key, id value);
 
+NSString *ORKLocalizedStringFromDate(NSDate *date);
+NSString *ORKStringFromDateISO8601(NSDate *date);
+NSDate *ORKDateFromStringISO8601(NSString *string);
+
 NSString *ORKSignatureStringFromDate(NSDate *date);
 
 NSURL *ORKCreateRandomBaseURL();

ResearchKit/Common/ORKHTMLPDFWriter.h → ResearchKit/Common/ORKPDFWriter.h

@@ -34,7 +34,7 @@
 
 NS_ASSUME_NONNULL_BEGIN
 
-@interface ORKHTMLPDFWriter : NSObject
+@interface ORKPDFWriter : NSObject
 
 - (void)writePDFFromHTML:(NSString *)html withCompletionBlock:(void (^)(NSData *data, NSError *error))completionBlock;
 

ResearchKit/Common/ORKHTMLPDFWriter.m → ResearchKit/Common/ORKPDFWriter.m

@@ -29,7 +29,7 @@ OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  */
 
 
-#import "ORKHTMLPDFWriter.h"
+#import "ORKPDFWriter.h"
 
 #import "ORKHelpers_Internal.h"
 
@@ -83,7 +83,7 @@ - (void)drawFooterForPageAtIndex:(NSInteger)pageIndex
 @end
 
 
-@interface ORKHTMLPDFWriter () <UIWebViewDelegate> {
+@interface ORKPDFWriter () <UIWebViewDelegate> {
     id _selfRetain;
 }
 
@@ -97,7 +97,7 @@ @interface ORKHTMLPDFWriter () <UIWebViewDelegate> {
 @end
 
 
-@implementation ORKHTMLPDFWriter
+@implementation ORKPDFWriter
 
 static const CGFloat HeaderHeight = 25.0;
 static const CGFloat FooterHeight = 25.0;
@@ -106,7 +106,7 @@ @implementation ORKHTMLPDFWriter
 - (void)writePDFFromHTML:(NSString *)html withCompletionBlock:(void (^)(NSData *data, NSError *error))completionBlock {
 
     _pageMargins = UIEdgeInsetsMake(PageEdge, PageEdge, PageEdge, PageEdge);
-    _pageSize = [ORKHTMLPDFWriter defaultPageSize];
+    _pageSize = [ORKPDFWriter defaultPageSize];
 
     _data = nil;
     _error = nil;

ResearchKit/Common/ORKResult.h

@@ -856,6 +856,13 @@ ORK_CLASS_AVAILABLE
  */
 @property (nonatomic) ORKQuestionType questionType;
 
+/**
+ A Boolean value indicating whether the result of a question step is empty.
+
+ @return YES if no answer has been given, otherwise NO.
+ */
+- (BOOL) isAnswerEmpty;
+
 @end
 
 

ResearchKit/Common/ORKResult.m

@@ -1299,6 +1299,10 @@ - (NSString *)descriptionWithNumberOfPaddingSpaces:(NSUInteger)numberOfPaddingSp
     return [description copy];
 }
 
+- (BOOL)isAnswerEmpty {
+    return ORKIsAnswerEmpty(self.answer);
+}
+
 @end
 
 

ResearchKit/Consent/ORKConsentDocument.m

@@ -40,7 +40,7 @@ OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
 #import "ORKConsentSectionFormatter.h"
 #import "ORKConsentSignature.h"
 #import "ORKConsentSignatureFormatter.h"
-#import "ORKHTMLPDFWriter.h"
+#import "ORKPDFWriter.h"
 
 #import "ORKHelpers_Internal.h"
 #import "ORKErrors.h"
@@ -53,12 +53,12 @@ @implementation ORKConsentDocument {
 #pragma mark - Initializers
 
 - (instancetype)init {
-    return [self initWithHTMLPDFWriter:[[ORKHTMLPDFWriter alloc] init]
+    return [self initWithPDFWriter:[[ORKPDFWriter alloc] init]
             consentSectionFormatter:[[ORKConsentSectionFormatter alloc] init]
             consentSignatureFormatter:[[ORKConsentSignatureFormatter alloc] init]];
 }
 
-- (instancetype)initWithHTMLPDFWriter:(ORKHTMLPDFWriter *)writer
+- (instancetype)initWithPDFWriter:(ORKPDFWriter *)writer
               consentSectionFormatter:(ORKConsentSectionFormatter *)sectionFormatter
             consentSignatureFormatter:(ORKConsentSignatureFormatter *)signatureFormatter{
     if (self = [super init]) {

ResearchKit/Consent/ORKConsentDocument_Internal.h

@@ -35,13 +35,13 @@
 
 NS_ASSUME_NONNULL_BEGIN
 
-@class ORKHTMLPDFWriter;
+@class ORKPDFWriter;
 @class ORKConsentSectionFormatter;
 @class ORKConsentSignatureFormatter;
 
 @interface ORKConsentDocument ()
 
-@property (nonatomic, strong, nullable) ORKHTMLPDFWriter *writer;
+@property (nonatomic, strong, nullable) ORKPDFWriter *writer;
 @property (nonatomic, strong, nullable) ORKConsentSectionFormatter *sectionFormatter;
 @property (nonatomic, strong, nullable) ORKConsentSignatureFormatter *signatureFormatter;
 

ResearchKit/Localized/en.lproj/ResearchKit.strings

@@ -423,6 +423,9 @@
 /* Charts */
 "CHART_NO_DATA_TEXT" = "No Data";
 
+/* Printing */
+"PRINT_TIMESTAMP" = "Started: %1$@, Completed: %2$@";
+
 /* Accessibility */
 "AX_BUTTON_BACK" = "Back";
 

ResearchKit/Printing/ORKHTMLPrintingTemplate.h

@@ -0,0 +1,63 @@
+/*
+ Copyright (c) 2016, Oliver Schaefer
+
+ Redistribution and use in source and binary forms, with or without modification,
+ are permitted provided that the following conditions are met:
+
+ 1.  Redistributions of source code must retain the above copyright notice, this
+ list of conditions and the following disclaimer.
+
+ 2.  Redistributions in binary form must reproduce the above copyright notice,
+ this list of conditions and the following disclaimer in the documentation and/or
+ other materials provided with the distribution.
+
+ 3.  Neither the name of the copyright holder(s) nor the names of any contributors
+ may be used to endorse or promote products derived from this software without
+ specific prior written permission. No license is granted to the trademarks of
+ the copyright holders even if such marks are included in this software.
+
+ THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+ AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE
+ FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+ SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+ CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+ OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+ OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ */
+
+
+#import <Foundation/Foundation.h>
+
+
+NS_ASSUME_NONNULL_BEGIN
+
+@interface ORKHTMLPrintingTemplate : NSObject
+
+- (NSString *)html;
+
+- (NSString *)step;
+
+- (NSString *)stepHeader;
+
+- (NSString *)formStep;
+
+- (NSString *)formStepAnswer;
+
+- (NSString *)questionStepAnswer;
+
+- (NSString *)stepAnswer;
+
+- (NSString *)stepSelectedAnswer;
+
+- (NSString *)stepUnselectedAnswer;
+
+- (NSString *)stepFooter;
+
+- (NSString *)image;
+
+@end
+
+NS_ASSUME_NONNULL_END